From d04d93c02aa2cf6e748607574232c99d434e8ce5 Mon Sep 17 00:00:00 2001 From: Kattni Date: Thu, 5 Nov 2026 21:55:29 -0500 Subject: [PATCH 1/5] Migrate the docs build from MkDocs to Zensical. - Build and live-serve run Zensical 0.1.0 (pinned) instead of MkDocs. - Config moves to Zensical-native files: docs/zensical.toml plus per-language docs/zensical..toml overrides, merged by docs-tools with the MkDocs INHERIT rule. Unexpected keys in a language file warn. - Navigation moves from literate-nav (SUMMARY.md) to native `nav`; existing nav-title translations are migrated in the PO files. - Add convert_mkdocs_config to convert downstream repos, with an equivalence check against the old YAML configuration. - Build-time defaults: classic theme variant, macros on_error_fail. - Theme fixes for Zensical: language selector links, header search, homepage title, TOC text, mkdocstrings locale. - Translated builds copy non-Markdown resources file by file. - Drop the MkDocs fallback and MkDocs-only dependencies. --- .gitignore | 2 + README.md | 91 +- docs/config.yml | 225 --- docs/en/SUMMARY.md | 48 - docs/en/content_test_bed/index.md | 4 +- docs/en/index.md | 6 +- docs/en/section_one/page_two.md | 2 +- docs/locales/ar/translations.po | 291 ++-- docs/locales/cs/translations.po | 291 ++-- docs/locales/da/translations.po | 291 ++-- docs/locales/de/translations.po | 292 ++-- docs/locales/es/translations.po | 291 ++-- docs/locales/fa/translations.po | 290 ++-- docs/locales/fr/translations.po | 291 ++-- docs/locales/it/translations.po | 291 ++-- docs/locales/ja/translations.po | 291 ++-- docs/locales/ko/translations.po | 291 ++-- docs/locales/pl/translations.po | 291 ++-- docs/locales/pt/translations.po | 291 ++-- docs/locales/ru/translations.po | 291 ++-- docs/locales/ta/translations.po | 290 ++-- docs/locales/tr/translations.po | 291 ++-- docs/locales/uk/translations.po | 291 ++-- docs/locales/vi/translations.po | 292 ++-- docs/locales/zh_CN/translations.po | 291 ++-- docs/locales/zh_TW/translations.po | 291 ++-- docs/mkdocs.ar.yml | 18 - docs/mkdocs.cs.yml | 18 - docs/mkdocs.da.yml | 18 - docs/mkdocs.de.yml | 18 - docs/mkdocs.en.yml | 11 - docs/mkdocs.es.yml | 18 - docs/mkdocs.fa.yml | 18 - docs/mkdocs.fr.yml | 18 - docs/mkdocs.it.yml | 18 - docs/mkdocs.ja.yml | 18 - docs/mkdocs.ko.yml | 18 - docs/mkdocs.pl.yml | 18 - docs/mkdocs.pt.yml | 18 - docs/mkdocs.ru.yml | 18 - docs/mkdocs.ta.yml | 18 - docs/mkdocs.tr.yml | 18 - docs/mkdocs.uk.yml | 18 - docs/mkdocs.vi.yml | 18 - docs/mkdocs.zh_CN.yml | 18 - docs/mkdocs.zh_TW.yml | 18 - docs/zensical.ar.toml | 18 + docs/zensical.cs.toml | 18 + docs/zensical.da.toml | 18 + docs/zensical.de.toml | 18 + docs/zensical.en.toml | 10 + docs/zensical.es.toml | 18 + docs/zensical.fa.toml | 18 + docs/zensical.fr.toml | 18 + docs/zensical.it.toml | 18 + docs/zensical.ja.toml | 18 + docs/zensical.ko.toml | 18 + docs/zensical.pl.toml | 18 + docs/zensical.pt.toml | 18 + docs/zensical.ru.toml | 18 + docs/zensical.ta.toml | 18 + docs/zensical.toml | 254 ++++ docs/zensical.tr.toml | 18 + docs/zensical.uk.toml | 18 + docs/zensical.vi.toml | 18 + docs/zensical.zh_CN.toml | 18 + docs/zensical.zh_TW.toml | 18 + pyproject.toml | 15 +- src/beeware_docs_tools/build_config.py | 464 ++++++ .../build_md_translations.py | 254 ++-- .../build_pot_translations.py | 15 +- .../convert_mkdocs_config.py | 1279 +++++++++++++++++ src/beeware_docs_tools/live_serve_en.py | 158 +- src/beeware_docs_tools/md_tempdir.py | 155 -- .../assets/stylesheets/beeware_theme.css | 9 + src/beeware_docs_tools/overrides/main.html | 13 + .../overrides/partials/alternate.html | 8 +- .../overrides/partials/header.html | 5 +- .../en/_shared/contribute/how/translate.md | 71 +- .../en/_shared/contribute/how/write-docs.md | 19 +- tests/test_build_config.py | 359 +++++ tests/test_convert_mkdocs_config.py | 314 ++++ tests/test_live_serve.py | 132 +- tox.ini | 4 +- 84 files changed, 5383 insertions(+), 4757 deletions(-) delete mode 100644 docs/config.yml delete mode 100644 docs/en/SUMMARY.md delete mode 100644 docs/mkdocs.ar.yml delete mode 100644 docs/mkdocs.cs.yml delete mode 100644 docs/mkdocs.da.yml delete mode 100644 docs/mkdocs.de.yml delete mode 100644 docs/mkdocs.en.yml delete mode 100644 docs/mkdocs.es.yml delete mode 100644 docs/mkdocs.fa.yml delete mode 100644 docs/mkdocs.fr.yml delete mode 100644 docs/mkdocs.it.yml delete mode 100644 docs/mkdocs.ja.yml delete mode 100644 docs/mkdocs.ko.yml delete mode 100644 docs/mkdocs.pl.yml delete mode 100644 docs/mkdocs.pt.yml delete mode 100644 docs/mkdocs.ru.yml delete mode 100644 docs/mkdocs.ta.yml delete mode 100644 docs/mkdocs.tr.yml delete mode 100644 docs/mkdocs.uk.yml delete mode 100644 docs/mkdocs.vi.yml delete mode 100644 docs/mkdocs.zh_CN.yml delete mode 100644 docs/mkdocs.zh_TW.yml create mode 100644 docs/zensical.ar.toml create mode 100644 docs/zensical.cs.toml create mode 100644 docs/zensical.da.toml create mode 100644 docs/zensical.de.toml create mode 100644 docs/zensical.en.toml create mode 100644 docs/zensical.es.toml create mode 100644 docs/zensical.fa.toml create mode 100644 docs/zensical.fr.toml create mode 100644 docs/zensical.it.toml create mode 100644 docs/zensical.ja.toml create mode 100644 docs/zensical.ko.toml create mode 100644 docs/zensical.pl.toml create mode 100644 docs/zensical.pt.toml create mode 100644 docs/zensical.ru.toml create mode 100644 docs/zensical.ta.toml create mode 100644 docs/zensical.toml create mode 100644 docs/zensical.tr.toml create mode 100644 docs/zensical.uk.toml create mode 100644 docs/zensical.vi.toml create mode 100644 docs/zensical.zh_CN.toml create mode 100644 docs/zensical.zh_TW.toml create mode 100644 src/beeware_docs_tools/build_config.py create mode 100644 src/beeware_docs_tools/convert_mkdocs_config.py delete mode 100644 src/beeware_docs_tools/md_tempdir.py create mode 100644 tests/test_build_config.py create mode 100644 tests/test_convert_mkdocs_config.py diff --git a/.gitignore b/.gitignore index 75157102..76e5e555 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,7 @@ # MkDocs _build +# Generated build configurations (removed after each build) +docs/_build.*.toml comment.md # uv diff --git a/README.md b/README.md index 6ae2f3b4..e3b7c766 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,85 @@ Tools for building BeeWare's documentation with a common theme and translations. +The documentation is built with [Zensical](https://zensical.org). + +## Configuration files + +A documentation repository has the following configuration files in its `docs` directory: + +* `zensical.toml`: the configuration shared by every language. +* `zensical..toml`: the settings for one language, for example `zensical.en.toml` and `zensical.de.toml`. There must be one for every language that is built, including English. + +All settings in both files go in a `[project]` table and its subtables, as described in the [Zensical documentation](https://zensical.org/docs/setup/basics/). Some things to note: + +* Markdown extensions are configured with dotted keys under `[project.markdown_extensions]`, for example `pymdownx.highlight = {}` or `toc.permalink = true`. Zensical reads the `pymdownx.*` extensions after all the other extensions. +* Plugins are configured under `[project.plugins.]`. +* A Python object (for example, an emoji index) is given as a string with its full dotted name, for example `"zensical.extensions.emoji.twemoji"`. +* The navigation is defined by the `nav` setting in `zensical.toml`. Titles in `nav` are translated with the rest of the documentation. There is no `SUMMARY.md` file, and wildcards aren't supported; every page must be listed. +* `site_url` doesn't need to be set. It is set at build time from the `READTHEDOCS_CANONICAL_URL` environment variable or, on Read the Docs, the URL of the version being built. +* Settings that depend on where content is during a build (`docs_dir`, `site_dir`, `theme.custom_dir`, the macros `include_dir`, the shared content Snippets path, and the mkdocstrings source `paths`) are set by docs-tools. mkdocstrings `paths` are given relative to the root of the repository. +* Unless they are set in the configuration, docs-tools also sets `theme.variant = "classic"` (the theme overrides are written for the classic Material look, not Zensical's default "modern" variant), the macros plugin's `on_error_fail = true` (so a macro that fails to render fails the build), and mkdocstrings' `locale` to `theme.language`. +* In a translated build, every non-Markdown file in `docs/en` (images, data files, stylesheets and so on) is copied into the translated content. + +A language file should only contain settings that are specific to the language: + +* `site_name` +* `docs_dir` +* `theme.language` +* `theme.direction` +* `extra.language_url` +* `extra.translation_type` +* `extra.header` (and anything under it) + +For example, `docs/zensical.de.toml`: + +```toml +[project] +site_name = "BeeWare Dokumentation" +docs_dir = "de" + +[project.theme] +language = "de" + +[project.extra] +language_url = "de/" +translation_type = "machine" + +[project.extra.header] +About = "Über" +``` + +The language file is merged over `zensical.toml` with the same rule MkDocs used for `INHERIT`: tables are merged, and any other value (including a list) replaces the value in `zensical.toml`. A language file can set other settings, but the build will warn about them, because a list in a language file replaces the list in `zensical.toml` instead of extending it. + +During a build, docs-tools writes the complete configuration for each language to `docs/_build..toml`, and generated content (translated Markdown, and the built site) to `docs/_build/build/`. The live server (`live_serve_en`) uses `docs/_build.live.en.toml` and `docs/_build/live/` instead, so a build can run while the live server is running. These are removed when the build or live server finishes; add `docs/_build.*.toml` and `_build` to `.gitignore` in case a build is interrupted. Zensical also keeps a cache in `docs/.cache`, which includes its own `.gitignore`. + +## Converting from MkDocs + +The `convert_mkdocs_config` command converts a repository's MkDocs configuration into this format: + +* `docs/config.yml` becomes `docs/zensical.toml`. +* Each `docs/mkdocs..yml` becomes `docs/zensical..toml`. +* The literate-nav navigation file (`docs/en/SUMMARY.md`) becomes the `nav` setting in `docs/zensical.toml`, and the literate-nav plugin is removed. The navigation is resolved with literate-nav's own parser, so wildcards are expanded to the pages they matched. +* Translations of navigation titles in `docs/locales//translations.po` are migrated to the plain titles used by `nav`. If a title already has its own translation (for example, because it is also a page heading), that translation is kept, and the difference is reported. +* `site_url: !ENV ...` is removed, as `site_url` is set at build time. +* Comments in the YAML files are carried over. + +Before writing anything, the converter checks that, for every language, the TOML configuration is the same as the configuration Zensical reads from the YAML files, apart from the intended differences listed above (and the order of the Markdown extensions, which is reported). If there are any other differences, it lists them and doesn't change any files. + +To convert a repository, install docs-tools with the `convert` extra (which adds literate-nav), and run the converter from the root of the repository: + +```console +$ python -m pip install -e "/path/to/beeware-docs-tools[convert]" +$ convert_mkdocs_config --check +$ convert_mkdocs_config +``` + +`--check` reports what would change without writing any files. By default, the converter deletes the original YAML and `SUMMARY.md` files; use `--keep-old` to keep them. Review the output, then: + +* Update any `tox.ini` settings that refer to MkDocs (for example, remove `DISABLE_MKDOCS_2_WARNING` and `NO_MKDOCS_2_WARNING`). +* Add `docs/_build.*.toml` to `.gitignore`. +* Recreate your tox environments (`tox -r`), as the dependencies have changed. + ## Adding a new language Weblate is able to generate a new language, however, adding a new language also requires a few changes to the documentation repository. @@ -10,11 +89,11 @@ For details, see [Adding a new translation](https://beeware.org/contributing/gui The following example outlines how you would go about adding German to this repo. The concepts are the same for any language in any of the docs repos. However, in order to support a language on another repo, you'll generally need to add support to *this* repository first - we can't support a language if `beeware-docs-tools` doesn't support it first. -### A new MkDocs configuration file +### A new language configuration file -The first thing to do is create a new file named `mkdocs.de.yml` in the `docs` directory. +The first thing to do is create a new file named `zensical.de.toml` in the `docs` directory. -For details, see [A new MkDocs configuration file](https://beeware.org/contributing/guide/how/translate/#a-new-mkdocs-configuration-file) in the Contribution guide. +For details, see [A new language configuration file](https://beeware.org/contributing/guide/how/translate/#a-new-language-configuration-file) in the Contribution guide. ### Update `tox.ini` @@ -24,11 +103,11 @@ For details, see, [Update `tox.ini`](https://beeware.org/contributing/guide/how/ Note that this repository is slightly different to other docs repositories that *use* docs tools. This repository includes documentation content, but also contains shared content that is used in other repositories. The tox file includes translation steps for *both* local content and shared content; other repositories will only have local content. -### Update `config.yml` +### Update `zensical.toml` -Add the language to `config.yml` so it will show up in the language selector in the header. +Add the language to `extra.alternate` in `zensical.toml` so it will show up in the language selector in the header. -For details, see [Update `config.yml`](https://beeware.org/contributing/guide/how/translate/#update-configyml) in the Contribution guide. +For details, see [Update `zensical.toml`](https://beeware.org/contributing/guide/how/translate/#update-zensicaltoml) in the Contribution guide. ### Run `tox translate` diff --git a/docs/config.yml b/docs/config.yml deleted file mode 100644 index 32381923..00000000 --- a/docs/config.yml +++ /dev/null @@ -1,225 +0,0 @@ -copyright: © Russell Keith-Magee - -not_in_nav: | - /index.md - /about/releases.md - -validation: - omitted_files: warn - absolute_links: relative_to_docs - anchors: warn - unrecognized_links: warn - -extra: - project_name: beeware-docs-tools - package_name: beeware-docs-tools - formal_name: "BeeWare Docs Tools" - website: false # true shows beeware.org-specific content, false shows project content. Default: false. - min_python_version: "3.10" # The oldest supported Python version - min_python_version_tag: "310" # The tag version of the minimum python version - recent_python_version: "3.13" # The newest Python version known to work on all platforms - docs_python_version: "3.13" # The version of Python required to build the documentation - translated: true # false hides content related to building translations. Default: false. - hide_coverage: false # true hides content related to code coverage. Default: false. - macos_only: false # true hides tabbed content, and displays only macOS instructions. Default: false. - contribution_guide_root: content_test_bed/how-to/contribute - alternate: - - name: English - link: /en/ - lang: en - - name: العَرَبِيَّة - link: /ar/ - lang: ar - - name: Čeština - link: /cs/ - lang: cs - - name: Dansk - link: /da/ - lang: da - - name: Deutsch - link: /de/ - lang: de - - name: Español - link: /es/ - lang: es - - name: فارسی - link: /fa/ - lang: fa - - name: Français - link: /fr/ - lang: fr - - name: Italiano - link: /it/ - lang: it - - name: 日本語 - link: /ja/ - lang: ja - - name: 한국어 - link: /ko/ - lang: ko - - name: Polski - link: /pl/ - lang: pl - - name: Português - link: /pt/ - lang: pt - - name: Русский - link: /ru/ - lang: ru - - name: தமிழ் - link: /ta/ - lang: ta - - name: Türkçe - link: /tr/ - lang: tr - - name: Yкраїнська - link: /uk/ - lang: uk - - name: Tiếng Việt - link: /vi/ - lang: vi - - name: 中文(简体) - link: /zh_CN/ - lang: zh-Hant - - name: 中文(繁體) - link: /zh_TW/ - lang: zh-TW - social: - - icon: fontawesome/brands/github - link: https://github.com/beeware - name: BeeWare on GitHub - - icon: fontawesome/brands/mastodon - link: https://fosstodon.org/@beeware - name: BeeWare on Mastodon - - icon: fontawesome/brands/discord - link: https://beeware.org/bee/chat/ - name: BeeWare on Discord - generator: false - -theme: - name: material - language: en - logo: assets/images/brutus-256.png - favicon: assets/images/brutus-256.png - features: - - content.tabs.link - - toc.follow - - navigation.indexes - - navigation.footer - - navigation.tabs - - navigation.tabs.sticky - - search.suggest - - search.highlight - - search.share - custom_dir: overrides - palette: - # Palette toggle for automatic mode - - media: "(prefers-color-scheme)" - toggle: - icon: material/brightness-auto - name: Switch to light mode - - # Palette toggle for light mode - - media: "(prefers-color-scheme: light)" - scheme: default - toggle: - icon: material/brightness-7 - name: Switch to dark mode - - # Palette toggle for dark mode - - media: "(prefers-color-scheme: dark)" - scheme: slate - toggle: - icon: material/brightness-4 - name: Switch to system preference - -markdown_extensions: - # PyMdown Extensions - pymdownx.fancylists: {} # Supports various ordered list styles - pymdownx.highlight: {} # Highlights code blocks, when language provided. - pymdownx.inlinehilite: {} # Highlights inline code, when language provided. - pymdownx.keys: {} # Fancy displays key combinations. - pymdownx.superfences: {} # Nicer code-blocks. - pymdownx.saneheaders: {} # Treats "#Content" with no space at the beginning of a line as text, not a header; helpful with MagicLink. rumdl will still verify header formatting. - pymdownx.tasklist: {} # Make fancy checklists. - pymdownx.blocks.caption: {} # Captions images. - pymdownx.blocks.admonition: # Enables admonitions. - types: - - note - - abstract - - info - - tip - - success - - question - - warning - - failure - - danger - - bug - - example - - quote - pymdownx.blocks.details: # Enables collapsible content. - types: - - {name: details-note, class: note} - - {name: details-abstract, class: abstract} - - {name: details-info, class: info} - - {name: details-tip, class: tip} - - {name: details-success, class: success} - - {name: details-question, class: question} - - {name: details-warning, class: warning} - - {name: details-failure, class: failure} - - {name: details-danger, class: danger} - - {name: details-bug, class: bug} - - {name: details-example, class: example} - - {name: details-quote, class: quote} - pymdownx.blocks.tab: # Enables tabbed content. - alternate_style: true - pymdownx.snippets: # Allows for injecting content from other locations. - base_path: ["docs"] - url_download: true - check_paths: true - pymdownx.magiclink: # Among other things, enables GitHub shorthand references. - provider: "github" - user: "beeware" - repo: "website" - repo_url_shortener: true - repo_url_shorthand: true - normalize_issue_symbols: true - # Python Markdown Extensions - attr_list: {} # Enables setting explicit anchors, and CSS classes, etc. - smarty: # Enables easy em and en dashes. - smart_quotes: false - toc: # Enables the ToC, in the left sidebar, in the documentation. - permalink: true - title: On this page - -plugins: - search: {} - autorefs: - resolve_closest: true # autorefs warns of the Usage headings begin duplicates without this - we will have to assign unique ids to all of them otherwise - literate-nav: - nav_file: SUMMARY.md - macros: - include_dir: {} - mkdocstrings: - default_handler: python - handlers: - python: - paths: [src] - options: - docstring_style: sphinx # Parses docstrings from Sphinx formatting - the `:param` formatting, not parsing rST links - allow_inspection: false # True includes *more* dunder methods, can be enabled on individual class entries if you want them - show_source: false # Otherwise, source code is shown collapsed for all - members_order: alphabetical # Orders things based on the source code - annotations_path: brief # Keeps type annotation links more concise - merge_init_into_class: true # Otherwise, init is displayed separately - separate_signature: true # Shows the `function(args)` separately from name - show_signature: true # Displays () or (args) along with the function name in the signature - show_signature_annotations: true # Includes annotations in signature blocks - signature_crossrefs: true # Enables cross-referencing on signature annotations - show_root_heading: true # Show heading of object at root, otherwise nothing - docstring_section_style: spacy # Better info layout than the other options - line_length: 80 # Requires ruff, forces longer signatures to be stacked - show_symbol_type_toc: true # Enables type symbols next to objects in ToC - show_symbol_type_heading: true # Enables type symbols next to object names in content - show_attribute_values: false # Suppresses the values of attributes in the signature - heading_level: 3 # Heading level of 3 to nest under References heading diff --git a/docs/en/SUMMARY.md b/docs/en/SUMMARY.md deleted file mode 100644 index 21ed34eb..00000000 --- a/docs/en/SUMMARY.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -search: - exclude: true ---- - -- Section one - - [Section one](section_one/index.md) - - [Section one - page two](section_one/page_two.md) -- [Section two](section_two/index.md) -- [Section three](section_three/index.md) - - ./section_three/* -- Shared content testbed - - [Shared content testbed](content_test_bed/index.md) - - How-to guides - - Contribute - - [Contributing](content_test_bed/how-to/contribute/index.md) - - [First-time contributors](content_test_bed/how-to/contribute/first-time-contributors.md) - - What can I do? - - [Fix an issue](content_test_bed/how-to/contribute/what/fix-issue.md) - - [Implement a new feature](content_test_bed/how-to/contribute/what/implement-feature.md) - - [Write documentation](content_test_bed/how-to/contribute/what/write-docs.md) - - [Triage an issue](content_test_bed/how-to/contribute/what/triage.md) - - [Review a pull request](content_test_bed/how-to/contribute/what/review-pr.md) - - [Propose a new feature](content_test_bed/how-to/contribute/what/propose-feature.md) - - [Translate content](content_test_bed/how-to/contribute/what/translate.md) - - [Use the tools](content_test_bed/how-to/contribute/what/use-tools.md) - - How do I contribute? - - [Setting up a development environment](content_test_bed/how-to/contribute/how/dev-environment.md) - - [Reproducing an issue](content_test_bed/how-to/contribute/how/reproduce-issue.md) - - [Working from a branch](content_test_bed/how-to/contribute/how/branches.md) - - [Avoiding scope creep](content_test_bed/how-to/contribute/how/scope-creep.md) - - [Writing, running, and testing code](content_test_bed/how-to/contribute/how/write-code.md) - - [Building documentation](content_test_bed/how-to/contribute/how/build-docs.md) - - [Writing documentation](content_test_bed/how-to/contribute/how/write-docs.md) - - [Adding a change note](content_test_bed/how-to/contribute/how/change-note.md) - - [Submitting a pull request](content_test_bed/how-to/contribute/how/submit-pr.md) - - [Providing a review](content_test_bed/how-to/contribute/how/review-pr.md) - - [Submitting a new issue](content_test_bed/how-to/contribute/how/new-issue.md) - - [Proposing a new feature](content_test_bed/how-to/contribute/how/propose-feature.md) - - [Translating content](content_test_bed/how-to/contribute/how/translate.md) - - What happens next? - - [Pull request review process](content_test_bed/how-to/contribute/next/pr-review.md) - - [Release process](content_test_bed/how-to/contribute/next/release.md) - - Policies - - [AI Policy](content_test_bed/how-to/contribute/policies/ai-policy.md) - - Style guides - - [Code style guide](content_test_bed/how-to/contribute/style/code-style-guide.md) - - [Documentation style guide](content_test_bed/how-to/contribute/style/docs-style-guide.md) diff --git a/docs/en/content_test_bed/index.md b/docs/en/content_test_bed/index.md index 23d0d504..baef80a4 100644 --- a/docs/en/content_test_bed/index.md +++ b/docs/en/content_test_bed/index.md @@ -10,7 +10,7 @@ If you are creating a new shared documentation file in the `shared-content` dire * For `style_guide.md`, you would add `style_guide_include.md`. 2. Using the Snippets syntax, add the filename to `filename_include.md`. The Snippets syntax for including content is `-8<- "filename.md"`. * For `style_guide.md`, you would add `-8<- "style_guide.md"` to `style_guide_include.md`. -3. Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section. - * For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`. +3. Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section. + * For `style_guide_include.md`, you would add `{ "Style guide" = "content_test_bed/style_guide_include.md" },`. Once these steps are completed, you can build the test site and view your new documentation rendered. diff --git a/docs/en/index.md b/docs/en/index.md index c601b0bb..040c9baf 100644 --- a/docs/en/index.md +++ b/docs/en/index.md @@ -2,7 +2,7 @@ ## Theme checklist -This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description. +This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description. ## Titlebar @@ -77,7 +77,7 @@ LICENSE README.md src ## Sidebar links -Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added. +Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added. ## Link colors @@ -125,7 +125,7 @@ This document is a translation of the English version. The translation has been Add `nopage` to the end of the URL in your browser to verify the 404 page exists, and includes the text "Brutus can't find what you're looking for". The current 404 page does not always render the images due to an issue with MkDocs. -*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.* +*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.* ## Next checks diff --git a/docs/en/section_one/page_two.md b/docs/en/section_one/page_two.md index 1d9f37b6..98f1b293 100644 --- a/docs/en/section_one/page_two.md +++ b/docs/en/section_one/page_two.md @@ -14,6 +14,6 @@ Verify that the text in the parameter table is rendering at the same size as the ## Macro functionality -The following should say 'Brutus says "Hello world!"'. This confirms that global variables and macros defined via MkDocs-Macros are available. +The following should say 'Brutus says "Hello world!"'. This confirms that global variables and macros defined via the macros plugin are available. {{ mascot_name }} says "{{ say_hello() }}" diff --git a/docs/locales/ar/translations.po b/docs/locales/ar/translations.po index ae525199..e0978869 100644 --- a/docs/locales/ar/translations.po +++ b/docs/locales/ar/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "القسم الأول" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[القسم الأول]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[القسم الأول - الصفحة الثانية]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[القسم الثاني]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[القسم الثالث]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "منصة اختبار المحتوى المشترك" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[منصة اختبار المحتوى المشترك]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "أدلة إرشادية" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "ساهم" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[المساهمة]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[المساهمون لأول مرة]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "ماذا يمكنني أن أفعل؟" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[إصلاح مشكلة]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[تنفيذ ميزة جديدة]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[كتابة الوثائق]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[تصنيف مشكلة]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[مراجعة طلب سحب]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[اقتراح ميزة جديدة]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[ترجمة المحتوى]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[استخدم الأدوات]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "كيف يمكنني المساهمة؟" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[إعداد بيئة التطوير]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[إعادة إنتاج إصدار]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[العمل من فرع]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[تجنب توسع النطاق]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[كتابة وتشغيل واختبار الكود]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[وثائق البناء]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[كتابة الوثائق]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[إضافة ملاحظة تغيير]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[إرسال طلب سحب]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[تقديم مراجعة]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[إرسال مشكلة جديدة]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[اقتراح ميزة جديدة]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[ترجمة المحتوى]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "ماذا سيحدث بعد ذلك؟" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[عملية مراجعة طلب السحب]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[عملية الإصدار]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "السياسات" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[سياسة الذكاء الاصطناعي]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "أدلة الأسلوب" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[دليل أسلوب الكود]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[دليل أسلوب التوثيق]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` ربط" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "الرابط الموجود هنا سيأخذك إلى قسم [خط العنوان][heading-font] في الصفحة الرئيسية. تم تضمينه للتحقق من ارتباط `autoref`." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "القسم الأول - الصفحة الثانية" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "القسم الثاني" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "القسم الثالث" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "المساهمة" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "إصلاح مشكلة" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "تنفيذ ميزة جديدة" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "كتابة الوثائق" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "تصنيف مشكلة" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "مراجعة طلب سحب" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "اقتراح ميزة جديدة" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "ترجمة المحتوى" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "استخدم الأدوات" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "العمل من فرع" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "إضافة ملاحظة تغيير" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "تقديم مراجعة" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "عملية مراجعة طلب السحب" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "عملية الإصدار" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "سياسة الذكاء الاصطناعي" diff --git a/docs/locales/cs/translations.po b/docs/locales/cs/translations.po index d117dae0..c479acf2 100644 --- a/docs/locales/cs/translations.po +++ b/docs/locales/cs/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "První část" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Část první]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Část první – strana druhá]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[Část druhá]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Část třetí]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Testovací prostředí sdíleného obsahu" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Testovací prostředí sdíleného obsahu]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Návody" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Přispějte" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Přispívání]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[První přispěvatelé]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "Co mohu dělat?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Opravit problém]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Implementovat novou funkci]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Napsat dokumentaci]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Třídění problému]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Zkontrolujte žádost o stažení]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Navrhnout novou funkci]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[Přeložit obsah]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Použijte nástroje]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "Jak mohu přispět?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Nastavení vývojového prostředí]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Reprodukce problému]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Práce z pobočky]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Vyhýbání se rozšiřování rozsahu projektu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Psaní, spouštění a testování kódu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Stavební dokumentace]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Psaní dokumentace]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Přidání poznámky o změně]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Odeslání žádosti o stažení]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[Poskytnutí recenze]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Odeslání nového problému]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Návrh nové funkce]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[Překlad obsahu]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "Co se stane dál?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Proces kontroly žádostí o stažení]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Proces uvolnění]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Zásady" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Politika v oblasti umělé inteligence]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Stylové příručky" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Pravidla pro styl kódu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Pravidla pro styl dokumentace]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` propojení" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Odkaz uvedený zde by vás měl přesměrovat do sekce [Heading font][heading-font] hlavní stránky. Je zde uveden za účelem ověření fungování odkazů `autoref`." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Část první – strana druhá" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "Část druhá" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Část třetí" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Přispívání" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Opravit problém" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Implementovat novou funkci" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Napsat dokumentaci" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Třídění problému" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Zkontrolujte žádost o stažení" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Navrhnout novou funkci" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "Přeložit obsah" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Použijte nástroje" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Práce z pobočky" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Přidání poznámky o změně" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "Poskytnutí recenze" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Proces kontroly žádostí o stažení" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Proces uvolnění" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "Politika v oblasti umělé inteligence" diff --git a/docs/locales/da/translations.po b/docs/locales/da/translations.po index b370fdbf..1fc95991 100644 --- a/docs/locales/da/translations.po +++ b/docs/locales/da/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "Afsnit 1" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Afsnit 1]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Afsnit 1 – side 2]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[Afsnit to]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Afsnit tre]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Testplatform for delt indhold" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Testplatform for delt indhold]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Vejledninger" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Bidrag" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Bidragende]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[Førstegangsbidragere]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "Hvad kan jeg gøre?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Løs et problem]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Implementer en ny funktion]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Skriv dokumentation]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Prioriter et problem]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Gennemgå en pull-anmodning]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Foreslå en ny funktion]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[Oversæt indhold]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Brug værktøjerne]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "Hvordan kan jeg bidrage?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Opsætning af et udviklingsmiljø]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Gengivelse af et problem]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Arbejde fra en gren]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Undgå scope creep]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Skrivning, kørsel og test af kode]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Bygningsdokumentation]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Skrivning af dokumentation]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Tilføjelse af en ændringsnote]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Indsendelse af en pull-anmodning]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[Giver en anmeldelse]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Indsendelse af et nyt problem]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Forslag til en ny funktion]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[Oversættelse af indhold]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "Hvad sker der nu?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Gennemgang af pull-anmodninger]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Frigivelsesproces]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Retningslinjer" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[AI-politik]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Stilguider" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Kode-stilguide]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Dokumentationsstilguide]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` sammenkædning" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Det link, der er angivet her, skal føre dig til afsnittet [Heading font][heading-font] på hovedsiden. Det er inkluderet for at verificere `autoref` linking." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Afsnit 1 – side 2" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "Afsnit to" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Afsnit tre" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Bidragende" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Løs et problem" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Implementer en ny funktion" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Skriv dokumentation" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Prioriter et problem" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Gennemgå en pull-anmodning" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Foreslå en ny funktion" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "Oversæt indhold" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Brug værktøjerne" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Arbejde fra en gren" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Tilføjelse af en ændringsnote" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "Giver en anmeldelse" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Gennemgang af pull-anmodninger" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Frigivelsesproces" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "AI-politik" diff --git a/docs/locales/de/translations.po b/docs/locales/de/translations.po index c20328a4..3e5c8a9c 100644 --- a/docs/locales/de/translations.po +++ b/docs/locales/de/translations.po @@ -12,235 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "Abschnitt eins" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Abschnitt eins]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Abschnitt eins - Seite zwei]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[Abschnitt zwei]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Abschnitt drei]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Testumgebung für gemeinsam genutzte Inhalte" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Testumgebung für gemeinsam genutzte Inhalte]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Anleitungen" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Beitragen" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Mitwirkend]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[Erstmalige Beitragszahler]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "Was kann ich tun?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Ein Problem beheben]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Implementierung einer neuen Funktion]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Dokumentation schreiben]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Triage eines Problems]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Eine Pull-Anfrage überprüfen]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Vorschlag für ein neues Merkmal]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[Inhalt übersetzen]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Benutze die Werkzeuge]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "Wie kann ich einen Beitrag leisten?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Einrichten einer Entwicklungsumgebung]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Reproduzieren einer Ausgabe]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Von einer Verzweigung aus arbeiten]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Vermeidung der schleichenden Ausweitung des Geltungsbereichs]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Schreiben, Ausführen und Testen von Code]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Gebäudedokumentation]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Dokumentation schreiben]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Hinzufügen einer Änderungsnotiz]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Einen Pull-Request einreichen]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[Bereitstellung einer Rezension]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Einreichung einer neuen Ausgabe]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Vorschlag für ein neues Merkmal]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[Inhalt übersetzen]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "Wie geht es weiter?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Pull-Request-Überprüfungsprozess]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Freigabeprozess]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Richtlinien" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[KI-Richtlinie]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Style Guides" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Guide Style Code]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Documentation style guide]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1077,3 +893,93 @@ msgstr "`autoref`-Verknüpfung" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Der hier angegebene Link sollte Sie zum Abschnitt [Überschrift-Schriftart][heading-font] auf der Hauptseite führen. Er ist enthalten, um die `autoref`-Verknüpfung zu überprüfen." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Abschnitt eins - Seite zwei" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "Abschnitt zwei" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Abschnitt drei" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Mitwirkend" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Ein Problem beheben" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Implementierung einer neuen Funktion" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Dokumentation schreiben" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Triage eines Problems" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Eine Pull-Anfrage überprüfen" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Vorschlag für ein neues Merkmal" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "Inhalt übersetzen" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Benutze die Werkzeuge" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Von einer Verzweigung aus arbeiten" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Hinzufügen einer Änderungsnotiz" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "Bereitstellung einer Rezension" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Pull-Request-Überprüfungsprozess" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Freigabeprozess" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "KI-Richtlinie" diff --git a/docs/locales/es/translations.po b/docs/locales/es/translations.po index 08221d82..88b2749e 100644 --- a/docs/locales/es/translations.po +++ b/docs/locales/es/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "Sección uno" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Sección uno]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Sección uno - página dos]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[Sección dos]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Sección tres]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Banco de pruebas de contenido compartido" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Banco de pruebas de contenido compartido]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Guías prácticas" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Contribuir" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Contribuir]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[Colaboradores nuevos]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "¿Qué puedo hacer?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Solucionar un problema]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Implementar una nueva función]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Escribir documentación]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Clasificar un problema]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Revisar una solicitud de incorporación de cambios]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Proponer una nueva función]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[Traducir contenido]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Utilice las herramientas]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "¿Cómo puedo contribuir?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Configuración de un entorno de desarrollo]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Reproducción de un problema]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Trabajar desde una rama]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Evitar la desviación del alcance]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Escribir, ejecutar y probar código]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Documentación del edificio]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Redacción de documentación]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Añadir una nota de cambio]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Enviar una solicitud de extracción]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[Proporcionar una reseña]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Enviar un nuevo problema]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Propuesta de una nueva función]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[Traducir contenido]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "¿Qué pasa después?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Proceso de revisión de solicitudes de incorporación de cambios]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Proceso de liberación]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Políticas" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Política de IA]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Guías de estilo" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Guía de estilo de código]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Guía de estilo para la documentación]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` enlace" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "El enlace que se proporciona aquí debería llevarte a la sección [Fuente del encabezado][heading-font] de la página principal. Se incluye para verificar el enlace `autoref`." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Sección uno - página dos" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "Sección dos" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Sección tres" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Contribuir" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Solucionar un problema" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Implementar una nueva función" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Escribir documentación" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Clasificar un problema" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Revisar una solicitud de incorporación de cambios" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Proponer una nueva función" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "Traducir contenido" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Utilice las herramientas" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Trabajar desde una rama" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Añadir una nota de cambio" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "Proporcionar una reseña" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Proceso de revisión de solicitudes de incorporación de cambios" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Proceso de liberación" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "Política de IA" diff --git a/docs/locales/fa/translations.po b/docs/locales/fa/translations.po index 639b488f..c103e0d3 100644 --- a/docs/locales/fa/translations.po +++ b/docs/locales/fa/translations.po @@ -12,233 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "بخش اول" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[بخش اول]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[بخش یک - صفحه دو]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[بخش دوم]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[بخش سوم]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "محیط آزمایشی محتوای مشترک" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[محیط آزمایشی محتوای مشترک]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "راهنمای چگونگی انجام" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "مشارکت کنید" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[مشارکت‌کننده]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[نخستین مشارکت‌کنندگان]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "چه کار می‌توانم بکنم؟" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[رفع یک مشکل]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[پیاده‌سازی یک ویژگی جدید]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[مستندسازی بنویسید]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[اولویت‌بندی یک مسئله]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[بررسی یک درخواست کشش]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[پیشنهاد یک ویژگی جدید]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[محتوا را ترجمه کنید]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[ابزارها را استفاده کنید]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "چگونه مشارکت کنم؟" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[راه‌اندازی محیط توسعه]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[بازتولید یک شماره]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[کار کردن از یک شعبه]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[اجتناب از گسترش دامنه]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[نوشتن، اجرا و تست کد]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[مستندسازی ساختمان]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[نوشتن مستندات]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[افزودن یادداشت تغییر]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[ارسال یک درخواست ادغام]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[ارائه یک نقد]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[ارسال یک مشکل جدید]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[پیشنهاد یک ویژگی جدید]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[محتوای در حال ترجمه]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "بعد چه می‌شود؟" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[فرآیند بازبینی درخواست کشش]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[فرآیند انتشار]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "سیاست‌ها" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[سیاست‌گذاری هوش مصنوعی]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "راهنماهای سبک" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[راهنمای سبک کد]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[راهنمای سبک مستندسازی]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1069,3 +887,93 @@ msgstr "لینک‌گذاری" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "لینک ارائه‌شده در اینجا باید شما را به بخش [Heading font][heading-font] صفحهٔ اصلی هدایت کند. این لینک برای تأیید پیوند `autoref` گنجانده شده است." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "بخش یک - صفحه دو" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "بخش دوم" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "بخش سوم" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "مشارکت‌کننده" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "رفع یک مشکل" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "پیاده‌سازی یک ویژگی جدید" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "مستندسازی بنویسید" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "اولویت‌بندی یک مسئله" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "بررسی یک درخواست کشش" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "پیشنهاد یک ویژگی جدید" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "محتوا را ترجمه کنید" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "ابزارها را استفاده کنید" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "کار کردن از یک شعبه" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "افزودن یادداشت تغییر" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "ارائه یک نقد" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "فرآیند بازبینی درخواست کشش" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "فرآیند انتشار" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "سیاست‌گذاری هوش مصنوعی" diff --git a/docs/locales/fr/translations.po b/docs/locales/fr/translations.po index 9cdac6e8..8ceb89ae 100644 --- a/docs/locales/fr/translations.po +++ b/docs/locales/fr/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "Section un" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Section 1]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Section un - page deux]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[Section deux]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Section trois]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Banc d'essai pour contenu partagé" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Banc d'essai de contenu partagé]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Guides pratiques" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Contribuer" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Contribuer]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[Premiers contributeurs]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "Que puis-je faire ?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Résoudre un problème]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Mettre en œuvre une nouvelle fonctionnalité]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Write documentation]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Triage d'un problème]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Examiner une demande d'extraction]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Proposer une nouvelle fonctionnalité]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[Traduire le contenu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Utiliser les outils]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "Comment puis-je contribuer ?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Mise en place d'un environnement de développement]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Reproduire un problème]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Travailler à partir d'une branche]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Éviter les dérives du champ d'application]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Écrire, exécuter et tester le code]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Documentation sur le bâtiment]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Documentation écrite]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Ajouter une note de modification]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Soumettre une demande d'extraction]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[Fournir un avis]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Soumission d'un nouveau numéro]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Proposer une nouvelle fonctionnalité]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[Traduction du contenu]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "Que se passe-t-il ensuite ?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Processus d'examen des demandes de retrait]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Processus de libération]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Politiques" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Politique en matière d'IA]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Style guides" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Code style guide]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Documentation style guide]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1079,3 +896,93 @@ msgstr "Liaison `autoref`" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Le lien fourni ici devrait vous amener à la section [Police des titres][heading-font] de la page principale. Il est inclus pour vérifier les liens `autoref`." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Section un - page deux" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "Section deux" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Section trois" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Contribuer" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Résoudre un problème" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Mettre en œuvre une nouvelle fonctionnalité" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Write documentation" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Triage d'un problème" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Examiner une demande d'extraction" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Proposer une nouvelle fonctionnalité" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "Traduire le contenu" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Utiliser les outils" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Travailler à partir d'une branche" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Ajouter une note de modification" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "Fournir un avis" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Processus d'examen des demandes de retrait" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Processus de libération" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "Politique en matière d'IA" diff --git a/docs/locales/it/translations.po b/docs/locales/it/translations.po index 799f0fea..383e1ce1 100644 --- a/docs/locales/it/translations.po +++ b/docs/locales/it/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "Sezione uno" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Sezione uno]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Sezione uno - pagina due]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[Sezione due]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Sezione tre]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Banco di prova per contenuti condivisi" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Banco di prova per contenuti condivisi]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Guide pratiche" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Contribuisci" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Contributo]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[Nuovi collaboratori]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "Cosa posso fare?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Risolvi un problema]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Implementare una nuova funzionalità]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Scrivere la documentazione]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Valutare un problema]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Esamina una richiesta pull]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Proponi una nuova funzionalità]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[Traduci contenuto]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Utilizza gli strumenti]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "Come posso contribuire?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Configurazione di un ambiente di sviluppo]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Riproduzione di un problema]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Lavorare da un ramo]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Evitare lo scope creep]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Scrittura, esecuzione e test del codice]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Documentazione dell'edificio]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Scrittura della documentazione]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Aggiunta di una nota di modifica]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Invio di una richiesta pull]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[Fornire una recensione]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Invio di una nuova segnalazione]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Proposta di una nuova funzionalità]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[Traduzione del contenuto]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "Cosa succede dopo?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Processo di revisione delle richieste di pull]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Processo di rilascio]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Politiche" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Politica sull'intelligenza artificiale]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Guide di stile" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Guida allo stile del codice]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Guida allo stile della documentazione]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` collegamento" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Il link fornito qui dovrebbe portarti alla sezione [Carattere titolo][heading-font] della pagina principale. È incluso per verificare il collegamento `autoref`." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Sezione uno - pagina due" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "Sezione due" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Sezione tre" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Contributo" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Risolvi un problema" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Implementare una nuova funzionalità" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Scrivere la documentazione" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Valutare un problema" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Esamina una richiesta pull" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Proponi una nuova funzionalità" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "Traduci contenuto" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Utilizza gli strumenti" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Lavorare da un ramo" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Aggiunta di una nota di modifica" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "Fornire una recensione" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Processo di revisione delle richieste di pull" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Processo di rilascio" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "Politica sull'intelligenza artificiale" diff --git a/docs/locales/ja/translations.po b/docs/locales/ja/translations.po index 73c1caa1..89f0360c 100644 --- a/docs/locales/ja/translations.po +++ b/docs/locales/ja/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "第一節" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[セクション1]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[セクション１－ページ２]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[セクション2]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[セクション３]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "共有コンテンツ試験環境" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[共有コンテンツテストベッド]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "ハウツーガイド" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "貢献する" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[寄稿]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[初めての投稿者]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "どうすればいいですか？" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[問題を修正する]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[新機能の実装]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[ドキュメントを作成する]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[問題をトリアージする]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[プルリクエストをレビューする]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[新機能の提案]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[コンテンツを翻訳]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[ツールを使用する]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "どのように貢献すればよいですか？" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[開発環境のセットアップ]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[問題の再現]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[ブランチから作業する]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[スコープの拡大を避ける]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[コードの記述、実行、およびテスト]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[ビルディングドキュメント]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[ドキュメント作成]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[変更メモの追加]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[プルリクエストの送信]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[レビューを提供すること]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[新しい問題を提出する]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[新機能の提案]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[コンテンツの翻訳]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "次に何が起こるのか？" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[プルリクエストのレビュープロセス]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[リリースプロセス]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "方針" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[AIポリシー]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "スタイルガイド" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[コードスタイルガイド]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[ドキュメントスタイルガイド]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` リンク" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "ここに提供されたリンクは、メインページの[見出しフォント][heading-font]セクションへ移動するはずです。これは`autoref`リンクの確認のために含まれています。" + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "セクション１－ページ２" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "セクション2" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "セクション３" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "寄稿" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "問題を修正する" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "新機能の実装" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "ドキュメントを作成する" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "問題をトリアージする" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "プルリクエストをレビューする" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "新機能の提案" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "コンテンツを翻訳" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "ツールを使用する" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "ブランチから作業する" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "変更メモの追加" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "レビューを提供すること" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "プルリクエストのレビュープロセス" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "リリースプロセス" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "AIポリシー" diff --git a/docs/locales/ko/translations.po b/docs/locales/ko/translations.po index 06269f07..6acbe29a 100644 --- a/docs/locales/ko/translations.po +++ b/docs/locales/ko/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "제1절" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[제1절]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[제1절 - 2면]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[제2절]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[제3절]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "공유 콘텐츠 테스트베드" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[공유 콘텐츠 테스트베드]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "사용 방법 안내서" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "기여하다" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[기여]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[첫 번째 기여자]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "어쩌면 좋을까?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[문제를 해결하세요]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[새 기능 구현]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[문서 작성]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[문제를 분류하다]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[풀 리퀘스트 검토하기]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[새로운 기능 제안하기]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[번역 내용]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[도구를 사용하세요]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "어떻게 기여할 수 있나요?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[개발 환경 설정]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[문제 재현]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[브랜치에서 작업하기]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[범위 확대 방지]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[코드를 작성하고, 실행하고, 테스트하기]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[빌딩 문서화]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[문서 작성]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[변경 사항 추가]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[풀 리퀘스트 제출하기]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[리뷰 제공]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[새 이슈 제출]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[새로운 기능 제안]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[번역 중인 콘텐츠]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "다음에는 무슨 일이 일어날까요?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[풀 리퀘스트 검토 프로세스]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[출시 절차]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "정책" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[AI 정책]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "스타일 가이드" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[코드 스타일 가이드]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[문서 스타일 가이드]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` 연결" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "여기에 제공된 링크는 메인 페이지의 [헤딩 글꼴][heading-font] 섹션으로 이동시켜야 합니다. 이는 `autoref` 링크를 확인하기 위해 포함되었습니다." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "제1절 - 2면" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "제2절" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "제3절" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "기여" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "문제를 해결하세요" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "새 기능 구현" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "문서 작성" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "문제를 분류하다" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "풀 리퀘스트 검토하기" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "새로운 기능 제안하기" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "번역 내용" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "도구를 사용하세요" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "브랜치에서 작업하기" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "변경 사항 추가" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "리뷰 제공" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "풀 리퀘스트 검토 프로세스" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "출시 절차" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "AI 정책" diff --git a/docs/locales/pl/translations.po b/docs/locales/pl/translations.po index b4e27992..beec11f0 100644 --- a/docs/locales/pl/translations.po +++ b/docs/locales/pl/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "Sekcja pierwsza" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Sekcja pierwsza]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Część pierwsza – strona druga]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[Sekcja druga]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Sekcja trzecia]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Platforma testowa wspólnych treści" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Testowanie treści udostępnianych]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Poradniki" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Współtwórz" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Wkład]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[Osoby publikujące po raz pierwszy]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "Co mogę zrobić?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Napraw problem]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Wdrożenie nowej funkcji]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Napisz dokumentację]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Klasyfikacja problemu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Sprawdź pull request]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Zaproponuj nową funkcję]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[Przetłumacz treść]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Użyj narzędzi]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "Jak mogę pomóc?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Konfiguracja środowiska programistycznego]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Powielanie problemu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Praca z gałęzią]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Unikanie rozszerzania zakresu projektu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Pisanie, uruchamianie i testowanie kodu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Dokumentacja budowlana]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Pisanie dokumentacji]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Dodanie uwagi dotyczącej zmiany]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Przesyłanie żądania pull]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[Przegląd]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Zgłaszanie nowego problemu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Proponowanie nowej funkcji]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[Tłumaczenie treści]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "Co będzie dalej?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Proces weryfikacji pull requestów]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Proces zwalniania]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Zasady" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Polityka dotycząca sztucznej inteligencji]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Przewodniki stylistyczne" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Przewodnik po stylu kodowania]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Przewodnik stylistyczny dotyczący dokumentacji]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` łączenie" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Podany tutaj link powinien przekierować Cię do sekcji [Czcionka nagłówka][heading-font] na stronie głównej. Został on umieszczony w celu sprawdzenia działania linków `autoref`." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Część pierwsza – strona druga" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "Sekcja druga" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Sekcja trzecia" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Wkład" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Napraw problem" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Wdrożenie nowej funkcji" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Napisz dokumentację" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Klasyfikacja problemu" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Sprawdź pull request" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Zaproponuj nową funkcję" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "Przetłumacz treść" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Użyj narzędzi" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Praca z gałęzią" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Dodanie uwagi dotyczącej zmiany" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "Przegląd" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Proces weryfikacji pull requestów" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Proces zwalniania" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "Polityka dotycząca sztucznej inteligencji" diff --git a/docs/locales/pt/translations.po b/docs/locales/pt/translations.po index aea812e3..97b43fbb 100644 --- a/docs/locales/pt/translations.po +++ b/docs/locales/pt/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "Seção um" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Seção um]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Seção um - página dois]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[Seção dois]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Seção três]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Banco de testes de conteúdo compartilhado" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Banco de testes de conteúdo compartilhado]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Guias práticos" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Contribua" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Contribuição]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[Colaboradores pela primeira vez]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "O que posso fazer?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Corrigir um problema]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Implementar um novo recurso]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Escreva a documentação]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Classificar um problema]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Revisar uma solicitação pull]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Proponha um novo recurso]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[Traduzir conteúdo]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Use as ferramentas]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "Como posso contribuir?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Configurando um ambiente de desenvolvimento]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Reproduzindo um problema]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Trabalhando a partir de uma ramificação]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Evitar o aumento do escopo]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Escrever, executar e testar código]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Documentação do edifício]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Documentação escrita]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Adicionando uma nota de alteração]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Enviando uma solicitação pull]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[Fornecendo uma revisão]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Enviando uma nova questão]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Propondo um novo recurso]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[Traduzindo conteúdo]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "O que acontece a seguir?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Processo de revisão de solicitação de pull]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Processo de liberação]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Políticas" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Política de IA]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Guias de estilo" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Guia de estilo de código]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Guia de estilo da documentação]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` ligação" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "O link fornecido aqui deve levá-lo para a seção [Fonte do título][heading-font] da página principal. Ele foi incluído para verificar o link `autoref`." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Seção um - página dois" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "Seção dois" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Seção três" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Contribuição" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Corrigir um problema" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Implementar um novo recurso" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Escreva a documentação" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Classificar um problema" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Revisar uma solicitação pull" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Proponha um novo recurso" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "Traduzir conteúdo" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Use as ferramentas" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Trabalhando a partir de uma ramificação" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Adicionando uma nota de alteração" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "Fornecendo uma revisão" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Processo de revisão de solicitação de pull" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Processo de liberação" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "Política de IA" diff --git a/docs/locales/ru/translations.po b/docs/locales/ru/translations.po index 9296776d..5466061a 100644 --- a/docs/locales/ru/translations.po +++ b/docs/locales/ru/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "Раздел первый" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Раздел первый]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Раздел первый — страница вторая]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[Раздел второй]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Раздел третий]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Тестовая платформа для совместного использования контента" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Тестовая платформа для обмена контентом]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Руководства по эксплуатации" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Внести вклад" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Вклад]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[Новые авторы]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "Что я могу сделать?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Исправить проблему]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Внедрить новую функцию]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Написать документацию]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Сортировка проблемы]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Просмотреть запрос на вытягивание]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Предложить новую функцию]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[Перевести контент]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Используйте инструменты]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "Как я могу внести свой вклад?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Настройка среды разработки]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Воспроизведение проблемы]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Работа из ветки]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Избегание расширения объема работ]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Написание, запуск и тестирование кода]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Документация по строительству]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Написание документации]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Добавление примечания об изменении]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Отправка запроса на извлечение]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[Предоставление обзора]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Отправка новой проблемы]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Предложение новой функции]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[Перевод контента]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "Что будет дальше?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Процесс рассмотрения запросов на добавление]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Процесс выпуска]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Политики" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Политика в области искусственного интеллекта]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Руководства по стилю" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Руководство по стилю кода]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Руководство по стилю документации]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` связывание" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Ссылка, указанная здесь, должна перенаправить вас в раздел [Шрифт заголовка][heading-font] главной страницы. Она включена для проверки ссылки `autoref`." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Раздел первый — страница вторая" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "Раздел второй" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Раздел третий" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Вклад" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Исправить проблему" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Внедрить новую функцию" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Написать документацию" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Сортировка проблемы" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Просмотреть запрос на вытягивание" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Предложить новую функцию" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "Перевести контент" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Используйте инструменты" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Работа из ветки" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Добавление примечания об изменении" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "Предоставление обзора" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Процесс рассмотрения запросов на добавление" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Процесс выпуска" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "Политика в области искусственного интеллекта" diff --git a/docs/locales/ta/translations.po b/docs/locales/ta/translations.po index 83974c31..3b3eadb1 100644 --- a/docs/locales/ta/translations.po +++ b/docs/locales/ta/translations.po @@ -12,233 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "பிரிவு ஒன்று" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[பிரிவு ஒன்று]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[பிரிவு ஒன்று - பக்கம் இரண்டு]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[பிரிவு இரண்டு]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[பிரிவு மூன்று]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "பகிர்ந்த உள்ளடக்க சோதனைக்களம்" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[பகிர்ந்த உள்ளடக்க சோதனைக்களம்]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "செய்முறை வழிகாட்டிகள்" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "பங்களிக்கவும்" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[பங்களிப்பு]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[முதல் முறை பங்களிப்பாளர்கள்]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "நான் என்ன செய்ய முடியும்?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[ஒரு சிக்கலைச் சரிசெய்யவும்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[ஒரு புதிய அம்சத்தைச் செயல்படுத்தவும்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[தயாரிப்பு ஆவணங்களை எழுதுங்கள்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[ஒரு சிக்கலை முன்னுரிமைப்படுத்துதல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[இழு கோரிக்கையை மதிப்பாய்வு செய்யவும்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[புதிய அம்சத்தை முன்மொழியுங்கள்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[உள்ளடக்கத்தை மொழிபெயர்க்கவும்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[கருவிகளைப் பயன்படுத்துங்கள்]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "நான் எப்படி பங்களிக்க முடியும்?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[ஒரு மேம்பாட்டுச் சூழலை அமைத்தல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[ஒரு சிக்கலை மீண்டும் வெளியிடுதல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[கிளையிலிருந்து வேலை செய்தல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[எல்லை மீறலைத் தவிர்த்தல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[எழுதுதல், இயங்குதல் மற்றும் குறியீட்டைச் சோதித்தல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[ஆவணப்படுத்துதல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[ஆவணங்களை எழுதுதல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[மாற்றக் குறிப்பைச் சேர்த்தல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[புல் கோரிக்கையைச் சமர்ப்பித்தல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[மதிப்பாய்வு வழங்குக]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[புதிய சிக்கலைச் சமர்ப்பித்தல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[ஒரு புதிய அம்சத்தை முன்மொழிதல்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[உள்ளடக்கத்தை மொழிபெயர்க்கிறது]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "அடுத்து என்ன நடக்கும்?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[பல் ரிக்வெஸ்ட் மதிப்பாய்வு செயல்முறை]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[வெளியீட்டு செயல்முறை]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "கொள்கைகள்" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[கலைப்புத்தி கொள்கை]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "பாணி வழிகாட்டிகள்" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[குறியீட்டு நடை வழிகாட்டி]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[ஆவணப்படுத்தல் பாணி வழிகாட்டி]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1069,3 +887,93 @@ msgstr "`autoref` இணைத்தல்" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "இங்கே வழங்கப்பட்ட இணைப்பு உங்களை முக்கியப் பக்கத்தின் [Heading font][heading-font] பகுதிக்கு அழைத்துச் செல்லும். இது `autoref` இணைப்பைச் சரிபார்க்க சேர்க்கப்பட்டுள்ளது." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "பிரிவு ஒன்று - பக்கம் இரண்டு" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "பிரிவு இரண்டு" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "பிரிவு மூன்று" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "பங்களிப்பு" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "ஒரு சிக்கலைச் சரிசெய்யவும்" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "ஒரு புதிய அம்சத்தைச் செயல்படுத்தவும்" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "தயாரிப்பு ஆவணங்களை எழுதுங்கள்" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "ஒரு சிக்கலை முன்னுரிமைப்படுத்துதல்" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "இழு கோரிக்கையை மதிப்பாய்வு செய்யவும்" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "புதிய அம்சத்தை முன்மொழியுங்கள்" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "உள்ளடக்கத்தை மொழிபெயர்க்கவும்" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "கருவிகளைப் பயன்படுத்துங்கள்" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "கிளையிலிருந்து வேலை செய்தல்" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "மாற்றக் குறிப்பைச் சேர்த்தல்" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "மதிப்பாய்வு வழங்குக" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "பல் ரிக்வெஸ்ட் மதிப்பாய்வு செயல்முறை" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "வெளியீட்டு செயல்முறை" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "கலைப்புத்தி கொள்கை" diff --git a/docs/locales/tr/translations.po b/docs/locales/tr/translations.po index e35a8751..a99866e0 100644 --- a/docs/locales/tr/translations.po +++ b/docs/locales/tr/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "Birinci bölüm" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Birinci bölüm]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Bölüm bir - sayfa iki]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[İkinci bölüm]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Üçüncü bölüm]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Paylaşılan içerik test ortamı" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Paylaşılan içerik test ortamı]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Nasıl yapılır kılavuzları" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Katkıda bulunun" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Katkıda bulunan]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[İlk kez katkıda bulunanlar]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "Ne yapabilirim?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Bir sorunu düzeltin]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Yeni bir özellik ekleyin]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Belgeleri yazın]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Bir sorunu öncelik sırasına koymak]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Çekme isteğini incele]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Yeni bir özellik önerin]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[İçeriği çevir]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Araçları kullanın]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "Nasıl katkıda bulunabilirim?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Geliştirme ortamı kurma]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Bir sorunu yeniden üretmek]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Bir şubeden çalışmak]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Kapsam genişlemesini önleme]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Kod yazma, çalıştırma ve test etme]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Bina belgeleri]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Dokümantasyon yazma]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Değişiklik notu ekleme]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Çekme isteği gönderme]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[İnceleme sunmak]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Yeni bir sorun bildirme]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Yeni bir özellik önermek]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[İçeriği çeviriyor]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "Sonra ne olacak?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Çekme isteği inceleme süreci]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Serbest bırakma süreci]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Politikalar" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Yapay Zeka Politikası]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Stil kılavuzları" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Kod stil kılavuzu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Belge stil kılavuzu]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` bağlantı" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Burada verilen bağlantı sizi ana sayfanın [Başlık yazı tipi][heading-font] bölümüne götürmelidir. `autoref` bağlantısını doğrulamak için eklenmiştir." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Bölüm bir - sayfa iki" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "İkinci bölüm" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Üçüncü bölüm" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Katkıda bulunan" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Bir sorunu düzeltin" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Yeni bir özellik ekleyin" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Belgeleri yazın" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Bir sorunu öncelik sırasına koymak" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Çekme isteğini incele" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Yeni bir özellik önerin" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "İçeriği çevir" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Araçları kullanın" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Bir şubeden çalışmak" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Değişiklik notu ekleme" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "İnceleme sunmak" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Çekme isteği inceleme süreci" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Serbest bırakma süreci" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "Yapay Zeka Politikası" diff --git a/docs/locales/uk/translations.po b/docs/locales/uk/translations.po index 05d6123c..4c41911d 100644 --- a/docs/locales/uk/translations.po +++ b/docs/locales/uk/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "Розділ перший" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Розділ перший]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Розділ перший — сторінка друга]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[Розділ другий]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Розділ третій]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Тестова платформа для спільного контенту" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Тестова платформа для спільного контенту]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Інструкції" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Долучитися" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Долучитися]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[Ті, хто вперше бере участь]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "Що мені робити?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Виправити проблему]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Реалізувати нову функцію]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Створити документацію]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Оцінка проблеми]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Переглянути запит на злиття]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Запропонувати нову функцію]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[Перекласти вміст]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Скористайтеся інструментами]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "Як я можу долучитися?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Налаштування середовища розробки]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Відтворення проблеми]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Робота з гілкою]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Як уникнути розширення обсягу робіт]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Написання, виконання та тестування коду]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Документація щодо побудови]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Написання документації]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Додавання примітки про зміну]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Подання запиту на злиття]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[Написання відгуку]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Повідомлення про нову проблему]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Пропозиція щодо нової функції]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[Переклад вмісту]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "Що буде далі?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Процес перевірки запитів на злиття]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Процес випуску]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Політики" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Політика щодо штучного інтелекту]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Керівництва зі стилю" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Керівництво зі стилю написання коду]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Керівництво зі стилю документації]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1071,3 +888,93 @@ msgstr "`autoref` посилання" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Наведене тут посилання має перенаправити вас до розділу [Шрифт заголовка][heading-font] на головній сторінці. Воно додано для перевірки роботи посилань `autoref`." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Розділ перший — сторінка друга" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "Розділ другий" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Розділ третій" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Долучитися" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Виправити проблему" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Реалізувати нову функцію" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Створити документацію" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Оцінка проблеми" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Переглянути запит на злиття" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Запропонувати нову функцію" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "Перекласти вміст" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Скористайтеся інструментами" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Робота з гілкою" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Додавання примітки про зміну" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "Написання відгуку" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Процес перевірки запитів на злиття" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Процес випуску" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "Політика щодо штучного інтелекту" diff --git a/docs/locales/vi/translations.po b/docs/locales/vi/translations.po index 8e03b2c9..1824829f 100644 --- a/docs/locales/vi/translations.po +++ b/docs/locales/vi/translations.po @@ -12,235 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "Phần một" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[Phần một]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[Phần một - trang hai]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[Phần hai]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[Phần ba]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "Môi trường thử nghiệm nội dung chia sẻ" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Môi trường thử nghiệm nội dung chia sẻ]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "Hướng dẫn thực hiện" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "Đóng góp" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[Đóng góp]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[Những người đóng góp lần đầu]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "Tôi có thể làm gì?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[Khắc phục sự cố]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[Thực hiện một tính năng mới]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[Viết tài liệu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[Phân loại vấn đề]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[Xem xét yêu cầu kéo]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[Đề xuất tính năng mới]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[Dịch nội dung]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[Sử dụng các công cụ]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "Làm thế nào để tôi có thể đóng góp?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[Thiết lập môi trường phát triển]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[Tái hiện sự cố]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[Làm việc trên một nhánh]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[Tránh tình trạng mở rộng phạm vi]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[Viết, chạy và kiểm thử mã nguồn]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[Tài liệu hướng dẫn]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[Viết tài liệu]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[Thêm ghi chú thay đổi]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[Gửi yêu cầu pull]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[Viết đánh giá]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[Gửi báo cáo sự cố mới]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[Đề xuất tính năng mới]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[Dịch nội dung]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "Tiếp theo sẽ ra sao?" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[Quy trình đánh giá yêu cầu kéo]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[Quy trình phát hành]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "Chính sách" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Chính sách về Trí tuệ nhân tạo]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "Hướng dẫn phong cách" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[Hướng dẫn phong cách mã nguồn]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[Hướng dẫn phong cách tài liệu]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1072,3 +888,93 @@ msgstr "`autoref` liên kết" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Liên kết được cung cấp ở đây sẽ đưa bạn đến phần [Heading font][heading-font] trên trang chủ. Liên kết này được đưa vào để kiểm tra tính hoạt động của liên kết `autoref`." + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "Phần một - trang hai" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "Phần hai" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "Phần ba" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "Đóng góp" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "Khắc phục sự cố" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "Thực hiện một tính năng mới" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "Viết tài liệu" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "Phân loại vấn đề" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "Xem xét yêu cầu kéo" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "Đề xuất tính năng mới" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "Dịch nội dung" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "Sử dụng các công cụ" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "Làm việc trên một nhánh" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "Thêm ghi chú thay đổi" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "Viết đánh giá" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "Quy trình đánh giá yêu cầu kéo" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "Quy trình phát hành" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "Chính sách về Trí tuệ nhân tạo" diff --git a/docs/locales/zh_CN/translations.po b/docs/locales/zh_CN/translations.po index b987a1ba..0848dcbd 100644 --- a/docs/locales/zh_CN/translations.po +++ b/docs/locales/zh_CN/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "第一部分" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[第一部分]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[第一部分 - 第二页]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[第二部分]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[第三部分]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "共享内容测试平台" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[共享内容测试平台]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "操作指南" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "贡献" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[贡献]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[首次投稿者]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "我能做什么？" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[修复问题]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[实现新功能]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[编写文档]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[对问题进行分级处理]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[审查拉取请求]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[提出新功能建议]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[翻译内容]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[使用工具]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "我该如何贡献？" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[搭建开发环境]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[重现问题]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[从分支工作]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[避免范围蔓延]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[编写、运行和测试代码]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[建筑文档]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[编写文档]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[添加变更说明]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[提交拉取请求]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[提供评论]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[提交新问题]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[提出新功能建议]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[翻译内容]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "接下来会发生什么？" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[拉取请求审核流程]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[发布流程]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "政策" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[人工智能政策]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "风格指南" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[代码样式指南]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[文档风格指南]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` 链接" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "此处提供的链接应引导您前往主页的[标题字体][heading-font]部分。此链接旨在验证`autoref`链接功能。" + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "第一部分 - 第二页" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "第二部分" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "第三部分" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "贡献" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "修复问题" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "实现新功能" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "编写文档" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "对问题进行分级处理" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "审查拉取请求" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "提出新功能建议" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "翻译内容" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "使用工具" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "从分支工作" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "添加变更说明" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "提供评论" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "拉取请求审核流程" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "发布流程" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "人工智能政策" diff --git a/docs/locales/zh_TW/translations.po b/docs/locales/zh_TW/translations.po index f76775fb..7ac7b925 100644 --- a/docs/locales/zh_TW/translations.po +++ b/docs/locales/zh_TW/translations.po @@ -12,234 +12,51 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/SUMMARY.md:1 -msgid "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" -msgstr "" -"---\n" -"search:\n" -" exclude: true\n" -"---\n" -"\n" - -#: docs/en/SUMMARY.md:1 +#: docs/en/titles.md #, fuzzy msgid "Section one" msgstr "第一節" -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one]{1}" -msgstr "[第一節]{1}" - -#: docs/en/SUMMARY.md:1 -#, fuzzy -msgid "[Section one - page two]{1}" -msgstr "[第一節 - 第二頁]{1}" - -#: docs/en/SUMMARY.md:4 -#, fuzzy -msgid "[Section two]{1}" -msgstr "[第二節]{1}" - -#: docs/en/SUMMARY.md:5 -#, fuzzy -msgid "[Section three]{1}" -msgstr "[第三節]{1}" - -#: docs/en/SUMMARY.md:5 -msgid "./section_three/*" -msgstr "./section_three/*" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Shared content testbed" msgstr "共享內容測試平台" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[共享內容測試平台]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How-to guides" msgstr "操作指南" -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Contribute" msgstr "貢獻" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Contributing]{1}" -msgstr "[貢獻]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[First-time contributors]{1}" -msgstr "[首次投稿者]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What can I do?" msgstr "我能做什麼？" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Fix an issue]{1}" -msgstr "[修復問題]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Implement a new feature]{1}" -msgstr "[實作新功能]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Write documentation]{1}" -msgstr "[撰寫文件]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Triage an issue]{1}" -msgstr "[分級處理問題]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Review a pull request]{1}" -msgstr "[審閱拉取請求]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Propose a new feature]{1}" -msgstr "[提出新功能建議]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translate content]{1}" -msgstr "[翻譯內容]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Use the tools]{1}" -msgstr "[使用工具]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "How do I contribute?" msgstr "我該如何貢獻？" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Setting up a development environment]{1}" -msgstr "[設定開發環境]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Reproducing an issue]{1}" -msgstr "[重現問題]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Working from a branch]{1}" -msgstr "[從分支工作]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Avoiding scope creep]{1}" -msgstr "[避免範圍蔓延]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing, running, and testing code]{1}" -msgstr "[寫作、執行與測試程式碼]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Building documentation]{1}" -msgstr "[建築文件]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Writing documentation]{1}" -msgstr "[撰寫文件]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Adding a change note]{1}" -msgstr "[新增變更說明]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a pull request]{1}" -msgstr "[提交拉取請求]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Providing a review]{1}" -msgstr "[提供評論]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Submitting a new issue]{1}" -msgstr "[提交新問題]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Proposing a new feature]{1}" -msgstr "[提案新增功能]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Translating content]{1}" -msgstr "[翻譯內容]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "What happens next?" msgstr "接下來會發生什麼事？" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Pull request review process]{1}" -msgstr "[拉取請求審查流程]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Release process]{1}" -msgstr "[釋放流程]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Policies" msgstr "政策" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[AI 政策]{1}" - -#: docs/en/SUMMARY.md:7 +#: docs/en/titles.md #, fuzzy msgid "Style guides" msgstr "風格指南" -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Code style guide]{1}" -msgstr "[程式碼樣式指南]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Documentation style guide]{1}" -msgstr "[文件風格指南]{1}" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -1070,3 +887,93 @@ msgstr "`autoref` 連結" #, fuzzy msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "此處提供的連結應可帶您前往主頁面的[標題字型][heading-font]區段。此連結旨在驗證`autoref`連結功能。" + +#: docs/en/titles.md +#, fuzzy +msgid "Section one - page two" +msgstr "第一節 - 第二頁" + +#: docs/en/titles.md +#, fuzzy +msgid "Section two" +msgstr "第二節" + +#: docs/en/titles.md +#, fuzzy +msgid "Section three" +msgstr "第三節" + +#: docs/en/titles.md +#, fuzzy +msgid "Contributing" +msgstr "貢獻" + +#: docs/en/titles.md +#, fuzzy +msgid "Fix an issue" +msgstr "修復問題" + +#: docs/en/titles.md +#, fuzzy +msgid "Implement a new feature" +msgstr "實作新功能" + +#: docs/en/titles.md +#, fuzzy +msgid "Write documentation" +msgstr "撰寫文件" + +#: docs/en/titles.md +#, fuzzy +msgid "Triage an issue" +msgstr "分級處理問題" + +#: docs/en/titles.md +#, fuzzy +msgid "Review a pull request" +msgstr "審閱拉取請求" + +#: docs/en/titles.md +#, fuzzy +msgid "Propose a new feature" +msgstr "提出新功能建議" + +#: docs/en/titles.md +#, fuzzy +msgid "Translate content" +msgstr "翻譯內容" + +#: docs/en/titles.md +#, fuzzy +msgid "Use the tools" +msgstr "使用工具" + +#: docs/en/titles.md +#, fuzzy +msgid "Working from a branch" +msgstr "從分支工作" + +#: docs/en/titles.md +#, fuzzy +msgid "Adding a change note" +msgstr "新增變更說明" + +#: docs/en/titles.md +#, fuzzy +msgid "Providing a review" +msgstr "提供評論" + +#: docs/en/titles.md +#, fuzzy +msgid "Pull request review process" +msgstr "拉取請求審查流程" + +#: docs/en/titles.md +#, fuzzy +msgid "Release process" +msgstr "釋放流程" + +#: docs/en/titles.md +#, fuzzy +msgid "AI Policy" +msgstr "AI 政策" diff --git a/docs/mkdocs.ar.yml b/docs/mkdocs.ar.yml deleted file mode 100644 index 3b4d057f..00000000 --- a/docs/mkdocs.ar.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: أدوات مستندات BeeWare -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: ar - -theme: - language: ar - -extra: - language_url: ar/ - translation_type: machine - header: - About: حول - Documentation: التوثيق - Community: المجتمع - Contributing: المساهمة - News: أخبار - Sponsor: الراعي diff --git a/docs/mkdocs.cs.yml b/docs/mkdocs.cs.yml deleted file mode 100644 index 74ada418..00000000 --- a/docs/mkdocs.cs.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: Nástroje pro dokumenty BeeWare -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: cs - -theme: - language: cs - -extra: - language_url: cs/ - translation_type: machine - header: - About: O nás - Documentation: Dokumentace - Community: Komunita - Contributing: Přispívání - News: Novinky - Sponsor: Sponzor diff --git a/docs/mkdocs.da.yml b/docs/mkdocs.da.yml deleted file mode 100644 index 4e384272..00000000 --- a/docs/mkdocs.da.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: BeeWare Docs-værktøjer -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: da - -theme: - language: da - -extra: - language_url: da/ - translation_type: machine - header: - About: Om - Documentation: Dokumentation - Community: Fællesskab - Contributing: Bidrag - News: Nyheder - Sponsor: Sponsor diff --git a/docs/mkdocs.de.yml b/docs/mkdocs.de.yml deleted file mode 100644 index f162d5eb..00000000 --- a/docs/mkdocs.de.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: BeeWare Werkzeuge für die Dokumentation -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: de - -theme: - language: de - -extra: - language_url: de/ - translation_type: human - header: - About: Über - Documentation: Dokumentation - Community: Gemeinschaft - Contributing: Beitrag leisten - News: Nachrichten - Sponsor: Sponsor diff --git a/docs/mkdocs.en.yml b/docs/mkdocs.en.yml deleted file mode 100644 index f9be9f86..00000000 --- a/docs/mkdocs.en.yml +++ /dev/null @@ -1,11 +0,0 @@ -INHERIT: config.yml -site_name: BeeWare Docs Tools -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: en - -theme: - language: en - -extra: - translation_type: original - header: {} diff --git a/docs/mkdocs.es.yml b/docs/mkdocs.es.yml deleted file mode 100644 index 4da8ef4e..00000000 --- a/docs/mkdocs.es.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: Herramientas de BeeWare Docs -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: es - -theme: - language: es - -extra: - language_url: es/ - translation_type: machine - header: - About: Acerca de - Documentation: Documentación - Community: Comunidad - Contributing: Contribuyendo - News: Noticias - Sponsor: Patrocinador diff --git a/docs/mkdocs.fa.yml b/docs/mkdocs.fa.yml deleted file mode 100644 index f72cfd79..00000000 --- a/docs/mkdocs.fa.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: ابزارهای اسناد BeeWare -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: fa - -theme: - language: fa - -extra: - language_url: fa/ - translation_type: machine - header: - About: درباره - Documentation: مدارک - Community: جامعه - Contributing: مشارکت‌کننده - News: اخبار - Sponsor: حامی diff --git a/docs/mkdocs.fr.yml b/docs/mkdocs.fr.yml deleted file mode 100644 index 0f06e92a..00000000 --- a/docs/mkdocs.fr.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: BeeWare Outils Docs -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: fr - -theme: - language: fr - -extra: - language_url: fr/ - translation_type: machine - header: - About: À propos - Documentation: Documentation - Community: Communauté - Contributing: Contribuant - News: Nouvelles - Sponsor: Mécène diff --git a/docs/mkdocs.it.yml b/docs/mkdocs.it.yml deleted file mode 100644 index 72e3f4be..00000000 --- a/docs/mkdocs.it.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: Strumenti di documentazione BeeWare -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: it - -theme: - language: it - -extra: - language_url: it/ - translation_type: machine - header: - About: Informazioni - Documentation: Documentazione - Community: Comunità - Contributing: Contribuire - News: Notizie - Sponsor: Sponsor diff --git a/docs/mkdocs.ja.yml b/docs/mkdocs.ja.yml deleted file mode 100644 index a54bf74a..00000000 --- a/docs/mkdocs.ja.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: BeeWare ドキュメントツール -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: ja - -theme: - language: ja - -extra: - language_url: ja/ - translation_type: machine - header: - About: について - Documentation: ドキュメント - Community: コミュニティ - Contributing: 寄稿 - News: ニュース - Sponsor: スポンサー diff --git a/docs/mkdocs.ko.yml b/docs/mkdocs.ko.yml deleted file mode 100644 index fd2a82a2..00000000 --- a/docs/mkdocs.ko.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: BeeWare Docs Tools -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: ko - -theme: - language: ko - -extra: - language_url: ko/ - translation_type: machine - header: - About: 소개 - Documentation: 문서화 - Community: 커뮤니티 - Contributing: 기여 - News: 뉴스 - Sponsor: 후원사 diff --git a/docs/mkdocs.pl.yml b/docs/mkdocs.pl.yml deleted file mode 100644 index e6e89d6b..00000000 --- a/docs/mkdocs.pl.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: Narzędzia BeeWare Docs -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: pl - -theme: - language: pl - -extra: - language_url: pl/ - translation_type: machine - header: - About: O - Documentation: Dokumentacja - Community: Społeczność - Contributing: Wkład - News: Aktualności - Sponsor: Sponsor diff --git a/docs/mkdocs.pt.yml b/docs/mkdocs.pt.yml deleted file mode 100644 index c7a6e573..00000000 --- a/docs/mkdocs.pt.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: Ferramentas de documentação BeeWare -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: pt - -theme: - language: pt - -extra: - language_url: pt/ - translation_type: machine - header: - About: Sobre - Documentation: Documentação - Community: Comunidade - Contributing: Contribuir - News: Notícias - Sponsor: Patrocinador diff --git a/docs/mkdocs.ru.yml b/docs/mkdocs.ru.yml deleted file mode 100644 index 851aa2e6..00000000 --- a/docs/mkdocs.ru.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: Инструменты для работы с документацией BeeWare -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: ru - -theme: - language: ru - -extra: - language_url: ru/ - translation_type: machine - header: - About: О нас - Documentation: Документация - Community: Сообщество - Contributing: Вклад - News: Новости - Sponsor: Спонсор diff --git a/docs/mkdocs.ta.yml b/docs/mkdocs.ta.yml deleted file mode 100644 index ebf802d7..00000000 --- a/docs/mkdocs.ta.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: BeeWare ஆவணக் கருவிகள் -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: ta - -theme: - language: ta - -extra: - language_url: ta/ - translation_type: machine - header: - About: பற்றி - Documentation: ஆவணப்படுத்தல் - Community: சமூகம் - Contributing: பங்களித்தல் - News: செய்திகள் - Sponsor: ஆதரவாளர் diff --git a/docs/mkdocs.tr.yml b/docs/mkdocs.tr.yml deleted file mode 100644 index d3dee646..00000000 --- a/docs/mkdocs.tr.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: BeeWare Dokümanları Araçları -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: tr - -theme: - language: tr - -extra: - language_url: tr/ - translation_type: machine - header: - About: Hakkında - Documentation: Belgeleme - Community: Topluluk - Contributing: Katkıda bulunan - News: Haberler - Sponsor: Sponsor diff --git a/docs/mkdocs.uk.yml b/docs/mkdocs.uk.yml deleted file mode 100644 index d5b630b8..00000000 --- a/docs/mkdocs.uk.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: Інструменти документації BeeWare -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: uk - -theme: - language: uk - -extra: - language_url: uk/ - translation_type: machine - header: - About: Про нас - Documentation: Документація - Community: Спільнота - Contributing: Внесок - News: Новини - Sponsor: Спонсор diff --git a/docs/mkdocs.vi.yml b/docs/mkdocs.vi.yml deleted file mode 100644 index 4fea1db5..00000000 --- a/docs/mkdocs.vi.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: Công cụ tài liệu BeeWare -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: vi - -theme: - language: vi - -extra: - language_url: vi/ - translation_type: machine - header: - About: Giới thiệu - Documentation: Tài liệu - Community: Cộng đồng - Contributing: Đóng góp - News: Tin tức - Sponsor: Nhà tài trợ diff --git a/docs/mkdocs.zh_CN.yml b/docs/mkdocs.zh_CN.yml deleted file mode 100644 index dd25c62e..00000000 --- a/docs/mkdocs.zh_CN.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: BeeWare 文档工具 -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: zh_CN - -theme: - language: zh - -extra: - language_url: zh_CN/ - translation_type: machine - header: - About: 关于 - Documentation: 文档 - Community: 社区 - Contributing: 贡献 - News: 新闻 - Sponsor: 赞助商 diff --git a/docs/mkdocs.zh_TW.yml b/docs/mkdocs.zh_TW.yml deleted file mode 100644 index b26e0715..00000000 --- a/docs/mkdocs.zh_TW.yml +++ /dev/null @@ -1,18 +0,0 @@ -INHERIT: config.yml -site_name: BeeWare 文檔工具 -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: zh_TW - -theme: - language: zh-TW - -extra: - language_url: zh_TW/ - translation_type: machine - header: - About: 關於 - Documentation: 文件 - Community: 社群 - Contributing: 貢獻 - News: 新聞 - Sponsor: 贊助商 diff --git a/docs/zensical.ar.toml b/docs/zensical.ar.toml new file mode 100644 index 00000000..cca7fddf --- /dev/null +++ b/docs/zensical.ar.toml @@ -0,0 +1,18 @@ +[project] +site_name = "أدوات مستندات BeeWare" +docs_dir = "ar" + +[project.theme] +language = "ar" + +[project.extra] +language_url = "ar/" +translation_type = "machine" + +[project.extra.header] +About = "حول" +Documentation = "التوثيق" +Community = "المجتمع" +Contributing = "المساهمة" +News = "أخبار" +Sponsor = "الراعي" diff --git a/docs/zensical.cs.toml b/docs/zensical.cs.toml new file mode 100644 index 00000000..1d3bd75a --- /dev/null +++ b/docs/zensical.cs.toml @@ -0,0 +1,18 @@ +[project] +site_name = "Nástroje pro dokumenty BeeWare" +docs_dir = "cs" + +[project.theme] +language = "cs" + +[project.extra] +language_url = "cs/" +translation_type = "machine" + +[project.extra.header] +About = "O nás" +Documentation = "Dokumentace" +Community = "Komunita" +Contributing = "Přispívání" +News = "Novinky" +Sponsor = "Sponzor" diff --git a/docs/zensical.da.toml b/docs/zensical.da.toml new file mode 100644 index 00000000..e8a2460b --- /dev/null +++ b/docs/zensical.da.toml @@ -0,0 +1,18 @@ +[project] +site_name = "BeeWare Docs-værktøjer" +docs_dir = "da" + +[project.theme] +language = "da" + +[project.extra] +language_url = "da/" +translation_type = "machine" + +[project.extra.header] +About = "Om" +Documentation = "Dokumentation" +Community = "Fællesskab" +Contributing = "Bidrag" +News = "Nyheder" +Sponsor = "Sponsor" diff --git a/docs/zensical.de.toml b/docs/zensical.de.toml new file mode 100644 index 00000000..c65c25e2 --- /dev/null +++ b/docs/zensical.de.toml @@ -0,0 +1,18 @@ +[project] +site_name = "BeeWare Werkzeuge für die Dokumentation" +docs_dir = "de" + +[project.theme] +language = "de" + +[project.extra] +language_url = "de/" +translation_type = "human" + +[project.extra.header] +About = "Über" +Documentation = "Dokumentation" +Community = "Gemeinschaft" +Contributing = "Beitrag leisten" +News = "Nachrichten" +Sponsor = "Sponsor" diff --git a/docs/zensical.en.toml b/docs/zensical.en.toml new file mode 100644 index 00000000..bf20c6fa --- /dev/null +++ b/docs/zensical.en.toml @@ -0,0 +1,10 @@ +[project] +site_name = "BeeWare Docs Tools" +docs_dir = "en" + +[project.theme] +language = "en" + +[project.extra] +translation_type = "original" +header = {} diff --git a/docs/zensical.es.toml b/docs/zensical.es.toml new file mode 100644 index 00000000..5855821a --- /dev/null +++ b/docs/zensical.es.toml @@ -0,0 +1,18 @@ +[project] +site_name = "Herramientas de BeeWare Docs" +docs_dir = "es" + +[project.theme] +language = "es" + +[project.extra] +language_url = "es/" +translation_type = "machine" + +[project.extra.header] +About = "Acerca de" +Documentation = "Documentación" +Community = "Comunidad" +Contributing = "Contribuyendo" +News = "Noticias" +Sponsor = "Patrocinador" diff --git a/docs/zensical.fa.toml b/docs/zensical.fa.toml new file mode 100644 index 00000000..70fcb0ad --- /dev/null +++ b/docs/zensical.fa.toml @@ -0,0 +1,18 @@ +[project] +site_name = "ابزارهای اسناد BeeWare" +docs_dir = "fa" + +[project.theme] +language = "fa" + +[project.extra] +language_url = "fa/" +translation_type = "machine" + +[project.extra.header] +About = "درباره" +Documentation = "مدارک" +Community = "جامعه" +Contributing = "مشارکت‌کننده" +News = "اخبار" +Sponsor = "حامی" diff --git a/docs/zensical.fr.toml b/docs/zensical.fr.toml new file mode 100644 index 00000000..53bc3c0c --- /dev/null +++ b/docs/zensical.fr.toml @@ -0,0 +1,18 @@ +[project] +site_name = "BeeWare Outils Docs" +docs_dir = "fr" + +[project.theme] +language = "fr" + +[project.extra] +language_url = "fr/" +translation_type = "machine" + +[project.extra.header] +About = "À propos" +Documentation = "Documentation" +Community = "Communauté" +Contributing = "Contribuant" +News = "Nouvelles" +Sponsor = "Mécène" diff --git a/docs/zensical.it.toml b/docs/zensical.it.toml new file mode 100644 index 00000000..0d13c638 --- /dev/null +++ b/docs/zensical.it.toml @@ -0,0 +1,18 @@ +[project] +site_name = "Strumenti di documentazione BeeWare" +docs_dir = "it" + +[project.theme] +language = "it" + +[project.extra] +language_url = "it/" +translation_type = "machine" + +[project.extra.header] +About = "Informazioni" +Documentation = "Documentazione" +Community = "Comunità" +Contributing = "Contribuire" +News = "Notizie" +Sponsor = "Sponsor" diff --git a/docs/zensical.ja.toml b/docs/zensical.ja.toml new file mode 100644 index 00000000..c1f66a2c --- /dev/null +++ b/docs/zensical.ja.toml @@ -0,0 +1,18 @@ +[project] +site_name = "BeeWare ドキュメントツール" +docs_dir = "ja" + +[project.theme] +language = "ja" + +[project.extra] +language_url = "ja/" +translation_type = "machine" + +[project.extra.header] +About = "について" +Documentation = "ドキュメント" +Community = "コミュニティ" +Contributing = "寄稿" +News = "ニュース" +Sponsor = "スポンサー" diff --git a/docs/zensical.ko.toml b/docs/zensical.ko.toml new file mode 100644 index 00000000..f5ae1692 --- /dev/null +++ b/docs/zensical.ko.toml @@ -0,0 +1,18 @@ +[project] +site_name = "BeeWare Docs Tools" +docs_dir = "ko" + +[project.theme] +language = "ko" + +[project.extra] +language_url = "ko/" +translation_type = "machine" + +[project.extra.header] +About = "소개" +Documentation = "문서화" +Community = "커뮤니티" +Contributing = "기여" +News = "뉴스" +Sponsor = "후원사" diff --git a/docs/zensical.pl.toml b/docs/zensical.pl.toml new file mode 100644 index 00000000..eac3a288 --- /dev/null +++ b/docs/zensical.pl.toml @@ -0,0 +1,18 @@ +[project] +site_name = "Narzędzia BeeWare Docs" +docs_dir = "pl" + +[project.theme] +language = "pl" + +[project.extra] +language_url = "pl/" +translation_type = "machine" + +[project.extra.header] +About = "O" +Documentation = "Dokumentacja" +Community = "Społeczność" +Contributing = "Wkład" +News = "Aktualności" +Sponsor = "Sponsor" diff --git a/docs/zensical.pt.toml b/docs/zensical.pt.toml new file mode 100644 index 00000000..e502eab7 --- /dev/null +++ b/docs/zensical.pt.toml @@ -0,0 +1,18 @@ +[project] +site_name = "Ferramentas de documentação BeeWare" +docs_dir = "pt" + +[project.theme] +language = "pt" + +[project.extra] +language_url = "pt/" +translation_type = "machine" + +[project.extra.header] +About = "Sobre" +Documentation = "Documentação" +Community = "Comunidade" +Contributing = "Contribuir" +News = "Notícias" +Sponsor = "Patrocinador" diff --git a/docs/zensical.ru.toml b/docs/zensical.ru.toml new file mode 100644 index 00000000..ffbc825f --- /dev/null +++ b/docs/zensical.ru.toml @@ -0,0 +1,18 @@ +[project] +site_name = "Инструменты для работы с документацией BeeWare" +docs_dir = "ru" + +[project.theme] +language = "ru" + +[project.extra] +language_url = "ru/" +translation_type = "machine" + +[project.extra.header] +About = "О нас" +Documentation = "Документация" +Community = "Сообщество" +Contributing = "Вклад" +News = "Новости" +Sponsor = "Спонсор" diff --git a/docs/zensical.ta.toml b/docs/zensical.ta.toml new file mode 100644 index 00000000..bf6e6fb0 --- /dev/null +++ b/docs/zensical.ta.toml @@ -0,0 +1,18 @@ +[project] +site_name = "BeeWare ஆவணக் கருவிகள்" +docs_dir = "ta" + +[project.theme] +language = "ta" + +[project.extra] +language_url = "ta/" +translation_type = "machine" + +[project.extra.header] +About = "பற்றி" +Documentation = "ஆவணப்படுத்தல்" +Community = "சமூகம்" +Contributing = "பங்களித்தல்" +News = "செய்திகள்" +Sponsor = "ஆதரவாளர்" diff --git a/docs/zensical.toml b/docs/zensical.toml new file mode 100644 index 00000000..31920565 --- /dev/null +++ b/docs/zensical.toml @@ -0,0 +1,254 @@ +[project] +copyright = "© Russell Keith-Magee" +not_in_nav = """ +/index.md +/about/releases.md +""" +nav = [ + { "Section one" = [ + { "Section one" = "section_one/index.md" }, + { "Section one - page two" = "section_one/page_two.md" }, + ] }, + { "Section two" = "section_two/index.md" }, + { "Section three" = [ + "section_three/index.md", + "section_three/page_01.md", + "section_three/page_02.md", + "section_three/page_03.md", + "section_three/page_04.md", + "section_three/page_05.md", + "section_three/page_06.md", + "section_three/page_07.md", + "section_three/page_08.md", + "section_three/page_09.md", + "section_three/page_10.md", + "section_three/page_11.md", + "section_three/page_12.md", + ] }, + { "Shared content testbed" = [ + { "Shared content testbed" = "content_test_bed/index.md" }, + { "How-to guides" = [ + { "Contribute" = [ + { "Contributing" = "content_test_bed/how-to/contribute/index.md" }, + { "First-time contributors" = "content_test_bed/how-to/contribute/first-time-contributors.md" }, + { "What can I do?" = [ + { "Fix an issue" = "content_test_bed/how-to/contribute/what/fix-issue.md" }, + { "Implement a new feature" = "content_test_bed/how-to/contribute/what/implement-feature.md" }, + { "Write documentation" = "content_test_bed/how-to/contribute/what/write-docs.md" }, + { "Triage an issue" = "content_test_bed/how-to/contribute/what/triage.md" }, + { "Review a pull request" = "content_test_bed/how-to/contribute/what/review-pr.md" }, + { "Propose a new feature" = "content_test_bed/how-to/contribute/what/propose-feature.md" }, + { "Translate content" = "content_test_bed/how-to/contribute/what/translate.md" }, + { "Use the tools" = "content_test_bed/how-to/contribute/what/use-tools.md" }, + ] }, + { "How do I contribute?" = [ + { "Setting up a development environment" = "content_test_bed/how-to/contribute/how/dev-environment.md" }, + { "Reproducing an issue" = "content_test_bed/how-to/contribute/how/reproduce-issue.md" }, + { "Working from a branch" = "content_test_bed/how-to/contribute/how/branches.md" }, + { "Avoiding scope creep" = "content_test_bed/how-to/contribute/how/scope-creep.md" }, + { "Writing, running, and testing code" = "content_test_bed/how-to/contribute/how/write-code.md" }, + { "Building documentation" = "content_test_bed/how-to/contribute/how/build-docs.md" }, + { "Writing documentation" = "content_test_bed/how-to/contribute/how/write-docs.md" }, + { "Adding a change note" = "content_test_bed/how-to/contribute/how/change-note.md" }, + { "Submitting a pull request" = "content_test_bed/how-to/contribute/how/submit-pr.md" }, + { "Providing a review" = "content_test_bed/how-to/contribute/how/review-pr.md" }, + { "Submitting a new issue" = "content_test_bed/how-to/contribute/how/new-issue.md" }, + { "Proposing a new feature" = "content_test_bed/how-to/contribute/how/propose-feature.md" }, + { "Translating content" = "content_test_bed/how-to/contribute/how/translate.md" }, + ] }, + { "What happens next?" = [ + { "Pull request review process" = "content_test_bed/how-to/contribute/next/pr-review.md" }, + { "Release process" = "content_test_bed/how-to/contribute/next/release.md" }, + ] }, + { "Policies" = [ + { "AI Policy" = "content_test_bed/how-to/contribute/policies/ai-policy.md" }, + ] }, + { "Style guides" = [ + { "Code style guide" = "content_test_bed/how-to/contribute/style/code-style-guide.md" }, + { "Documentation style guide" = "content_test_bed/how-to/contribute/style/docs-style-guide.md" }, + ] }, + ] }, + ] }, + ] }, +] + +[project.validation] +omitted_files = "warn" +absolute_links = "relative_to_docs" +anchors = "warn" +unrecognized_links = "warn" + +[project.extra] +project_name = "beeware-docs-tools" +package_name = "beeware-docs-tools" +formal_name = "BeeWare Docs Tools" +website = false # true shows beeware.org-specific content, false shows project content. Default: false. +min_python_version = "3.10" # The oldest supported Python version +min_python_version_tag = "310" # The tag version of the minimum python version +recent_python_version = "3.13" # The newest Python version known to work on all platforms +docs_python_version = "3.13" # The version of Python required to build the documentation +translated = true # false hides content related to building translations. Default: false. +hide_coverage = false # true hides content related to code coverage. Default: false. +macos_only = false # true hides tabbed content, and displays only macOS instructions. Default: false. +contribution_guide_root = "content_test_bed/how-to/contribute" +alternate = [ + { name = "English", link = "/en/", lang = "en" }, + { name = "العَرَبِيَّة", link = "/ar/", lang = "ar" }, + { name = "Čeština", link = "/cs/", lang = "cs" }, + { name = "Dansk", link = "/da/", lang = "da" }, + { name = "Deutsch", link = "/de/", lang = "de" }, + { name = "Español", link = "/es/", lang = "es" }, + { name = "فارسی", link = "/fa/", lang = "fa" }, + { name = "Français", link = "/fr/", lang = "fr" }, + { name = "Italiano", link = "/it/", lang = "it" }, + { name = "日本語", link = "/ja/", lang = "ja" }, + { name = "한국어", link = "/ko/", lang = "ko" }, + { name = "Polski", link = "/pl/", lang = "pl" }, + { name = "Português", link = "/pt/", lang = "pt" }, + { name = "Русский", link = "/ru/", lang = "ru" }, + { name = "தமிழ்", link = "/ta/", lang = "ta" }, + { name = "Türkçe", link = "/tr/", lang = "tr" }, + { name = "Yкраїнська", link = "/uk/", lang = "uk" }, + { name = "Tiếng Việt", link = "/vi/", lang = "vi" }, + { name = "中文(简体)", link = "/zh_CN/", lang = "zh-Hant" }, + { name = "中文(繁體)", link = "/zh_TW/", lang = "zh-TW" }, +] +social = [ + { icon = "fontawesome/brands/github", link = "https://github.com/beeware", name = "BeeWare on GitHub" }, + { icon = "fontawesome/brands/mastodon", link = "https://fosstodon.org/@beeware", name = "BeeWare on Mastodon" }, + { icon = "fontawesome/brands/discord", link = "https://beeware.org/bee/chat/", name = "BeeWare on Discord" }, +] +generator = false + +[project.theme] +name = "material" +variant = "classic" # Zensical: the overrides and beeware_theme.css target the classic Material look. +language = "en" +logo = "assets/images/brutus-256.png" +favicon = "assets/images/brutus-256.png" +features = [ + "content.tabs.link", + "toc.follow", + "navigation.indexes", + "navigation.footer", + "navigation.tabs", + "navigation.tabs.sticky", + "search.suggest", + "search.highlight", + "search.share", +] +custom_dir = "overrides" + +# Palette toggle for automatic mode +[[project.theme.palette]] +media = "(prefers-color-scheme)" +toggle.icon = "material/brightness-auto" +toggle.name = "Switch to light mode" + +# Palette toggle for light mode +[[project.theme.palette]] +media = "(prefers-color-scheme: light)" +scheme = "default" +toggle.icon = "material/brightness-7" +toggle.name = "Switch to dark mode" + +# Palette toggle for dark mode +[[project.theme.palette]] +media = "(prefers-color-scheme: dark)" +scheme = "slate" +toggle.icon = "material/brightness-4" +toggle.name = "Switch to system preference" + +[project.markdown_extensions] +# Python Markdown Extensions +attr_list = {} # Enables setting explicit anchors, and CSS classes, etc. +# Enables easy em and en dashes. +smarty.smart_quotes = false +# Enables the ToC, in the left sidebar, in the documentation. +toc.permalink = true +toc.title = "On this page" +# PyMdown Extensions +pymdownx.fancylists = {} # Supports various ordered list styles +pymdownx.highlight = {} # Highlights code blocks, when language provided. +pymdownx.inlinehilite = {} # Highlights inline code, when language provided. +pymdownx.keys = {} # Fancy displays key combinations. +pymdownx.superfences = {} # Nicer code-blocks. +pymdownx.saneheaders = {} # Treats "#Content" with no space at the beginning of a line as text, not a header; helpful with MagicLink. rumdl will still verify header formatting. +pymdownx.tasklist = {} # Make fancy checklists. +pymdownx.blocks.caption = {} # Captions images. +# Enables admonitions. +pymdownx.blocks.admonition.types = [ + "note", + "abstract", + "info", + "tip", + "success", + "question", + "warning", + "failure", + "danger", + "bug", + "example", + "quote", +] +# Enables collapsible content. +pymdownx.blocks.details.types = [ + { name = "details-note", class = "note" }, + { name = "details-abstract", class = "abstract" }, + { name = "details-info", class = "info" }, + { name = "details-tip", class = "tip" }, + { name = "details-success", class = "success" }, + { name = "details-question", class = "question" }, + { name = "details-warning", class = "warning" }, + { name = "details-failure", class = "failure" }, + { name = "details-danger", class = "danger" }, + { name = "details-bug", class = "bug" }, + { name = "details-example", class = "example" }, + { name = "details-quote", class = "quote" }, +] +# Enables tabbed content. +pymdownx.blocks.tab.alternate_style = true +# Allows for injecting content from other locations. +pymdownx.snippets.base_path = ["docs"] +pymdownx.snippets.url_download = true +pymdownx.snippets.check_paths = true +# Among other things, enables GitHub shorthand references. +pymdownx.magiclink.provider = "github" +pymdownx.magiclink.user = "beeware" +pymdownx.magiclink.repo = "website" +pymdownx.magiclink.repo_url_shortener = true +pymdownx.magiclink.repo_url_shorthand = true +pymdownx.magiclink.normalize_issue_symbols = true + +[project.plugins.search] + +[project.plugins.autorefs] +resolve_closest = true # autorefs warns of the Usage headings begin duplicates without this - we will have to assign unique ids to all of them otherwise + +[project.plugins.macros] +on_error_fail = true # Fail the build if a macro fails to render. + +[project.plugins.mkdocstrings] +default_handler = "python" + +[project.plugins.mkdocstrings.handlers.python] +paths = ["src"] + +[project.plugins.mkdocstrings.handlers.python.options] +docstring_style = "sphinx" # Parses docstrings from Sphinx formatting - the `:param` formatting, not parsing rST links +allow_inspection = false # True includes *more* dunder methods, can be enabled on individual class entries if you want them +show_source = false # Otherwise, source code is shown collapsed for all +members_order = "alphabetical" # Orders things based on the source code +annotations_path = "brief" # Keeps type annotation links more concise +merge_init_into_class = true # Otherwise, init is displayed separately +separate_signature = true # Shows the `function(args)` separately from name +show_signature = true # Displays () or (args) along with the function name in the signature +show_signature_annotations = true # Includes annotations in signature blocks +signature_crossrefs = true # Enables cross-referencing on signature annotations +show_root_heading = true # Show heading of object at root, otherwise nothing +docstring_section_style = "spacy" # Better info layout than the other options +line_length = 80 # Requires ruff, forces longer signatures to be stacked +show_symbol_type_toc = true # Enables type symbols next to objects in ToC +show_symbol_type_heading = true # Enables type symbols next to object names in content +show_attribute_values = false # Suppresses the values of attributes in the signature +heading_level = 3 # Heading level of 3 to nest under References heading diff --git a/docs/zensical.tr.toml b/docs/zensical.tr.toml new file mode 100644 index 00000000..6bb848b3 --- /dev/null +++ b/docs/zensical.tr.toml @@ -0,0 +1,18 @@ +[project] +site_name = "BeeWare Dokümanları Araçları" +docs_dir = "tr" + +[project.theme] +language = "tr" + +[project.extra] +language_url = "tr/" +translation_type = "machine" + +[project.extra.header] +About = "Hakkında" +Documentation = "Belgeleme" +Community = "Topluluk" +Contributing = "Katkıda bulunan" +News = "Haberler" +Sponsor = "Sponsor" diff --git a/docs/zensical.uk.toml b/docs/zensical.uk.toml new file mode 100644 index 00000000..845ebd94 --- /dev/null +++ b/docs/zensical.uk.toml @@ -0,0 +1,18 @@ +[project] +site_name = "Інструменти документації BeeWare" +docs_dir = "uk" + +[project.theme] +language = "uk" + +[project.extra] +language_url = "uk/" +translation_type = "machine" + +[project.extra.header] +About = "Про нас" +Documentation = "Документація" +Community = "Спільнота" +Contributing = "Внесок" +News = "Новини" +Sponsor = "Спонсор" diff --git a/docs/zensical.vi.toml b/docs/zensical.vi.toml new file mode 100644 index 00000000..5b282814 --- /dev/null +++ b/docs/zensical.vi.toml @@ -0,0 +1,18 @@ +[project] +site_name = "Công cụ tài liệu BeeWare" +docs_dir = "vi" + +[project.theme] +language = "vi" + +[project.extra] +language_url = "vi/" +translation_type = "machine" + +[project.extra.header] +About = "Giới thiệu" +Documentation = "Tài liệu" +Community = "Cộng đồng" +Contributing = "Đóng góp" +News = "Tin tức" +Sponsor = "Nhà tài trợ" diff --git a/docs/zensical.zh_CN.toml b/docs/zensical.zh_CN.toml new file mode 100644 index 00000000..70defbdc --- /dev/null +++ b/docs/zensical.zh_CN.toml @@ -0,0 +1,18 @@ +[project] +site_name = "BeeWare 文档工具" +docs_dir = "zh_CN" + +[project.theme] +language = "zh" + +[project.extra] +language_url = "zh_CN/" +translation_type = "machine" + +[project.extra.header] +About = "关于" +Documentation = "文档" +Community = "社区" +Contributing = "贡献" +News = "新闻" +Sponsor = "赞助商" diff --git a/docs/zensical.zh_TW.toml b/docs/zensical.zh_TW.toml new file mode 100644 index 00000000..28ba7fa9 --- /dev/null +++ b/docs/zensical.zh_TW.toml @@ -0,0 +1,18 @@ +[project] +site_name = "BeeWare 文檔工具" +docs_dir = "zh_TW" + +[project.theme] +language = "zh-TW" + +[project.extra] +language_url = "zh_TW/" +translation_type = "machine" + +[project.extra.header] +About = "關於" +Documentation = "文件" +Community = "社群" +Contributing = "貢獻" +News = "新聞" +Sponsor = "贊助商" diff --git a/pyproject.toml b/pyproject.toml index 54401d4d..d4043fad 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -28,11 +28,7 @@ dependencies = [ "markdown-checker==1.2.2", "mistletoe==1.6.0", "mkdocs-autorefs==1.4.5", - "mkdocs-literate-nav==0.6.3", # DO NOT UPGRADE - Uncertain whether author's move to ProperDocs will cause incompatibility - "mkdocs-macros-plugin @ git+https://github.com/kattni/mkdocs-macros-plugin@include-dir-multiple-directories", - "mkdocs-material==9.8.0", "mkdocs-rss-plugin==1.19.0", - "mkdocs==1.6.1", # DO NOT UPGRADE - 2+ is not compatible with anything here "mkdocstrings-python==2.0.10", "pymdown-extensions==12.3", "pyspelling==2.13", @@ -41,7 +37,15 @@ dependencies = [ "polib==1.2.0", "ruff==0.17.2", "setuptools_scm==10.3.4", + "tomli-w==1.2.0", "translate-toolkit==3.20.1", + "zensical==0.1.0", # Pre-1.0; pin exactly. +] + +[project.optional-dependencies] +# Needed by `convert_mkdocs_config` to convert a literate-nav navigation file. +convert = [ + "mkdocs-literate-nav==0.6.3", ] [dependency-groups] @@ -83,6 +87,7 @@ Source = "https://github.com/beeware/beeware-docs-tools/" [project.scripts] build_md_translations = "beeware_docs_tools.build_md_translations:main" build_po_translations = "beeware_docs_tools.build_po_translations:main" +convert_mkdocs_config = "beeware_docs_tools.convert_mkdocs_config:main" build_pot_translations = "beeware_docs_tools.build_pot_translations:main" live_serve_en = "beeware_docs_tools.live_serve_en:main" update_machine_translations = "beeware_docs_tools.update_machine_translations:main" @@ -126,7 +131,7 @@ filterwarnings = [ [tool.rumdl] flavor = "mkdocs" include = ["**/*.md"] -exclude = ["docs/en/SUMMARY.md", "comment.md", "CODE_OF_CONDUCT.md"] +exclude = ["comment.md", "CODE_OF_CONDUCT.md"] respect-gitignore = true # Disable rules: diff --git a/src/beeware_docs_tools/build_config.py b/src/beeware_docs_tools/build_config.py new file mode 100644 index 00000000..a4e657a0 --- /dev/null +++ b/src/beeware_docs_tools/build_config.py @@ -0,0 +1,464 @@ +"""Load the project configuration, and generate the configuration for a build. + +The documentation configuration is stored in two kinds of file in the ``docs`` +directory: + +* ``zensical.toml``, the base configuration, shared by every language; and +* ``zensical..toml``, the per-language overrides (``site_name``, + ``docs_dir``, ``theme.language`` and so on). + +Both files put their settings in a ``[project]`` table. The language file is +merged over the base configuration with the same rule MkDocs used for +``INHERIT``: tables are merged recursively, and any other value (including a +list) in the language file replaces the base value. + +Zensical requires ``docs_dir`` and ``site_dir`` to be inside the directory that +contains the configuration file, and it resolves symlinks before checking. To +satisfy this, the complete configuration for a build is written as +``docs/_build..toml``, next to the files it was generated from. This means +the English content in ``docs/en`` is used directly. + +Everything else that is generated during a build (translated Markdown, the +merged macros include directory, and the built site) is written into +``docs/_build``. All of this is removed when the build finishes. +""" + +import copy +import os +import shutil +import tomllib +import warnings +from importlib.metadata import PackageNotFoundError, metadata +from pathlib import Path + +import polib +import tomli_w + +PACKAGE_PATH = Path(__file__).parent +OVERRIDES_PATH = PACKAGE_PATH / "overrides" +SHARED_CONTENT_PATH = PACKAGE_PATH / "shared_content" + +# The base configuration file, relative to the `docs` directory. +BASE_CONFIG = "zensical.toml" +# The working directory for generated content, relative to the `docs` directory. +# Each kind of run (a build, or a live server) has its own subdirectory, so they +# can be used at the same time. +WORK_DIR = "_build" + +# The settings that a language file is expected to override. A key ending in +# `.*` allows anything under that key. +LANGUAGE_KEYS = { + "site_name", + "docs_dir", + "theme.language", + "theme.direction", + "extra.language_url", + "extra.translation_type", + "extra.header.*", +} + + +def language_config_name(language): + """The name of the configuration file for a language.""" + return f"zensical.{language}.toml" + + +def merge_config(base, override): + """Merge one configuration over another, using MkDocs's `INHERIT` rule. + + Tables (dictionaries) are merged recursively; any other value in + ``override`` (including a list) replaces the value in ``base``. ``base`` is + not modified. + + :param base: The configuration to merge into. + :param override: The configuration whose values take precedence. + :returns: The merged configuration. + """ + merged = copy.deepcopy(base) + for key, value in override.items(): + if isinstance(merged.get(key), dict) and isinstance(value, dict): + merged[key] = merge_config(merged[key], value) + else: + merged[key] = copy.deepcopy(value) + return merged + + +def _dotted_keys(table, prefix=""): + """Yield the dotted name of every non-table value in a table.""" + for key, value in table.items(): + name = f"{prefix}{key}" + if isinstance(value, dict) and value: + yield from _dotted_keys(value, f"{name}.") + else: + yield name + + +def unexpected_language_keys(language_config): + """Find any settings in a language file that aren't per-language settings. + + :param language_config: The ``[project]`` table of a language file. + :returns: A list of dotted key names. + """ + unexpected = [] + for name in _dotted_keys(language_config): + if name in LANGUAGE_KEYS: + continue + if any( + key.endswith(".*") and (name == key[:-2] or name.startswith(key[:-1])) + for key in LANGUAGE_KEYS + ): + continue + unexpected.append(name) + return unexpected + + +def read_toml(path): + """Read the ``[project]`` table of a TOML configuration file.""" + with Path(path).open("rb") as f: + return tomllib.load(f).get("project", {}) + + +def canonical_url(env=None): + """Determine the canonical URL of the site from the environment. + + ``READTHEDOCS_CANONICAL_URL`` is only populated for the version marked + canonical in the Read the Docs project settings, so it's often empty for + "latest" or PR-preview builds. Without a ``site_url``, it's not possible + to generate correct absolute asset links for generated error pages (e.g. + 404.html), which are served for any missing URL regardless of their depth + in the site. So, on Read the Docs, fall back to the URL of the version + being built. + + :param env: The environment to use; defaults to ``os.environ``. + :returns: The canonical URL, or None if it can't be determined. + """ + if env is None: + env = os.environ + + if url := env.get("READTHEDOCS_CANONICAL_URL"): + return url + + if env.get("READTHEDOCS") == "True": + project = env.get("READTHEDOCS_PROJECT") + version = env.get("READTHEDOCS_VERSION") + language = env.get("READTHEDOCS_LANGUAGE", "en") + if project and version: + return f"https://{project}.readthedocs.io/{language}/{version}/" + + return None + + +def load_config(project_path, language="en", env=None): + """Load the configuration for a language. + + The language file is merged over the base configuration. If no site URL is + configured, it is set from the environment (if available). The version of + the documented package is added to ``extra``. + + :param project_path: The root of the project being documented. + :param language: The language code to load. + :param env: The environment to use; defaults to ``os.environ``. + :returns: The merged ``[project]`` table. + """ + docs = project_path / "docs" + config = read_toml(docs / BASE_CONFIG) + + language_file = docs / language_config_name(language) + language_config = read_toml(language_file) + for name in unexpected_language_keys(language_config): + warnings.warn( + f"{language_file.relative_to(project_path)} sets {name!r}, which isn't " + "a per-language setting. It will be applied, but note that a list " + "in a language file replaces the base value, rather than being merged.", + stacklevel=2, + ) + config = merge_config(config, language_config) + + # A configured `site_url` takes precedence (as a literal `site_url` did in + # the MkDocs configuration); otherwise, use the canonical URL (as + # `site_url: !ENV READTHEDOCS_CANONICAL_URL` did). + if "site_url" not in config and (url := canonical_url(env)): + config["site_url"] = url + + try: + version = metadata(config["extra"]["package_name"])["version"] + config["extra"]["version"] = version + except (KeyError, PackageNotFoundError): + pass + + return config + + +def translate(po): + """Generate a translator function using the provided PO file.""" + + def _translate(entry): + po_entry = po.find(entry) + if po_entry: + translated = po_entry.msgstr + if translated: + return translated + return entry + + return _translate + + +def process_nav(entry, fn): + """Recursively walk a nav definition, calling a function on human-readable strings. + + :param entry: A node in a navigation tree + :param fn: A function that takes a single human-readable string, and returns + a "processed" string. + """ + if isinstance(entry, dict): + # Recursively translate all keys, and all list values. otherwise return + # values as is (as they will be a file reference) + return { + process_nav(child, fn): process_nav(value, fn) + if isinstance(value, list) + else value + for child, value in entry.items() + } + elif isinstance(entry, list): + # Recursively translate any dictionary in a list; + # otherwise return as-is (as it will be a file reference) + return [ + process_nav(child, fn) if isinstance(child, dict) else child + for child in entry + ] + else: + # The entry must be a string. Process it. + return fn(entry) + + +def work_path(project_path, run="build"): + """The directory that holds content generated during a run. + + :param project_path: The root of the project being documented. + :param run: The kind of run: "build" or "live". + """ + return project_path / "docs" / WORK_DIR / run + + +def build_config_path(project_path, language, run="build"): + """The path of the generated configuration for a language. + + :param project_path: The root of the project being documented. + :param language: The language code. + :param run: The kind of run: "build" or "live". + """ + name = f"{language}.toml" if run == "build" else f"{run}.{language}.toml" + return project_path / "docs" / f"{WORK_DIR}.{name}" + + +def clean_build_files(project_path, languages, run="build"): + """Remove the generated configurations and working directory of a run. + + :param project_path: The root of the project being documented. + :param languages: The language codes whose configurations should be removed. + :param run: The kind of run: "build" or "live". + """ + for language in languages: + build_config_path(project_path, language, run).unlink(missing_ok=True) + + shutil.rmtree(work_path(project_path, run), ignore_errors=True) + + # Only remove the shared working directory if nothing else is using it + # (other than the metadata macOS's Finder may have added). + work = project_path / "docs" / WORK_DIR + (work / ".DS_Store").unlink(missing_ok=True) + try: + work.rmdir() + except OSError: + pass + + +def merge_include_dirs(include_dirs, target): + """Merge several directories into one directory of symlinks. + + The macros ``include_dir`` setting accepts a single directory. This builds + a directory tree in ``target`` that contains a symlink to every file in + each of the ``include_dirs``. When the same relative path exists in more + than one directory, the first directory wins; this matches how a Jinja + loader with multiple search paths would find templates. + + :param include_dirs: The directories to merge, in priority order. + :param target: The directory to create. Any existing content is removed. + """ + shutil.rmtree(target, ignore_errors=True) + target.mkdir(parents=True) + for include_dir in include_dirs: + include_dir = Path(include_dir) + for source in sorted(include_dir.rglob("*")): + if not source.is_file(): + continue + dest = target / source.relative_to(include_dir) + if dest.is_symlink() or dest.exists(): + continue + dest.parent.mkdir(parents=True, exist_ok=True) + dest.symlink_to(source.resolve()) + + +def _relative_to_docs(project_path, path): + """Express a path relative to the `docs` directory, as a POSIX string.""" + return ( + Path(path).resolve().relative_to((project_path / "docs").resolve()).as_posix() + ) + + +def _translate_include_yaml(include_yaml, project_path, md_path): + """Point any `include_yaml` files in the English content at the translated content.""" + + def _translate_path(path): + parts = Path(path).parts + if parts and parts[0] == "en": + return ( + Path(_relative_to_docs(project_path, md_path)) / Path(*parts[1:]) + ).as_posix() + return path + + if isinstance(include_yaml, dict): + return {key: _translate_path(path) for key, path in include_yaml.items()} + return [_translate_path(path) for path in include_yaml] + + +def build_settings( + project_path, + config, + language, + md_path, + shared_content_path, + site_path, + watch=None, + run="build", +): + """The settings that depend on where the content for a build is. + + :param project_path: The root of the project being documented. + :param config: The configuration for the language, as returned by + ``load_config()``. + :param language: The language code being built. + :param md_path: The directory containing the Markdown content for the + language. Must be inside the project's ``docs`` directory. + :param shared_content_path: The directory containing the shared content for + the language. + :param site_path: The directory where the site will be built. Must be inside + the project's ``docs`` directory. + :param watch: Optional list of extra paths to watch when serving. + :param run: The kind of run: "build" or "live". + :returns: A configuration table, to be merged over ``config``. + """ + md_path = Path(md_path) + shared_content_path = Path(shared_content_path).resolve() + + settings = { + "docs_dir": _relative_to_docs(project_path, md_path), + "site_dir": _relative_to_docs(project_path, site_path), + "theme": {"custom_dir": str(OVERRIDES_PATH.resolve())}, + } + + # The theme overrides are written for Zensical's classic variant (the look + # of Material for MkDocs), rather than its default "modern" variant. + if "variant" not in config.get("theme", {}): + settings["theme"]["variant"] = "classic" + + # Shared content can be included using the Snippets extension. The + # extension can be configured with a dotted key (`pymdownx.snippets.x = ...`, + # which TOML reads as nested tables), or a quoted key + # (`"pymdownx.snippets".x = ...`); preserve whichever form is in use. + extensions = config.get("markdown_extensions", {}) + if "pymdownx.snippets" in extensions: + snippets = extensions["pymdownx.snippets"] or {} + wrap = lambda value: {"pymdownx.snippets": value} # noqa: E731 + else: + snippets = extensions.get("pymdownx", {}).get("snippets") or {} + wrap = lambda value: {"pymdownx": {"snippets": value}} # noqa: E731 + settings["markdown_extensions"] = wrap( + {"base_path": [*snippets.get("base_path", []), str(shared_content_path)]} + ) + + # Shared content can also be included using the macros plugin. The local + # contribution guide is an additional include root, so templates can be + # included from either location. + plugins = config.get("plugins", {}) + include_dirs = [shared_content_path] + contribution_root = config.get("extra", {}).get("contribution_guide_root") + if contribution_root: + include_dirs.append((md_path / contribution_root).resolve()) + include_path = work_path(project_path, run) / "includes" / language + merge_include_dirs(include_dirs, include_path) + macros = {"include_dir": str(include_path.resolve())} + # By default, a macro that fails to render only produces an error message in + # the page; fail the build instead, unless configured otherwise. + if "on_error_fail" not in (plugins.get("macros") or {}): + macros["on_error_fail"] = True + + # Data files included by the macros plugin are referenced relative to the + # `docs` directory; for a translation, use the copy in the translated content. + include_yaml = (plugins.get("macros") or {}).get("include_yaml") + if language != "en" and include_yaml: + macros["include_yaml"] = _translate_include_yaml( + include_yaml, project_path, md_path + ) + settings["plugins"] = {"macros": macros} + + # Source code for API documentation is referenced relative to the project root. + try: + source_paths = plugins["mkdocstrings"]["handlers"]["python"]["paths"] + except (KeyError, TypeError): + pass + else: + settings["plugins"]["mkdocstrings"] = { + "handlers": { + "python": { + "paths": [ + str((project_path / path).resolve()) for path in source_paths + ] + } + } + } + + # mkdocstrings (as a MkDocs plugin) used the theme language for the labels + # in API documentation, but Zensical defaults to English. Use the same rule + # the plugin used, unless a locale has been configured. + if "mkdocstrings" in plugins and not (plugins["mkdocstrings"] or {}).get("locale"): + theme = config.get("theme", {}) + locale = theme.get("language") or theme.get("locale") or "en" + settings["plugins"].setdefault("mkdocstrings", {})["locale"] = str( + locale + ).replace("_", "-") + + # Translate the navigation titles. + if language != "en" and "nav" in config: + po = polib.pofile(project_path / f"docs/locales/{language}/translations.po") + settings["nav"] = process_nav(config["nav"], translate(po)) + + if watch: + settings["watch"] = [str(Path(path).resolve()) for path in watch] + + return settings + + +def write_build_config(project_path, config, language, run="build", **kwargs): + """Write the complete configuration for a build. + + :param project_path: The root of the project being documented. + :param config: The configuration for the language, as returned by + ``load_config()``. + :param language: The language code being built. + :param run: The kind of run: "build" or "live". + :param kwargs: The locations of the build content; see ``build_settings()``. + :returns: The path of the generated configuration file. + """ + build_config = merge_config( + config, build_settings(project_path, config, language, run=run, **kwargs) + ) + + config_file = build_config_path(project_path, language, run) + with config_file.open("wb") as f: + f.write( + b"# Generated by beeware-docs-tools; removed after the build. Do not edit.\n" + ) + tomli_w.dump({"project": build_config}, f) + + return config_file diff --git a/src/beeware_docs_tools/build_md_translations.py b/src/beeware_docs_tools/build_md_translations.py index e143ead7..c0993209 100644 --- a/src/beeware_docs_tools/build_md_translations.py +++ b/src/beeware_docs_tools/build_md_translations.py @@ -1,11 +1,16 @@ -import os import shutil import subprocess +import sys from argparse import ArgumentParser, Namespace from pathlib import Path -from tempfile import TemporaryDirectory -from .md_tempdir import load_config, save_config, symlink_from_temp +from .build_config import ( + SHARED_CONTENT_PATH, + clean_build_files, + load_config, + work_path, + write_build_config, +) # This tool is used to generate translated Markdown, if a language other than # English is provided, and build the documentation site for the provided @@ -31,6 +36,9 @@ def parse_args() -> Namespace: parser.add_argument("language_code", nargs="*") parser.add_argument("--output", type=Path, default=PROJECT_PATH / "_build" / "html") parser.add_argument("--build-with-warnings", action="store_true") + # Retained for compatibility. The API documentation source paths in the + # mkdocstrings configuration are resolved relative to the project root, so + # there's no longer any need to identify them separately. parser.add_argument("--source-code", type=Path, action="append") args = parser.parse_args() @@ -72,145 +80,195 @@ def generate_translated_md( ) -def build_docs(config_file: Path, output_path: Path, build_with_warnings: bool) -> None: +def build_command(config_file: Path, build_with_warnings: bool) -> list[str]: """ - Run `mkdocs build` for a given language. + The command used to build the documentation for a given language. + + The site is built into the ``site_dir`` defined by the configuration file. :param config_file: The path to the language-specific configuration file. - :param output_path: The output directory for the site content. + :param build_with_warnings: If False, the build fails on any warning. """ - build_command = [ - "python", + command = [ + sys.executable, "-m", - "mkdocs", + "zensical", "build", "--clean", "--config-file", str(config_file), - "--site-dir", - str(output_path), ] if not build_with_warnings: - build_command.append("--strict") - - env = os.environ.copy() - if env.get("READTHEDOCS") == "True" and not env.get("READTHEDOCS_CANONICAL_URL"): - # READTHEDOCS_CANONICAL_URL is only populated for the version marked - # canonical in the Read the Docs project settings, so it's often empty - # for "latest" or PR-preview builds. Without it, `mkdocs`'s `site_url` - # is unset, and it can't generate correct absolute asset links for - # generated error pages (e.g. 404.html), which are served for any - # missing URL regardless of its depth in the site. - project = env.get("READTHEDOCS_PROJECT") - version = env.get("READTHEDOCS_VERSION") - language = env.get("READTHEDOCS_LANGUAGE", "en") - if project and version: - env["READTHEDOCS_CANONICAL_URL"] = ( - f"https://{project}.readthedocs.io/{language}/{version}/" - ) + command.append("--strict") + + return command + + +def copy_resources(en_md_path: Path, md_path: Path) -> list[Path]: + """Make the non-Markdown files of the English content available to a translation. + + If the documentation includes images or other resources, they must be + available in the translated content directory for the relative links in the + translated Markdown to function the same way they do in the original + Markdown files. This copies every file in the English content that isn't + Markdown (including hidden files, such as ``.authors.yml``) into the + translated content directory, unless the translation already contains it. - subprocess.run(build_command, check=True, env=env) + The files are copied, rather than symlinked, because Zensical doesn't + follow symlinked directories when it copies files into the built site. + + :param en_md_path: The directory containing the English content. + :param md_path: The directory containing the translated content. + :returns: The paths (relative to the content directory) that were copied. + """ + copied = [] + for path in sorted(en_md_path.rglob("*")): + if not path.is_file() or path.suffix == ".md" or path.name == ".DS_Store": + continue + relative_path = path.relative_to(en_md_path) + target = md_path / relative_path + if target.exists() or target.is_symlink(): + continue + target.parent.mkdir(parents=True, exist_ok=True) + shutil.copy2(path, target) + copied.append(relative_path) + return copied + + +def publish_site(site_path: Path, output_path: Path, keep: list[str]) -> None: + """Copy a built site into its final output location. + + Any existing content in the output location is removed first, apart from + any directories named in ``keep``. + + :param site_path: The directory containing the built site. + :param output_path: The final output location. + :param keep: Names of directories in the output location to preserve (the + output location for the English site contains the other languages). + """ + if output_path.is_dir(): + for child in output_path.iterdir(): + if child.name in keep and child.is_dir(): + continue + if child.is_dir() and not child.is_symlink(): + shutil.rmtree(child) + else: + child.unlink() + shutil.copytree(site_path, output_path, dirs_exist_ok=True) + + +def prune_site(output_path: Path, language: str, languages: list[str]) -> None: + """Remove build artefacts that aren't needed in the final site.""" + # If a SUMMARY folder has been created, it is unnecessary; prune it. + summary = output_path / "SUMMARY" + if summary.is_dir(): + print(f"Prune {summary}", flush=True) + shutil.rmtree(summary) + + # If a non-English language contains a language folder (in any capitalization), + # it is an artefact of redirects; prune it. + if language != "en": + for lang in languages: + # Also try zh-cn variant of zh_CN (et al) + for name in {lang, lang.replace("_", "-").lower()}: + lang_dir = output_path / name + if lang_dir.is_dir(): + print(f"Prune {lang_dir}", flush=True) + shutil.rmtree(lang_dir) def main(): args = parse_args() - with TemporaryDirectory() as temp_md_directory: - temp_md_path = Path(temp_md_directory) + output = Path(args.output).resolve() + work = work_path(PROJECT_PATH) + en_md_path = PROJECT_PATH / "docs/en" + + # Any language that has been (or could be) built into a subdirectory of the + # output directory. + all_languages = sorted( + { + *args.language_code, + *( + path.name + for path in (PROJECT_PATH / "docs/locales").glob("*") + if path.is_dir() + ), + } + ) - config = load_config(PROJECT_PATH) - symlink_from_temp(PROJECT_PATH, temp_md_path, args.source_code, config) + try: + # Make sure there is nothing left over from a previous build. + clean_build_files(PROJECT_PATH, args.language_code) - output = Path(args.output).resolve() for language in args.language_code: - print(f"Processing {language}") - - save_config(PROJECT_PATH, temp_md_path, config, language) + print(f"Processing {language}", flush=True) if language != "en": - # Final output path is language-specific - output_path = output / language - - # Create temp output directories for primary and shared content. - md_output_path = temp_md_path / language - sc_output_path = temp_md_path / f"shared_content/{language}" - md_output_path.mkdir(parents=True, exist_ok=True) - sc_output_path.mkdir(parents=True, exist_ok=True) + # Generate translated content in the working directory + md_path = work / "md" / language + shared_content_path = work / "shared_content" / language + md_path.mkdir(parents=True) + shared_content_path.mkdir(parents=True) # Generate translated primary content generate_translated_md( docs_path=PROJECT_PATH / "docs", language=language, - output_path=md_output_path, + output_path=md_path, ) # Generate translated shared content generate_translated_md( - docs_path=Path(__file__).parent / "shared_content", + docs_path=SHARED_CONTENT_PATH, language=language, - output_path=sc_output_path, + output_path=shared_content_path, ) - # If the documentation includes images or resources, they must be - # explicitly symlinked to the temporary language output directory - # for the relative links in the translated Markdown to function the - # same way they do in the original Markdown files. This finds all - # images and resources subdirectories, and symlinks them. - for name in ["images", "resources", "*.yml", "*.css"]: - en_md_dir = PROJECT_PATH / "docs/en" - for path in en_md_dir.glob(f"**/{name}"): - relative_path = path.relative_to(en_md_dir) - (temp_md_path / language / relative_path).parent.mkdir( - parents=True, exist_ok=True - ) - (temp_md_path / language / relative_path).symlink_to(path) + copy_resources(en_md_path, md_path) + # Final output path is language-specific + output_path = output / language else: - # Symlink to en directory - # - # Note: because this is symlinking back to the permanent en directory, - # any files written here will persist after the build. If it ever - # becomes necessary to write files into this directory, we'll need to - # revert to creating an actual temp en directory and symlinking the - # relevant files inside of it. - # - # (Prior to PR #48, a symlink to the shared content was created inside - # temp/en.) - (temp_md_path / "en").symlink_to( - PROJECT_PATH / "docs/en", - target_is_directory=True, - ) + md_path = en_md_path + shared_content_path = SHARED_CONTENT_PATH / "en" # EN content is always output into the root build path output_path = output - # Build documentation in provided language. - build_docs( - config_file=temp_md_path / f"mkdocs.{language}.yml", - output_path=output_path, - build_with_warnings=args.build_with_warnings, + site_path = work / "site" / language + config = load_config(PROJECT_PATH, language) + config_file = write_build_config( + PROJECT_PATH, + config, + language, + md_path=md_path, + shared_content_path=shared_content_path, + site_path=site_path, ) - # If a SUMMARY folder has been created, it is unnecessary; prune it. - summary = output_path / "SUMMARY" - if summary.is_dir(): - print(f"Prune {summary.relative_to(Path.cwd())}") - shutil.rmtree(summary) + # Build documentation in provided language. + subprocess.run( + build_command(config_file, args.build_with_warnings), check=True + ) - # If a non-English language contains a language folder (in any capitalization), - # it is an artefact of redirects; prune it. - if language != "en": - for lang in args.language_code: - lang_dir = output_path / lang - if lang_dir.is_dir(): - print(f"Prune {lang_dir.relative_to(Path.cwd())}") - shutil.rmtree(lang_dir) - # Also try zh-cn variant of zh_CN (et al) - lang_dir = output_path / lang.replace("_", "-").lower() - if lang_dir.is_dir(): - print(f"Prune {lang_dir.relative_to(Path.cwd())}") - shutil.rmtree(lang_dir) + publish_site( + site_path, + output_path, + keep=( + [ + name + for lang in all_languages + for name in {lang, lang.replace("_", "-").lower()} + ] + if language == "en" + else [] + ), + ) + prune_site(output_path, language, args.language_code) + finally: + clean_build_files(PROJECT_PATH, args.language_code) if __name__ == "__main__": diff --git a/src/beeware_docs_tools/build_pot_translations.py b/src/beeware_docs_tools/build_pot_translations.py index 857f034f..ced71f44 100644 --- a/src/beeware_docs_tools/build_pot_translations.py +++ b/src/beeware_docs_tools/build_pot_translations.py @@ -4,9 +4,8 @@ from tempfile import TemporaryDirectory import polib -import yaml -from .md_tempdir import process_nav +from .build_config import BASE_CONFIG, process_nav, read_toml # This tool is used to generate PO template (POT) files from English Markdown # content. @@ -33,10 +32,14 @@ def parse_args() -> Namespace: return args -def generate_titles(docs: Path) -> None: +def generate_titles(docs: Path) -> Path | None: + """Write the navigation titles into a Markdown file, so they can be translated. + + :param docs: The directory containing the `zensical.toml` configuration. + :returns: The path of the generated file, or None if there is no navigation. + """ try: - with (docs / "config.yml").open() as f: - config = yaml.load(f, Loader=yaml.SafeLoader) + config = read_toml(docs / BASE_CONFIG) en_titles = [] @@ -52,7 +55,7 @@ def accumulate(entry): ) return title_file except FileNotFoundError: - # "No config.yml file + # No zensical.toml file pass except KeyError: # No navigation in config. diff --git a/src/beeware_docs_tools/convert_mkdocs_config.py b/src/beeware_docs_tools/convert_mkdocs_config.py new file mode 100644 index 00000000..6c3f2597 --- /dev/null +++ b/src/beeware_docs_tools/convert_mkdocs_config.py @@ -0,0 +1,1279 @@ +"""Convert a project's MkDocs configuration to Zensical's native TOML format. + +This converts: + +* ``docs/config.yml`` into ``docs/zensical.toml``; +* each ``docs/mkdocs..yml`` into ``docs/zensical..toml``; and +* the literate-nav navigation file (``docs/en/SUMMARY.md``) into a ``nav`` + setting in ``docs/zensical.toml``. + +Comments in the YAML files are carried over to the TOML files. + +Before anything is written, the converted configuration for every language is +checked against the configuration Zensical reads from the original YAML files. +The only differences allowed are the intended ones (see ``compare_configs()``). +If there are any others, nothing is written. + +Navigation titles that were translated as part of ``SUMMARY.md`` are migrated +in each ``docs/locales//translations.po``, so the translations carry over +to the titles in the new ``nav`` setting. +""" + +import datetime +import json +import math +import re +import sys +import tempfile +import tomllib +from argparse import ArgumentParser +from pathlib import Path + +import polib +import yaml + +from .build_config import ( + BASE_CONFIG, + language_config_name, + merge_config, + process_nav, + read_toml, + unexpected_language_keys, +) + +# The file that `build_pot_translations` generates the navigation titles into, +# relative to the `docs` directory. +TITLES_FILE = "en/titles.md" + + +class ConversionError(Exception): + pass + + +########################################################################### +# Reading YAML +########################################################################### + + +class PythonName(str): + """A reference to a Python object (a ``!!python/name:`` tag).""" + + +class EnvTag: + """An ``!ENV`` tag, which has no equivalent in TOML.""" + + def __init__(self, value): + self.value = value + + def __repr__(self): + return f"!ENV {self.value!r}" + + +def _extension_alias(name): + from zensical.config import _extension_alias + + return _extension_alias(name) + + +class _Loader(yaml.SafeLoader): + pass + + +def _construct_env(loader, node): + if isinstance(node, yaml.ScalarNode): + return EnvTag(loader.construct_scalar(node)) + return EnvTag(loader.construct_sequence(node)) + + +_Loader.add_constructor("!ENV", _construct_env) +_Loader.add_multi_constructor( + "tag:yaml.org,2002:python/name:", + lambda loader, suffix, node: PythonName(_extension_alias(suffix)), +) + + +def _walk_nodes(node, path, starts, ends): + """Record the lines on which each node of a YAML document starts and ends.""" + + def note_end(n): + line = n.end_mark.line + ends[line] = max(ends.get(line, 0), n.end_mark.column) + + if isinstance(node, yaml.MappingNode): + for key_node, value_node in node.value: + child = (*path, key_node.value) + starts.setdefault(key_node.start_mark.line, []).append(child) + note_end(key_node) + _walk_nodes(value_node, child, starts, ends) + if node.flow_style: + note_end(node) + elif isinstance(node, yaml.SequenceNode): + for index, item in enumerate(node.value): + child = (*path, index) + starts.setdefault(item.start_mark.line, []).append(child) + _walk_nodes(item, child, starts, ends) + if node.flow_style: + note_end(node) + else: + note_end(node) + + +def extract_comments(text): + """Find the comments in a YAML document, and the setting each describes. + + A comment on its own line describes the setting that follows it. A comment + at the end of a line describes the setting on that line. + + :param text: The YAML document. + :returns: A tuple of a dictionary mapping a key path (a tuple of keys and + list indices) to ``{"before": [lines], "trailing": text}``, and a list + of comments that couldn't be attached to a setting. + """ + root = yaml.compose(text, Loader=_Loader) + comments = {} + unplaced = [] + if root is None: + return comments, unplaced + + starts = {} + ends = {} + _walk_nodes(root, (), starts, ends) + + pending = [] + for number, line in enumerate(text.splitlines()): + stripped = line.strip() + if stripped.startswith("#"): + comment = stripped[1:].removeprefix(" ").rstrip() + # Editor directives for YAML (such as the MkDocs schema) don't + # apply to TOML. + if not comment.startswith("yaml-language-server:"): + pending.append(comment) + continue + if not stripped: + continue + if number in starts and pending: + comments.setdefault(starts[number][0], {}).setdefault("before", []).extend( + pending + ) + pending = [] + if number in ends: + match = re.match(r"^[\s:]*#\s?(.*)$", line[ends[number] :]) + if match: + if number in starts: + comments.setdefault(starts[number][-1], {})["trailing"] = ( + match.group(1).rstrip() + ) + else: + unplaced.append(match.group(1)) + unplaced.extend(pending) + return comments, unplaced + + +def load_yaml(path): + """Load a YAML configuration file, and its comments.""" + text = Path(path).read_text(encoding="utf-8") + try: + data = yaml.load(text, Loader=_Loader) or {} + except yaml.YAMLError as e: + raise ConversionError(f"Unable to read {path}: {e}") from e + comments, unplaced = extract_comments(text) + return data, comments, unplaced + + +########################################################################### +# Converting values +########################################################################### + + +def _rename_comments(comments, old_prefix, new_prefix): + """Move the comments under one key path to another key path.""" + for path in list(comments): + if path[: len(old_prefix)] == old_prefix: + comments[(*new_prefix, *path[len(old_prefix) :])] = comments.pop(path) + + +def normalize_named_items(value, path, comments): + """Convert a `markdown_extensions` or `plugins` setting to a table. + + MkDocs allows these settings to be a list of names, or of single-key + mappings; TOML needs a table. A missing configuration becomes an empty + table. + """ + if value is None: + return {} + if isinstance(value, dict): + return {name: {} if conf is None else conf for name, conf in value.items()} + if not isinstance(value, list): + raise ConversionError(f"{'.'.join(path)} must be a list or a mapping") + + result = {} + for index, item in enumerate(value): + if isinstance(item, str): + name, conf = item, {} + _rename_comments(comments, (*path, index), (*path, name)) + elif isinstance(item, dict) and len(item) == 1: + [(name, conf)] = item.items() + conf = {} if conf is None else conf + # Comments on the item, and on its key, both describe the setting. + item_comments = comments.pop((*path, index), {}) + _rename_comments(comments, (*path, index, name), (*path, name)) + if item_comments: + merged = comments.setdefault((*path, name), {}) + merged["before"] = item_comments.get("before", []) + merged.get( + "before", [] + ) + if "trailing" in item_comments and "trailing" not in merged: + merged["trailing"] = item_comments["trailing"] + else: + raise ConversionError(f"Unexpected entry in {'.'.join(path)}: {item!r}") + result[name] = conf + return result + + +def to_toml_data(value, path, notes, python_names): + """Convert a value loaded from YAML into a value that can be written as TOML. + + :param value: The value to convert. + :param path: The key path of the value, for messages. + :param notes: A list to which notes about the conversion are added. + :param python_names: A set to which the strings converted from Python + names are added. + """ + name = ".".join(str(part) for part in path) + if isinstance(value, PythonName): + notes.append(f"{name}: Python name converted to the string {str(value)!r}") + python_names.add(str(value)) + return str(value) + if isinstance(value, EnvTag): + raise ConversionError( + f"{name} uses !ENV, which isn't supported in TOML. Remove it from the " + "YAML configuration, and convert again." + ) + if isinstance(value, dict): + result = {} + for key, child in value.items(): + if not isinstance(key, str): + raise ConversionError(f"{name} has a non-string key: {key!r}") + if child is None: + notes.append( + f"{name}.{key}: dropped, because it has no value (null), which " + "Zensical treats the same as not setting it" + ) + continue + result[key] = to_toml_data(child, (*path, key), notes, python_names) + return result + if isinstance(value, list): + if any(item is None for item in value): + raise ConversionError(f"{name} contains a null value") + return [ + to_toml_data(item, (*path, index), notes, python_names) + for index, item in enumerate(value) + ] + if isinstance(value, (str, bool, int, float, datetime.date)): + return value + raise ConversionError(f"{name} has a value that can't be converted: {value!r}") + + +########################################################################### +# Navigation +########################################################################### + + +def resolve_literate_nav(docs_dir, plugin_config, yaml_nav, exclude_globs=()): + """Resolve the navigation the literate-nav plugin would have generated. + + This uses literate-nav's own parser, so the result is the navigation that + MkDocs used. + + :param docs_dir: The directory containing the (English) Markdown content. + :param plugin_config: The configuration of the literate-nav plugin. + :param yaml_nav: The `nav` setting from the configuration, if any. + :param exclude_globs: Glob patterns (as used by the `exclude` plugin) of + files that are removed from the site before literate-nav runs. + :returns: A tuple of the resolved navigation, and the list of navigation + files (relative to the docs directory) that were used. + """ + try: + from mkdocs.structure.files import Files, InclusionLevel, get_files + from mkdocs_literate_nav.plugin import resolve_directories_in_nav + except ImportError as e: + raise ConversionError( + "Converting a literate-nav navigation file requires mkdocs-literate-nav. " + "Install it with `python -m pip install mkdocs-literate-nav==0.6.3`, or " + "install beeware-docs-tools with the `convert` extra." + ) from e + + unsupported = set(plugin_config) - {"nav_file", "implicit_index", "tab_length"} + if unsupported: + raise ConversionError( + f"Unsupported literate-nav settings: {', '.join(sorted(unsupported))}" + ) + + import fnmatch + + with tempfile.TemporaryDirectory() as site_dir: + files = get_files( + { + "docs_dir": str(docs_dir), + "site_dir": site_dir, + "use_directory_urls": True, + "exclude_docs": None, + "draft_docs": None, + "not_in_nav": None, + } + ) + if exclude_globs: + files = Files( + [ + file + for file in files + if not any(fnmatch.fnmatch(file.src_path, g) for g in exclude_globs) + ] + ) + + nav_file = plugin_config.get("nav_file", "SUMMARY.md") + nav = resolve_directories_in_nav( + yaml_nav, + files, + nav_file_name=nav_file, + implicit_index=plugin_config.get("implicit_index", False), + markdown_config={ + "extensions": [], + "extension_configs": {}, + "tab_length": plugin_config.get("tab_length", 4), + }, + ) + nav_files = [ + file.src_uri + for file in files + if file.name == Path(nav_file).stem + and file.inclusion == InclusionLevel.NOT_IN_NAV + ] + nav_comments = {} + return _clean_nav(nav, nav_comments), nav_files, nav_comments + + +_HTML_COMMENT = re.compile(r"", re.DOTALL) + + +def _clean_nav(nav, comments=None, path=()): + """Convert a resolved navigation into plain lists, strings and mappings. + + literate-nav represents an untitled page as ``{None: path}``; in a `nav` + setting, that is written as the bare path. + + An HTML comment in a navigation file becomes part of the title of the item + it follows (where it isn't visible, because it's rendered as a comment). + These are removed from the title, and recorded in ``comments``. + + :param nav: The resolved navigation. + :param comments: A dictionary that will map the index path of an item to + the comments that were removed from its title. + :param path: The index path of ``nav``. + """ + if comments is None: + comments = {} + result = [] + for index, item in enumerate(nav): + if isinstance(item, dict): + if len(item) != 1: + raise ConversionError(f"Unexpected navigation entry: {item!r}") + [(title, value)] = item.items() + if isinstance(value, list): + value = _clean_nav(value, comments, (*path, index)) + if title is not None: + found = [c.strip() for c in _HTML_COMMENT.findall(title)] + if found: + comments[(*path, index)] = found + title = " ".join(_HTML_COMMENT.sub(" ", title).split()) + result.append(value if title is None else {title: value}) + else: + result.append(item) + return result + + +def nav_titles(nav): + """The set of titles in a `nav` setting.""" + titles = set() + + def accumulate(entry): + titles.add(entry) + return entry + + process_nav(nav, accumulate) + return titles + + +########################################################################### +# Writing TOML +########################################################################### + +_BARE_KEY = re.compile(r"^[A-Za-z0-9_-]+$") +_LINE_LENGTH = 88 +_INDENT = " " + + +def _escape(text): + """Escape text for use in a TOML basic string.""" + text = json.dumps(text, ensure_ascii=False)[1:-1] + return text.replace("\x7f", "\\u007f") + + +def toml_key(key): + """Format a key, quoting it if necessary. Keys are always on a single line.""" + return key if _BARE_KEY.match(key) else f'"{_escape(key)}"' + + +def toml_string(value): + """Format a string as a TOML basic string (multi-line if it contains newlines).""" + if "\n" in value.rstrip("\n") or value.endswith("\n") and len(value) > 1: + lines = value.split("\n") + body = "\n".join(_escape(line) for line in lines) + return f'"""\n{body}"""' + return f'"{_escape(value)}"' + + +def toml_scalar(value): + if isinstance(value, bool): + return "true" if value else "false" + if isinstance(value, int): + return str(value) + if isinstance(value, float): + if math.isnan(value): + return "nan" + if math.isinf(value): + return "inf" if value > 0 else "-inf" + return repr(value) + if isinstance(value, str): + return toml_string(value) + if isinstance(value, datetime.date): + return value.isoformat() + raise ConversionError(f"Can't write {value!r} as TOML") + + +def toml_inline(value): + """Format a value on a single line.""" + if isinstance(value, dict): + if not value: + return "{}" + items = ", ".join(f"{toml_key(k)} = {toml_inline(v)}" for k, v in value.items()) + return f"{{ {items} }}" + if isinstance(value, list): + return "[" + ", ".join(toml_inline(v) for v in value) + "]" + return toml_scalar(value) + + +def _is_table(value): + return isinstance(value, dict) and bool(value) + + +def _is_array_of_tables(value): + return ( + isinstance(value, list) + and bool(value) + and all(isinstance(item, dict) for item in value) + and any(any(isinstance(v, dict) for v in item.values()) for item in value) + ) + + +class TomlWriter: + """Write configuration data as TOML, with comments. + + :param comments: The comments to include, keyed by key path, as returned + by ``extract_comments()``. + :param path_map: A function that maps a key path in the TOML data to the key + path of the original YAML setting (for finding comments). + :param nav_comments: Comments for items in the `nav` setting, keyed by + the index path of the item. + """ + + def __init__(self, comments, path_map=lambda path: path, nav_comments=None): + self.comments = comments + self.path_map = path_map + self.nav_comments = nav_comments or {} + self.used = set() + self.lines = [] + + def _comments(self, path): + yaml_path = self.path_map(path) + found = self.comments.get(yaml_path) + if found: + self.used.add(yaml_path) + return found + return {} + + def _before(self, path, indent=""): + for line in self._comments(path).get("before", []): + self.lines.append(f"{indent}# {line}".rstrip()) + + def _trailing(self, path): + trailing = self._comments(path).get("trailing") + return f" # {trailing}" if trailing else "" + + def unused_comments(self): + return { + path: comment + for path, comment in self.comments.items() + if path not in self.used + } + + def blank(self): + if self.lines and self.lines[-1] != "": + self.lines.append("") + + def text(self): + while self.lines and self.lines[-1] == "": + self.lines.pop() + return "\n".join(self.lines) + "\n" + + # Values + + def key_value(self, key, value, path, indent=""): + """Write `key = value`, where `key` may be a dotted key.""" + self._before(path, indent) + trailing = self._trailing(path) + if isinstance(value, list) and self._multiline_array(value, path, key, indent): + line = f"{indent}{key} = [" + self.lines.append(line + trailing) + self._array_items(value, path, indent + _INDENT) + self.lines.append(f"{indent}]") + return + if isinstance(value, str) and "\n" in value: + self.lines.append(f"{indent}{key} = {toml_string(value)}{trailing}") + return + self.lines.append(f"{indent}{key} = {toml_inline(value)}{trailing}") + + def _multiline_array(self, value, path, key, indent): + if not value: + return False + if any(isinstance(item, (dict, list)) for item in value): + return True + if any(self._comments((*path, index)) for index in range(len(value))): + return True + return len(f"{indent}{key} = {toml_inline(value)}") > _LINE_LENGTH + + def _array_items(self, value, path, indent): + for index, item in enumerate(value): + item_path = (*path, index) + self._before(item_path, indent) + if isinstance(item, list) and item: + self.lines.append(f"{indent}[{self._trailing(item_path)}") + self._array_items(item, item_path, indent + _INDENT) + self.lines.append(f"{indent}],") + else: + self.lines.append( + f"{indent}{toml_inline(item)},{self._trailing(item_path)}" + ) + + def dotted_values(self, prefix, value, path, indent=""): + """Write a table as dotted keys (`a.b.c = value`) in the current table.""" + if not _is_table(value): + self.key_value(prefix, value, path, indent) + return + # Comments on the table itself go above its first value. + comments = self._comments(path) + for line in comments.get("before", []): + self.lines.append(f"{indent}# {line}".rstrip()) + if "trailing" in comments: + self.lines.append(f"{indent}# {comments['trailing']}".rstrip()) + for key, child in value.items(): + self.dotted_values(f"{prefix}.{toml_key(key)}", child, (*path, key), indent) + + def nav(self, key, nav, path): + """Write a `nav` setting, as nested arrays of inline tables.""" + self._before(path) + self.lines.append(f"{key} = [{self._trailing(path)}") + self._nav_items(nav, _INDENT, ()) + self.lines.append("]") + + def _nav_items(self, items, indent, path): + for index, item in enumerate(items): + for comment in self.nav_comments.get((*path, index), []): + for line in comment.splitlines(): + self.lines.append(f"{indent}# {line.strip()}".rstrip()) + if isinstance(item, str): + self.lines.append(f"{indent}{toml_string(item)},") + continue + if not isinstance(item, dict) or len(item) != 1: + raise ConversionError(f"Unexpected navigation entry: {item!r}") + [(title, value)] = item.items() + # Titles are always quoted, for consistency. + key = f'"{_escape(title)}"' + if isinstance(value, list): + self.lines.append(f"{indent}{{ {key} = [") + self._nav_items(value, indent + _INDENT, (*path, index)) + self.lines.append(f"{indent}] }},") + else: + self.lines.append(f"{indent}{{ {key} = {toml_inline(value)} }},") + + # Tables + + def table(self, path, table, header_style=None): + """Write a table, and all of its subtables. + + :param path: The key path of the table. + :param table: The table's content. + :param header_style: Optional function that takes a key path and returns + the way to write that table: "dotted" (as dotted keys in the parent + table), "nav", or None (as a table with a header). + """ + header_style = header_style or (lambda path: None) + if not isinstance(table, dict): + raise ConversionError(f"{'.'.join(path)} must be a table") + simple = [] + subtables = [] + for key, value in table.items(): + child = (*path, key) + style = header_style(child) + if style in {"dotted", "nav"} or ( + style != "table" + and not (_is_table(value) or _is_array_of_tables(value)) + ): + simple.append((key, value, style)) + else: + subtables.append((key, value)) + + header = ".".join(toml_key(key) for key in path) + if path and (simple or not subtables or self._comments(path)): + self.blank() + self._before(path) + self.lines.append(f"[{header}]{self._trailing(path)}") + + for key, value, style in simple: + child = (*path, key) + if style == "nav": + self.nav(toml_key(key), value, child) + elif style == "dotted": + key_text = ( + _extension_key(key) + if path[-1:] == ("markdown_extensions",) + else toml_key(key) + ) + self.dotted_values(key_text, value, child) + else: + self.key_value(toml_key(key), value, child) + + for key, value in subtables: + child = (*path, key) + if isinstance(value, dict): + self.table(child, value, header_style) + else: + self.array_of_tables(child, value) + + def array_of_tables(self, path, items): + header = ".".join(toml_key(key) for key in path) + self._before(path) + for index, item in enumerate(items): + item_path = (*path, index) + self.blank() + self._before(item_path) + self.lines.append(f"[[{header}]]{self._trailing(item_path)}") + for key, value in item.items(): + self.dotted_values(toml_key(key), value, (*item_path, key)) + + +def _extension_key(name): + """The TOML key for a Markdown extension. + + Zensical reads ``pymdownx.`` and ``pymdownx.blocks.`` (and the + same for ``zensical``) as dotted keys. Any other name containing a dot must + be quoted. + """ + parts = name.split(".") + if len(parts) == 1: + return toml_key(name) + if ( + parts[0] in {"pymdownx", "zensical"} + and (len(parts) == 2 or (len(parts) == 3 and parts[1] == "blocks")) + and all(_BARE_KEY.match(part) for part in parts) + ): + return name + return toml_string(name) + + +def _extension_order(name): + """The order Zensical reads dotted extension keys in. + + Zensical moves the ``pymdownx`` extensions (and then the ``zensical`` + extensions) after all the others. + """ + key = _extension_key(name) + if key.startswith("pymdownx."): + return 1 + if key.startswith("zensical."): + return 2 + return 0 + + +def write_config_toml(project, comments, nav_key=False, nav_comments=None): + """Format a ``[project]`` table as TOML. + + :param project: The configuration. + :param comments: The comments from the YAML file. + :param nav_key: True if the `nav` setting should be written as a navigation + tree. + :param nav_comments: Comments for items in the `nav` setting. + :returns: A tuple of the TOML text, and the comments that weren't written. + """ + project = dict(project) + + def path_map(path): + # The TOML data is nested under "project"; the YAML isn't. + return path[1:] + + writer = TomlWriter(comments, path_map, nav_comments) + + def header_style(path): + if path == ("project", "nav") and nav_key: + return "nav" + if len(path) == 3 and path[1] == "markdown_extensions": + return "dotted" + # Each plugin is written as a table, even if it's empty. + if len(path) == 3 and path[1] == "plugins": + return "table" + return None + + # Write the Markdown extensions in the order Zensical will read them in. + extensions = project.get("markdown_extensions") + if extensions: + project["markdown_extensions"] = dict( + sorted(extensions.items(), key=lambda item: _extension_order(item[0])) + ) + + writer.table(("project",), project, header_style) + return writer.text(), writer.unused_comments() + + +########################################################################### +# Equivalence checks +########################################################################### + + +def _callable_name(value): + return f"{value.__module__}.{value.__qualname__}" + + +def _normalize(value): + """Normalize a loaded configuration value for comparison. + + Python objects (from ``!!python/name:`` tags) are represented by their + dotted name, and null values (which can't be expressed in TOML, and which + Zensical treats the same as a missing value) are removed. + """ + if isinstance(value, dict): + return {k: _normalize(v) for k, v in value.items() if v is not None} + if isinstance(value, list): + return [_normalize(v) for v in value] + if callable(value): + return _callable_name(value) + return value + + +def _resolve_names(value, names): + """Resolve the strings that were converted from Python names to objects.""" + from zensical.config import _resolve + + if isinstance(value, dict): + return {k: _resolve_names(v, names) for k, v in value.items()} + if isinstance(value, list): + return [_resolve_names(v, names) for v in value] + if isinstance(value, str) and value in names: + return _callable_name(_resolve(value)) + return value + + +def _differences(old, new, path=()): + """List the differences between two normalized configuration values.""" + name = ".".join(str(p) for p in path) or "(root)" + if isinstance(old, dict) and isinstance(new, dict): + diffs = [] + for key in old.keys() | new.keys(): + if key not in new: + diffs.append(f"{name}.{key}: missing from the converted configuration") + elif key not in old: + diffs.append(f"{name}.{key}: added by the conversion") + else: + diffs.extend(_differences(old[key], new[key], (*path, key))) + return diffs + if old != new: + return [f"{name}: {old!r} became {new!r}"] + return [] + + +def _markdown_extensions(config): + from zensical.config import _convert_markdown_extensions + + names, configs = _convert_markdown_extensions( + config.pop("markdown_extensions", None) + ) + return names, configs + + +def compare_configs(old, new, python_names, allowed): + """Compare the configuration Zensical read from YAML with the converted one. + + The intended differences are: + + * `nav` is generated from the literate-nav navigation file (the + literate-nav plugin and its navigation file are removed); + * `site_url` is set from the environment, rather than with ``!ENV``; + * Python names are strings, rather than ``!!python/name:`` tags; and + * the Markdown extensions with dotted keys (``pymdownx.*``) are read after + the others. + + :param old: The configuration from ``zensical.config._yaml_load()``. + :param new: The merged TOML configuration. + :param python_names: The strings that were converted from Python names. + :param allowed: The intended differences that apply: a set containing any + of "nav" and "site_url". + :returns: A tuple of the list of unexpected differences, and a list of + notes about intended differences. + """ + # Named items with no configuration (`search:` or `- search`) are the same + # as an empty configuration; resolve that before null values are removed. + old = dict(old) + for setting in ("plugins", "markdown_extensions"): + value = old.get(setting) + if isinstance(value, list): + old[setting] = { + (item if isinstance(item, str) else next(iter(item))): ( + {} if isinstance(item, str) else next(iter(item.values())) + ) + for item in value + } + if isinstance(old.get(setting), dict): + old[setting] = {k: {} if v is None else v for k, v in old[setting].items()} + + old = _normalize(old) + new = _normalize(_resolve_names(new, python_names)) + notes = [] + + if "site_url" in allowed: + old.pop("site_url", None) + new.pop("site_url", None) + + old_plugins = old.get("plugins") or {} + if "nav" in allowed: + old_plugins.pop("literate-nav", None) + old.pop("nav", None) + new.pop("nav", None) + old["plugins"] = old_plugins + new.setdefault("plugins", {}) + if list(old_plugins) != list(new["plugins"]): + message = ( + f"plugins: order or names changed from {list(old_plugins)} to " + f"{list(new['plugins'])}" + ) + return [message], notes + + old_names, old_configs = _markdown_extensions(old) + new_names, new_configs = _markdown_extensions(new) + diffs = [] + if old_names != new_names: + if sorted(old_names) == sorted(new_names): + notes.append( + "Markdown extension order: " + + ", ".join(new_names) + + " (was " + + ", ".join(old_names) + + ")" + ) + else: + diffs.append(f"markdown_extensions: {old_names} became {new_names}") + diffs.extend( + _differences( + _normalize(old_configs), _normalize(new_configs), ("markdown_extensions",) + ) + ) + diffs.extend(_differences(old, new)) + return diffs, notes + + +########################################################################### +# Translations +########################################################################### + +_LINK = re.compile(r"^\s*\[(?P.*)\]\s*(\{\d+\}|\([^)]*\))\s*$", re.DOTALL) + + +def migrate_nav_translations(po_path, nav_sources, titles, titles_occurrence): + """Migrate the navigation title translations in a PO file. + + Titles that were translated as part of a literate-nav navigation file have + msgids like ``[Title]{1}`` (for a link) or ``Title`` (for a section). In a + `nav` setting, all titles are extracted as plain text (``Title``). This + adds (or fills in) an entry for each title, using the translation of the + link text, keeping the fuzzy flag as it was, and removes the entries that + were only used by the navigation file. + + :param po_path: The PO file to update. + :param nav_sources: The source references (as used in the PO file) of the + navigation files. + :param titles: The titles in the new `nav` setting. + :param titles_occurrence: The source reference to use for title entries. + :returns: A dictionary of counts and messages describing the migration. + """ + po = polib.pofile(str(po_path), wrapwidth=100000) + report = { + "moved": 0, + "matched": 0, + "kept": 0, + "removed": 0, + "conflicts": [], + "unmapped": [], + } + + nav_entries = [ + entry + for entry in po + if not entry.obsolete + and any(source in nav_sources for source, _ in entry.occurrences) + ] + + def is_nav_only(entry): + return all(source in nav_sources for source, _ in entry.occurrences) + + for entry in nav_entries: + link = _LINK.match(entry.msgid) + title = link.group("title") if link else entry.msgid + if title not in titles: + continue + + if not link: + # Already a plain title; it's kept, with a new source reference. + report["kept"] += 1 + continue + + translated = "" + if entry.msgstr: + match = _LINK.match(entry.msgstr) + if match: + translated = match.group("title") + else: + report["unmapped"].append(f"{entry.msgid!r} -> {entry.msgstr!r}") + continue + + target = po.find(title) + if target is None or target.obsolete: + po.append( + polib.POEntry( + msgid=title, + msgstr=translated, + flags=list(entry.flags), + occurrences=[(titles_occurrence, "")], + ) + ) + report["moved"] += 1 + elif not target.msgstr and translated: + target.msgstr = translated + target.flags = list(entry.flags) + report["moved"] += 1 + elif target.msgstr and translated and target.msgstr != translated: + report["conflicts"].append( + f"{title!r}: kept {target.msgstr!r}, not {translated!r}" + ) + else: + report["matched"] += 1 + + for entry in nav_entries: + others = [o for o in entry.occurrences if o[0] not in nav_sources] + link = _LINK.match(entry.msgid) + is_title = not link and entry.msgid in titles + if is_title: + entry.occurrences = [*others, (titles_occurrence, "")] + elif others: + entry.occurrences = others + elif is_nav_only(entry): + po.remove(entry) + report["removed"] += 1 + + po.save(str(po_path)) + return report + + +########################################################################### +# Conversion +########################################################################### + + +def convert(docs, write=True, keep_old=False, out=print): + """Convert the MkDocs configuration in a ``docs`` directory. + + :param docs: The ``docs`` directory. + :param write: If False, check the conversion, but don't change any files. + :param keep_old: If True, don't delete the original files. + :param out: A function used to report progress. + :returns: True if the conversion succeeded. + """ + docs = Path(docs) + base_file = docs / "config.yml" + if not base_file.is_file(): + raise ConversionError(f"{base_file} doesn't exist") + language_files = sorted(docs.glob("mkdocs.*.yml")) + if not language_files: + raise ConversionError(f"No mkdocs.<lang>.yml files in {docs}") + languages = [path.name[len("mkdocs.") : -len(".yml")] for path in language_files] + + notes = [] + allowed = set() + python_names = set() + + # Load the base configuration. + base, base_comments, unplaced = load_yaml(base_file) + for comment in unplaced: + notes.append(f"{base_file.name}: comment not carried over: {comment!r}") + if "INHERIT" in base: + raise ConversionError(f"{base_file.name} uses INHERIT, which isn't supported") + + if isinstance(base.get("site_url"), EnvTag): + del base["site_url"] + allowed.add("site_url") + notes.append( + f"{base_file.name}: site_url (!ENV) removed; it's set from " + "READTHEDOCS_CANONICAL_URL at build time" + ) + + for setting in ("markdown_extensions", "plugins"): + if setting in base: + base[setting] = normalize_named_items( + base[setting], (setting,), base_comments + ) + + # Load the language configurations. + language_configs = {} + for language, path in zip(languages, language_files, strict=True): + config, comments, unplaced = load_yaml(path) + for comment in unplaced: + notes.append(f"{path.name}: comment not carried over: {comment!r}") + inherit = config.pop("INHERIT", None) + if inherit != "config.yml": + raise ConversionError( + f"{path.name} must have `INHERIT: config.yml` (found {inherit!r})" + ) + if isinstance(config.get("site_url"), EnvTag): + del config["site_url"] + allowed.add("site_url") + for setting in ("markdown_extensions", "plugins"): + if setting in config: + raise ConversionError( + f"{path.name} sets {setting}, which isn't supported in a " + "language file" + ) + language_configs[language] = (config, comments) + + # A literal `site_url` is kept. If every language file sets the same one, + # it's moved into the base configuration. + site_urls = { + str(config.get("site_url")) + for config, _ in language_configs.values() + if "site_url" in config + } + if ( + len(site_urls) == 1 + and all("site_url" in config for config, _ in language_configs.values()) + and base.get("site_url", next(iter(site_urls))) == next(iter(site_urls)) + ): + base["site_url"] = next(iter(site_urls)) + for config, comments in language_configs.values(): + del config["site_url"] + _rename_comments(comments, ("site_url",), ("removed",)) + notes.append( + f"site_url: the same value ({base['site_url']!r}) was set for every " + f"language, so it was moved into {BASE_CONFIG}" + ) + + # Note any plugins that Zensical doesn't support (and will ignore). + from zensical.config import _PLUGIN_UNSUPPORTED_OPTIONS + + for name in base.get("plugins", {}): + canonical = name.removeprefix("material/").split("/", 1)[0] + if canonical not in _PLUGIN_UNSUPPORTED_OPTIONS: + notes.append( + f"plugins.{name}: Zensical doesn't support this plugin, and will " + "ignore it" + ) + + # Convert the literate-nav navigation file into a `nav` setting. + nav_files = [] + nav_comments = {} + plugins = base.get("plugins", {}) + if "literate-nav" in plugins: + en_config = language_configs.get("en", ({}, {}))[0] + docs_dir = docs / en_config.get("docs_dir", base.get("docs_dir", "docs")) + exclude_globs = (plugins.get("exclude") or {}).get("glob", []) + nav, nav_files, nav_comments = resolve_literate_nav( + docs_dir, + plugins.pop("literate-nav") or {}, + base.get("nav"), + exclude_globs=exclude_globs, + ) + nav_files = [docs_dir / path for path in nav_files] + _rename_comments(base_comments, ("plugins", "literate-nav"), ("removed",)) + base["nav"] = nav + allowed.add("nav") + notes.append( + "nav: generated from " + + ", ".join(str(path.relative_to(docs.parent)) for path in nav_files) + + "; the literate-nav plugin was removed" + ) + + # Convert the values to TOML-compatible data. + def convert_values(config, label): + conversion_notes = [] + data = to_toml_data(config, (), conversion_notes, python_names) + for note in conversion_notes: + notes.append(f"{label}: {note}") + return data + + base = convert_values(base, base_file.name) + language_data = { + language: (convert_values(config, f"mkdocs.{language}.yml"), comments) + for language, (config, comments) in language_configs.items() + } + + # Write the TOML files. + outputs = {} + text, unused = write_config_toml( + base, base_comments, nav_key=True, nav_comments=nav_comments + ) + outputs[BASE_CONFIG] = text + for path, comment in unused.items(): + if path and path[0] == "removed": + continue + notes.append( + f"{base_file.name}: comment not carried over ({'.'.join(map(str, path))}): " + f"{comment}" + ) + for language, (config, comments) in language_data.items(): + text, unused = write_config_toml(config, comments) + outputs[language_config_name(language)] = text + for path, comment in unused.items(): + if path and path[0] == "removed": + continue + notes.append( + f"mkdocs.{language}.yml: comment not carried over " + f"({'.'.join(map(str, path))}): {comment}" + ) + + # Check the converted configuration against what Zensical reads from YAML. + from zensical.config import _yaml_load + + failed = False + with tempfile.TemporaryDirectory() as temp: + temp_path = Path(temp) + for name, text in outputs.items(): + (temp_path / name).write_text(text, encoding="utf-8") + try: + tomllib.loads(text) + except tomllib.TOMLDecodeError as e: + raise ConversionError(f"Generated invalid TOML for {name}: {e}") from e + + new_base = read_toml(temp_path / BASE_CONFIG) + reported_notes = set() + for language, path in zip(languages, language_files, strict=True): + with path.open(encoding="utf-8") as f: + old = _yaml_load(f) + language_config = read_toml(temp_path / language_config_name(language)) + for key in unexpected_language_keys(language_config): + notes.append( + f"{language_config_name(language)}: {key!r} isn't a per-language " + "setting; it will produce a warning at build time" + ) + new = merge_config(new_base, language_config) + diffs, check_notes = compare_configs(old, new, python_names, allowed) + for note in check_notes: + if note not in reported_notes: + reported_notes.add(note) + notes.append(note) + if diffs: + failed = True + out(f"{language}: the converted configuration differs:") + for diff in diffs: + out(f" {diff}") + else: + out(f"{language}: the converted configuration is equivalent") + + for note in notes: + out(f"Note: {note}") + + if failed: + out("Conversion failed; no files were changed.") + return False + + if not write: + out("Check complete; no files were changed (--check).") + return True + + for name, text in outputs.items(): + (docs / name).write_text(text, encoding="utf-8") + out(f"Wrote {docs / name}") + + # Migrate the translations of the navigation titles. + if nav_files: + titles = nav_titles(base["nav"]) + project_root = docs.parent + nav_sources = {path.relative_to(project_root).as_posix() for path in nav_files} + titles_occurrence = (docs / TITLES_FILE).relative_to(project_root).as_posix() + for po_path in sorted(docs.glob("locales/*/translations.po")): + report = migrate_nav_translations( + po_path, nav_sources, titles, titles_occurrence + ) + out( + f"{po_path}: {report['moved']} link titles migrated, " + f"{report['matched']} already had the same translation, " + f"{len(report['conflicts'])} already had a different translation, " + f"{len(report['unmapped'])} couldn't be mapped; " + f"{report['kept']} section titles kept; " + f"{report['removed']} navigation-only entries removed" + ) + for conflict in report["conflicts"]: + out(f" Conflict: {conflict}") + for unmapped in report["unmapped"]: + out(f" Couldn't map: {unmapped}") + + if not keep_old: + for path in [base_file, *language_files, *nav_files]: + path.unlink() + out(f"Removed {path}") + + return True + + +def main(): + parser = ArgumentParser( + description=( + "Convert docs/config.yml, docs/mkdocs.<lang>.yml and the literate-nav " + "navigation file into docs/zensical.toml and docs/zensical.<lang>.toml." + ) + ) + parser.add_argument( + "-d", + "--docs-directory", + type=Path, + default=Path("docs"), + help="The documentation directory. Default: docs", + ) + parser.add_argument( + "--check", + action="store_true", + help="Check the conversion, but don't change any files.", + ) + parser.add_argument( + "--keep-old", + action="store_true", + help="Don't delete the original YAML and navigation files.", + ) + args = parser.parse_args() + + try: + success = convert( + args.docs_directory, write=not args.check, keep_old=args.keep_old + ) + except ConversionError as e: + print(f"Error: {e}", file=sys.stderr) + sys.exit(1) + sys.exit(0 if success else 1) + + +if __name__ == "__main__": + main() diff --git a/src/beeware_docs_tools/live_serve_en.py b/src/beeware_docs_tools/live_serve_en.py index a99d4712..4a9d09a1 100644 --- a/src/beeware_docs_tools/live_serve_en.py +++ b/src/beeware_docs_tools/live_serve_en.py @@ -1,109 +1,127 @@ -import http.client import subprocess -import threading -import time -import webbrowser +import sys from argparse import ArgumentParser, Namespace from pathlib import Path -from tempfile import TemporaryDirectory -from .md_tempdir import load_config, save_config, symlink_from_temp +from .build_config import ( + BASE_CONFIG, + SHARED_CONTENT_PATH, + clean_build_files, + language_config_name, + load_config, + work_path, + write_build_config, +) -# The theme overrides directory in config.yml is relative to the docs directory. -# Therefore, the live build expects there to be an overrides directory in the -# local docs directory. This script symlinks all the necessary directories and -# config files to a temp directory and serves the live build from the temp -# directory. +# This script generates the build configuration for the English documentation, +# and serves a live build of it. The English content is served directly from +# `docs/en`, so edits are picked up as they are made. PROJECT_PATH = Path.cwd() - - -def launch_browser(port: int, timeout: int = 30) -> None: - start_time = time.time() - while time.time() - start_time < timeout: - try: - conn = http.client.HTTPConnection("localhost", port, timeout=1) - try: - conn.request("HEAD", "/") - response = conn.getresponse() - # Mkdocs might return various 2xx or 3xx status codes when ready - if response.status < 400: - break - finally: - conn.close() - except (OSError, http.client.HTTPException): - time.sleep(0.1) - else: - print( - f"\nWarning: Live server did not come up on port {port} within {timeout} seconds. " - "Browser will not be launched automatically." - ) - return - - webbrowser.open(f"http://localhost:{port}/") +# The live server has its own working directory, so a build can run at the same +# time. +RUN = "live" def parse_args() -> Namespace: parser = ArgumentParser() - parser.add_argument("watch_directories", nargs="*") + parser.add_argument( + "watch_directories", + nargs="*", + help="Additional directories (relative to the project root) to watch for changes.", + ) parser.add_argument("--strict", action="store_true") + # Retained for compatibility. The API documentation source paths in the + # mkdocstrings configuration are resolved relative to the project root, so + # there's no longer any need to identify them separately. parser.add_argument("--source-code", action="append") parser.add_argument("--port", type=int, default=8037) + parser.add_argument( + "--no-open", + dest="open_browser", + action="store_false", + help="Don't open the live build in a web browser.", + ) args = parser.parse_args() return args -def serve_docs( - output_path: Path, - strict: bool, - watch_directories: list[str], +def watch_paths(project_path: Path, watch_directories: list[str]) -> list[Path]: + """The paths to watch for changes, in addition to the English content. + + :param project_path: The root of the project being documented. + :param watch_directories: Additional directories, relative to the project + root, to watch for changes. + """ + paths = [ + project_path / "docs" / BASE_CONFIG, + project_path / "docs" / language_config_name("en"), + SHARED_CONTENT_PATH / "en", + ] + paths.extend(project_path / directory for directory in watch_directories) + return [path for path in paths if path.exists()] + + +def serve_command( + config_file: Path, port: int, -) -> None: - serve_command = [ - "python", + strict: bool, + open_browser: bool, +) -> list[str]: + """The command used to serve the live build. + + :param config_file: The path to the build configuration file. + :param port: The port to serve on. + :param strict: If True, request strict mode. + :param open_browser: If True, open the live build in a web browser. + """ + command = [ + sys.executable, "-m", - "mkdocs", + "zensical", "serve", - "--clean", "--config-file", - str(output_path / "mkdocs.en.yml"), - "--watch", - "docs", + str(config_file), "--dev-addr", f"localhost:{port}", ] - if strict: - serve_command.append("--strict") + if open_browser: + command.append("--open") - for directory in watch_directories: - serve_command.extend(["--watch", directory]) + if strict: + command.append("--strict") - threading.Thread(target=launch_browser, args=(port,), daemon=True).start() - - subprocess.run( - serve_command, - check=True, - ) + return command def main(): args = parse_args() - with TemporaryDirectory() as temp_md_directory: - temp_md_path = Path(temp_md_directory) - - config = load_config(PROJECT_PATH) - symlink_from_temp(PROJECT_PATH, temp_md_path, args.source_code, config) - save_config(PROJECT_PATH, temp_md_path, config) - - (temp_md_path / "en").symlink_to( - PROJECT_PATH / "docs/en", - target_is_directory=True, + config = load_config(PROJECT_PATH, "en") + + try: + clean_build_files(PROJECT_PATH, ["en"], run=RUN) + config_file = write_build_config( + PROJECT_PATH, + config, + "en", + md_path=PROJECT_PATH / "docs/en", + shared_content_path=SHARED_CONTENT_PATH / "en", + site_path=work_path(PROJECT_PATH, RUN) / "site" / "en", + run=RUN, + watch=watch_paths(PROJECT_PATH, args.watch_directories), ) - serve_docs(temp_md_path, args.strict, args.watch_directories, args.port) + subprocess.run( + serve_command(config_file, args.port, args.strict, args.open_browser), + check=True, + ) + except KeyboardInterrupt: + pass + finally: + clean_build_files(PROJECT_PATH, ["en"], run=RUN) if __name__ == "__main__": diff --git a/src/beeware_docs_tools/md_tempdir.py b/src/beeware_docs_tools/md_tempdir.py deleted file mode 100644 index e22c04e2..00000000 --- a/src/beeware_docs_tools/md_tempdir.py +++ /dev/null @@ -1,155 +0,0 @@ -from importlib.metadata import metadata -from pathlib import Path - -import polib -import yaml - - -def load_config(project_path): - """Load the config.yml file, and add the version_number to extra.""" - - with (project_path / "docs/config.yml").open() as f: - config = yaml.load(f, Loader=yaml.SafeLoader) - - try: - version = metadata(config["extra"]["package_name"])["version"] - config["extra"]["version"] = version - except KeyError: - pass - - return config - - -def translate(po): - """Generate a translator function using the provided PO file.""" - - def _translate(entry): - po_entry = po.find(entry) - if po_entry: - translated = po_entry.msgstr - if translated: - return translated - return entry - - return _translate - - -def process_nav(entry, fn): - """Recursively walk a nav definition, calling a function on human-readable strings. - - :param entry: A node in a navigation tree - :param fn: A function that takes a single human-readable string, and returns - a "processed" string. - """ - if isinstance(entry, dict): - # Recursively translate all keys, and all list values. otherwise return - # values as is (as they will be a file reference) - return { - process_nav(child, fn): process_nav(value, fn) - if isinstance(value, list) - else value - for child, value in entry.items() - } - elif isinstance(entry, list): - # Recursively translate any dictionary in a list; - # otherwise return as-is (as it will be a file reference) - return [ - process_nav(child, fn) if isinstance(child, dict) else child - for child in entry - ] - else: - # The entry must be a string. Process it. - return fn(entry) - - -def save_config(project_path, temp_md_path, config, language="en"): - """Add the base_path to Snippets, and dump the updated copy to the temp directory""" - # Necessary so that it's available relative to the build. - - base_path = config["markdown_extensions"]["pymdownx.snippets"].get("base_path", []) - - contribution_root = config["extra"].get("contribution_guide_root") - - if language != "en": - shared_content_path = temp_md_path.resolve() / f"shared_content/{language}" - if contribution_root: - local_docs_path = temp_md_path.resolve() / language / contribution_root - else: - shared_content_path = (Path(__file__).parent / "shared_content/en").resolve() - if contribution_root: - local_docs_path = (project_path / "docs/en" / contribution_root).resolve() - - base_path.append(str(shared_content_path)) - config["markdown_extensions"]["pymdownx.snippets"]["base_path"] = base_path - config["plugins"]["macros"]["include_dir"] = [str(shared_content_path)] - if contribution_root: - config["plugins"]["macros"]["include_dir"].append(str(local_docs_path)) - - with (temp_md_path / "config.yml").open("w", encoding="utf-8") as config_f: - yaml.dump(config, config_f) - - # Build the language configuration into the temp directory. docs_dir and - # INHERIT paths are relative, so to build translations successfully while - # allowing English to build on its own, files must be available relative to - # the build. For the main website, we also need to generate a translated - # `nav` configuration. - if language != "en" and "nav" in config: - mkdocs_config = yaml.load( - (project_path / f"docs/mkdocs.{language}.yml").read_text(), - Loader=yaml.SafeLoader, - ) - - po = polib.pofile(project_path / f"docs/locales/{language}/translations.po") - mkdocs_config["nav"] = process_nav( - config["nav"], - translate(po), - ) - - mkdocs_config["plugins"] = { - "macros": {"include_yaml": [{"team": f"{language}/news/.authors.yml"}]} - } - - with (temp_md_path / f"mkdocs.{language}.yml").open( - "w", encoding="utf-8" - ) as mkdocs_f: - yaml.dump(mkdocs_config, mkdocs_f) - - else: - # On non-website builds, and for the English build of the website, we - # can symlink the original language configuraton. - (temp_md_path / f"mkdocs.{language}.yml").symlink_to( - project_path / f"docs/mkdocs.{language}.yml" - ) - - -def symlink_from_temp(project_path, temp_md_path, source_code, config): - """Symlink the relevant files so that they're available in the temp dir.""" - # If source code directory or directories provided, symlink from the temp directory, - # so it is available relative to the build. - if source_code: - for source in source_code: - # If source includes subdirectories, the parent directory must be created. - # If a single directory is provided, this will rely on `exists_ok=True` to - # avoid failing. - (temp_md_path / source).parent.mkdir(parents=True, exist_ok=True) - (temp_md_path / source).symlink_to( - project_path / source, target_is_directory=True - ) - - # Symlink the overrides directory from the temp directory, so it is available - # relative to the build. - (temp_md_path / "overrides").symlink_to( - Path(__file__).parent / "overrides", target_is_directory=True - ) - - # Symlink to the macros module, if there is one. - try: - module_name = config["plugins"]["macros"]["module_name"] - except KeyError: - module_name = "main" - - macros_path = project_path / f"docs/{module_name}.py" - symlink_path = temp_md_path / f"{module_name}.py" - if macros_path.is_file(): - symlink_path.parent.mkdir(parents=True, exist_ok=True) - symlink_path.symlink_to(macros_path) diff --git a/src/beeware_docs_tools/overrides/assets/stylesheets/beeware_theme.css b/src/beeware_docs_tools/overrides/assets/stylesheets/beeware_theme.css index 14a86526..53ac664a 100644 --- a/src/beeware_docs_tools/overrides/assets/stylesheets/beeware_theme.css +++ b/src/beeware_docs_tools/overrides/assets/stylesheets/beeware_theme.css @@ -211,6 +211,15 @@ input.md-search__input, .md-search__suggest, .md-search-result__meta { overflow-wrap: break-word; } +/* Zensical wraps the text of table of contents links in `.md-typeset`, which + its theme renders smaller, and without wrapping. Match the rest of the + sidebar. */ +.md-nav__link .md-typeset { + font-size: inherit; + line-height: inherit; + overflow-wrap: break-word; +} + /* Link colors */ /* Remove link color from section headers that are not links */ .md-nav__link[for]:focus, diff --git a/src/beeware_docs_tools/overrides/main.html b/src/beeware_docs_tools/overrides/main.html index 92bcea9a..b1a20208 100644 --- a/src/beeware_docs_tools/overrides/main.html +++ b/src/beeware_docs_tools/overrides/main.html @@ -22,6 +22,19 @@ {% extends "base.html" %} +{#- Zensical doesn't provide `page.is_homepage`, so the homepage would be titled + "<page title> - <site name>". Identify the homepage by its URL, so it's + titled with the site name only, as it was with Material for MkDocs. -#} +{% block htmltitle %} + {% if page.meta and page.meta.title %} + <title>{{ page.meta.title }} - {{ config.site_name }} + {% elif page.title and not (page.is_homepage or page.url == "") %} + {{ page.title | striptags }} - {{ config.site_name }} + {% else %} + {{ config.site_name }} + {% endif %} +{% endblock %} + {% block styles %} {{ super() }} diff --git a/src/beeware_docs_tools/overrides/partials/alternate.html b/src/beeware_docs_tools/overrides/partials/alternate.html index 2a8d174c..19af17d1 100644 --- a/src/beeware_docs_tools/overrides/partials/alternate.html +++ b/src/beeware_docs_tools/overrides/partials/alternate.html @@ -7,11 +7,17 @@ + {#- The (relative) URL of the root of this language's site, without a + trailing slash, and the URL of this page relative to that root. The + 404 page has no page URL. -#} + {%- set base = base_url -%} + {%- if base[-1:] == "/" %}{% set base = base[:-1] %}{% endif -%} + {%- set path = page.url if page and page.url else "" %}
    {% for alt in config.extra.alternate %}
  • - + {{ alt.name }}
    • diff --git a/src/beeware_docs_tools/overrides/partials/header.html b/src/beeware_docs_tools/overrides/partials/header.html index 3c0db859..f9c48334 100644 --- a/src/beeware_docs_tools/overrides/partials/header.html +++ b/src/beeware_docs_tools/overrides/partials/header.html @@ -136,14 +136,15 @@ {% endif %} - {% if "material/search" in config.plugins %} - {% set search = config.plugins["material/search"] | attr("config") %} + {% if "search" in config.plugins %} + {% set search = config.plugins["search"] | attr("config") %} {% if search.enabled %} diff --git a/src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md b/src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md index 5b73f5d7..4c1fa3e8 100644 --- a/src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md +++ b/src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md @@ -18,47 +18,46 @@ Once we have this info, we'll get you added to the team. If the language you plan to help out with doesn't already exist, there are some additional steps required before you can get started: -* Create the `/docs/mkdocs.language-code.yml` file, with language-specific content. +* Create the `/docs/zensical.language-code.toml` file, with language-specific content. * Update `tox.ini` to include the new language build commands. -* Update `/docs/config.yml` to include the language under `extra: alternate:`. +* Update `/docs/zensical.toml` to include the language in `extra.alternate`. The following demonstrates the necessary changes using German as an example; a German translation already exists; replace the references to German, `de`, or other content for the language you're targeting. -#### A new MkDocs configuration file - -First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content: - -```yaml -INHERIT: config.yml -site_name: {{ formal_name }} Dokumentation -site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %} -docs_dir: de - -theme: - language: de - -extra: - language_url: de/ - translation_type: machine - header: - About: Über - Documentation: Dokumentation - Community: Gemeinschaft - Contributing: Mitwirken - News: Neuigkeiten - Sponsor: Förderer +#### A new language configuration file + +First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content: + +```toml +[project] +site_name = "{{ formal_name }} Dokumentation" +docs_dir = "de" + +[project.theme] +language = "de" + +[project.extra] +language_url = "de/" +translation_type = "machine" + +[project.extra.header] +About = "Über" +Documentation = "Dokumentation" +Community = "Gemeinschaft" +Contributing = "Mitwirken" +News = "Neuigkeiten" +Sponsor = "Förderer" ``` Here's what is going on in this file: -* This file inherits the configuration content from `config.yml`. +* The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included. * The `site_name` value is translated. -* The `site_url` value is the project site URL, followed by the language code. * The `docs_dir` should be the language code. -* The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme](https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/). For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences. -* The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German. -* The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%. -* The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation). +* The `theme.language` value should be the language code, as [specified by the Zensical theme](https://zensical.org/docs/setup/language/). For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences. +* The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German. +* The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%. +* The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation). #### Update `tox.ini` @@ -73,14 +72,12 @@ You would add the following: * A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code. * The new language code to the line beginning with `all:`. -#### Update `config.yml` +#### Update `zensical.toml` -Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following: +Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following: -```yaml - - name: Deutsch - link: /de/ - lang: de +```toml + { name = "Deutsch", link = "/de/", lang = "de" }, ``` The language name should be translated into the language. The link must include the `/`s. diff --git a/src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md b/src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md index 7ac9c7e7..b34df889 100644 --- a/src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md +++ b/src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md @@ -14,17 +14,18 @@ If you're adding a new document, there are a few more steps involved. You'll need to create the document in the appropriate location within the `docs/en` directory. For discussion, we'll say you're adding a new document with the filename `new_doc.md`. -Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example: - -```markdown -- ./path/to/directory/* +Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example: + +```toml +nav = [ + { "Existing section" = [ + { "Existing document" = "path/to/existing_doc.md" }, + { "My new document" = "path/to/new_doc.md" }, + ] }, +] ``` -If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example: - -```markdown -- [My new document](new_doc.md) -``` +The titles in the `nav` setting are translated along with the rest of the documentation. ### Writing your documentation diff --git a/tests/test_build_config.py b/tests/test_build_config.py new file mode 100644 index 00000000..6380fdf5 --- /dev/null +++ b/tests/test_build_config.py @@ -0,0 +1,359 @@ +import tomllib + +import polib +import pytest + +from beeware_docs_tools.build_config import ( + OVERRIDES_PATH, + build_config_path, + canonical_url, + clean_build_files, + load_config, + merge_config, + merge_include_dirs, + unexpected_language_keys, + work_path, + write_build_config, +) +from beeware_docs_tools.build_md_translations import copy_resources + + +def test_merge_config(): + """Tables are merged recursively; lists and scalars are replaced.""" + base = { + "site_name": "Base", + "theme": {"name": "material", "features": ["a", "b"]}, + "extra": {"alternate": [1, 2]}, + } + override = { + "site_name": "Override", + "theme": {"language": "fr", "features": ["c"]}, + } + + merged = merge_config(base, override) + + assert merged == { + "site_name": "Override", + "theme": {"name": "material", "features": ["c"], "language": "fr"}, + "extra": {"alternate": [1, 2]}, + } + # The base configuration isn't modified. + assert base["theme"] == {"name": "material", "features": ["a", "b"]} + + +def test_unexpected_language_keys(): + """Only per-language settings are expected in a language file.""" + assert ( + unexpected_language_keys( + { + "site_name": "Docs", + "docs_dir": "fr", + "theme": {"language": "fr", "direction": "ltr"}, + "extra": { + "language_url": "fr/", + "translation_type": "machine", + "header": {"About": "À propos"}, + }, + } + ) + == [] + ) + # An empty header table is allowed. + assert unexpected_language_keys({"extra": {"header": {}}}) == [] + assert unexpected_language_keys( + {"site_url": "https://example.com", "theme": {"features": ["x"]}} + ) == ["site_url", "theme.features"] + + +@pytest.mark.parametrize( + "env, expected", + [ + ({}, None), + ( + {"READTHEDOCS_CANONICAL_URL": "https://example.com/en/stable/"}, + "https://example.com/en/stable/", + ), + ( + { + "READTHEDOCS": "True", + "READTHEDOCS_PROJECT": "toga", + "READTHEDOCS_VERSION": "latest", + "READTHEDOCS_LANGUAGE": "fr", + }, + "https://toga.readthedocs.io/fr/latest/", + ), + ({"READTHEDOCS": "True"}, None), + ], +) +def test_canonical_url(env, expected): + """The canonical URL comes from Read the Docs, if available.""" + assert canonical_url(env) == expected + + +def make_project(path, base, language_files): + docs = path / "docs" + (docs / "en").mkdir(parents=True) + (docs / "zensical.toml").write_text(base, encoding="utf-8") + for language, content in language_files.items(): + (docs / f"zensical.{language}.toml").write_text(content, encoding="utf-8") + return path + + +BASE = """\ +[project] +nav = [{ "Home" = "index.md" }, { "Section" = ["section/index.md"] }] + +[project.extra] +package_name = "this-package-does-not-exist" +contribution_guide_root = "how-to/contribute" + +[project.theme] +features = ["a"] + +[project.markdown_extensions] +pymdownx.snippets.base_path = ["docs"] +pymdownx.snippets.check_paths = true + +[project.plugins.macros] +include_yaml = { team = "en/news/.authors.yml" } + +[project.plugins.mkdocstrings.handlers.python] +paths = ["src"] +""" + + +def test_load_config(tmp_path): + """The language file is merged over the base configuration.""" + project = make_project( + tmp_path, + BASE, + {"en": '[project]\nsite_name = "Docs"\ndocs_dir = "en"\n'}, + ) + + config = load_config(project, "en", env={}) + + assert config["site_name"] == "Docs" + assert config["docs_dir"] == "en" + assert config["theme"]["features"] == ["a"] + assert "site_url" not in config + + +def test_load_config_site_url(tmp_path): + """The site URL is set from the environment, unless it's configured.""" + env = {"READTHEDOCS_CANONICAL_URL": "https://example.com/"} + project = make_project( + tmp_path, + BASE, + { + "en": '[project]\nsite_name = "Docs"\n', + "fr": '[project]\nsite_name = "Docs"\nsite_url = "https://fr.example.com/"\n', + }, + ) + + assert load_config(project, "en", env=env)["site_url"] == "https://example.com/" + with pytest.warns(UserWarning, match="sets 'site_url'"): + config = load_config(project, "fr", env=env) + assert config["site_url"] == "https://fr.example.com/" + + +def test_load_config_unexpected_key(tmp_path): + """A setting that isn't a per-language setting produces a warning.""" + project = make_project( + tmp_path, + BASE, + {"fr": '[project]\nsite_name = "Docs"\n[project.theme]\nfeatures = ["b"]\n'}, + ) + + with pytest.warns(UserWarning, match="sets 'theme.features'.*replaces"): + config = load_config(project, "fr", env={}) + + # The setting is still applied. + assert config["theme"]["features"] == ["b"] + + +def test_merge_include_dirs(tmp_path): + """Include directories are merged; the first directory wins.""" + first = tmp_path / "first" + second = tmp_path / "second" + (first / "how").mkdir(parents=True) + (second / "how").mkdir(parents=True) + (first / "how/branches.md").write_text("first", encoding="utf-8") + (second / "how/branches.md").write_text("second", encoding="utf-8") + (second / "how/local.md").write_text("local", encoding="utf-8") + (first / "_shared").mkdir() + (first / "_shared/content.md").write_text("shared", encoding="utf-8") + + target = tmp_path / "merged" + merge_include_dirs([first, second], target) + + assert (target / "how/branches.md").read_text(encoding="utf-8") == "first" + assert (target / "how/local.md").read_text(encoding="utf-8") == "local" + assert (target / "_shared/content.md").read_text(encoding="utf-8") == "shared" + assert (target / "how/branches.md").is_symlink() + + +def test_write_build_config(tmp_path): + """The build configuration includes the location of the build content.""" + project = make_project( + tmp_path, + BASE, + {"en": '[project]\nsite_name = "Docs"\ndocs_dir = "en"\n'}, + ) + shared = tmp_path / "shared" + shared.mkdir() + config = load_config(project, "en", env={}) + + config_file = write_build_config( + project, + config, + "en", + md_path=project / "docs/en", + shared_content_path=shared, + site_path=work_path(project) / "site/en", + ) + + assert config_file == build_config_path(project, "en") + with config_file.open("rb") as f: + written = tomllib.load(f)["project"] + + assert written["docs_dir"] == "en" + assert written["site_dir"] == "_build/build/site/en" + assert written["theme"]["custom_dir"] == str(OVERRIDES_PATH.resolve()) + snippets = written["markdown_extensions"]["pymdownx"]["snippets"] + assert snippets == { + "base_path": ["docs", str(shared.resolve())], + "check_paths": True, + } + macros = written["plugins"]["macros"] + assert macros["include_dir"] == str((work_path(project) / "includes/en").resolve()) + # The English data files aren't changed. + assert macros["include_yaml"] == {"team": "en/news/.authors.yml"} + assert written["plugins"]["mkdocstrings"]["handlers"]["python"]["paths"] == [ + str((project / "src").resolve()) + ] + assert written["nav"] == [{"Home": "index.md"}, {"Section": ["section/index.md"]}] + # mkdocstrings uses the theme language for its labels. + assert written["plugins"]["mkdocstrings"]["locale"] == "en" + # The classic theme variant is used, and macro errors fail the build. + assert written["theme"]["variant"] == "classic" + assert macros["on_error_fail"] is True + + clean_build_files(project, ["en"]) + assert not config_file.exists() + assert not (project / "docs/_build").exists() + + +def test_build_and_live_are_separate(tmp_path): + """A build and a live server use separate files.""" + assert build_config_path(tmp_path, "en") == tmp_path / "docs/_build.en.toml" + assert build_config_path(tmp_path, "en", "live") == ( + tmp_path / "docs/_build.live.en.toml" + ) + live = work_path(tmp_path, "live") + (live / "site").mkdir(parents=True) + (work_path(tmp_path) / "site").mkdir(parents=True) + + clean_build_files(tmp_path, ["en"]) + + # The live server's files are untouched. + assert live.is_dir() + assert not work_path(tmp_path).exists() + + +def test_write_build_config_translation(tmp_path): + """A translated build uses translated content, data files and navigation.""" + project = make_project( + tmp_path, + BASE.replace( + 'pymdownx.snippets.base_path = ["docs"]', + '"pymdownx.snippets".base_path = ["docs"]', + ) + .replace("pymdownx.snippets.check_paths", '"pymdownx.snippets".check_paths') + .replace('features = ["a"]', 'features = ["a"]\nvariant = "modern"') + .replace( + "[project.plugins.macros]\n", + "[project.plugins.macros]\non_error_fail = false\n", + ), + {"fr": '[project]\nsite_name = "Documents"\ndocs_dir = "fr"\n'}, + ) + po = polib.POFile() + po.append(polib.POEntry(msgid="Home", msgstr="Accueil")) + po.append(polib.POEntry(msgid="Section", msgstr="")) + (project / "docs/locales/fr").mkdir(parents=True) + po.save(str(project / "docs/locales/fr/translations.po")) + md_path = work_path(project) / "md/fr" + md_path.mkdir(parents=True) + config = load_config(project, "fr", env={}) + + config_file = write_build_config( + project, + config, + "fr", + md_path=md_path, + shared_content_path=tmp_path, + site_path=work_path(project) / "site/fr", + ) + with config_file.open("rb") as f: + written = tomllib.load(f)["project"] + + assert written["docs_dir"] == "_build/build/md/fr" + # Explicit settings aren't overridden. + assert written["theme"]["variant"] == "modern" + assert written["plugins"]["macros"]["on_error_fail"] is False + # The quoted key form of the extension is preserved. + assert written["markdown_extensions"]["pymdownx.snippets"]["base_path"] == [ + "docs", + str(tmp_path.resolve()), + ] + assert "pymdownx" not in written["markdown_extensions"] + assert written["plugins"]["macros"]["include_yaml"] == { + "team": "_build/build/md/fr/news/.authors.yml" + } + assert written["nav"] == [ + {"Accueil": "index.md"}, + {"Section": ["section/index.md"]}, + ] + clean_build_files(project, ["fr"]) + + +def test_copy_resources(tmp_path): + """The non-Markdown files of the English content are copied to a translation.""" + en = tmp_path / "en" + fr = tmp_path / "fr" + for name in [ + "index.md", + "images/logo.png", + "reference/images/diagram.svg", + "reference/canvas-images/canvas.png", + "reference/resources/index.md", + "reference/resources/icon.png", + "news/.authors.yml", + "news/.team.yml", + "stylesheets/extra.css", + ".DS_Store", + ]: + (en / name).parent.mkdir(parents=True, exist_ok=True) + (en / name).write_text(name, encoding="utf-8") + # po2md has already generated the translated Markdown, including in a + # content directory named `resources`. + (fr / "reference/resources").mkdir(parents=True) + (fr / "index.md").write_text("translated", encoding="utf-8") + (fr / "reference/resources/index.md").write_text("translated", encoding="utf-8") + + copied = copy_resources(en, fr) + + assert sorted(str(p) for p in copied) == [ + "images/logo.png", + "news/.authors.yml", + "news/.team.yml", + "reference/canvas-images/canvas.png", + "reference/images/diagram.svg", + "reference/resources/icon.png", + "stylesheets/extra.css", + ] + # Files are real copies, not symlinks. + assert not (fr / "images/logo.png").is_symlink() + assert (fr / "images/logo.png").read_text(encoding="utf-8") == "images/logo.png" + # Translated Markdown isn't overwritten. + assert (fr / "index.md").read_text(encoding="utf-8") == "translated" + assert not (fr / ".DS_Store").exists() diff --git a/tests/test_convert_mkdocs_config.py b/tests/test_convert_mkdocs_config.py new file mode 100644 index 00000000..cace73a0 --- /dev/null +++ b/tests/test_convert_mkdocs_config.py @@ -0,0 +1,314 @@ +import tomllib + +import polib +import pytest + +from beeware_docs_tools.build_config import load_config +from beeware_docs_tools.convert_mkdocs_config import ( + ConversionError, + compare_configs, + convert, + extract_comments, + toml_key, + toml_string, +) + +CONFIG_YML = """\ +# yaml-language-server: $schema=https://squidfunk.github.io/mkdocs-material/schema.json +copyright: Someone + +not_in_nav: | + /index.md + +extra: + project_name: example # The name of the project + alternate: + - name: English + link: /en/ + lang: en + +theme: + name: material + features: + - navigation.tabs + palette: + # Light mode + - media: "(prefers-color-scheme: light)" + scheme: default + toggle: + icon: material/brightness-7 + name: Switch to dark mode + +markdown_extensions: + - attr_list + - toc: + permalink: true + - pymdownx.highlight: {} # Highlights code + - pymdownx.emoji: + emoji_index: !!python/name:material.extensions.emoji.twemoji + - pymdownx.blocks.admonition: + types: + - note + - markdown.extensions.smarty: + smart_quotes: false + +plugins: + - search + - literate-nav: + nav_file: SUMMARY.md + - macros: + on_error_fail: true +""" + +MKDOCS_EN_YML = """\ +INHERIT: config.yml +site_name: Example +site_url: !ENV READTHEDOCS_CANONICAL_URL +docs_dir: en + +theme: + language: en +""" + +MKDOCS_FR_YML = """\ +INHERIT: config.yml +site_name: Exemple +site_url: !ENV READTHEDOCS_CANONICAL_URL +docs_dir: fr + +theme: + language: fr + +extra: + language_url: fr/ +""" + +SUMMARY_MD = """\ +- [Home](index.md) +- Guide + - [Guide](guide/index.md) + - ./guide/* +- Reference + + - [Reference](reference/index.md) + - [API](reference/api.md) +""" + + +@pytest.fixture +def project(tmp_path, monkeypatch): + monkeypatch.delenv("READTHEDOCS_CANONICAL_URL", raising=False) + monkeypatch.delenv("READTHEDOCS", raising=False) + docs = tmp_path / "docs" + (docs / "en/guide").mkdir(parents=True) + (docs / "en/reference").mkdir(parents=True) + (docs / "config.yml").write_text(CONFIG_YML, encoding="utf-8") + (docs / "mkdocs.en.yml").write_text(MKDOCS_EN_YML, encoding="utf-8") + (docs / "mkdocs.fr.yml").write_text(MKDOCS_FR_YML, encoding="utf-8") + (docs / "en/SUMMARY.md").write_text(SUMMARY_MD, encoding="utf-8") + for page in [ + "index.md", + "guide/index.md", + "guide/b.md", + "guide/a.md", + "reference/index.md", + "reference/api.md", + ]: + (docs / "en" / page).write_text(f"# {page}\n", encoding="utf-8") + + po = polib.POFile(wrapwidth=100000) + po.metadata = {"Content-Type": "text/plain; charset=UTF-8"} + for msgid, msgstr, flags in [ + ("[Home]{1}", "[Accueil]{1}", ["fuzzy"]), + ("Guide", "Guide FR", []), + ("[Guide]{1}", "[Le guide]{1}", []), + ("./guide/*", "./guide/*", []), + ("[Reference]{1}", "[Référence]{1}", []), + ("[API]{1}", "", []), + ]: + po.append( + polib.POEntry( + msgid=msgid, + msgstr=msgstr, + flags=flags, + occurrences=[("docs/en/SUMMARY.md", "1")], + ) + ) + po.append( + polib.POEntry( + msgid="Reference", + msgstr="", + occurrences=[("docs/en/reference/index.md", "1")], + ) + ) + (docs / "locales/fr").mkdir(parents=True) + po.save(str(docs / "locales/fr/translations.po")) + + monkeypatch.chdir(tmp_path) + return tmp_path + + +def test_convert(project): + """A project is converted, and the converted configuration is equivalent.""" + messages = [] + assert convert(project / "docs", out=messages.append) + docs = project / "docs" + + output = "\n".join(messages) + assert "en: the converted configuration is equivalent" in output + assert "fr: the converted configuration is equivalent" in output + + # The original files have been removed. + assert not (docs / "config.yml").exists() + assert not (docs / "mkdocs.en.yml").exists() + assert not (docs / "en/SUMMARY.md").exists() + + text = (docs / "zensical.toml").read_text(encoding="utf-8") + base = tomllib.loads(text)["project"] + + # The navigation is resolved, including wildcards; HTML comments are + # removed from titles, and kept as TOML comments. + assert base["nav"] == [ + {"Home": "index.md"}, + {"Guide": [{"Guide": "guide/index.md"}, "guide/a.md", "guide/b.md"]}, + { + "Reference": [ + {"Reference": "reference/index.md"}, + {"API": "reference/api.md"}, + ] + }, + ] + assert "# A comment about the reference" in text + assert "literate-nav" not in base["plugins"] + assert list(base["plugins"]) == ["search", "macros"] + assert "[project.plugins.search]" in text + + # Markdown extensions use dotted keys, with Python names as strings. + assert "pymdownx.highlight = {} # Highlights code" in text + assert 'pymdownx.emoji.emoji_index = "zensical.extensions.emoji.twemoji"' in text + assert '"markdown.extensions.smarty".smart_quotes = false' in text + assert "toc.permalink = true" in text + + # Comments are carried over, except YAML editor directives. + assert "yaml-language-server" not in text + assert 'project_name = "example" # The name of the project' in text + assert "# Light mode\n[[project.theme.palette]]" in text + assert 'toggle.icon = "material/brightness-7"' in text + + # The language files only contain the language settings. + fr = tomllib.loads((docs / "zensical.fr.toml").read_text(encoding="utf-8")) + assert fr == { + "project": { + "site_name": "Exemple", + "docs_dir": "fr", + "theme": {"language": "fr"}, + "extra": {"language_url": "fr/"}, + } + } + + # The result can be loaded. + config = load_config(project, "fr", env={}) + assert config["site_name"] == "Exemple" + assert config["theme"]["features"] == ["navigation.tabs"] + + +def test_convert_translations(project): + """Navigation title translations are migrated to plain titles.""" + messages = [] + assert convert(project / "docs", out=messages.append) + + po = polib.pofile(str(project / "docs/locales/fr/translations.po")) + entries = {entry.msgid: entry for entry in po if not entry.obsolete} + + # Link titles become plain titles, keeping their flags. + assert entries["Home"].msgstr == "Accueil" + assert entries["Home"].fuzzy + assert entries["Home"].occurrences == [("docs/en/titles.md", "")] + # An existing plain title (a section title) keeps its translation. + assert entries["Guide"].msgstr == "Guide FR" + # An existing, untranslated entry (a page heading) is filled in, and keeps + # its own source reference. + assert entries["Reference"].msgstr == "Référence" + assert ("docs/en/reference/index.md", "1") in entries["Reference"].occurrences + # An untranslated link title becomes an untranslated plain title. + assert entries["API"].msgstr == "" + # Entries that were only used by the navigation file are removed. + assert not any("{1}" in msgid for msgid in entries) + assert "./guide/*" not in entries + + output = "\n".join(messages) + assert "Conflict: 'Guide': kept 'Guide FR', not 'Le guide'" in output + + +def test_check_doesnt_write(project): + """In check mode, nothing is changed.""" + messages = [] + assert convert(project / "docs", write=False, out=messages.append) + assert (project / "docs/config.yml").exists() + assert not (project / "docs/zensical.toml").exists() + + +def test_keep_old(project): + """The original files can be kept.""" + assert convert(project / "docs", keep_old=True, out=lambda msg: None) + assert (project / "docs/config.yml").exists() + assert (project / "docs/en/SUMMARY.md").exists() + assert (project / "docs/zensical.toml").exists() + + +def test_unsupported_env(project): + """!ENV can only be used for site_url.""" + config = project / "docs/config.yml" + config.write_text( + config.read_text(encoding="utf-8") + "repo_url: !ENV REPO_URL\n", + encoding="utf-8", + ) + with pytest.raises(ConversionError, match="repo_url uses !ENV"): + convert(project / "docs", out=lambda msg: None) + + +def test_compare_configs_detects_differences(): + """Unintended differences are reported.""" + old = { + "site_name": "A", + "plugins": {"search": None}, + "markdown_extensions": ["toc"], + "theme": {"features": ["a", "b"]}, + } + new = { + "site_name": "A", + "plugins": {"search": {}}, + "markdown_extensions": {"toc": {}}, + "theme": {"features": ["a"]}, + } + diffs, _ = compare_configs(old, new, set(), set()) + assert diffs == ["theme.features: ['a', 'b'] became ['a']"] + + +def test_extract_comments(): + """Comments are attached to the setting they describe.""" + comments, unplaced = extract_comments( + "# Before a\na: 1 # After a\nb:\n # Before c\n - c # After c\n# Dangling\n" + ) + assert comments[("a",)] == {"before": ["Before a"], "trailing": "After a"} + assert comments[("b", 0)] == {"before": ["Before c"], "trailing": "After c"} + assert unplaced == ["Dangling"] + + +@pytest.mark.parametrize( + "value, expected", + [ + ("simple", '"simple"'), + ('quote " and \\ backslash', '"quote \\" and \\\\ backslash"'), + ("line\nbreak\n", '"""\nline\nbreak\n"""'), + ], +) +def test_toml_string(value, expected): + assert toml_string(value) == expected + assert tomllib.loads(f"x = {expected}")["x"] == value + + +def test_toml_key(): + assert toml_key("bare_key-1") == "bare_key-1" + assert toml_key("needs quotes") == '"needs quotes"' + assert toml_key("multi\nline") == '"multi\\nline"' diff --git a/tests/test_live_serve.py b/tests/test_live_serve.py index c51e5aae..cc88879c 100644 --- a/tests/test_live_serve.py +++ b/tests/test_live_serve.py @@ -1,85 +1,47 @@ -from unittest.mock import MagicMock, patch - -from beeware_docs_tools.live_serve_en import launch_browser - - -class TestLaunchBrowser: - @patch("beeware_docs_tools.live_serve_en.webbrowser.open") - @patch("beeware_docs_tools.live_serve_en.http.client.HTTPConnection") - def test_launch_browser_success(self, mock_http_connection, mock_webbrowser_open): - mock_conn = MagicMock() - mock_response = MagicMock() - mock_response.status = 200 - mock_conn.getresponse.return_value = mock_response - mock_http_connection.return_value = mock_conn - - launch_browser(8000, timeout=1) - - mock_webbrowser_open.assert_called_once_with("http://localhost:8000/") - mock_conn.request.assert_called_once_with("HEAD", "/") - mock_conn.getresponse.assert_called_once() - mock_conn.close.assert_called_once() - - @patch("beeware_docs_tools.live_serve_en.webbrowser.open") - @patch("beeware_docs_tools.live_serve_en.http.client.HTTPConnection") - @patch("beeware_docs_tools.live_serve_en.time.sleep") - def test_launch_browser_connection_refused_then_success( - self, mock_sleep, mock_http_connection, mock_webbrowser_open - ): - mock_conn = MagicMock() - mock_response = MagicMock() - mock_response.status = 200 - - # First call raises OSError, second call succeeds - mock_conn.getresponse.side_effect = [OSError(), mock_response] - mock_http_connection.return_value = mock_conn - - launch_browser(8000, timeout=1) - - mock_webbrowser_open.assert_called_once_with("http://localhost:8000/") - assert mock_conn.request.call_count == 2 - assert mock_conn.getresponse.call_count == 2 - # It should have slept once after the first failure - mock_sleep.assert_called_once_with(0.1) - - @patch("beeware_docs_tools.live_serve_en.webbrowser.open") - @patch("beeware_docs_tools.live_serve_en.http.client.HTTPConnection") - @patch("beeware_docs_tools.live_serve_en.time.sleep") - @patch("beeware_docs_tools.live_serve_en.time.time") - def test_launch_browser_timeout( - self, mock_time, mock_sleep, mock_http_connection, mock_webbrowser_open - ): - mock_conn = MagicMock() - mock_conn.getresponse.side_effect = OSError() - mock_http_connection.return_value = mock_conn - - # Simulate time passing to trigger timeout immediately on second iteration - mock_time.side_effect = [0, 0, 1] - - launch_browser(8000, timeout=1) - - mock_webbrowser_open.assert_not_called() - mock_sleep.assert_called_once_with(0.1) - - @patch("beeware_docs_tools.live_serve_en.webbrowser.open") - @patch("beeware_docs_tools.live_serve_en.http.client.HTTPConnection") - @patch("beeware_docs_tools.live_serve_en.time.sleep") - def test_launch_browser_server_error( - self, mock_sleep, mock_http_connection, mock_webbrowser_open - ): - mock_conn = MagicMock() - mock_response = MagicMock() - mock_response.status = 503 # Server error, shouldn't break loop - mock_success_response = MagicMock() - mock_success_response.status = 200 - - mock_conn.getresponse.side_effect = [mock_response, mock_success_response] - mock_http_connection.return_value = mock_conn - - launch_browser(8000, timeout=1) - - mock_webbrowser_open.assert_called_once_with("http://localhost:8000/") - assert mock_conn.request.call_count == 2 - assert ( - mock_sleep.call_count == 0 - ) # we no longer sleep on 503, only on exception +import sys +from pathlib import Path + +from beeware_docs_tools.live_serve_en import serve_command, watch_paths + + +def test_serve_command(): + """The live server is started with Zensical, on the requested port.""" + command = serve_command( + Path("/project/docs/_build.en.toml"), 8037, strict=False, open_browser=True + ) + assert command == [ + sys.executable, + "-m", + "zensical", + "serve", + "--config-file", + "/project/docs/_build.en.toml", + "--dev-addr", + "localhost:8037", + "--open", + ] + + +def test_serve_command_no_open_strict(): + """The browser can be suppressed, and strict mode requested.""" + command = serve_command( + Path("/project/docs/_build.en.toml"), 9000, strict=True, open_browser=False + ) + assert "--open" not in command + assert command[-1] == "--strict" + assert "localhost:9000" in command + + +def test_watch_paths(tmp_path): + """Configuration files and requested directories are watched, if they exist.""" + (tmp_path / "docs").mkdir() + (tmp_path / "docs/zensical.toml").write_text("[project]\n", encoding="utf-8") + (tmp_path / "docs/zensical.en.toml").write_text("[project]\n", encoding="utf-8") + (tmp_path / "src").mkdir() + + paths = watch_paths(tmp_path, ["src", "missing"]) + + assert tmp_path / "docs/zensical.toml" in paths + assert tmp_path / "docs/zensical.en.toml" in paths + assert tmp_path / "src" in paths + assert tmp_path / "missing" not in paths diff --git a/tox.ini b/tox.ini index 6d49e310..c681d9fe 100644 --- a/tox.ini +++ b/tox.ini @@ -12,6 +12,7 @@ commands = pre-commit run --all-files --show-diff-on-failure --color=always package = wheel wheel_build_env = .pkg depends: pre-commit +extras = convert dependency_groups = test commands = python -X warn_default_encoding -m pytest {posargs:-vv --color yes} @@ -28,9 +29,6 @@ templates_dir = {tox_root}{/}docs{/}locales{/}templates # Docs are always built on Python 3.13. See also the RTD config. base_python = py313 skip_install = true -setenv = - DISABLE_MKDOCS_2_WARNING = true - NO_MKDOCS_2_WARNING = 1 passenv = DEEPL_API_KEY READTHEDOCS_CANONICAL_URL From 8e57c7338064ea409855d0c1cb6811c582ff8563 Mon Sep 17 00:00:00 2001 From: Kattni Date: Thu, 5 Nov 2026 22:05:33 -0500 Subject: [PATCH 2/5] Pin mkdocs explicitly, noting it's only needed by mkdocstrings. --- pyproject.toml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/pyproject.toml b/pyproject.toml index d4043fad..28b74baf 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -27,6 +27,10 @@ dependencies = [ "deepl==1.32.0", "markdown-checker==1.2.2", "mistletoe==1.6.0", + # Not used to build the docs; Zensical does that. Required because mkdocstrings + # (API docs) imports MkDocs at runtime. Remove once Zensical's native API docs + # replace mkdocstrings. + "mkdocs==1.6.1", "mkdocs-autorefs==1.4.5", "mkdocs-rss-plugin==1.19.0", "mkdocstrings-python==2.0.10", From 87dbc69a24ec643732523b6dd0c3a520123112ac Mon Sep 17 00:00:00 2001 From: Kattni Date: Thu, 5 Nov 2026 22:35:37 -0500 Subject: [PATCH 3/5] Preserve translations, and fix translated builds, in the Zensical migration. - Give navigation titles their own translation context ("navigation"), so they keep the translations they had in SUMMARY.md instead of sharing one with page headings of the same text. Untranslated navigation entries are seeded from previous translations, so other repos keep theirs on their next translation run. - Re-migrate docs-tools' nav-title translations from main: all 760 now match what main displayed. - Port existing translations of the strings that changed in this migration (style guide, translation guide, test bed), applying the same substitutions; human translations whose meaning changed are kept and marked for review. - Keep mkdocstrings API directives out of the translation catalogs, and restore them after po2md, which mangles their options blocks. - Give translated builds their own site_url (with the language directory), fixing their canonical links, sitemaps and 404 pages. - Refer to Zensical in the style guide. - Drop mkdocs-rss-plugin; Zensical handles RSS natively. --- docs/en/section_one/page_two.md | 4 + docs/locales/ar/translations.po | 271 +++++++++++------ docs/locales/cs/translations.po | 271 +++++++++++------ docs/locales/da/translations.po | 271 +++++++++++------ docs/locales/de/translations.po | 271 +++++++++++------ docs/locales/es/translations.po | 271 +++++++++++------ docs/locales/fa/translations.po | 272 +++++++++++------ docs/locales/fr/translations.po | 271 +++++++++++------ docs/locales/it/translations.po | 271 +++++++++++------ docs/locales/ja/translations.po | 271 +++++++++++------ docs/locales/ko/translations.po | 271 +++++++++++------ docs/locales/pl/translations.po | 271 +++++++++++------ docs/locales/pt/translations.po | 271 +++++++++++------ docs/locales/ru/translations.po | 271 +++++++++++------ docs/locales/ta/translations.po | 271 +++++++++++------ docs/locales/tr/translations.po | 271 +++++++++++------ docs/locales/uk/translations.po | 272 +++++++++++------ docs/locales/vi/translations.po | 271 +++++++++++------ docs/locales/zh_CN/translations.po | 271 +++++++++++------ docs/locales/zh_TW/translations.po | 271 +++++++++++------ docs/spelling_wordlist | 2 + pyproject.toml | 1 - src/beeware_docs_tools/api_directives.py | 158 ++++++++++ src/beeware_docs_tools/build_config.py | 35 ++- .../build_md_translations.py | 6 + .../build_po_translations.py | 8 + .../build_pot_translations.py | 35 ++- .../convert_mkdocs_config.py | 127 +++----- src/beeware_docs_tools/nav_translations.py | 120 ++++++++ .../contribute/style/docs-style-guide.md | 22 +- .../en/_shared/contribute/what/write-docs.md | 2 +- .../shared_content/locales/ar/translations.po | 279 ++++++++--------- .../shared_content/locales/cs/translations.po | 278 ++++++++--------- .../shared_content/locales/da/translations.po | 279 ++++++++--------- .../shared_content/locales/de/translations.po | 280 ++++++++--------- .../shared_content/locales/es/translations.po | 278 ++++++++--------- .../shared_content/locales/fa/translations.po | 280 ++++++++--------- .../shared_content/locales/fr/translations.po | 282 ++++++++---------- .../shared_content/locales/it/translations.po | 281 ++++++++--------- .../shared_content/locales/ja/translations.po | 279 ++++++++--------- .../shared_content/locales/ko/translations.po | 279 ++++++++--------- .../shared_content/locales/pl/translations.po | 279 ++++++++--------- .../shared_content/locales/pt/translations.po | 278 ++++++++--------- .../shared_content/locales/ru/translations.po | 279 ++++++++--------- .../shared_content/locales/ta/translations.po | 279 ++++++++--------- .../shared_content/locales/tr/translations.po | 279 ++++++++--------- .../shared_content/locales/uk/translations.po | 279 ++++++++--------- .../shared_content/locales/vi/translations.po | 276 ++++++++--------- .../locales/zh_CN/translations.po | 281 ++++++++--------- .../locales/zh_TW/translations.po | 279 ++++++++--------- tests/test_api_blocks.py | 218 ++++++++++++++ tests/test_build_config.py | 44 +++ tests/test_convert_mkdocs_config.py | 41 +-- tests/test_nav_translations.py | 93 ++++++ 54 files changed, 6659 insertions(+), 4712 deletions(-) create mode 100644 src/beeware_docs_tools/api_directives.py create mode 100644 src/beeware_docs_tools/nav_translations.py create mode 100644 tests/test_api_blocks.py create mode 100644 tests/test_nav_translations.py diff --git a/docs/en/section_one/page_two.md b/docs/en/section_one/page_two.md index 98f1b293..7f42819e 100644 --- a/docs/en/section_one/page_two.md +++ b/docs/en/section_one/page_two.md @@ -10,7 +10,11 @@ The following should show the reference documentation for the `DocsTest` class, Verify that the text in the parameter table is rendering at the same size as the rest of the font. +The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation. + ::: beeware_docs_tools.docs_test.DocsTest + options: + show_root_heading: true ## Macro functionality diff --git a/docs/locales/ar/translations.po b/docs/locales/ar/translations.po index e0978869..50b1a10d 100644 --- a/docs/locales/ar/translations.po +++ b/docs/locales/ar/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "القسم الأول" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "منصة اختبار المحتوى المشترك" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "أدلة إرشادية" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "ساهم" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "ماذا يمكنني أن أفعل؟" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "كيف يمكنني المساهمة؟" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "ماذا سيحدث بعد ذلك؟" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "السياسات" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "أدلة الأسلوب" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "يتم تضمين هذا الملف فقط لتلبية متطلبات msgid "First-time contributors" msgstr "المساهمون لأول مرة" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "المساهمون لأول مرة" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "وثائق البناء" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "وثائق البناء" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "إعداد بيئة التطوير" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "إعداد بيئة التطوير" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "إرسال مشكلة جديدة" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "إرسال مشكلة جديدة" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "اقتراح ميزة جديدة" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "اقتراح ميزة جديدة" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "إذا كنت مهتمًا، يمكنك البدء في [تنفيذ ال msgid "Reproducing an issue" msgstr "إعادة إنتاج مشكلة" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "إعادة إنتاج إصدار" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "تجنب توسع نطاق العمل" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "تجنب توسع النطاق" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "تقديم طلب سحب" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "إرسال طلب سحب" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "ترجمة المحتوى" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "ترجمة المحتوى" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "كتابة الكود وتشغيله واختباره" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "كتابة وتشغيل واختبار الكود" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "بمجرد أن تصبح كل شيء جاهزًا للعمل، يمكن msgid "Writing documentation" msgstr "كتابة الوثائق" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "كتابة الوثائق" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "دليل أسلوب الكود" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "دليل أسلوب الكود" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "دليل أسلوب التوثيق" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "دليل أسلوب التوثيق" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "بالنسبة إلى `style_guide.md`, يمكنك إضافة `-8<- \"style_guide.md\"` إلى `style_guide_include.md`." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "قم بتحديث القسم `Shared content test bed` في `/docs/SUMMARY.md` لتضمين الملف `_include` الجديد والمسار، بنفس مستوى المسافة البادئة للعناصر الأخرى في هذا القسم." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "بالنسبة إلى `style_guide_include.md`, يمكنك إضافة `- [Style guide](content_test_bed/style_guide_include.md)`." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "بالنسبة إلى `style_guide_include.md`, يمكنك إضافة `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "قائمة مراجعة الموضوع" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "تم تصميم هذا العرض التوضيحي لاختبار الميزات المختلفة لتجاوزات سمة BeeWare MkDocs Material. يرجى قراءة وتحقق من أن كل ما هو مدرج في هذه الصفحة والصفحات التالية موجود ويعمل كما هو موضح في الوصف." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "تم تصميم هذا العرض التوضيحي لاختبار الميزات المختلفة لتجاوزات سمة BeeWare Zensical. يرجى قراءة وتحقق من أن كل ما هو مدرج في هذه الصفحة والصفحات التالية موجود ويعمل كما هو موضح في الوصف." #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "روابط الشريط الجانبي" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "توجد روابط في الشريط الجانبي، وتشير إلى مستودع `beeware-docs-tools`. وهذا يؤكد أن محتوى الشريط الجانبي قد تم تحميله، وأن `project-name` قد تم تعيينه في ملف تكوين MkDocs، وأن رقم الإصدار قد تم حسابه وإضافته." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "توجد روابط في الشريط الجانبي، وتشير إلى مستودع `beeware-docs-tools`. وهذا يؤكد أن محتوى الشريط الجانبي قد تم تحميله، وأن `project-name` قد تم تعيينه في ملف تكوين Zensical، وأن رقم الإصدار قد تم حسابه وإضافته." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "أضف `nopage` إلى نهاية عنوان URL في متصفحك للتحقق من وجود صفحة 404، والتي تتضمن النص \"Brutus لا يمكنه العثور على ما تبحث عنه\". لا تعرض صفحة 404 الحالية الصور دائمًا بسبب مشكلة في MkDocs." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*تفشل عمليات إنشاء MkDocs مع الروابط الداخلية غير المعترف بها، لذا عليك التحقق يدويًا من ذلك عن طريق تعديل عنوان URL في متصفحك.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "تحقق من أن النص في جدول المعلمات يتم عرضه بنفس حجم باقي الخط." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "وظائف الماكرو" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "يجب أن يكون النص التالي \"Brutus says \"Hello world!\"\". وهذا يؤكد أن المتغيرات العالمية والماكروات المحددة عبر MkDocs-Macros متاحة." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} يقول \"{{ say_hello() }}\"" @@ -888,92 +917,164 @@ msgstr "`autoref` ربط" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "الرابط الموجود هنا سيأخذك إلى قسم [خط العنوان][heading-font] في الصفحة الرئيسية. تم تضمينه للتحقق من ارتباط `autoref`." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "القسم الأول" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "القسم الأول - الصفحة الثانية" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "القسم الثاني" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "القسم الثالث" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "منصة اختبار المحتوى المشترك" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "أدلة إرشادية" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "ساهم" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "المساهمة" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "ماذا يمكنني أن أفعل؟" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "إصلاح مشكلة" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "تنفيذ ميزة جديدة" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "كتابة الوثائق" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "تصنيف مشكلة" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "مراجعة طلب سحب" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "اقتراح ميزة جديدة" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "ترجمة المحتوى" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "استخدم الأدوات" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "كيف يمكنني المساهمة؟" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "العمل من فرع" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "إضافة ملاحظة تغيير" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "تقديم مراجعة" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "ماذا سيحدث بعد ذلك؟" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "عملية مراجعة طلب السحب" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "عملية الإصدار" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "السياسات" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "سياسة الذكاء الاصطناعي" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "أدلة الأسلوب" diff --git a/docs/locales/cs/translations.po b/docs/locales/cs/translations.po index c479acf2..096155d8 100644 --- a/docs/locales/cs/translations.po +++ b/docs/locales/cs/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "První část" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Testovací prostředí sdíleného obsahu" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Návody" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Přispějte" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "Co mohu dělat?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "Jak mohu přispět?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "Co se stane dál?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Zásady" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Stylové příručky" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Tento soubor je zahrnut pouze proto, aby vyhověl odkazu v souboru `code msgid "First-time contributors" msgstr "První přispěvatelé" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "První přispěvatelé" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Stavební dokumentace" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Stavební dokumentace" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Nastavení vývojového prostředí" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Nastavení vývojového prostředí" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Odeslání nového problému" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Odeslání nového problému" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Návrh nové funkce" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Návrh nové funkce" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "Pokud máte zájem, můžete začít [implementovat svou novou funkci]{1 msgid "Reproducing an issue" msgstr "Reprodukce problému" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Reprodukce problému" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Vyhýbání se rozšiřování rozsahu" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Vyhýbání se rozšiřování rozsahu projektu" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Odeslání žádosti o stažení" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Odeslání žádosti o stažení" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "Překlad obsahu" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "Překlad obsahu" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Psaní, spouštění a testování kódu" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Psaní, spouštění a testování kódu" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "Jakmile máte vše funkční, můžete [odeslat žádost o stažení]{1} msgid "Writing documentation" msgstr "Psaní dokumentace" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Psaní dokumentace" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Pravidla pro styl kódu" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Pravidla pro styl kódu" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Pravidla pro styl dokumentace" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Pravidla pro styl dokumentace" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "Pro `style_guide.md` byste přidali `-8<- \"style_guide.md\"` do `style_guide_include.md`." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "Aktualizujte sekci `Shared content test bed` v `/docs/SUMMARY.md` tak, aby obsahovala nový soubor `_include` a cestu, na stejné úrovni odsazení jako ostatní položky v této sekci." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "Pro `style_guide_include.md` byste přidali `- [Style guide](content_test_bed/style_guide_include.md)`." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "Pro `style_guide_include.md` byste přidali `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "Kontrolní seznam témat" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "Toto demo je určeno k testování různých funkcí přepsání motivu BeeWare MkDocs Material. Přečtěte si prosím a ověřte, zda vše uvedené na této a následujících stránkách je přítomno a funguje tak, jak je popsáno v popisu." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "Toto demo je určeno k testování různých funkcí přepsání motivu BeeWare Zensical. Přečtěte si prosím a ověřte, zda vše uvedené na této a následujících stránkách je přítomno a funguje tak, jak je popsáno v popisu." #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "Odkazy v postranním panelu" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "Odkazy v postranním panelu existují a odkazují na repozitář `beeware-docs-tools`. To potvrzuje, že obsah postranního panelu byl načten, že `project-name` bylo nastaveno v konfiguračním souboru MkDocs a že číslo verze bylo vypočítáno a přidáno." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "Odkazy v postranním panelu existují a odkazují na repozitář `beeware-docs-tools`. To potvrzuje, že obsah postranního panelu byl načten, že `project-name` bylo nastaveno v konfiguračním souboru Zensical a že číslo verze bylo vypočítáno a přidáno." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Přidejte `nopage` na konec adresy URL ve svém prohlížeči, abyste ověřili, že stránka 404 existuje a obsahuje text „Brutus nemůže najít to, co hledáte“. Aktuální stránka 404 kvůli problému s MkDocs ne vždy zobrazuje obrázky." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*MkDocs selže při vytváření neznámých interních odkazů, proto je nutné tuto kontrolu ručně ověřit úpravou URL adresy v prohlížeči.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Ověřte, zda se text v tabulce parametrů vykresluje ve stejné velikosti jako zbytek písma." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Makro funkce" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "Následující text by měl znít „Brutus říká ‚Ahoj světe!‘“. Tím se potvrzuje, že globální proměnné a makra definovaná pomocí MkDocs-Macros jsou k dispozici." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} říká „{{ say_hello() }}“" @@ -888,92 +917,164 @@ msgstr "`autoref` propojení" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Odkaz uvedený zde by vás měl přesměrovat do sekce [Heading font][heading-font] hlavní stránky. Je zde uveden za účelem ověření fungování odkazů `autoref`." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Část první" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Část první – strana druhá" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "Část druhá" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Část třetí" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Testovací prostředí sdíleného obsahu" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Návody" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Přispějte" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Přispívání" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "Co mohu dělat?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Opravit problém" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Implementovat novou funkci" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Napsat dokumentaci" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Třídění problému" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Zkontrolujte žádost o stažení" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Navrhnout novou funkci" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "Přeložit obsah" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Použijte nástroje" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "Jak mohu přispět?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Práce z pobočky" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Přidání poznámky o změně" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "Poskytnutí recenze" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "Co se stane dál?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Proces kontroly žádostí o stažení" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Proces uvolnění" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Zásady" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "Politika v oblasti umělé inteligence" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Stylové příručky" diff --git a/docs/locales/da/translations.po b/docs/locales/da/translations.po index 1fc95991..fd961bcc 100644 --- a/docs/locales/da/translations.po +++ b/docs/locales/da/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "Afsnit 1" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Testplatform for delt indhold" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Vejledninger" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Bidrag" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "Hvad kan jeg gøre?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "Hvordan kan jeg bidrage?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "Hvad sker der nu?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Retningslinjer" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Stilguider" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Denne fil er udelukkende inkluderet for at opfylde linket i `code_contri msgid "First-time contributors" msgstr "Førstegangsbidragere" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "Førstegangsbidragere" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Bygningsdokumentation" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Bygningsdokumentation" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Opsætning af et udviklingsmiljø" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Opsætning af et udviklingsmiljø" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Indsendelse af et nyt problem" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Indsendelse af et nyt problem" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Forslag til en ny funktion" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Forslag til en ny funktion" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "Hvis du er interesseret, kan du begynde at [implementere din nye funktio msgid "Reproducing an issue" msgstr "Gengivelse af et problem" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Gengivelse af et problem" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Undgå scope creep" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Undgå scope creep" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Indsendelse af en pull-anmodning" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Indsendelse af en pull-anmodning" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "Oversættelse af indhold" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "Oversættelse af indhold" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Skrivning, kørsel og test af kode" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Skrivning, kørsel og test af kode" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "Når alt fungerer, kan du [indsende en pull-anmodning]{1} med dine ændr msgid "Writing documentation" msgstr "Skrivning af dokumentation" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Skrivning af dokumentation" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Kode-stilguide" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Kode-stilguide" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Dokumentationsstilguide" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Dokumentationsstilguide" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "For `style_guide.md` skal du tilføje `-8<- \"style_guide.md\"` til `style_guide_include.md`." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "Opdater afsnittet `Shared content test bed` i `/docs/SUMMARY.md` for at inkludere den nye `_include` fil og sti, på samme indrykningsniveau som de andre elementer i det pågældende afsnit." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "For `style_guide_include.md` skal du tilføje `- [Style guide](content_test_bed/style_guide_include.md)`." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "For `style_guide_include.md` skal du tilføje `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "Tema-tjekliste" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "Denne demo er designet til at teste de forskellige funktioner i BeeWare MkDocs Material-temaets overstyringer. Læs venligst igennem og kontroller, at alt, hvad der er angivet på denne og de følgende sider, er til stede og fungerer som beskrevet." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "Denne demo er designet til at teste de forskellige funktioner i BeeWare Zensical-temaets overstyringer. Læs venligst igennem og kontroller, at alt, hvad der er angivet på denne og de følgende sider, er til stede og fungerer som beskrevet." #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "Links i sidepanelet" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "Der findes links i sidepanelet, som peger på `beeware-docs-tools` repo. Dette bekræfter, at indholdet i sidepanelet er blevet indlæst, og at `project-name` er blevet indstillet i MkDocs-konfigurationsfilen, og at versionsnummeret er beregnet og tilføjet." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "Der findes links i sidepanelet, som peger på `beeware-docs-tools` repo. Dette bekræfter, at indholdet i sidepanelet er blevet indlæst, og at `project-name` er blevet indstillet i Zensical-konfigurationsfilen, og at versionsnummeret er beregnet og tilføjet." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Tilføj `nopage` til slutningen af URL'en i din browser for at kontrollere, at 404-siden findes, og at den indeholder teksten \"Brutus kan ikke finde det, du leder efter\". Den nuværende 404-side viser ikke altid billederne på grund af et problem med MkDocs." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*MkDocs-kompileringer mislykkes med ukendte interne links, så du skal manuelt verificere denne kontrol ved at ændre URL'en i din browser.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Kontroller, at teksten i parametertabellen vises i samme størrelse som resten af skrifttypen." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Makrofunktionalitet" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "Følgende skal sige 'Brutus siger \"Hej verden!\"'. Dette bekræfter, at globale variabler og makroer defineret via MkDocs-Macros er tilgængelige." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} siger \"{{ say_hello() }}\"" @@ -888,92 +917,164 @@ msgstr "`autoref` sammenkædning" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Det link, der er angivet her, skal føre dig til afsnittet [Heading font][heading-font] på hovedsiden. Det er inkluderet for at verificere `autoref` linking." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 #, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Afsnit 1" + +#: docs/en/titles.md:7 +#, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Afsnit 1 – side 2" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "Afsnit to" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Afsnit tre" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 +#, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Testplatform for delt indhold" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Vejledninger" + +#: docs/en/titles.md:19 #, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Bidrag" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Bidragende" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "Hvad kan jeg gøre?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Løs et problem" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Implementer en ny funktion" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Skriv dokumentation" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Prioriter et problem" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Gennemgå en pull-anmodning" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Foreslå en ny funktion" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "Oversæt indhold" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Brug værktøjerne" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "Hvordan kan jeg bidrage?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Arbejde fra en gren" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Tilføjelse af en ændringsnote" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "Giver en anmeldelse" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "Hvad sker der nu?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Gennemgang af pull-anmodninger" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Frigivelsesproces" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Retningslinjer" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "AI-politik" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Stilguider" diff --git a/docs/locales/de/translations.po b/docs/locales/de/translations.po index 3e5c8a9c..27c2558f 100644 --- a/docs/locales/de/translations.po +++ b/docs/locales/de/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "Abschnitt eins" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Testumgebung für gemeinsam genutzte Inhalte" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Anleitungen" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Beitragen" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "Was kann ich tun?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "Wie kann ich einen Beitrag leisten?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "Wie geht es weiter?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Richtlinien" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Style Guides" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Diese Datei ist nur enthalten, um den Link in der Datei `code_contributi msgid "First-time contributors" msgstr "Erstmalige Beitragszahler" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "Erstmalige Beitragszahler" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Bauunterlagen" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Gebäudedokumentation" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Einrichten einer Entwicklungsumgebung" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Einrichten einer Entwicklungsumgebung" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Einreichen einer neuen Ausgabe" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Einreichung einer neuen Ausgabe" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Vorschlag für eine neue Funktion" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Vorschlag für ein neues Merkmal" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "Wenn Sie Interesse haben, können Sie mit der [Implementierung Ihrer neu msgid "Reproducing an issue" msgstr "Reproduzieren eines Problems" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Reproduzieren einer Ausgabe" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Vermeidung der schleichenden Ausweitung des Umfangs" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Vermeidung der schleichenden Ausweitung des Geltungsbereichs" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Einreichen einer Pull-Anfrage" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Einen Pull-Request einreichen" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -233,6 +236,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "Inhalte übersetzen" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "Inhalt übersetzen" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -242,6 +251,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Schreiben, Ausführen und Testen von Code" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Schreiben, Ausführen und Testen von Code" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -261,6 +276,12 @@ msgstr "Sobald Sie alles zum Laufen gebracht haben, können Sie [einen Pull-Requ msgid "Writing documentation" msgstr "Dokumentation schreiben" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Dokumentation schreiben" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -311,6 +332,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Code style guide" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Guide Style Code" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -320,6 +347,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Documentation style guide" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Documentation style guide" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -422,14 +455,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "Für `style_guide.md` würden Sie `-8<- \"style_guide.md\"` zu `style_guide_include.md` hinzufügen." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "Aktualisieren Sie den Abschnitt `Shared content test bed` in `/docs/SUMMARY.md`, um die neue `_include` Datei und den Pfad auf der gleichen Einrückungsebene wie die anderen Elemente in diesem Abschnitt aufzunehmen." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "Für `style_guide_include.md` würden Sie `- [Style guide](content_test_bed/style_guide_include.md)` hinzufügen." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "Für `style_guide_include.md` würden Sie `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },` hinzufügen." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -448,8 +480,8 @@ msgstr "Themen-Checkliste" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "Diese Demo wurde entwickelt, um die verschiedenen Funktionen der BeeWare MkDocs Material-Themenüberschreibungen zu testen. Bitte lesen Sie sie durch und überprüfen Sie, ob alles, was auf dieser und den folgenden Seiten aufgeführt ist, vorhanden ist und wie in der Beschreibung beschrieben funktioniert." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "Diese Demo wurde entwickelt, um die verschiedenen Funktionen der BeeWare Zensical-Themenüberschreibungen zu testen. Bitte lesen Sie sie durch und überprüfen Sie, ob alles, was auf dieser und den folgenden Seiten aufgeführt ist, vorhanden ist und wie in der Beschreibung beschrieben funktioniert." #: docs/en/index.md:7 #, fuzzy @@ -592,8 +624,8 @@ msgstr "Links in der Seitenleiste" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "Sidebar-Links sind vorhanden und verweisen auf das \"beeware-docs-tools\"-Repositorium. Dies bestätigt, dass der Inhalt der Seitenleiste geladen wurde und der \"Projektname\" in der MkDocs-Konfigurationsdatei gesetzt wurde, und die Versionsnummer wird berechnet und hinzugefügt." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "Sidebar-Links sind vorhanden und verweisen auf das \"beeware-docs-tools\"-Repositorium. Dies bestätigt, dass der Inhalt der Seitenleiste geladen wurde und der \"Projektname\" in der Zensical-Konfigurationsdatei gesetzt wurde, und die Versionsnummer wird berechnet und hinzugefügt." #: docs/en/index.md:82 #, fuzzy @@ -681,9 +713,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Fügen Sie `nopage` am Ende der URL in Ihrem Browser ein, um zu überprüfen, ob die 404-Seite existiert und den Text \"Brutus kann nicht finden, wonach Sie suchen\" enthält. Die aktuelle 404-Seite zeigt die Bilder aufgrund eines Problems mit MkDocs nicht immer an." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*MkDocs-Builds schlagen bei nicht erkannten internen Links fehl, so dass Sie diese Prüfung manuell überprüfen müssen, indem Sie die URL in Ihrem Browser ändern." +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -830,21 +861,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Überprüfen Sie, ob der Text in der Parametertabelle in derselben Größe wie der Rest der Schriftart dargestellt wird." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Makro-Funktionalität" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "Im Folgenden sollte 'Brutus sagt \"Hallo Welt!\"' stehen. Dies bestätigt, dass globale Variablen und Makros, die über MkDocs-Macros definiert wurden, verfügbar sind." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} sagt \"{{ say_hello() }}\"" @@ -894,92 +923,164 @@ msgstr "`autoref`-Verknüpfung" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Der hier angegebene Link sollte Sie zum Abschnitt [Überschrift-Schriftart][heading-font] auf der Hauptseite führen. Er ist enthalten, um die `autoref`-Verknüpfung zu überprüfen." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Abschnitt eins" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Abschnitt eins - Seite zwei" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "Abschnitt zwei" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Abschnitt drei" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Testumgebung für gemeinsam genutzte Inhalte" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Anleitungen" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Beitragen" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Mitwirkend" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "Was kann ich tun?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Ein Problem beheben" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Implementierung einer neuen Funktion" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Dokumentation schreiben" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Triage eines Problems" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Eine Pull-Anfrage überprüfen" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Vorschlag für ein neues Merkmal" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "Inhalt übersetzen" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Benutze die Werkzeuge" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "Wie kann ich einen Beitrag leisten?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Von einer Verzweigung aus arbeiten" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Hinzufügen einer Änderungsnotiz" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "Bereitstellung einer Rezension" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "Wie geht es weiter?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Pull-Request-Überprüfungsprozess" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Freigabeprozess" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Richtlinien" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "KI-Richtlinie" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Style Guides" diff --git a/docs/locales/es/translations.po b/docs/locales/es/translations.po index 88b2749e..f5643366 100644 --- a/docs/locales/es/translations.po +++ b/docs/locales/es/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "Sección uno" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Banco de pruebas de contenido compartido" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Guías prácticas" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Contribuir" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "¿Qué puedo hacer?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "¿Cómo puedo contribuir?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "¿Qué pasa después?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Políticas" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Guías de estilo" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Este archivo se incluye únicamente para satisfacer el enlace en el arch msgid "First-time contributors" msgstr "Colaboradores por primera vez" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "Colaboradores nuevos" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Documentación de la construcción" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Documentación del edificio" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Configuración de un entorno de desarrollo" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Configuración de un entorno de desarrollo" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Enviar un nuevo problema" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Enviar un nuevo problema" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Proponer una nueva función" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Propuesta de una nueva función" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "Si estás interesado, puedes comenzar a [implementar tu nueva función]{ msgid "Reproducing an issue" msgstr "Reproducción de un problema" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Reproducción de un problema" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Evitar la desviación del alcance" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Evitar la desviación del alcance" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Enviar una solicitud de extracción" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Enviar una solicitud de extracción" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "Traducción de contenidos" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "Traducir contenido" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Escribir, ejecutar y probar código." +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Escribir, ejecutar y probar código" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "Una vez que todo funcione correctamente, puedes [enviar una solicitud de msgid "Writing documentation" msgstr "Redacción de documentación" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Redacción de documentación" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Guía de estilo de código" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Guía de estilo de código" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Guía de estilo para la documentación" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Guía de estilo para la documentación" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "Para `style_guide.md`, añadirías `-8<- \"style_guide.md\"` a `style_guide_include.md`." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "Actualiza la sección `Shared content test bed` en `/docs/SUMMARY.md` para incluir el nuevo archivo `_include` y la ruta, con el mismo nivel de sangría que los demás elementos de esa sección." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "Para `style_guide_include.md`, añadirías `- [Style guide](content_test_bed/style_guide_include.md)`." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "Para `style_guide_include.md`, añadirías `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "Lista de verificación del tema" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "Esta demostración está diseñada para probar las diversas características de las modificaciones del tema BeeWare MkDocs Material. Lea detenidamente y compruebe que todo lo que aparece en esta página y en las siguientes está presente y funciona tal y como se detalla en la descripción." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "Esta demostración está diseñada para probar las diversas características de las modificaciones del tema BeeWare Zensical. Lea detenidamente y compruebe que todo lo que aparece en esta página y en las siguientes está presente y funciona tal y como se detalla en la descripción." #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "Enlaces de la barra lateral" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "Existen enlaces en la barra lateral que apuntan al repositorio `beeware-docs-tools`. Esto confirma que se ha cargado el contenido de la barra lateral, que se ha configurado `project-name` en el archivo de configuración de MkDocs y que se ha calculado y añadido el número de versión." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "Existen enlaces en la barra lateral que apuntan al repositorio `beeware-docs-tools`. Esto confirma que se ha cargado el contenido de la barra lateral, que se ha configurado `project-name` en el archivo de configuración de Zensical y que se ha calculado y añadido el número de versión." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Añade `nopage` al final de la URL en tu navegador para verificar que la página 404 existe e incluye el texto «Brutus no puede encontrar lo que estás buscando». La página 404 actual no siempre muestra las imágenes debido a un problema con MkDocs." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*MkDocs falla al compilar enlaces internos no reconocidos, por lo que es necesario verificar manualmente esta comprobación modificando la URL en el navegador.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Comprueba que el texto de la tabla de parámetros se muestra con el mismo tamaño que el resto de la fuente." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Funcionalidad macro" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "Lo siguiente debería decir «Brutus dice \"¡Hola mundo!\"». Esto confirma que las variables globales y las macros definidas a través de MkDocs-Macros están disponibles." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} dice «{{ say_hello() }}»." @@ -888,92 +917,164 @@ msgstr "`autoref` enlace" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "El enlace que se proporciona aquí debería llevarte a la sección [Fuente del encabezado][heading-font] de la página principal. Se incluye para verificar el enlace `autoref`." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Sección uno" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Sección uno - página dos" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "Sección dos" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Sección tres" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Banco de pruebas de contenido compartido" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Guías prácticas" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Contribuir" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Contribuir" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "¿Qué puedo hacer?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Solucionar un problema" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Implementar una nueva función" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Escribir documentación" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Clasificar un problema" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Revisar una solicitud de incorporación de cambios" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Proponer una nueva función" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "Traducir contenido" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Utilice las herramientas" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "¿Cómo puedo contribuir?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Trabajar desde una rama" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Añadir una nota de cambio" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "Proporcionar una reseña" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "¿Qué pasa después?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Proceso de revisión de solicitudes de incorporación de cambios" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Proceso de liberación" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Políticas" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "Política de IA" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Guías de estilo" diff --git a/docs/locales/fa/translations.po b/docs/locales/fa/translations.po index c103e0d3..fa2e5a25 100644 --- a/docs/locales/fa/translations.po +++ b/docs/locales/fa/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "بخش اول" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "محیط آزمایشی محتوای مشترک" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "راهنمای چگونگی انجام" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "مشارکت کنید" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "چه کار می‌توانم بکنم؟" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "چگونه مشارکت کنم؟" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "بعد چه می‌شود؟" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "سیاست‌ها" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "راهنماهای سبک" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "این فایل صرفاً برای برآورده کردن لینک د msgid "First-time contributors" msgstr "مشارکت‌کنندگان تازه‌کار" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "نخستین مشارکت‌کنندگان" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "مستندسازی ساختمان" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "مستندسازی ساختمان" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "راه‌اندازی محیط توسعه" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "راه‌اندازی محیط توسعه" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "ارسال یک مشکل جدید" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "ارسال یک مشکل جدید" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "پیشنهاد یک ویژگی جدید" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "پیشنهاد یک ویژگی جدید" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "اگر علاقه‌مند هستید، می‌توانید [پیاده msgid "Reproducing an issue" msgstr "تولید مجدد یک مشکل" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "بازتولید یک شماره" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "اجتناب از گسترش دامنه" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "اجتناب از گسترش دامنه" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "ارسال یک درخواست برداشت" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "ارسال یک درخواست ادغام" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "ترجمه‌ی محتوا" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "محتوای در حال ترجمه" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "نوشتن، اجرا و تست کد" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "نوشتن، اجرا و تست کد" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "وقتی همه چیز به درستی کار کرد، می‌توانی msgid "Writing documentation" msgstr "نوشتن مستندات" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "نوشتن مستندات" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "راهنمای سبک کدنویسی" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "راهنمای سبک کد" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "راهنمای سبک مستندسازی" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "راهنمای سبک مستندسازی" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "برای `style_guide.md`، شما `-8<- \"style_guide.md\"` را به `style_guide_include.md` اضافه می‌کنید." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "بخش `Shared content test bed` را در `/docs/SUMMARY.md` به‌روزرسانی کنید تا فایل و مسیر جدید `_include` را شامل شود و هم‌سطح با سایر موارد در آن بخش باشد." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "برای `style_guide_include.md`، شما `- [Style guide](content_test_bed/style_guide_include.md)` را اضافه می‌کنید." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "برای `style_guide_include.md`، شما `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },` را اضافه می‌کنید." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -444,9 +476,8 @@ msgid "Theme checklist" msgstr "فهرست موضوعات" #: docs/en/index.md:5 -#, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "این دمو برای آزمایش ویژگی‌های مختلف overrideهای تم Material در BeeWare MkDocs طراحی شده است. لطفاً آن را مطالعه کرده و تأیید کنید که همه موارد فهرست‌شده در این صفحه و صفحات بعدی موجود بوده و مطابق توضیحات کار می‌کنند." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "" #: docs/en/index.md:7 #, fuzzy @@ -589,8 +620,8 @@ msgstr "پیوندهای نوار کناری" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "پیوندهای نوار کناری وجود دارند و به مخزن `beeware-docs-tools` اشاره می‌کنند. این تأیید می‌کند که محتوای نوار کناری بارگذاری شده است، `project-name` در فایل پیکربندی MkDocs تنظیم شده است و شماره نسخه محاسبه و اضافه شده است." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "پیوندهای نوار کناری وجود دارند و به مخزن `beeware-docs-tools` اشاره می‌کنند. این تأیید می‌کند که محتوای نوار کناری بارگذاری شده است، `project-name` در فایل پیکربندی Zensical تنظیم شده است و شماره نسخه محاسبه و اضافه شده است." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +706,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "در انتهای آدرس اینترنتی در مرورگر خود `nopage` را اضافه کنید تا مطمئن شوید صفحهٔ خطای ۴۰۴ وجود دارد و شامل متن «بروتوس نمی‌تواند آنچه را که به دنبالش هستید پیدا کند» است. صفحهٔ ۴۰۴ فعلی به دلیل مشکلی در MkDocs همیشه تصاویر را نمایش نمی‌دهد." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "ساخت MkDocs با لینک‌های داخلی ناشناخته با شکست مواجه می‌شود، بنابراین باید این بررسی را با تغییر آدرس URL در مرورگر خود به‌صورت دستی تأیید کنید." +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +854,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "تأیید کنید که متن در جدول پارامترها با همان اندازهٔ سایر قسمت‌های قلم نمایش داده می‌شود." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "کارکرد ماکرو" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "خروجی زیر باید عبارت «Brutus می‌گوید \"Hello world!\"» را نمایش دهد. این تأیید می‌کند که متغیرهای سراسری و ماکروهای تعریف‌شده از طریق MkDocs-Macros در دسترس هستند." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} می‌گوید «{{ say_hello() }}»" @@ -888,92 +916,164 @@ msgstr "لینک‌گذاری" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "لینک ارائه‌شده در اینجا باید شما را به بخش [Heading font][heading-font] صفحهٔ اصلی هدایت کند. این لینک برای تأیید پیوند `autoref` گنجانده شده است." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "بخش اول" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "بخش یک - صفحه دو" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "بخش دوم" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "بخش سوم" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "محیط آزمایشی محتوای مشترک" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "راهنمای چگونگی انجام" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "مشارکت کنید" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "مشارکت‌کننده" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "چه کار می‌توانم بکنم؟" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "رفع یک مشکل" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "پیاده‌سازی یک ویژگی جدید" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "مستندسازی بنویسید" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "اولویت‌بندی یک مسئله" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "بررسی یک درخواست کشش" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "پیشنهاد یک ویژگی جدید" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "محتوا را ترجمه کنید" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "ابزارها را استفاده کنید" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "چگونه مشارکت کنم؟" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "کار کردن از یک شعبه" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "افزودن یادداشت تغییر" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "ارائه یک نقد" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "بعد چه می‌شود؟" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "فرآیند بازبینی درخواست کشش" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "فرآیند انتشار" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "سیاست‌ها" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "سیاست‌گذاری هوش مصنوعی" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "راهنماهای سبک" diff --git a/docs/locales/fr/translations.po b/docs/locales/fr/translations.po index 8ceb89ae..b6966748 100644 --- a/docs/locales/fr/translations.po +++ b/docs/locales/fr/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "Section un" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Banc d'essai pour contenu partagé" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Guides pratiques" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Contribuer" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "Que puis-je faire ?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "Comment puis-je contribuer ?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "Que se passe-t-il ensuite ?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Politiques" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Style guides" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Ce fichier est inclus uniquement pour satisfaire le lien dans le fichier msgid "First-time contributors" msgstr "Premiers contributeurs" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "Premiers contributeurs" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Documentation sur les bâtiments" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Documentation sur le bâtiment" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -133,6 +100,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Mise en place d'un environnement de développement" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Mise en place d'un environnement de développement" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -142,6 +115,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Soumettre un nouveau numéro" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Soumission d'un nouveau numéro" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -151,6 +130,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Proposer une nouvelle fonctionnalité" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Proposer une nouvelle fonctionnalité" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -165,6 +150,12 @@ msgstr "Si vous êtes intéressé, vous pouvez commencer à [mettre en œuvre vo msgid "Reproducing an issue" msgstr "Reproduire un problème" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Reproduire un problème" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -193,6 +184,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Éviter les dérives" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Éviter les dérives du champ d'application" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -202,6 +199,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Soumettre une demande d'extraction" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Soumettre une demande d'extraction" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -236,6 +239,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "Traduire le contenu" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "Traduction du contenu" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -245,6 +254,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Rédiger, exécuter et tester le code" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Écrire, exécuter et tester le code" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -264,6 +279,12 @@ msgstr "Une fois que tout fonctionne, vous pouvez [soumettre une demande d'extra msgid "Writing documentation" msgstr "Rédaction de la documentation" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Documentation écrite" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -314,6 +335,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Code style guide" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Code style guide" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -323,6 +350,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Documentation style guide" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Documentation style guide" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -425,14 +458,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "Pour `style_guide.md`, vous devez ajouter `-8<- \"style_guide.md\"`à `style_guide_include.md`." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "Mettre à jour la section `Shared content test bed` dans `/docs/SUMMARY.md` pour inclure le nouveau fichier `_include` et le chemin, au même niveau d'indentation que les autres éléments de cette section." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "Pour `style_guide_include.md`, vous devez ajouter `- [Style guide](content_test_bed/style_guide_include.md)`." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "Pour `style_guide_include.md`, vous devez ajouter `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -451,8 +483,8 @@ msgstr "Liste de contrôle des thèmes" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "Cette démo est conçue pour tester les différentes caractéristiques des surcharges du thème MkDocs Material de BeeWare. Veuillez lire et vérifier que tout ce qui est listé sur cette page et les suivantes est présent et fonctionne comme indiqué dans la description." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "Cette démo est conçue pour tester les différentes caractéristiques des surcharges du thème Zensical de BeeWare. Veuillez lire et vérifier que tout ce qui est listé sur cette page et les suivantes est présent et fonctionne comme indiqué dans la description." #: docs/en/index.md:7 #, fuzzy @@ -595,8 +627,8 @@ msgstr "Liens dans la barre latérale" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "Les liens sidebar existent, et pointent vers le repo `beeware-docs-tools`. Cela confirme que le contenu de la barre latérale a été chargé, que le `project-name` a été défini dans le fichier de configuration de MkDocs, et que le numéro de version est calculé et ajouté." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "Les liens sidebar existent, et pointent vers le repo `beeware-docs-tools`. Cela confirme que le contenu de la barre latérale a été chargé, que le `project-name` a été défini dans le fichier de configuration de Zensical, et que le numéro de version est calculé et ajouté." #: docs/en/index.md:82 #, fuzzy @@ -684,9 +716,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Ajoutez `nopage` à la fin de l'URL dans votre navigateur pour vérifier que la page 404 existe, et qu'elle contient le texte \"Brutus ne peut pas trouver ce que vous cherchez\". La page 404 actuelle ne rend pas toujours les images en raison d'un problème avec MkDocs." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*Les constructions de MkDocs échouent en cas de liens internes non reconnus, vous devez donc vérifier manuellement cette vérification en modifiant l'URL dans votre navigateur." +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -833,21 +864,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Vérifiez que le texte dans le tableau des paramètres s'affiche dans la même taille que le reste de la police." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Fonctionnalité des macros" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "Ce qui suit devrait être \"Brutus dit \"Hello world !\"\". Cela confirme que les variables globales et les macros définies via MkDocs-Macros sont disponibles." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} dit \"{{ say_hello() }}\"" @@ -897,92 +926,164 @@ msgstr "Liaison `autoref`" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Le lien fourni ici devrait vous amener à la section [Police des titres][heading-font] de la page principale. Il est inclus pour vérifier les liens `autoref`." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Section 1" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Section un - page deux" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "Section deux" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Section trois" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Banc d'essai de contenu partagé" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Guides pratiques" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Contribuer" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Contribuer" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "Que puis-je faire ?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Résoudre un problème" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Mettre en œuvre une nouvelle fonctionnalité" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Write documentation" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Triage d'un problème" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Examiner une demande d'extraction" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Proposer une nouvelle fonctionnalité" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "Traduire le contenu" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Utiliser les outils" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "Comment puis-je contribuer ?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Travailler à partir d'une branche" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Ajouter une note de modification" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "Fournir un avis" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "Que se passe-t-il ensuite ?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Processus d'examen des demandes de retrait" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Processus de libération" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Politiques" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "Politique en matière d'IA" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Style guides" diff --git a/docs/locales/it/translations.po b/docs/locales/it/translations.po index 383e1ce1..b4f3d1ae 100644 --- a/docs/locales/it/translations.po +++ b/docs/locales/it/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "Sezione uno" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Banco di prova per contenuti condivisi" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Guide pratiche" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Contribuisci" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "Cosa posso fare?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "Come posso contribuire?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "Cosa succede dopo?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Politiche" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Guide di stile" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Questo file è incluso esclusivamente per soddisfare il collegamento nel msgid "First-time contributors" msgstr "Nuovi collaboratori" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "Nuovi collaboratori" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Documentazione dell'edificio" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Documentazione dell'edificio" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Configurazione di un ambiente di sviluppo" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Configurazione di un ambiente di sviluppo" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Invio di una nuova segnalazione" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Invio di una nuova segnalazione" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Proposta di una nuova funzionalità" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Proposta di una nuova funzionalità" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "Se sei interessato, puoi iniziare a [implementare la tua nuova funzional msgid "Reproducing an issue" msgstr "Riproduzione di un problema" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Riproduzione di un problema" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Evitare lo scope creep" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Evitare lo scope creep" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Invio di una richiesta pull" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Invio di una richiesta pull" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "Traduzione dei contenuti" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "Traduzione del contenuto" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Scrittura, esecuzione e test del codice" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Scrittura, esecuzione e test del codice" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "Una volta che tutto funziona, puoi [inviare una richiesta pull]{1} con l msgid "Writing documentation" msgstr "Scrittura della documentazione" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Scrittura della documentazione" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Guida allo stile del codice" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Guida allo stile del codice" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Guida allo stile della documentazione" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Guida allo stile della documentazione" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "Per `style_guide.md`, dovresti aggiungere `-8<- \"style_guide.md\"` a `style_guide_include.md`." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "Aggiorna la sezione `Shared content test bed` in `/docs/SUMMARY.md` per includere il nuovo file `_include` e il percorso, allo stesso livello di indentazione degli altri elementi in quella sezione." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "Per `style_guide_include.md`, dovresti aggiungere `- [Style guide](content_test_bed/style_guide_include.md)`." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "Per `style_guide_include.md`, dovresti aggiungere `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "Lista di controllo dei temi" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "Questa demo è stata progettata per testare le varie funzionalità delle sostituzioni del tema BeeWare MkDocs Material. Si prega di leggere attentamente e verificare che tutto ciò che è elencato in questa pagina e nelle pagine seguenti sia presente e funzioni come descritto." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "Questa demo è stata progettata per testare le varie funzionalità delle sostituzioni del tema BeeWare Zensical. Si prega di leggere attentamente e verificare che tutto ciò che è elencato in questa pagina e nelle pagine seguenti sia presente e funzioni come descritto." #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "Link nella barra laterale" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "I link della barra laterale esistono e puntano al repository `beeware-docs-tools`. Ciò conferma che il contenuto della barra laterale è stato caricato, che `project-name` è stato impostato nel file di configurazione MkDocs e che il numero di versione è stato calcolato e aggiunto." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "I link della barra laterale esistono e puntano al repository `beeware-docs-tools`. Ciò conferma che il contenuto della barra laterale è stato caricato, che `project-name` è stato impostato nel file di configurazione Zensical e che il numero di versione è stato calcolato e aggiunto." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Aggiungi `nopage` alla fine dell'URL nel tuo browser per verificare che la pagina 404 esista e includa il testo \"Brutus non riesce a trovare ciò che stai cercando\". L'attuale pagina 404 non sempre visualizza le immagini a causa di un problema con MkDocs." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*MkDocs non riesce a compilare i link interni non riconosciuti, quindi è necessario verificare manualmente questo controllo modificando l'URL nel browser.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Verificare che il testo nella tabella dei parametri venga visualizzato con le stesse dimensioni del resto del carattere." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Funzionalità macro" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "Il testo seguente dovrebbe essere \"Brutus dice 'Ciao mondo!'\". Ciò conferma che le variabili globali e le macro definite tramite MkDocs-Macros sono disponibili." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} dice \"{{ say_hello() }}\"" @@ -888,92 +917,164 @@ msgstr "`autoref` collegamento" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Il link fornito qui dovrebbe portarti alla sezione [Carattere titolo][heading-font] della pagina principale. È incluso per verificare il collegamento `autoref`." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Sezione uno" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Sezione uno - pagina due" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "Sezione due" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Sezione tre" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 +#, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Banco di prova per contenuti condivisi" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Guide pratiche" + +#: docs/en/titles.md:19 #, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Contribuisci" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Contributo" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "Cosa posso fare?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Risolvi un problema" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Implementare una nuova funzionalità" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Scrivere la documentazione" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Valutare un problema" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Esamina una richiesta pull" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Proponi una nuova funzionalità" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "Traduci contenuto" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Utilizza gli strumenti" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "Come posso contribuire?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Lavorare da un ramo" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Aggiunta di una nota di modifica" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "Fornire una recensione" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "Cosa succede dopo?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Processo di revisione delle richieste di pull" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Processo di rilascio" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Politiche" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "Politica sull'intelligenza artificiale" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Guide di stile" diff --git a/docs/locales/ja/translations.po b/docs/locales/ja/translations.po index 89f0360c..b04bec4b 100644 --- a/docs/locales/ja/translations.po +++ b/docs/locales/ja/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "第一節" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "共有コンテンツ試験環境" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "ハウツーガイド" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "貢献する" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "どうすればいいですか？" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "どのように貢献すればよいですか？" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "次に何が起こるのか？" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "方針" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "スタイルガイド" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "このファイルは`code_contribution_base.md`ファイル内のリン msgid "First-time contributors" msgstr "初めての投稿者" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "初めての投稿者" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "建築文書" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "ビルディングドキュメント" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "開発環境の構築" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "開発環境のセットアップ" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "新しい問題を提出する" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "新しい問題を提出する" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "新機能の提案" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "新機能の提案" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "ご興味があれば、[新機能の実装]{1}を開始できます。" msgid "Reproducing an issue" msgstr "問題の再現" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "問題の再現" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "スコープクリープの回避" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "スコープの拡大を避ける" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "プルリクエストの送信" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "プルリクエストの送信" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "コンテンツの翻訳" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "コンテンツの翻訳" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "コードの記述、実行、およびテスト" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "コードの記述、実行、およびテスト" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "すべてが正常に動作したら、変更内容を含むプルリク msgid "Writing documentation" msgstr "ドキュメントの作成" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "ドキュメント作成" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "コードスタイルガイド" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "コードスタイルガイド" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "ドキュメントスタイルガイド" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "ドキュメントスタイルガイド" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "`style_guide.md` の場合、`-8<- \"style_guide.md\"` を `style_guide_include.md` に追加します。" #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "`Shared content test bed` セクション内の `/docs/SUMMARY.md` を更新し、新しい `_include` ファイルとパスを含めるようにしてください。そのセクション内の他の項目と同じインデントレベルで記述してください。" +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "`style_guide_include.md` の場合、`- [Style guide](content_test_bed/style_guide_include.md)` を追加します。" +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "`style_guide_include.md` の場合、`{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },` を追加します。" #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "テーマチェックリスト" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "このデモは、BeeWare MkDocs Materialテーマの各種機能オーバーライドをテストするために設計されています。本ページおよび次ページに記載されているすべての項目が、説明通りに存在し機能していることを確認してください。" +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "このデモは、BeeWare Zensicalテーマの各種機能オーバーライドをテストするために設計されています。本ページおよび次ページに記載されているすべての項目が、説明通りに存在し機能していることを確認してください。" #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "サイドバーリンク" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "サイドバーリンクが存在し、`beeware-docs-tools`リポジトリを指しています。これは、サイドバーコンテンツが読み込まれ、MkDocs設定ファイルで`project-name`が設定され、バージョン番号が計算されて追加されたことを確認します。" +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "サイドバーリンクが存在し、`beeware-docs-tools`リポジトリを指しています。これは、サイドバーコンテンツが読み込まれ、Zensical設定ファイルで`project-name`が設定され、バージョン番号が計算されて追加されたことを確認します。" #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "ブラウザのURL末尾に`nopage`を追加し、404ページが存在し、「Brutus can't find what you're looking for」というテキストが含まれていることを確認してください。現在の404ページは、MkDocsの問題により画像が常に表示されるとは限りません。" #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*MkDocsのビルドは認識されない内部リンクで失敗するため、ブラウザでURLを変更してこのチェックを手動で確認する必要があります。*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "パラメータテーブル内のテキストが、フォントの他の部分と同じサイズで表示されていることを確認してください。" #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "マクロ機能" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "以下は「Brutus says \"Hello world!\"」と表示されるはずです。これにより、MkDocs-Macros経由で定義されたグローバル変数とマクロが利用可能であることが確認できます。" +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }}は「{{ say_hello() }}」と言っている" @@ -888,92 +917,164 @@ msgstr "`autoref` リンク" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "ここに提供されたリンクは、メインページの[見出しフォント][heading-font]セクションへ移動するはずです。これは`autoref`リンクの確認のために含まれています。" -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "セクション1" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "セクション１－ページ２" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "セクション2" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "セクション３" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "共有コンテンツテストベッド" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "ハウツーガイド" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "貢献する" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "寄稿" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "どうすればいいですか？" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "問題を修正する" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "新機能の実装" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "ドキュメントを作成する" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "問題をトリアージする" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "プルリクエストをレビューする" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "新機能の提案" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "コンテンツを翻訳" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "ツールを使用する" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "どのように貢献すればよいですか？" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "ブランチから作業する" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "変更メモの追加" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "レビューを提供すること" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "次に何が起こるのか？" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "プルリクエストのレビュープロセス" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "リリースプロセス" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "方針" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "AIポリシー" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "スタイルガイド" diff --git a/docs/locales/ko/translations.po b/docs/locales/ko/translations.po index 6acbe29a..8eabe27c 100644 --- a/docs/locales/ko/translations.po +++ b/docs/locales/ko/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "제1절" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "공유 콘텐츠 테스트베드" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "사용 방법 안내서" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "기여하다" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "어쩌면 좋을까?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "어떻게 기여할 수 있나요?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "다음에는 무슨 일이 일어날까요?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "정책" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "스타일 가이드" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "이 파일은 `code_contribution_base.md` 파일의 링크를 충족시 msgid "First-time contributors" msgstr "첫 기고자" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "첫 번째 기여자" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "건축 문서" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "빌딩 문서화" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "개발 환경 설정" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "개발 환경 설정" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "새 이슈 제출" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "새 이슈 제출" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "새로운 기능 제안" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "새로운 기능 제안" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "관심이 있으시다면, [새로운 기능 구현]{1}을 시작하실 msgid "Reproducing an issue" msgstr "문제를 재현하다" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "문제 재현" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "범위 확대 방지" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "범위 확대 방지" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "풀 리퀘스트 제출" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "풀 리퀘스트 제출하기" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "콘텐츠 번역" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "번역 중인 콘텐츠" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "코드를 작성하고, 실행하고, 테스트하기" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "코드를 작성하고, 실행하고, 테스트하기" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "모든 것이 정상적으로 작동하는지 확인한 후에는 변경 msgid "Writing documentation" msgstr "문서 작성" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "문서 작성" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "코드 스타일 가이드" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "코드 스타일 가이드" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "문서 작성 스타일 가이드" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "문서 스타일 가이드" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "`style_guide.md`의 경우, `-8<- \"style_guide.md\"`를 `style_guide_include.md`에 추가하면 됩니다." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "`Shared content test bed` 섹션의 `/docs/SUMMARY.md` 부분을 업데이트하여 새로운 `_include` 파일과 경로를 포함시키되, 해당 섹션 내 다른 항목들과 동일한 들여쓰기 수준으로 맞추십시오." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "`style_guide_include.md`의 경우, `- [Style guide](content_test_bed/style_guide_include.md)`를 추가하면 됩니다." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "`style_guide_include.md`의 경우, `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`를 추가하면 됩니다." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "테마 체크리스트" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "이 데모는 BeeWare MkDocs Material 테마 오버라이드의 다양한 기능을 테스트하기 위해 설계되었습니다. 본 페이지 및 다음 페이지에 나열된 모든 항목이 설명된 대로 존재하고 작동하는지 확인하시기 바랍니다." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "이 데모는 BeeWare Zensical 테마 오버라이드의 다양한 기능을 테스트하기 위해 설계되었습니다. 본 페이지 및 다음 페이지에 나열된 모든 항목이 설명된 대로 존재하고 작동하는지 확인하시기 바랍니다." #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "사이드바 링크" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "사이드바 링크가 존재하며 `beeware-docs-tools` 저장소를 가리킵니다. 이는 사이드바 콘텐츠가 로드되었고, MkDocs 구성 파일에서 `project-name`가 설정되었으며, 버전 번호가 계산되어 추가되었음을 확인시켜 줍니다." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "사이드바 링크가 존재하며 `beeware-docs-tools` 저장소를 가리킵니다. 이는 사이드바 콘텐츠가 로드되었고, Zensical 구성 파일에서 `project-name`가 설정되었으며, 버전 번호가 계산되어 추가되었음을 확인시켜 줍니다." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "브라우저의 URL 끝에 `nopage`를 추가하여 404 페이지가 존재하는지, 그리고 \"Brutus가 찾고 계신 내용을 찾을 수 없습니다\"라는 텍스트가 포함되어 있는지 확인하세요. 현재 404 페이지는 MkDocs의 문제로 인해 이미지를 항상 렌더링하지는 않습니다." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*MkDocs 빌드는 인식되지 않는 내부 링크로 인해 실패하므로, 브라우저에서 URL을 수동으로 수정하여 이 검사를 직접 확인해야 합니다.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "매개변수 테이블의 텍스트가 나머지 글꼴과 동일한 크기로 렌더링되는지 확인하십시오." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "매크로 기능" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "다음은 'Brutus says \"Hello world!\"'라고 표시되어야 합니다. 이는 MkDocs-Macros를 통해 정의된 전역 변수와 매크로가 사용 가능함을 확인시켜 줍니다." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }}는 \"{{ say_hello() }}\"라고 말한다." @@ -888,92 +917,164 @@ msgstr "`autoref` 연결" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "여기에 제공된 링크는 메인 페이지의 [헤딩 글꼴][heading-font] 섹션으로 이동시켜야 합니다. 이는 `autoref` 링크를 확인하기 위해 포함되었습니다." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "제1절" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "제1절 - 2면" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "제2절" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "제3절" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "공유 콘텐츠 테스트베드" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "사용 방법 안내서" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "기여하다" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "기여" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "어쩌면 좋을까?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "문제를 해결하세요" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "새 기능 구현" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "문서 작성" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "문제를 분류하다" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "풀 리퀘스트 검토하기" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "새로운 기능 제안하기" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "번역 내용" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "도구를 사용하세요" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "어떻게 기여할 수 있나요?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "브랜치에서 작업하기" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "변경 사항 추가" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "리뷰 제공" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "다음에는 무슨 일이 일어날까요?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "풀 리퀘스트 검토 프로세스" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "출시 절차" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "정책" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "AI 정책" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "스타일 가이드" diff --git a/docs/locales/pl/translations.po b/docs/locales/pl/translations.po index beec11f0..7a65c9c8 100644 --- a/docs/locales/pl/translations.po +++ b/docs/locales/pl/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "Sekcja pierwsza" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Platforma testowa wspólnych treści" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Poradniki" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Współtwórz" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "Co mogę zrobić?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "Jak mogę pomóc?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "Co będzie dalej?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Zasady" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Przewodniki stylistyczne" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Ten plik został dołączony wyłącznie w celu spełnienia wymagań lin msgid "First-time contributors" msgstr "Osoby, które po raz pierwszy przekazują darowiznę" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "Osoby publikujące po raz pierwszy" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Dokumentacja budowlana" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Dokumentacja budowlana" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Konfiguracja środowiska programistycznego" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Konfiguracja środowiska programistycznego" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Zgłaszanie nowego problemu" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Zgłaszanie nowego problemu" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Proponowanie nowej funkcji" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Proponowanie nowej funkcji" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "Jeśli jesteś zainteresowany, możesz rozpocząć [wdrażanie nowej fun msgid "Reproducing an issue" msgstr "Odtworzenie problemu" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Powielanie problemu" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Unikanie rozszerzania zakresu projektu" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Unikanie rozszerzania zakresu projektu" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Przesyłanie żądania ściągnięcia" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Przesyłanie żądania pull" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "Tłumaczenie treści" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "Tłumaczenie treści" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Pisanie, uruchamianie i testowanie kodu" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Pisanie, uruchamianie i testowanie kodu" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "Gdy wszystko będzie już działać, możesz [przesłać pull request]{1 msgid "Writing documentation" msgstr "Pisanie dokumentacji" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Pisanie dokumentacji" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Przewodnik po stylu kodowania" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Przewodnik po stylu kodowania" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Przewodnik po stylu dokumentacji" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Przewodnik stylistyczny dotyczący dokumentacji" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "W przypadku `style_guide.md` należy dodać `-8<- \"style_guide.md\"` do `style_guide_include.md`." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "Zaktualizuj sekcję `Shared content test bed` w `/docs/SUMMARY.md`, aby uwzględnić nowy plik `_include` i ścieżkę, na tym samym poziomie wcięcia, co pozostałe elementy w tej sekcji." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "W przypadku `style_guide_include.md` należy dodać `- [Style guide](content_test_bed/style_guide_include.md)`." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "W przypadku `style_guide_include.md` należy dodać `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "Lista kontrolna motywów" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "To demo zostało zaprojektowane w celu przetestowania różnych funkcji motywu BeeWare MkDocs Material. Proszę przeczytać i sprawdzić, czy wszystko, co jest wymienione na tej i kolejnych stronach, jest obecne i działa zgodnie z opisem." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "To demo zostało zaprojektowane w celu przetestowania różnych funkcji motywu BeeWare Zensical. Proszę przeczytać i sprawdzić, czy wszystko, co jest wymienione na tej i kolejnych stronach, jest obecne i działa zgodnie z opisem." #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "Linki w pasku bocznym" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "Istnieją linki w pasku bocznym, które kierują do repozytorium `beeware-docs-tools`. Potwierdza to, że zawartość paska bocznego została załadowana, a `project-name` zostało ustawione w pliku konfiguracyjnym MkDocs, a numer wersji został obliczony i dodany." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "Istnieją linki w pasku bocznym, które kierują do repozytorium `beeware-docs-tools`. Potwierdza to, że zawartość paska bocznego została załadowana, a `project-name` zostało ustawione w pliku konfiguracyjnym Zensical, a numer wersji został obliczony i dodany." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Dodaj `nopage` na końcu adresu URL w przeglądarce, aby sprawdzić, czy strona 404 istnieje i zawiera tekst „Brutus nie może znaleźć tego, czego szukasz”. Obecna strona 404 nie zawsze wyświetla obrazy z powodu problemu z MkDocs." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*Kompilacja MkDocs kończy się niepowodzeniem w przypadku nierozpoznanych linków wewnętrznych, dlatego należy ręcznie zweryfikować to sprawdzenie, modyfikując adres URL w przeglądarce.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Sprawdź, czy tekst w tabeli parametrów jest renderowany w tym samym rozmiarze, co reszta czcionki." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Funkcjonalność makr" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "Poniższy fragment powinien brzmieć „Brutus mówi »Witaj świecie!«”. Potwierdza to, że zmienne globalne i makra zdefiniowane za pomocą MkDocs-Macros są dostępne." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} mówi „{{ say_hello() }}”" @@ -888,92 +917,164 @@ msgstr "`autoref` łączenie" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Podany tutaj link powinien przekierować Cię do sekcji [Czcionka nagłówka][heading-font] na stronie głównej. Został on umieszczony w celu sprawdzenia działania linków `autoref`." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Sekcja pierwsza" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Część pierwsza – strona druga" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "Sekcja druga" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Sekcja trzecia" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 +#, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Testowanie treści udostępnianych" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Poradniki" + +#: docs/en/titles.md:19 #, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Współtwórz" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Wkład" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "Co mogę zrobić?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Napraw problem" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Wdrożenie nowej funkcji" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Napisz dokumentację" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Klasyfikacja problemu" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Sprawdź pull request" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Zaproponuj nową funkcję" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "Przetłumacz treść" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Użyj narzędzi" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "Jak mogę pomóc?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Praca z gałęzią" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Dodanie uwagi dotyczącej zmiany" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "Przegląd" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "Co będzie dalej?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Proces weryfikacji pull requestów" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Proces zwalniania" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Zasady" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "Polityka dotycząca sztucznej inteligencji" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Przewodniki stylistyczne" diff --git a/docs/locales/pt/translations.po b/docs/locales/pt/translations.po index 97b43fbb..d821c4f2 100644 --- a/docs/locales/pt/translations.po +++ b/docs/locales/pt/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "Seção um" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Banco de testes de conteúdo compartilhado" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Guias práticos" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Contribua" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "O que posso fazer?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "Como posso contribuir?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "O que acontece a seguir?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Políticas" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Guias de estilo" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Este arquivo está incluído apenas para satisfazer o link no arquivo `c msgid "First-time contributors" msgstr "Colaboradores pela primeira vez" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "Colaboradores pela primeira vez" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Documentação da construção" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Documentação do edifício" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Configurando um ambiente de desenvolvimento" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Configurando um ambiente de desenvolvimento" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Enviando uma nova questão" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Enviando uma nova questão" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Propondo um novo recurso" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Propondo um novo recurso" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "Se estiver interessado, você pode começar a [implementar seu novo recu msgid "Reproducing an issue" msgstr "Reproduzindo um problema" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Reproduzindo um problema" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Evitar o aumento do escopo" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Evitar o aumento do escopo" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Enviando uma solicitação pull" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Enviando uma solicitação pull" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "Traduzindo conteúdo" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "Traduzindo conteúdo" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Escrever, executar e testar código" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Escrever, executar e testar código" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "Depois de ter tudo funcionando, você pode [enviar uma solicitação pul msgid "Writing documentation" msgstr "Redigir documentação" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Documentação escrita" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Guia de estilo de código" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Guia de estilo de código" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Guia de estilo da documentação" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Guia de estilo da documentação" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "Para `style_guide.md`, você adicionaria `-8<- \"style_guide.md\"` a `style_guide_include.md`." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "Atualize a seção `Shared content test bed` em `/docs/SUMMARY.md` para incluir o novo arquivo `_include` e caminho, no mesmo nível de indentação que os outros itens nessa seção." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "Para `style_guide_include.md`, você adicionaria `- [Style guide](content_test_bed/style_guide_include.md)`." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "Para `style_guide_include.md`, você adicionaria `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "Lista de verificação do tema" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "Esta demonstração foi concebida para testar as várias funcionalidades das substituições do tema BeeWare MkDocs Material. Leia atentamente e verifique se tudo o que está listado nesta página e nas páginas seguintes está presente e a funcionar conforme descrito." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "Esta demonstração foi concebida para testar as várias funcionalidades das substituições do tema BeeWare Zensical. Leia atentamente e verifique se tudo o que está listado nesta página e nas páginas seguintes está presente e a funcionar conforme descrito." #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "Links da barra lateral" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "Os links da barra lateral existem e apontam para o repositório `beeware-docs-tools`. Isso confirma que o conteúdo da barra lateral foi carregado, que `project-name` foi definido no arquivo de configuração do MkDocs e que o número da versão foi calculado e adicionado." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "Os links da barra lateral existem e apontam para o repositório `beeware-docs-tools`. Isso confirma que o conteúdo da barra lateral foi carregado, que `project-name` foi definido no arquivo de configuração do Zensical e que o número da versão foi calculado e adicionado." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Adicione `nopage` ao final da URL no seu navegador para verificar se a página 404 existe e inclui o texto “Brutus não consegue encontrar o que você está procurando”. A página 404 atual nem sempre exibe as imagens devido a um problema com o MkDocs." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*O MkDocs falha na compilação com links internos não reconhecidos, portanto, você precisa verificar manualmente essa verificação modificando a URL no seu navegador.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Verifique se o texto na tabela de parâmetros está sendo renderizado no mesmo tamanho que o restante da fonte." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Funcionalidade macro" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "O seguinte deve dizer “Brutus diz ‘Olá, mundo!’”. Isso confirma que as variáveis globais e macros definidas via MkDocs-Macros estão disponíveis." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} diz “{{ say_hello() }}”" @@ -888,92 +917,164 @@ msgstr "`autoref` ligação" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "O link fornecido aqui deve levá-lo para a seção [Fonte do título][heading-font] da página principal. Ele foi incluído para verificar o link `autoref`." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Seção um" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Seção um - página dois" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "Seção dois" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Seção três" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 +#, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Banco de testes de conteúdo compartilhado" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Guias práticos" + +#: docs/en/titles.md:19 #, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Contribua" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Contribuição" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "O que posso fazer?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Corrigir um problema" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Implementar um novo recurso" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Escreva a documentação" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Classificar um problema" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Revisar uma solicitação pull" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Proponha um novo recurso" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "Traduzir conteúdo" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Use as ferramentas" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "Como posso contribuir?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Trabalhando a partir de uma ramificação" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Adicionando uma nota de alteração" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "Fornecendo uma revisão" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "O que acontece a seguir?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Processo de revisão de solicitação de pull" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Processo de liberação" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Políticas" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "Política de IA" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Guias de estilo" diff --git a/docs/locales/ru/translations.po b/docs/locales/ru/translations.po index 5466061a..6341742c 100644 --- a/docs/locales/ru/translations.po +++ b/docs/locales/ru/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "Раздел первый" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Тестовая платформа для совместного использования контента" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Руководства по эксплуатации" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Внести вклад" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "Что я могу сделать?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "Как я могу внести свой вклад?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "Что будет дальше?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Политики" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Руководства по стилю" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Этот файл включен исключительно для то msgid "First-time contributors" msgstr "Новые авторы" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "Новые авторы" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Строительная документация" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Документация по строительству" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Настройка среды разработки" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Настройка среды разработки" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Отправка новой проблемы" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Отправка новой проблемы" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Предложение новой функции" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Предложение новой функции" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "Если вы заинтересованы, можете приступ msgid "Reproducing an issue" msgstr "Воспроизведение проблемы" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Воспроизведение проблемы" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Избегание расширения объема работ" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Избегание расширения объема работ" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Отправка запроса на извлечение" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Отправка запроса на извлечение" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "Перевод контента" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "Перевод контента" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Написание, запуск и тестирование кода" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Написание, запуск и тестирование кода" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "Как только все будет работать, вы может msgid "Writing documentation" msgstr "Написание документации" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Написание документации" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Руководство по стилю кода" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Руководство по стилю кода" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Руководство по стилю документации" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Руководство по стилю документации" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "Для `style_guide.md` вы бы добавили `-8<- \"style_guide.md\"` к `style_guide_include.md`." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "Обновите раздел `Shared content test bed` в `/docs/SUMMARY.md`, чтобы включить новый файл `_include` и путь к нему, на том же уровне отступа, что и другие элементы в этом разделе." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "Для `style_guide_include.md` вы бы добавили `- [Style guide](content_test_bed/style_guide_include.md)`." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "Для `style_guide_include.md` вы бы добавили `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "Контрольный список тем" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "Эта демонстрация предназначена для тестирования различных функций переопределений темы BeeWare MkDocs Material. Пожалуйста, прочтите и убедитесь, что все, что указано на этой и следующих страницах, присутствует и функционирует в соответствии с описанием." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "Эта демонстрация предназначена для тестирования различных функций переопределений темы BeeWare Zensical. Пожалуйста, прочтите и убедитесь, что все, что указано на этой и следующих страницах, присутствует и функционирует в соответствии с описанием." #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "Ссылки в боковой панели" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "Ссылки в боковой панели существуют и указывают на репозиторий `beeware-docs-tools`. Это подтверждает, что содержимое боковой панели было загружено, а `project-name` был установлен в конфигурационном файле MkDocs, и номер версии был вычислен и добавлен." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "Ссылки в боковой панели существуют и указывают на репозиторий `beeware-docs-tools`. Это подтверждает, что содержимое боковой панели было загружено, а `project-name` был установлен в конфигурационном файле Zensical, и номер версии был вычислен и добавлен." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Добавьте `nopage` в конец URL-адреса в браузере, чтобы убедиться, что страница 404 существует и содержит текст «Brutus не может найти то, что вы ищете». Текущая страница 404 не всегда отображает изображения из-за проблемы с MkDocs." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*MkDocs не может обработать неизвестные внутренние ссылки, поэтому вам необходимо вручную проверить это, изменив URL-адрес в браузере.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Убедитесь, что текст в таблице параметров отображается того же размера, что и остальная часть шрифта." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Макрофункциональность" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "Следующее должно быть «Брут говорит: «Привет, мир!»». Это подтверждает, что глобальные переменные и макросы, определенные с помощью MkDocs-Macros, доступны." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} говорит «{{ say_hello() }}»" @@ -888,92 +917,164 @@ msgstr "`autoref` связывание" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Ссылка, указанная здесь, должна перенаправить вас в раздел [Шрифт заголовка][heading-font] главной страницы. Она включена для проверки ссылки `autoref`." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Раздел первый" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Раздел первый — страница вторая" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "Раздел второй" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Раздел третий" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 +#, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Тестовая платформа для обмена контентом" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Руководства по эксплуатации" + +#: docs/en/titles.md:19 #, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Внести вклад" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Вклад" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "Что я могу сделать?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Исправить проблему" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Внедрить новую функцию" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Написать документацию" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Сортировка проблемы" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Просмотреть запрос на вытягивание" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Предложить новую функцию" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "Перевести контент" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Используйте инструменты" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "Как я могу внести свой вклад?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Работа из ветки" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Добавление примечания об изменении" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "Предоставление обзора" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "Что будет дальше?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Процесс рассмотрения запросов на добавление" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Процесс выпуска" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Политики" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "Политика в области искусственного интеллекта" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Руководства по стилю" diff --git a/docs/locales/ta/translations.po b/docs/locales/ta/translations.po index 3b3eadb1..766fc553 100644 --- a/docs/locales/ta/translations.po +++ b/docs/locales/ta/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "பிரிவு ஒன்று" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "பகிர்ந்த உள்ளடக்க சோதனைக்களம்" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "செய்முறை வழிகாட்டிகள்" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "பங்களிக்கவும்" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "நான் என்ன செய்ய முடியும்?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "நான் எப்படி பங்களிக்க முடியும்?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "அடுத்து என்ன நடக்கும்?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "கொள்கைகள்" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "பாணி வழிகாட்டிகள்" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "இந்தக் கோப்பு, `code_contribution_base.md` க msgid "First-time contributors" msgstr "முதல் முறை பங்களிப்பாளர்கள்" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "முதல் முறை பங்களிப்பாளர்கள்" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "கட்டுமான ஆவணங்கள்" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "ஆவணப்படுத்துதல்" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "ஒரு மேம்பாட்டுச் சூழலை அமைத்தல்" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "ஒரு மேம்பாட்டுச் சூழலை அமைத்தல்" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "புதிய சிக்கலைச் சமர்ப்பித்தல்" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "புதிய சிக்கலைச் சமர்ப்பித்தல்" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "புதிய அம்சத்தை முன்மொழிதல்" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "ஒரு புதிய அம்சத்தை முன்மொழிதல்" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "உங்களுக்கு ஆர்வமிருந்தால msgid "Reproducing an issue" msgstr "ஒரு சிக்கலை மீண்டும் உருவாக்குதல்" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "ஒரு சிக்கலை மீண்டும் வெளியிடுதல்" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "எல்லை மீறலைத் தவிர்த்தல்" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "எல்லை மீறலைத் தவிர்த்தல்" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "புல் ரிக்வெஸ்டைச் சமர்ப்பித்தல்" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "புல் கோரிக்கையைச் சமர்ப்பித்தல்" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "உள்ளடக்கத்தை மொழிபெயர்த்தல்" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "உள்ளடக்கத்தை மொழிபெயர்க்கிறது" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "எழுதுதல், இயக்கிப் பார்த்தல் மற்றும் சோதனை செய்தல்" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "எழுதுதல், இயங்குதல் மற்றும் குறியீட்டைச் சோதித்தல்" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "அனைத்தும் சரியாக வேலை செய் msgid "Writing documentation" msgstr "ஆவணங்களை எழுதுதல்" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "ஆவணங்களை எழுதுதல்" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "குறியீட்டு நடை வழிகாட்டி" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "குறியீட்டு நடை வழிகாட்டி" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "ஆவணப்படுத்தல் பாணி வழிகாட்டி" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "ஆவணப்படுத்தல் பாணி வழிகாட்டி" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "`style_guide.md`, `-8<- \"style_guide.md\"`-இல் சேர்க்கப்படும்." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "புதிய `Shared content test bed` கோப்பு மற்றும் பாதையைச் சேர்க்க, `/docs/SUMMARY.md` இல் உள்ள `_include` பிரிவை, அந்தப் பிரிவில் உள்ள மற்ற உருப்படிகளைப் போலவே அதே உள்ளிழுப்பு மட்டத்தில் புதுப்பிக்கவும்." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "`style_guide_include.md`, என்பதற்கு நீங்கள் `- [Style guide](content_test_bed/style_guide_include.md)`. சேர்ப்பீர்கள்." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "`style_guide_include.md`, என்பதற்கு நீங்கள் `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`. சேர்ப்பீர்கள்." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -444,9 +476,8 @@ msgid "Theme checklist" msgstr "தலைப்பு சரிபார்ப்புப் பட்டியல்" #: docs/en/index.md:5 -#, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "இந்த டெமோ, BeeWare MkDocs மெட்டீரியல் தீம் ஓவர்ரைடுகளின் பல்வேறு அம்சங்களைச் சோதிப்பதற்காக வடிவமைக்கப்பட்டுள்ளது. தயவுசெய்து இந்த மற்றும் அடுத்தடுத்த பக்கங்களில் பட்டியலிடப்பட்டுள்ள அனைத்தும், விளக்கத்தில் விவரிக்கப்பட்டுள்ளபடி இருப்பதையும், செயல்படுவதையும் சரிபார்க்கவும்." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "" #: docs/en/index.md:7 #, fuzzy @@ -589,8 +620,8 @@ msgstr "பக்கப் பட்டி இணைப்புகள்" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "பக்கப்பட்டி இணைப்புகள் உள்ளன, அவை `beeware-docs-tools` ரெப்போவைக் குறிக்கின்றன. இது பக்கப்பட்டி உள்ளடக்கம் ஏற்றப்பட்டுள்ளது என்பதையும், MkDocs உள்ளமைவுக் கோப்பில் `project-name` அமைக்கப்பட்டுள்ளது என்பதையும், பதிப்பு எண் கணக்கிடப்பட்டு சேர்க்கப்பட்டுள்ளது என்பதையும் உறுதிப்படுத்துகிறது." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "பக்கப்பட்டி இணைப்புகள் உள்ளன, அவை `beeware-docs-tools` ரெப்போவைக் குறிக்கின்றன. இது பக்கப்பட்டி உள்ளடக்கம் ஏற்றப்பட்டுள்ளது என்பதையும், Zensical உள்ளமைவுக் கோப்பில் `project-name` அமைக்கப்பட்டுள்ளது என்பதையும், பதிப்பு எண் கணக்கிடப்பட்டு சேர்க்கப்பட்டுள்ளது என்பதையும் உறுதிப்படுத்துகிறது." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +706,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "உங்கள் உலாவியில் உள்ள URL-இன் முடிவில் `nopage` என்பதைச் சேர்ப்பதன் மூலம், 404 பக்கம் உள்ளது என்பதையும், அதில் \"Brutus can't find what you're looking for\" என்ற உரை உள்ளது என்பதையும் சரிபார்க்கலாம். MkDocs-இல் உள்ள ஒரு சிக்கல் காரணமாக, தற்போதைய 404 பக்கம் எப்போதும் படங்களைக் காட்டவில்லை." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*அடையாளம் தெரியாத உள் இணைப்புகளால் MkDocs உருவாக்கம் தோல்வியடைகிறது, எனவே உங்கள் உலாவியில் URL-ஐ மாற்றுவதன் மூலம் இந்தச் சரிபார்ப்பை நீங்கள் கைமுறையாகச் சரிபார்க்க வேண்டும்.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -825,20 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "பராமீட்டர் அட்டவணையில் உள்ள உரை, மற்ற எழுத்துருக்களைப் போலவே ஒரே அளவில் காட்டப்படுவதைச் சரிபார்க்கவும்." #: docs/en/section_one/page_two.md:13 -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "மேக்ரோ செயல்பாடு" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "பின்வருவது 'புருட்டஸ் சொல்கிறது \"ஹலோ வேர்ல்ட்!\"' என்று காட்ட வேண்டும். இது, MkDocs-Macros வழியாக வரையறுக்கப்பட்ட குளோபல் வேரியபிள்கள் மற்றும் மேக்ரோக்கள் கிடைக்கின்றன என்பதை உறுதிப்படுத்துகிறது." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} கூறுகிறார் \"{{ say_hello() }}\"" @@ -888,92 +917,164 @@ msgstr "`autoref` இணைத்தல்" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "இங்கே வழங்கப்பட்ட இணைப்பு உங்களை முக்கியப் பக்கத்தின் [Heading font][heading-font] பகுதிக்கு அழைத்துச் செல்லும். இது `autoref` இணைப்பைச் சரிபார்க்க சேர்க்கப்பட்டுள்ளது." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "பிரிவு ஒன்று" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "பிரிவு ஒன்று - பக்கம் இரண்டு" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "பிரிவு இரண்டு" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "பிரிவு மூன்று" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "பகிர்ந்த உள்ளடக்க சோதனைக்களம்" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "செய்முறை வழிகாட்டிகள்" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "பங்களிக்கவும்" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "பங்களிப்பு" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "நான் என்ன செய்ய முடியும்?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "ஒரு சிக்கலைச் சரிசெய்யவும்" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "ஒரு புதிய அம்சத்தைச் செயல்படுத்தவும்" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "தயாரிப்பு ஆவணங்களை எழுதுங்கள்" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "ஒரு சிக்கலை முன்னுரிமைப்படுத்துதல்" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "இழு கோரிக்கையை மதிப்பாய்வு செய்யவும்" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "புதிய அம்சத்தை முன்மொழியுங்கள்" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "உள்ளடக்கத்தை மொழிபெயர்க்கவும்" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "கருவிகளைப் பயன்படுத்துங்கள்" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "நான் எப்படி பங்களிக்க முடியும்?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "கிளையிலிருந்து வேலை செய்தல்" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "மாற்றக் குறிப்பைச் சேர்த்தல்" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "மதிப்பாய்வு வழங்குக" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "அடுத்து என்ன நடக்கும்?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "பல் ரிக்வெஸ்ட் மதிப்பாய்வு செயல்முறை" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "வெளியீட்டு செயல்முறை" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "கொள்கைகள்" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "கலைப்புத்தி கொள்கை" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "பாணி வழிகாட்டிகள்" diff --git a/docs/locales/tr/translations.po b/docs/locales/tr/translations.po index a99866e0..d383bcf7 100644 --- a/docs/locales/tr/translations.po +++ b/docs/locales/tr/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "Birinci bölüm" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Paylaşılan içerik test ortamı" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Nasıl yapılır kılavuzları" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Katkıda bulunun" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "Ne yapabilirim?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "Nasıl katkıda bulunabilirim?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "Sonra ne olacak?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Politikalar" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Stil kılavuzları" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Bu dosya, `code_contribution_base.md` dosyasındaki bağlantıyı karş msgid "First-time contributors" msgstr "İlk kez katkıda bulunanlar" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "İlk kez katkıda bulunanlar" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Bina belgeleri" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Bina belgeleri" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Geliştirme ortamı kurma" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Geliştirme ortamı kurma" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Yeni bir sorun bildirme" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Yeni bir sorun bildirme" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Yeni bir özellik önermek" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Yeni bir özellik önermek" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "Eğer ilgileniyorsanız, [yeni özelliğinizi uygulamaya başlayabilirsi msgid "Reproducing an issue" msgstr "Bir sorunu yeniden üretme" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Bir sorunu yeniden üretmek" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Kapsam genişlemesini önleme" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Kapsam genişlemesini önleme" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Çekme isteği gönderme" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Çekme isteği gönderme" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "İçeriği çevirmek" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "İçeriği çeviriyor" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Kod yazma, çalıştırma ve test etme" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Kod yazma, çalıştırma ve test etme" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "Her şey çalışır hale geldiğinde, değişikliklerinizi içeren bir msgid "Writing documentation" msgstr "Dokümantasyon yazma" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Dokümantasyon yazma" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Kod stil kılavuzu" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Kod stil kılavuzu" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Dokümantasyon stil kılavuzu" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Belge stil kılavuzu" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "`style_guide.md` için, `-8<- \"style_guide.md\"`'yi `style_guide_include.md`'ye eklemeniz gerekir." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "`Shared content test bed` bölümündeki `/docs/SUMMARY.md` kısmını, yeni `_include` dosyasını ve yolunu içerecek şekilde, o bölümdeki diğer öğelerle aynı girinti düzeyinde güncelleyin." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "`style_guide_include.md` için, `- [Style guide](content_test_bed/style_guide_include.md)` eklemeniz gerekir." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "`style_guide_include.md` için, `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },` eklemeniz gerekir." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "Tema kontrol listesi" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "Bu demo, BeeWare MkDocs Material tema geçersiz kılmalarının çeşitli özelliklerini test etmek için tasarlanmıştır. Lütfen bu sayfayı ve sonraki sayfaları baştan sona okuyun ve burada ve sonraki sayfalarda listelenen her şeyin mevcut olduğunu ve açıklamada belirtildiği gibi çalıştığını doğrulayın." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "Bu demo, BeeWare Zensical tema geçersiz kılmalarının çeşitli özelliklerini test etmek için tasarlanmıştır. Lütfen bu sayfayı ve sonraki sayfaları baştan sona okuyun ve burada ve sonraki sayfalarda listelenen her şeyin mevcut olduğunu ve açıklamada belirtildiği gibi çalıştığını doğrulayın." #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "Kenar çubuğu bağlantıları" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "Kenar çubuğu bağlantıları mevcuttur ve `beeware-docs-tools` deposuna yönlendirir. Bu, kenar çubuğu içeriğinin yüklendiğini, MkDocs yapılandırma dosyasında `project-name` ayarlandığını ve sürüm numarasının hesaplanıp eklendiğini doğrular." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "Kenar çubuğu bağlantıları mevcuttur ve `beeware-docs-tools` deposuna yönlendirir. Bu, kenar çubuğu içeriğinin yüklendiğini, Zensical yapılandırma dosyasında `project-name` ayarlandığını ve sürüm numarasının hesaplanıp eklendiğini doğrular." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Tarayıcınızda URL'nin sonuna `nopage` ekleyerek 404 sayfasının varlığını ve \"Brutus aradığınızı bulamıyor\" metnini içerdiğini doğrulayın. Mevcut 404 sayfası, MkDocs ile ilgili bir sorun nedeniyle her zaman görüntüleri göstermez." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*MkDocs, tanınmayan iç bağlantılar nedeniyle derleme hatası verir, bu nedenle tarayıcınızda URL'yi değiştirerek bu kontrolü manuel olarak doğrulamanız gerekir.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Parametre tablosundaki metnin, yazı tipinin geri kalanıyla aynı boyutta görüntülendiğini doğrulayın." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Makro işlevselliği" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "Aşağıda \"Brutus diyor ki 'Merhaba dünya!'\" yazmalıdır. Bu, MkDocs-Macros aracılığıyla tanımlanan global değişkenlerin ve makroların kullanılabilir olduğunu doğrular." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} \"{{ say_hello() }}\" diyor." @@ -888,92 +917,164 @@ msgstr "`autoref` bağlantı" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Burada verilen bağlantı sizi ana sayfanın [Başlık yazı tipi][heading-font] bölümüne götürmelidir. `autoref` bağlantısını doğrulamak için eklenmiştir." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Birinci bölüm" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Bölüm bir - sayfa iki" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "İkinci bölüm" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Üçüncü bölüm" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Paylaşılan içerik test ortamı" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Nasıl yapılır kılavuzları" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Katkıda bulunun" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Katkıda bulunan" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "Ne yapabilirim?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Bir sorunu düzeltin" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Yeni bir özellik ekleyin" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Belgeleri yazın" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Bir sorunu öncelik sırasına koymak" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Çekme isteğini incele" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Yeni bir özellik önerin" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "İçeriği çevir" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Araçları kullanın" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "Nasıl katkıda bulunabilirim?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Bir şubeden çalışmak" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Değişiklik notu ekleme" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "İnceleme sunmak" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "Sonra ne olacak?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Çekme isteği inceleme süreci" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Serbest bırakma süreci" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Politikalar" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "Yapay Zeka Politikası" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Stil kılavuzları" diff --git a/docs/locales/uk/translations.po b/docs/locales/uk/translations.po index 4c41911d..bec4216c 100644 --- a/docs/locales/uk/translations.po +++ b/docs/locales/uk/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "Розділ перший" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Тестова платформа для спільного контенту" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Інструкції" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Долучитися" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "Що мені робити?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "Як я можу долучитися?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "Що буде далі?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Політики" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Керівництва зі стилю" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Цей файл включено виключно для того, що msgid "First-time contributors" msgstr "Ті, хто робить внесок вперше" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "Ті, хто вперше бере участь" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Будівельна документація" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Документація щодо побудови" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Налаштування середовища розробки" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Налаштування середовища розробки" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Подання нової проблеми" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Повідомлення про нову проблему" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Пропозиція щодо нової функції" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Пропозиція щодо нової функції" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "Якщо вас це зацікавило, ви можете розпо msgid "Reproducing an issue" msgstr "Відтворення проблеми" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Відтворення проблеми" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Як уникнути розширення обсягу робіт" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Як уникнути розширення обсягу робіт" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Подання запиту на злиття" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Подання запиту на злиття" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "Переклад контенту" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "Переклад вмісту" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Написання, виконання та тестування коду" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Написання, виконання та тестування коду" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "Як тільки все запрацює, ви зможете [наді msgid "Writing documentation" msgstr "Написання документації" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Написання документації" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Керівництво зі стилю кодування" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Керівництво зі стилю написання коду" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Керівництво зі стилю оформлення документації" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Керівництво зі стилю документації" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "Для `style_guide.md` потрібно додати `-8<- \"style_guide.md\"` до `style_guide_include.md`." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "Оновіть розділ `Shared content test bed` у `/docs/SUMMARY.md`, щоб включити новий файл `_include` та шлях до нього, дотримуючись того самого рівня відступу, що й інші елементи в цьому розділі." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "Для `style_guide_include.md` слід додати `- [Style guide](content_test_bed/style_guide_include.md)`." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "Для `style_guide_include.md` слід додати `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -444,9 +476,8 @@ msgid "Theme checklist" msgstr "Перелік питань за темою" #: docs/en/index.md:5 -#, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "Ця демонстраційна версія призначена для тестування різних функцій налаштувань теми «Material» для BeeWare MkDocs. Будь ласка, ознайомтеся з нею та переконайтеся, що все, що зазначено на цій та наступних сторінках, присутнє та працює відповідно до опису." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "" #: docs/en/index.md:7 #, fuzzy @@ -589,8 +620,8 @@ msgstr "Посилання у бічній панелі" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "Посилання в бічній панелі існують і ведуть до репозиторію `beeware-docs-tools`. Це підтверджує, що вміст бічної панелі завантажено, у файлі конфігурації MkDocs встановлено значення `project-name`, а номер версії обчислено та додано." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "Посилання в бічній панелі існують і ведуть до репозиторію `beeware-docs-tools`. Це підтверджує, що вміст бічної панелі завантажено, у файлі конфігурації Zensical встановлено значення `project-name`, а номер версії обчислено та додано." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +706,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Додайте `nopage` в кінець URL-адреси у вашому браузері, щоб переконатися, що сторінка 404 існує і містить текст «Brutus не може знайти те, що ви шукаєте». Наразі на сторінці 404 зображення не завжди відображаються через проблему з MkDocs." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*Збірка MkDocs завершується з помилкою через невизнані внутрішні посилання, тому вам потрібно вручну перевірити це, змінивши URL-адресу у своєму браузері.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -825,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Переконайтеся, що текст у таблиці параметрів відображається тим самим розміром, що й решта тексту." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Функціональні можливості макросів" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "У наведеному нижче прикладі має з’явитися текст «Brutus says \"Hello world!\"». Це підтверджує, що глобальні змінні та макроси, визначені за допомогою MkDocs-Macros, доступні." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} каже: «{{ say_hello() }}»" @@ -889,92 +917,164 @@ msgstr "`autoref` посилання" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Наведене тут посилання має перенаправити вас до розділу [Шрифт заголовка][heading-font] на головній сторінці. Воно додано для перевірки роботи посилань `autoref`." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Розділ перший" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Розділ перший — сторінка друга" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "Розділ другий" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Розділ третій" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Тестова платформа для спільного контенту" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Інструкції" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Долучитися" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Долучитися" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "Що мені робити?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Виправити проблему" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Реалізувати нову функцію" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Створити документацію" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Оцінка проблеми" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Переглянути запит на злиття" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Запропонувати нову функцію" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "Перекласти вміст" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Скористайтеся інструментами" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "Як я можу долучитися?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Робота з гілкою" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Додавання примітки про зміну" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "Написання відгуку" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "Що буде далі?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Процес перевірки запитів на злиття" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Процес випуску" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Політики" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "Політика щодо штучного інтелекту" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Керівництва зі стилю" diff --git a/docs/locales/vi/translations.po b/docs/locales/vi/translations.po index 1824829f..3ce8a678 100644 --- a/docs/locales/vi/translations.po +++ b/docs/locales/vi/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "Phần một" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "Môi trường thử nghiệm nội dung chia sẻ" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "Hướng dẫn thực hiện" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "Đóng góp" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "Tôi có thể làm gì?" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "Làm thế nào để tôi có thể đóng góp?" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "Tiếp theo sẽ ra sao?" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "Chính sách" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "Hướng dẫn phong cách" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "Tệp này được đưa vào chỉ để đáp ứng liên kết trong msgid "First-time contributors" msgstr "Những người đóng góp lần đầu" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "Những người đóng góp lần đầu" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "Tài liệu xây dựng" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "Tài liệu hướng dẫn" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "Thiết lập môi trường phát triển" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "Thiết lập môi trường phát triển" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "Gửi báo cáo sự cố mới" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "Gửi báo cáo sự cố mới" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "Đề xuất một tính năng mới" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "Đề xuất tính năng mới" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "Nếu bạn quan tâm, bạn có thể bắt đầu [triển khai tính msgid "Reproducing an issue" msgstr "Tái hiện sự cố" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "Tái hiện sự cố" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "Tránh tình trạng mở rộng phạm vi" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "Tránh tình trạng mở rộng phạm vi" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "Gửi yêu cầu pull" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "Gửi yêu cầu pull" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "Dịch nội dung" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "Dịch nội dung" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "Viết, chạy và kiểm thử mã nguồn" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "Viết, chạy và kiểm thử mã nguồn" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "Khi mọi thứ đã hoạt động bình thường, bạn có thể [g msgid "Writing documentation" msgstr "Viết tài liệu" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "Viết tài liệu" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "Hướng dẫn phong cách lập trình" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "Hướng dẫn phong cách mã nguồn" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "Hướng dẫn phong cách biên soạn tài liệu" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "Hướng dẫn phong cách tài liệu" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "Đối với `style_guide.md`, bạn sẽ thêm `-8<- \"style_guide.md\"` vào `style_guide_include.md`." #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "Cập nhật phần `Shared content test bed` trong `/docs/SUMMARY.md` để thêm tệp `_include` mới và đường dẫn, với mức thụt lề giống như các mục khác trong phần đó." +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "Đối với `style_guide_include.md`, bạn sẽ thêm `- [Style guide](content_test_bed/style_guide_include.md)`." +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "Đối với `style_guide_include.md`, bạn sẽ thêm `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "Danh sách kiểm tra chủ đề" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "Bản demo này được thiết kế để kiểm tra các tính năng khác nhau của các tùy chỉnh giao diện BeeWare MkDocs Material. Vui lòng xem qua và xác minh rằng tất cả các nội dung được liệt kê trên trang này và các trang tiếp theo đều có sẵn và hoạt động đúng như mô tả." +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "Bản demo này được thiết kế để kiểm tra các tính năng khác nhau của các tùy chỉnh giao diện BeeWare Zensical. Vui lòng xem qua và xác minh rằng tất cả các nội dung được liệt kê trên trang này và các trang tiếp theo đều có sẵn và hoạt động đúng như mô tả." #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "Các liên kết ở thanh bên" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "Các liên kết trên thanh bên đã xuất hiện và trỏ đến kho lưu trữ `beeware-docs-tools`. Điều này xác nhận rằng nội dung thanh bên đã được tải, biến `project-name` đã được thiết lập trong tệp cấu hình MkDocs, và số phiên bản đã được tính toán và thêm vào." +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "Các liên kết trên thanh bên đã xuất hiện và trỏ đến kho lưu trữ `beeware-docs-tools`. Điều này xác nhận rằng nội dung thanh bên đã được tải, biến `project-name` đã được thiết lập trong tệp cấu hình Zensical, và số phiên bản đã được tính toán và thêm vào." #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "Hãy thêm `nopage` vào cuối URL trong trình duyệt của bạn để kiểm tra xem trang 404 có tồn tại hay không và có hiển thị dòng chữ \"Brutus không thể tìm thấy nội dung bạn đang tìm kiếm\" hay không. Trang 404 hiện tại không phải lúc nào cũng hiển thị hình ảnh do một sự cố với MkDocs." #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*Quá trình biên dịch MkDocs sẽ thất bại do có các liên kết nội bộ không được nhận diện, vì vậy bạn cần kiểm tra lại thủ công bằng cách chỉnh sửa URL trong trình duyệt của mình.*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -825,21 +856,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "Kiểm tra xem văn bản trong bảng tham số có được hiển thị với kích thước tương tự như phần còn lại của phông chữ hay không." #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "Chức năng macro" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "Đoạn mã sau đây sẽ hiển thị dòng chữ 'Brutus says \"Hello world!\"'. Điều này xác nhận rằng các biến toàn cục và macro được định nghĩa thông qua MkDocs-Macros đã sẵn sàng sử dụng." +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} nói: \"{{ say_hello() }}\"" @@ -889,92 +918,164 @@ msgstr "`autoref` liên kết" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "Liên kết được cung cấp ở đây sẽ đưa bạn đến phần [Heading font][heading-font] trên trang chủ. Liên kết này được đưa vào để kiểm tra tính hoạt động của liên kết `autoref`." -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "Phần một" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "Phần một - trang hai" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "Phần hai" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "Phần ba" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "Môi trường thử nghiệm nội dung chia sẻ" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "Hướng dẫn thực hiện" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "Đóng góp" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "Đóng góp" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "Tôi có thể làm gì?" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "Khắc phục sự cố" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "Thực hiện một tính năng mới" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "Viết tài liệu" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "Phân loại vấn đề" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "Xem xét yêu cầu kéo" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "Đề xuất tính năng mới" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "Dịch nội dung" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "Sử dụng các công cụ" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "Làm thế nào để tôi có thể đóng góp?" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "Làm việc trên một nhánh" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "Thêm ghi chú thay đổi" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "Viết đánh giá" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "Tiếp theo sẽ ra sao?" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "Quy trình đánh giá yêu cầu kéo" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "Quy trình phát hành" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "Chính sách" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "Chính sách về Trí tuệ nhân tạo" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "Hướng dẫn phong cách" diff --git a/docs/locales/zh_CN/translations.po b/docs/locales/zh_CN/translations.po index 0848dcbd..64366f41 100644 --- a/docs/locales/zh_CN/translations.po +++ b/docs/locales/zh_CN/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "第一部分" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "共享内容测试平台" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "操作指南" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "贡献" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "我能做什么？" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "我该如何贡献？" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "接下来会发生什么？" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "政策" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "风格指南" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "此文件仅为满足`code_contribution_base.md`文件中的链接而包 msgid "First-time contributors" msgstr "首次投稿者" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "首次投稿者" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "建筑文件" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "建筑文档" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "搭建开发环境" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "搭建开发环境" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "提交新问题" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "提交新问题" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "提出一项新功能" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "提出新功能建议" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "若您感兴趣，可开始[实现新功能]{1}。" msgid "Reproducing an issue" msgstr "重现问题" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "重现问题" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "避免范围蔓延" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "避免范围蔓延" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "提交拉取请求" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "提交拉取请求" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "翻译内容" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "翻译内容" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "编写、运行和测试代码" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "编写、运行和测试代码" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "当您完成所有操作后，即可提交包含您修改内容的拉取 msgid "Writing documentation" msgstr "编写文档" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "编写文档" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "代码风格指南" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "代码样式指南" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "文档风格指南" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "文档风格指南" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "对于 `style_guide.md`，你需要在 `-8<- \"style_guide.md\"` 中添加 `style_guide_include.md`。" #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "更新`Shared content test bed`部分中的`/docs/SUMMARY.md`内容，包含新的`_include`文件及其路径，并保持与该部分其他项目相同的缩进级别。" +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "对于 `style_guide_include.md`，你需要添加 `- [Style guide](content_test_bed/style_guide_include.md)`。" +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "对于 `style_guide_include.md`，你需要添加 `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`。" #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "主题检查清单" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "本演示旨在测试BeeWare MkDocs Material主题覆盖功能的各项特性。请仔细阅读并确认本页及后续页面所列内容均存在且功能如描述所述正常运作。" +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "本演示旨在测试BeeWare Zensical主题覆盖功能的各项特性。请仔细阅读并确认本页及后续页面所列内容均存在且功能如描述所述正常运作。" #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "侧边栏链接" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "侧边栏链接存在，且指向`beeware-docs-tools`仓库。这证实了侧边栏内容已加载，且`project-name`已在MkDocs配置文件中设置，同时版本号已计算并添加。" +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "侧边栏链接存在，且指向`beeware-docs-tools`仓库。这证实了侧边栏内容已加载，且`project-name`已在Zensical配置文件中设置，同时版本号已计算并添加。" #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "在浏览器中将 URL 末尾添加 `nopage` 以验证 404 页面是否存在，并包含文本 \"Brutus 找不到您要查找的内容\"。由于 MkDocs 的问题，当前 404 页面有时无法正确显示图片。" #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*MkDocs 构建会因未识别的内部链接而失败，因此您需要通过在浏览器中修改 URL 手动验证此检查。*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "请确认参数表中的文本渲染尺寸与字体其他部分一致。" #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "宏功能" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "以下内容应显示为“Brutus says 'Hello world!'”。这证实了通过 MkDocs-Macros 定义的全局变量和宏是可用的。" +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} 说 \"{{ say_hello() }}\"" @@ -888,92 +917,164 @@ msgstr "`autoref` 链接" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "此处提供的链接应引导您前往主页的[标题字体][heading-font]部分。此链接旨在验证`autoref`链接功能。" -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "第一部分" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "第一部分 - 第二页" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "第二部分" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "第三部分" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 +#, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "共享内容测试平台" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "操作指南" + +#: docs/en/titles.md:19 #, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "贡献" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "贡献" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "我能做什么？" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "修复问题" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "实现新功能" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "编写文档" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "对问题进行分级处理" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "审查拉取请求" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "提出新功能建议" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "翻译内容" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "使用工具" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "我该如何贡献？" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "从分支工作" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "添加变更说明" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "提供评论" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "接下来会发生什么？" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "拉取请求审核流程" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "发布流程" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "政策" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "人工智能政策" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "风格指南" diff --git a/docs/locales/zh_TW/translations.po b/docs/locales/zh_TW/translations.po index 7ac7b925..d723c565 100644 --- a/docs/locales/zh_TW/translations.po +++ b/docs/locales/zh_TW/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -12,51 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.1\n" -#: docs/en/titles.md -#, fuzzy -msgid "Section one" -msgstr "第一節" - -#: docs/en/titles.md -#, fuzzy -msgid "Shared content testbed" -msgstr "共享內容測試平台" - -#: docs/en/titles.md -#, fuzzy -msgid "How-to guides" -msgstr "操作指南" - -#: docs/en/titles.md -#, fuzzy -msgid "Contribute" -msgstr "貢獻" - -#: docs/en/titles.md -#, fuzzy -msgid "What can I do?" -msgstr "我能做什麼？" - -#: docs/en/titles.md -#, fuzzy -msgid "How do I contribute?" -msgstr "我該如何貢獻？" - -#: docs/en/titles.md -#, fuzzy -msgid "What happens next?" -msgstr "接下來會發生什麼事？" - -#: docs/en/titles.md -#, fuzzy -msgid "Policies" -msgstr "政策" - -#: docs/en/titles.md -#, fuzzy -msgid "Style guides" -msgstr "風格指南" - #: docs/en/about/releases.md:1 #, fuzzy msgid "Place-holder file" @@ -72,6 +27,12 @@ msgstr "此檔案僅為滿足 `code_contribution_base.md` 檔案中的連結而 msgid "First-time contributors" msgstr "首次投稿者" +#: docs/en/titles.md:23 +#, fuzzy +msgctxt "navigation" +msgid "First-time contributors" +msgstr "首次投稿者" + #: docs/en/content_test_bed/how-to/contribute/first-time-contributors.md:3 msgid "{% extends \"_shared/contribute/first-time-contributors.md\" %}" msgstr "{% extends \"_shared/contribute/first-time-contributors.md\" %}" @@ -90,6 +51,12 @@ msgstr "{% extends \"_shared/contribute/how/branches.md\" %}" msgid "Building documentation" msgstr "建築文件" +#: docs/en/titles.md:55 +#, fuzzy +msgctxt "navigation" +msgid "Building documentation" +msgstr "建築文件" + #: docs/en/content_test_bed/how-to/contribute/how/build-docs.md:3 msgid "{% extends \"_shared/contribute/how/build-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/build-docs.md\" %}" @@ -130,6 +97,12 @@ msgstr "{% extends \"_shared/contribute/how/change-note.md\" %}" msgid "Setting up a development environment" msgstr "建立開發環境" +#: docs/en/titles.md:45 +#, fuzzy +msgctxt "navigation" +msgid "Setting up a development environment" +msgstr "設定開發環境" + #: docs/en/content_test_bed/how-to/contribute/how/dev-environment.md:3 msgid "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" @@ -139,6 +112,12 @@ msgstr "{% extends \"_shared/contribute/how/dev-environment.md\" %}" msgid "Submitting a new issue" msgstr "提交新問題" +#: docs/en/titles.md:65 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a new issue" +msgstr "提交新問題" + #: docs/en/content_test_bed/how-to/contribute/how/new-issue.md:3 msgid "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" @@ -148,6 +127,12 @@ msgstr "{% extends \"_shared/contribute/how/new-issue.md\" %}" msgid "Proposing a new feature" msgstr "提出新功能" +#: docs/en/titles.md:67 +#, fuzzy +msgctxt "navigation" +msgid "Proposing a new feature" +msgstr "提案新增功能" + #: docs/en/content_test_bed/how-to/contribute/how/propose-feature.md:3 msgid "{% extends \"_shared/contribute/how/propose-feature.md\" %}" msgstr "{% extends \"_shared/contribute/how/propose-feature.md\" %}" @@ -162,6 +147,12 @@ msgstr "若您有興趣，可開始[實作您的新功能]{1}。" msgid "Reproducing an issue" msgstr "重現問題" +#: docs/en/titles.md:47 +#, fuzzy +msgctxt "navigation" +msgid "Reproducing an issue" +msgstr "重現問題" + #: docs/en/content_test_bed/how-to/contribute/how/reproduce-issue.md:3 msgid "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" msgstr "{% extends \"_shared/contribute/how/reproduce-issue.md\" %}" @@ -190,6 +181,12 @@ msgstr "{% extends \"_shared/contribute/how/review-pr.md\" %}" msgid "Avoiding scope creep" msgstr "避免範圍蔓延" +#: docs/en/titles.md:51 +#, fuzzy +msgctxt "navigation" +msgid "Avoiding scope creep" +msgstr "避免範圍蔓延" + #: docs/en/content_test_bed/how-to/contribute/how/scope-creep.md:3 msgid "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" @@ -199,6 +196,12 @@ msgstr "{% extends \"_shared/contribute/how/scope-creep.md\" %}" msgid "Submitting a pull request" msgstr "提交拉取請求" +#: docs/en/titles.md:61 +#, fuzzy +msgctxt "navigation" +msgid "Submitting a pull request" +msgstr "提交拉取請求" + #: docs/en/content_test_bed/how-to/contribute/how/submit-pr.md:3 msgid "{% extends \"_shared/contribute/how/submit-pr.md\" %}" msgstr "{% extends \"_shared/contribute/how/submit-pr.md\" %}" @@ -230,6 +233,12 @@ msgstr "{% endif %}" msgid "Translating content" msgstr "翻譯內容" +#: docs/en/titles.md:69 +#, fuzzy +msgctxt "navigation" +msgid "Translating content" +msgstr "翻譯內容" + #: docs/en/content_test_bed/how-to/contribute/how/translate.md:3 msgid "{% extends \"_shared/contribute/how/translate.md\" %}" msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" @@ -239,6 +248,12 @@ msgstr "{% extends \"_shared/contribute/how/translate.md\" %}" msgid "Writing, running, and testing code" msgstr "編寫、執行與測試程式碼" +#: docs/en/titles.md:53 +#, fuzzy +msgctxt "navigation" +msgid "Writing, running, and testing code" +msgstr "寫作、執行與測試程式碼" + #: docs/en/content_test_bed/how-to/contribute/how/write-code.md:3 msgid "{% extends \"_shared/contribute/how/write-code.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-code.md\" %}" @@ -258,6 +273,12 @@ msgstr "當您完成所有設定後，即可[提交拉取請求]{1}以提交您 msgid "Writing documentation" msgstr "撰寫文件" +#: docs/en/titles.md:57 +#, fuzzy +msgctxt "navigation" +msgid "Writing documentation" +msgstr "撰寫文件" + #: docs/en/content_test_bed/how-to/contribute/how/write-docs.md:3 msgid "{% extends \"_shared/contribute/how/write-docs.md\" %}" msgstr "{% extends \"_shared/contribute/how/write-docs.md\" %}" @@ -308,6 +329,12 @@ msgstr "{% extends \"_shared/contribute/policies/ai-policy.md\" %}" msgid "Code style guide" msgstr "程式碼樣式指南" +#: docs/en/titles.md:83 +#, fuzzy +msgctxt "navigation" +msgid "Code style guide" +msgstr "程式碼樣式指南" + #: docs/en/content_test_bed/how-to/contribute/style/code-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" @@ -317,6 +344,12 @@ msgstr "{% extends \"_shared/contribute/style/code-style-guide.md\" %}" msgid "Documentation style guide" msgstr "文件風格指南" +#: docs/en/titles.md:85 +#, fuzzy +msgctxt "navigation" +msgid "Documentation style guide" +msgstr "文件風格指南" + #: docs/en/content_test_bed/how-to/contribute/style/docs-style-guide.md:3 msgid "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" msgstr "{% extends \"_shared/contribute/style/docs-style-guide.md\" %}" @@ -419,14 +452,13 @@ msgid "For `style_guide.md`, you would add `-8<- \"style_guide.md\"` to `style_g msgstr "對於 `style_guide.md`, 您需要在 `-8<- \"style_guide.md\"` 中添加 `style_guide_include.md`。" #: docs/en/content_test_bed/index.md:13 -#, fuzzy -msgid "Update the `Shared content test bed` section in `/docs/SUMMARY.md` to include the new `_include` file and path, at the same indentation level as the other items in that section." -msgstr "請更新 `Shared content test bed` 區段中的 `/docs/SUMMARY.md` 部分，加入新的 `_include` 檔案與路徑，並保持與該區段中其他項目相同的縮排層級。" +msgid "Update the `Shared content testbed` section of the `nav` setting in `/docs/zensical.toml` to include the new `_include` file and path, at the same indentation level as the other items in that section." +msgstr "" #: docs/en/content_test_bed/index.md:13 #, fuzzy -msgid "For `style_guide_include.md`, you would add `- [Style guide](content_test_bed/style_guide_include.md)`." -msgstr "對於 `style_guide_include.md`，您需要添加 `- [Style guide](content_test_bed/style_guide_include.md)`。" +msgid "For `style_guide_include.md`, you would add `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`." +msgstr "對於 `style_guide_include.md`，您需要添加 `{ \"Style guide\" = \"content_test_bed/style_guide_include.md\" },`。" #: docs/en/content_test_bed/index.md:16 #, fuzzy @@ -445,8 +477,8 @@ msgstr "主題檢查清單" #: docs/en/index.md:5 #, fuzzy -msgid "This demo is designed to test the various features of the BeeWare MkDocs Material theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." -msgstr "此示範旨在測試 BeeWare MkDocs Material 主題覆寫的各項功能。請仔細閱讀並確認本頁及後續頁面所列的所有項目均存在且運作如說明所述。" +msgid "This demo is designed to test the various features of the BeeWare Zensical theme overrides. Please read through and verify that everything listed on this and the following pages is present and functioning as detailed in the description." +msgstr "此示範旨在測試 BeeWare Zensical 主題覆寫的各項功能。請仔細閱讀並確認本頁及後續頁面所列的所有項目均存在且運作如說明所述。" #: docs/en/index.md:7 #, fuzzy @@ -589,8 +621,8 @@ msgstr "側邊欄連結" #: docs/en/index.md:80 #, fuzzy -msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the MkDocs configuration file, and the version number is computed and added." -msgstr "側邊欄連結存在，且指向 `beeware-docs-tools` 儲存庫。這確認了側邊欄內容已載入，且 `project-name` 已在 MkDocs 設定檔中設定，同時版本號碼已計算並加入。" +msgid "Sidebar links exist, and point to the `beeware-docs-tools` repo. This confirms that the sidebar content has been loaded, and the `project-name` has been set in the Zensical configuration file, and the version number is computed and added." +msgstr "側邊欄連結存在，且指向 `beeware-docs-tools` 儲存庫。這確認了側邊欄內容已載入，且 `project-name` 已在 Zensical 設定檔中設定，同時版本號碼已計算並加入。" #: docs/en/index.md:82 #, fuzzy @@ -675,9 +707,8 @@ msgid "Add `nopage` to the end of the URL in your browser to verify the 404 page msgstr "在瀏覽器網址列的末尾添加 `nopage` 以驗證 404 頁面是否存在，並確認其包含文字「Brutus 無法找到您要的內容」。由於 MkDocs 的問題，當前 404 頁面並非總是能正確顯示圖片。" #: docs/en/index.md:128 -#, fuzzy -msgid "*MkDocs builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" -msgstr "*MkDocs 因無法識別內部連結而導致建置失敗，因此您需要手動修改瀏覽器中的網址以驗證此檢查機制。*" +msgid "*Strict builds fail with unrecognized internal links, so you need to manually verify this check by modifying the URL in your browser.*" +msgstr "" #: docs/en/index.md:130 #, fuzzy @@ -824,21 +855,19 @@ msgid "Verify that the text in the parameter table is rendering at the same size msgstr "請確認參數表中的文字是否與字型其餘部分以相同大小呈現。" #: docs/en/section_one/page_two.md:13 -#, fuzzy -msgid "::: beeware_docs_tools.docs_test.DocsTest" -msgstr "::: beeware_docs_tools.docs_test.DocsTest" +msgid "The reference documentation below has an `options` block. Translated builds fail if the block isn't preserved during translation." +msgstr "" -#: docs/en/section_one/page_two.md:15 +#: docs/en/section_one/page_two.md:19 #, fuzzy msgid "Macro functionality" msgstr "巨集功能" -#: docs/en/section_one/page_two.md:17 -#, fuzzy -msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via MkDocs-Macros are available." -msgstr "以下內容應顯示「Brutus 說『Hello world！』」。這確認了透過 MkDocs-Macros 定義的全局變數和巨集可正常使用。" +#: docs/en/section_one/page_two.md:21 +msgid "The following should say 'Brutus says \"Hello world!\"'. This confirms that global variables and macros defined via the macros plugin are available." +msgstr "" -#: docs/en/section_one/page_two.md:19 +#: docs/en/section_one/page_two.md:23 #, fuzzy msgid "{{ mascot_name }} says \"{{ say_hello() }}\"" msgstr "{{ mascot_name }} 說「{{ say_hello() }}」" @@ -888,92 +917,164 @@ msgstr "`autoref` 連結" msgid "The link provided here should take you to the [Heading font][heading-font] section of the main page. It is included to verify `autoref` linking." msgstr "此處提供的連結應可帶您前往主頁面的[標題字型][heading-font]區段。此連結旨在驗證`autoref`連結功能。" -#: docs/en/titles.md +#: docs/en/titles.md:3 docs/en/titles.md:5 +#, fuzzy +msgctxt "navigation" +msgid "Section one" +msgstr "第一節" + +#: docs/en/titles.md:7 #, fuzzy +msgctxt "navigation" msgid "Section one - page two" msgstr "第一節 - 第二頁" -#: docs/en/titles.md +#: docs/en/titles.md:9 #, fuzzy +msgctxt "navigation" msgid "Section two" msgstr "第二節" -#: docs/en/titles.md +#: docs/en/titles.md:11 #, fuzzy +msgctxt "navigation" msgid "Section three" msgstr "第三節" -#: docs/en/titles.md +#: docs/en/titles.md:13 docs/en/titles.md:15 #, fuzzy +msgctxt "navigation" +msgid "Shared content testbed" +msgstr "共享內容測試平台" + +#: docs/en/titles.md:17 +#, fuzzy +msgctxt "navigation" +msgid "How-to guides" +msgstr "操作指南" + +#: docs/en/titles.md:19 +#, fuzzy +msgctxt "navigation" +msgid "Contribute" +msgstr "貢獻" + +#: docs/en/titles.md:21 +#, fuzzy +msgctxt "navigation" msgid "Contributing" msgstr "貢獻" -#: docs/en/titles.md +#: docs/en/titles.md:25 +#, fuzzy +msgctxt "navigation" +msgid "What can I do?" +msgstr "我能做什麼？" + +#: docs/en/titles.md:27 #, fuzzy +msgctxt "navigation" msgid "Fix an issue" msgstr "修復問題" -#: docs/en/titles.md +#: docs/en/titles.md:29 #, fuzzy +msgctxt "navigation" msgid "Implement a new feature" msgstr "實作新功能" -#: docs/en/titles.md +#: docs/en/titles.md:31 #, fuzzy +msgctxt "navigation" msgid "Write documentation" msgstr "撰寫文件" -#: docs/en/titles.md +#: docs/en/titles.md:33 #, fuzzy +msgctxt "navigation" msgid "Triage an issue" msgstr "分級處理問題" -#: docs/en/titles.md +#: docs/en/titles.md:35 #, fuzzy +msgctxt "navigation" msgid "Review a pull request" msgstr "審閱拉取請求" -#: docs/en/titles.md +#: docs/en/titles.md:37 #, fuzzy +msgctxt "navigation" msgid "Propose a new feature" msgstr "提出新功能建議" -#: docs/en/titles.md +#: docs/en/titles.md:39 #, fuzzy +msgctxt "navigation" msgid "Translate content" msgstr "翻譯內容" -#: docs/en/titles.md +#: docs/en/titles.md:41 #, fuzzy +msgctxt "navigation" msgid "Use the tools" msgstr "使用工具" -#: docs/en/titles.md +#: docs/en/titles.md:43 #, fuzzy +msgctxt "navigation" +msgid "How do I contribute?" +msgstr "我該如何貢獻？" + +#: docs/en/titles.md:49 +#, fuzzy +msgctxt "navigation" msgid "Working from a branch" msgstr "從分支工作" -#: docs/en/titles.md +#: docs/en/titles.md:59 #, fuzzy +msgctxt "navigation" msgid "Adding a change note" msgstr "新增變更說明" -#: docs/en/titles.md +#: docs/en/titles.md:63 #, fuzzy +msgctxt "navigation" msgid "Providing a review" msgstr "提供評論" -#: docs/en/titles.md +#: docs/en/titles.md:71 +#, fuzzy +msgctxt "navigation" +msgid "What happens next?" +msgstr "接下來會發生什麼事？" + +#: docs/en/titles.md:73 #, fuzzy +msgctxt "navigation" msgid "Pull request review process" msgstr "拉取請求審查流程" -#: docs/en/titles.md +#: docs/en/titles.md:75 #, fuzzy +msgctxt "navigation" msgid "Release process" msgstr "釋放流程" -#: docs/en/titles.md +#: docs/en/titles.md:77 #, fuzzy +msgctxt "navigation" +msgid "Policies" +msgstr "政策" + +#: docs/en/titles.md:79 +#, fuzzy +msgctxt "navigation" msgid "AI Policy" msgstr "AI 政策" + +#: docs/en/titles.md:81 +#, fuzzy +msgctxt "navigation" +msgid "Style guides" +msgstr "風格指南" diff --git a/docs/spelling_wordlist b/docs/spelling_wordlist index 2db5cd49..bb206c1c 100644 --- a/docs/spelling_wordlist +++ b/docs/spelling_wordlist @@ -41,6 +41,7 @@ mergeable MkDocs Namespaces namespace +natively nav pre PR @@ -74,3 +75,4 @@ visionOS watchOS Weblate webpage +Zensical diff --git a/pyproject.toml b/pyproject.toml index 28b74baf..cdad1419 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -32,7 +32,6 @@ dependencies = [ # replace mkdocstrings. "mkdocs==1.6.1", "mkdocs-autorefs==1.4.5", - "mkdocs-rss-plugin==1.19.0", "mkdocstrings-python==2.0.10", "pymdown-extensions==12.3", "pyspelling==2.13", diff --git a/src/beeware_docs_tools/api_directives.py b/src/beeware_docs_tools/api_directives.py new file mode 100644 index 00000000..8308bf7a --- /dev/null +++ b/src/beeware_docs_tools/api_directives.py @@ -0,0 +1,158 @@ +"""Handling of mkdocstrings API directives during translation. + +An API directive is a ``::: identifier`` line, optionally followed by an +indented YAML ``options:`` block:: + + ::: toga.Button + options: + show_root_heading: false + +API directives contain only Python identifiers and option settings, so there is +nothing in them to translate. However, the translate-toolkit tools treat the +indented lines as a continuation of the ``:::`` paragraph: ``md2po`` extracts +the whole directive as a single string, and ``po2md`` writes it back on a +single line (``::: toga.Button options: show_root_heading: false``), which +mkdocstrings can't parse, so the translated build fails. + +So: + +* ``blank_api_blocks`` removes API directives from the copy of the English + content that ``md2po`` reads, so they never reach the translation catalogs + (and Weblate); and +* ``restore_api_blocks`` replaces the API directives in the translated content + generated by ``po2md`` with the English originals. +""" + +import re +from pathlib import Path + +# The opening line of a fenced code block, and an API directive. +FENCE_RE = re.compile(r"^\s*(`{3,}|~{3,})") +API_DIRECTIVE_RE = re.compile(r"^(\s*):::\s+(\S+)") + + +def api_blocks(lines: list[str]) -> list[tuple[int, int, str, str]]: + """Find the API directives in Markdown content. + + A directive is a ``::: identifier`` line, followed by any lines that are + indented further than it (the ``options:`` block), with blank lines allowed + between them. Directives inside fenced code blocks are ignored. + + :param lines: The lines of the Markdown content. + :returns: A ``(start, end, indent, identifier)`` tuple for each directive, + where ``lines[start:end]`` are the lines of the directive, and + ``indent`` is the indentation of the ``:::`` line. + """ + blocks = [] + fence = None + i = 0 + while i < len(lines): + line = lines[i] + fence_match = FENCE_RE.match(line) + if fence: + # A fence is closed by a bare fence of the same character that is + # at least as long. + if ( + fence_match + and fence_match.group(1)[0] == fence[0] + and len(fence_match.group(1)) >= len(fence) + and not line.strip()[len(fence_match.group(1)) :].strip() + ): + fence = None + elif fence_match: + fence = fence_match.group(1) + elif directive := API_DIRECTIVE_RE.match(line): + indent = directive.group(1) + end = i + 1 + j = i + 1 + while j < len(lines): + if not lines[j].strip(): + j += 1 + elif len(lines[j]) - len(lines[j].lstrip()) > len(indent): + j += 1 + end = j + else: + break + blocks.append((i, end, indent, directive.group(2))) + i = end + continue + i += 1 + return blocks + + +def _write_lines(path: Path, lines: list[str], newline_at_end: bool) -> None: + path.write_text( + "\n".join(lines) + ("\n" if newline_at_end else ""), + encoding="utf-8", + ) + + +def blank_api_blocks(md_path: Path) -> list[Path]: + """Replace every API directive in Markdown content with blank lines. + + The lines are blanked, rather than removed, so that the line numbers + recorded in the translation catalogs still match the original content. + + :param md_path: The directory containing the Markdown content. Files are + modified in place, so this must be a copy. + :returns: The paths (relative to ``md_path``) that were changed. + """ + changed = [] + for md_file in sorted(md_path.rglob("*.md")): + text = md_file.read_text(encoding="utf-8") + lines = text.splitlines() + blocks = api_blocks(lines) + if not blocks: + continue + for start, end, _, _ in blocks: + lines[start:end] = [""] * (end - start) + _write_lines(md_file, lines, text.endswith("\n")) + changed.append(md_file.relative_to(md_path)) + return changed + + +def restore_api_blocks(en_md_path: Path, md_path: Path) -> list[Path]: + """Restore the API directives in translated Markdown content. + + Each API directive in the translated content is replaced with the English + original with the same identifier (in order of appearance, if an identifier + is used more than once in a file). The original is re-indented to match the + translated content, as ``po2md`` normalizes the indentation of list items. + + :param en_md_path: The directory containing the English content. + :param md_path: The directory containing the translated content. + :returns: The paths (relative to the content directory) that were changed. + """ + restored = [] + for en_file in sorted(en_md_path.rglob("*.md")): + target = md_path / en_file.relative_to(en_md_path) + if not target.is_file(): + continue + + en_lines = en_file.read_text(encoding="utf-8").splitlines() + originals = {} + for start, end, indent, identifier in api_blocks(en_lines): + originals.setdefault(identifier, []).append((indent, en_lines[start:end])) + if not originals: + continue + + text = target.read_text(encoding="utf-8") + lines = text.splitlines() + new_lines = [] + position = 0 + for start, end, indent, identifier in api_blocks(lines): + if not originals.get(identifier): + continue + original_indent, original = originals[identifier].pop(0) + new_lines.extend(lines[position:start]) + new_lines.extend( + indent + line.removeprefix(original_indent) if line.strip() else "" + for line in original + ) + position = end + new_lines.extend(lines[position:]) + + if new_lines != lines: + _write_lines(target, new_lines, text.endswith("\n")) + restored.append(en_file.relative_to(en_md_path)) + return restored diff --git a/src/beeware_docs_tools/build_config.py b/src/beeware_docs_tools/build_config.py index a4e657a0..c71cd2d5 100644 --- a/src/beeware_docs_tools/build_config.py +++ b/src/beeware_docs_tools/build_config.py @@ -34,6 +34,8 @@ import polib import tomli_w +from .nav_translations import NAV_CONTEXT + PACKAGE_PATH = Path(__file__).parent OVERRIDES_PATH = PACKAGE_PATH / "overrides" SHARED_CONTENT_PATH = PACKAGE_PATH / "shared_content" @@ -148,6 +150,16 @@ def canonical_url(env=None): return None +def translated_site_url(url, language): + """The site URL of a translation, published in a language subdirectory. + + :param url: The site URL of the English site. + :param language: The language code, which is also the subdirectory name. + :returns: The site URL of the translation, with a trailing slash. + """ + return f"{url.rstrip('/')}/{language}/" + + def load_config(project_path, language="en", env=None): """Load the configuration for a language. @@ -180,6 +192,18 @@ def load_config(project_path, language="en", env=None): if "site_url" not in config and (url := canonical_url(env)): config["site_url"] = url + # Translations are published in a subdirectory named for the language (see + # `build_md_translations`), so a site URL shared with English must have that + # directory added. Otherwise, a translation's canonical links, sitemap, and + # 404 page all point at the English site. A site URL set in the language + # file is used as is. + if ( + language != "en" + and "site_url" not in language_config + and (url := config.get("site_url")) + ): + config["site_url"] = translated_site_url(url, language) + try: version = metadata(config["extra"]["package_name"])["version"] config["extra"]["version"] = version @@ -193,11 +217,12 @@ def translate(po): """Generate a translator function using the provided PO file.""" def _translate(entry): - po_entry = po.find(entry) - if po_entry: - translated = po_entry.msgstr - if translated: - return translated + # Navigation titles have their own context (see `nav_translations`); + # a catalog that predates it may only have an entry without context. + for msgctxt in (NAV_CONTEXT, None): + po_entry = po.find(entry, msgctxt=msgctxt) + if po_entry and po_entry.msgstr: + return po_entry.msgstr return entry return _translate diff --git a/src/beeware_docs_tools/build_md_translations.py b/src/beeware_docs_tools/build_md_translations.py index c0993209..c4b373fb 100644 --- a/src/beeware_docs_tools/build_md_translations.py +++ b/src/beeware_docs_tools/build_md_translations.py @@ -4,6 +4,7 @@ from argparse import ArgumentParser, Namespace from pathlib import Path +from .api_directives import restore_api_blocks from .build_config import ( SHARED_CONTENT_PATH, clean_build_files, @@ -226,6 +227,11 @@ def main(): output_path=shared_content_path, ) + # po2md breaks mkdocstrings API directives that have options; + # put the English originals back. + restore_api_blocks(en_md_path, md_path) + restore_api_blocks(SHARED_CONTENT_PATH / "en", shared_content_path) + copy_resources(en_md_path, md_path) # Final output path is language-specific diff --git a/src/beeware_docs_tools/build_po_translations.py b/src/beeware_docs_tools/build_po_translations.py index 1145c70c..9cc70472 100644 --- a/src/beeware_docs_tools/build_po_translations.py +++ b/src/beeware_docs_tools/build_po_translations.py @@ -6,6 +6,8 @@ import polib +from .nav_translations import seed_nav_translations + # This tool is used to generate updated PO files from updated PO template (POT) # files, which are based on the English Markdown content. # @@ -64,6 +66,12 @@ def pot_to_po( ) for entry in po.obsolete_entries(): po.remove(entry) + + # Navigation titles that have just been given their own context start out + # untranslated; carry over the translation they had before. + previous_path = Path.cwd() / docs / f"locales/{language}/translations.po" + if previous_path.exists(): + seed_nav_translations(po, polib.pofile(previous_path, wrapwidth=100000)) po.save(output_path / docs / language / "translations.po") diff --git a/src/beeware_docs_tools/build_pot_translations.py b/src/beeware_docs_tools/build_pot_translations.py index ced71f44..e536589c 100644 --- a/src/beeware_docs_tools/build_pot_translations.py +++ b/src/beeware_docs_tools/build_pot_translations.py @@ -1,3 +1,4 @@ +import shutil import subprocess from argparse import ArgumentParser, Namespace from pathlib import Path @@ -5,7 +6,9 @@ import polib +from .api_directives import blank_api_blocks from .build_config import BASE_CONFIG, process_nav, read_toml +from .nav_translations import TITLES_FILE, add_nav_context # This tool is used to generate PO template (POT) files from English Markdown # content. @@ -48,7 +51,7 @@ def accumulate(entry): process_nav(config["nav"], accumulate) - title_file = docs / "en/titles.md" + title_file = docs / TITLES_FILE title_file.write_text( "\n\n" + "\n\n".join(en_titles) @@ -109,6 +112,9 @@ def markdown_to_pot(docs: Path, working_path: Path, excludes: list[Path]) -> Non # Resave with a long wrap width to remove word wraps. po = polib.pofile(output_path, wrapwidth=100000) + # Navigation titles get their own context, so they can be translated + # separately from page headings with the same text. + add_nav_context(po) po.save(output_path) @@ -125,18 +131,25 @@ def generate_pot_files(docs: Path, excludes: list[Path]) -> None: with TemporaryDirectory() as temp_working_directory: temp_working_path = Path(temp_working_directory) - (temp_working_path / docs).parent.mkdir(parents=True, exist_ok=True) - - try: - (temp_working_path / docs).symlink_to( - Path.cwd() / docs, - target_is_directory=True, - ) - except FileExistsError: - pass - title_file = generate_titles(docs) + # md2po reads a copy of the English Markdown content, from which the + # mkdocstrings API directives have been blanked out; they contain + # nothing to translate, and md2po mangles them (see `api_directives`). + # The copy is at the same relative path, so the locations recorded in + # the POT file are unchanged. + en_copy = temp_working_path / docs / "en" + shutil.copytree( + Path.cwd() / docs / "en", + en_copy, + ignore=lambda directory, names: [ + name + for name in names + if not name.endswith(".md") and not Path(directory, name).is_dir() + ], + ) + blank_api_blocks(en_copy) + markdown_to_pot(docs=docs, working_path=temp_working_path, excludes=excludes) if title_file: diff --git a/src/beeware_docs_tools/convert_mkdocs_config.py b/src/beeware_docs_tools/convert_mkdocs_config.py index 6c3f2597..174672c8 100644 --- a/src/beeware_docs_tools/convert_mkdocs_config.py +++ b/src/beeware_docs_tools/convert_mkdocs_config.py @@ -40,10 +40,12 @@ read_toml, unexpected_language_keys, ) - -# The file that `build_pot_translations` generates the navigation titles into, -# relative to the `docs` directory. -TITLES_FILE = "en/titles.md" +from .nav_translations import ( + LINK_RE, + NAV_CONTEXT, + TITLES_FILE, + previous_translation, +) class ConversionError(Exception): @@ -893,18 +895,17 @@ def compare_configs(old, new, python_names, allowed): # Translations ########################################################################### -_LINK = re.compile(r"^\s*\[(?P.*)\]\s*(\{\d+\}|\([^)]*\))\s*$", re.DOTALL) - def migrate_nav_translations(po_path, nav_sources, titles, titles_occurrence): """Migrate the navigation title translations in a PO file. - Titles that were translated as part of a literate-nav navigation file have - msgids like ``[Title]{1}`` (for a link) or ``Title`` (for a section). In a - `nav` setting, all titles are extracted as plain text (``Title``). This - adds (or fills in) an entry for each title, using the translation of the - link text, keeping the fuzzy flag as it was, and removes the entries that - were only used by the navigation file. + Each title in the new `nav` setting gets an entry with the navigation + context (see `nav_translations`), carrying over the translation the + navigation previously displayed: the link text translation from the + literate-nav navigation file (``[Title]{1}``), or, for a section title, the + translation of the same text. The fuzzy flag is kept as it was. The + navigation file's references are then removed, along with any entries only + the navigation file used. :param po_path: The PO file to update. :param nav_sources: The source references (as used in the PO file) of the @@ -914,76 +915,46 @@ def migrate_nav_translations(po_path, nav_sources, titles, titles_occurrence): :returns: A dictionary of counts and messages describing the migration. """ po = polib.pofile(str(po_path), wrapwidth=100000) - report = { - "moved": 0, - "matched": 0, - "kept": 0, - "removed": 0, - "conflicts": [], - "unmapped": [], - } - - nav_entries = [ - entry - for entry in po - if not entry.obsolete - and any(source in nav_sources for source, _ in entry.occurrences) - ] - - def is_nav_only(entry): - return all(source in nav_sources for source, _ in entry.occurrences) + previous = polib.pofile(str(po_path), wrapwidth=100000) + report = {"migrated": 0, "untranslated": 0, "removed": 0, "unmapped": []} - for entry in nav_entries: - link = _LINK.match(entry.msgid) - title = link.group("title") if link else entry.msgid - if title not in titles: + # A translated link that has lost its link markup can't be mapped. + for entry in previous: + if entry.obsolete or entry.msgctxt or not entry.msgstr: continue - - if not link: - # Already a plain title; it's kept, with a new source reference. - report["kept"] += 1 + if not any(source in nav_sources for source, _ in entry.occurrences): continue - - translated = "" - if entry.msgstr: - match = _LINK.match(entry.msgstr) - if match: - translated = match.group("title") - else: - report["unmapped"].append(f"{entry.msgid!r} -> {entry.msgstr!r}") - continue - - target = po.find(title) - if target is None or target.obsolete: - po.append( - polib.POEntry( - msgid=title, - msgstr=translated, - flags=list(entry.flags), - occurrences=[(titles_occurrence, "")], - ) - ) - report["moved"] += 1 - elif not target.msgstr and translated: - target.msgstr = translated - target.flags = list(entry.flags) - report["moved"] += 1 - elif target.msgstr and translated and target.msgstr != translated: - report["conflicts"].append( - f"{title!r}: kept {target.msgstr!r}, not {translated!r}" + link = LINK_RE.match(entry.msgid) + if link and link.group("title") in titles and not LINK_RE.match(entry.msgstr): + report["unmapped"].append(f"{entry.msgid!r} -> {entry.msgstr!r}") + + for title in dict.fromkeys(titles): + nav_entry = po.find(title, msgctxt=NAV_CONTEXT) + if nav_entry is None: + nav_entry = polib.POEntry( + msgid=title, + msgctxt=NAV_CONTEXT, + msgstr="", + occurrences=[(titles_occurrence, "")], ) + po.append(nav_entry) + if nav_entry.msgstr: + continue + if found := previous_translation(previous, title): + nav_entry.msgstr, nav_entry.flags = found + report["migrated"] += 1 else: - report["matched"] += 1 + report["untranslated"] += 1 - for entry in nav_entries: + for entry in list(po): + if entry.obsolete or entry.msgctxt: + continue others = [o for o in entry.occurrences if o[0] not in nav_sources] - link = _LINK.match(entry.msgid) - is_title = not link and entry.msgid in titles - if is_title: - entry.occurrences = [*others, (titles_occurrence, "")] - elif others: + if len(others) == len(entry.occurrences): + continue + if others: entry.occurrences = others - elif is_nav_only(entry): + else: po.remove(entry) report["removed"] += 1 @@ -1219,15 +1190,11 @@ def convert_values(config, label): po_path, nav_sources, titles, titles_occurrence ) out( - f"{po_path}: {report['moved']} link titles migrated, " - f"{report['matched']} already had the same translation, " - f"{len(report['conflicts'])} already had a different translation, " + f"{po_path}: {report['migrated']} navigation titles migrated, " + f"{report['untranslated']} untranslated, " f"{len(report['unmapped'])} couldn't be mapped; " - f"{report['kept']} section titles kept; " f"{report['removed']} navigation-only entries removed" ) - for conflict in report["conflicts"]: - out(f" Conflict: {conflict}") for unmapped in report["unmapped"]: out(f" Couldn't map: {unmapped}") diff --git a/src/beeware_docs_tools/nav_translations.py b/src/beeware_docs_tools/nav_translations.py new file mode 100644 index 00000000..ec09b731 --- /dev/null +++ b/src/beeware_docs_tools/nav_translations.py @@ -0,0 +1,120 @@ +"""Translation of navigation titles. + +Navigation titles are written into a generated Markdown file (``titles.md``) so +that ``md2po`` extracts them. A navigation title is often the same text as the +heading of the page it links to (for example, "Building documentation"), and +``md2po`` merges duplicate strings, so the two would share a single +translation. Translators may have (and in practice, have) translated them +differently; for example, a shorter title for the navigation. + +To keep those translations apart, navigation titles are given their own +message context (``msgctxt "navigation"``), which also tells translators where +the string is used. When a navigation entry has no translation yet, it is +seeded from the translation it would previously have used: + +* the link text of an entry from a literate-nav navigation file + (``[Title]{1}``, from ``SUMMARY.md``); or +* an entry with the same text and no context (a navigation title from before + this context was introduced, or the matching page heading). +""" + +import re + +import polib + +NAV_CONTEXT = "navigation" + +# The generated file containing the navigation titles, relative to the docs +# directory. +TITLES_FILE = "en/titles.md" + +# A link, as extracted by md2po from a literate-nav navigation file. +LINK_RE = re.compile(r"^\s*\[(?P<title>.*)\]\s*(\{\d+\}|\([^)]*\))\s*$", re.DOTALL) + + +def is_titles_source(source: str) -> bool: + """Is a source reference (from a PO entry) the navigation titles file?""" + return source == TITLES_FILE or source.endswith(f"/{TITLES_FILE}") + + +def add_nav_context(po: polib.POFile) -> int: + """Give the navigation titles in a catalog their own context. + + An entry that is only used by the navigation titles file gets the + navigation context. An entry that is also used elsewhere (usually as a page + heading) is split in two: the existing entry keeps the other references, + and a new entry with the navigation context gets the navigation titles + file reference. + + :param po: The catalog, as generated by ``md2po``; it is modified in place. + :returns: The number of navigation entries. + """ + count = 0 + for entry in list(po): + if entry.msgctxt or entry.obsolete: + continue + titles = [o for o in entry.occurrences if is_titles_source(o[0])] + if not titles: + continue + count += 1 + others = [o for o in entry.occurrences if not is_titles_source(o[0])] + if others: + entry.occurrences = others + po.insert( + po.index(entry) + 1, + polib.POEntry( + msgid=entry.msgid, + msgctxt=NAV_CONTEXT, + msgstr="", + occurrences=titles, + ), + ) + else: + entry.msgctxt = NAV_CONTEXT + return count + + +def previous_translation(previous: polib.POFile, title: str): + """Find the translation a navigation title had before it had a context. + + :param previous: The catalog to search. + :param title: The navigation title. + :returns: A ``(translation, flags)`` tuple, or None if there's no + translation. + """ + # A literate-nav link entry is what the navigation actually displayed. + for entry in previous: + if entry.obsolete or entry.msgctxt or not entry.msgstr: + continue + link = LINK_RE.match(entry.msgid) + if link and link.group("title") == title: + translated = LINK_RE.match(entry.msgstr) + if translated: + return translated.group("title"), list(entry.flags) + + # Otherwise, an entry with the same text and no context. + for entry in previous: + if entry.obsolete or entry.msgctxt or not entry.msgstr: + continue + if entry.msgid == title: + return entry.msgstr, list(entry.flags) + + return None + + +def seed_nav_translations(po: polib.POFile, previous: polib.POFile) -> list[str]: + """Fill in untranslated navigation entries from previous translations. + + :param po: The catalog to update, in place. + :param previous: The catalog containing the previous translations. This + can be the same catalog as ``po``. + :returns: The navigation titles that were filled in. + """ + seeded = [] + for entry in po: + if entry.obsolete or entry.msgctxt != NAV_CONTEXT or entry.msgstr: + continue + if found := previous_translation(previous, entry.msgid): + entry.msgstr, entry.flags = found + seeded.append(entry.msgid) + return seeded diff --git a/src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md b/src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md index 363d8359..d806fbed 100644 --- a/src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md +++ b/src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md @@ -1,4 +1,4 @@ -This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content. +This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content. ## General style @@ -15,7 +15,7 @@ This guide includes information on expected style, MkDocs-specific syntax, vario You should cross-reference content in documentation whenever possible. This section covers the various ways you can do that, each of which are based on the type of information being referenced. -MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows: +Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows: ```markdown [Link text](https://example.com/) @@ -27,15 +27,15 @@ You can also use this format to link to a local file: [Link text](path/to/file.md) ``` -Referencing specific sections of files, or API documentation requires using the MkDocs reference link format. +Referencing specific sections of files, or API documentation requires using the Zensical reference link format. ### Custom Markdown anchors and content cross-referencing Markdown generates anchors for all headers (anything on a single line starting with between one and six `#` symbols), based on the content of the header. For example, the anchor generated for this section is `custom-markdown-anchors-and-content-cross---referencing`. However, due to the way that our translations work, anytime a section header is referenced, it must have a custom anchor. -MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors. +Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors. -MkDocs reference links are any links formatted as follows: +Zensical reference links are any links formatted as follows: ```markdown [Link text][link-target] @@ -43,7 +43,7 @@ MkDocs reference links are any links formatted as follows: /// warning | Custom header and content anchors are required -Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated. +Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated. /// @@ -77,7 +77,7 @@ Standard Markdown is used to link to an anchor _in the same file_, which is form [Link text](#anchor-name) ``` -Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows: +Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows: ```markdown [Link text][anchor-name] @@ -85,7 +85,7 @@ Linking to an anchor in a separate document uses the MkDocs reference link style ### API reference links -The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references. +Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references. There are multiple options for linking to a documented class, or a class method or attribute, regardless of whether you are linking from the same file or a separate file. When linking to classes, etc., you must include backticks in the first set of square brackets to render the name as inline code. The backticks are not necessary only if you are using custom text that should not be rendered as inline code. Backticks should never be included in the second set of square brackets. @@ -208,7 +208,7 @@ Note text here. Content below. ``` -All [supported admonition types](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#supported-types) are available for use as admonitions. +All [supported admonition types](https://zensical.org/docs/authoring/admonitions/#supported-types) are available for use as admonitions. ### Tabbed content @@ -274,7 +274,7 @@ Collapsed content. Content below. ``` -All [supported admonition types](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#supported-types) are available for use with collapsed content, however, you must declare them as `details-admonitiontype`. So, a "note" type collapsed block would be `details-note` (as shown above), a "warning" type collapsed block would be `details-warning`, and so on. +All [supported admonition types](https://zensical.org/docs/authoring/admonitions/#supported-types) are available for use with collapsed content, however, you must declare them as `details-admonitiontype`. So, a "note" type collapsed block would be `details-note` (as shown above), a "warning" type collapsed block would be `details-warning`, and so on. ### Jinja directives @@ -368,7 +368,7 @@ Important notes: ### Using Macros to include content from BeeWare Docs Tools shared content -You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin](https://mkdocs-macros-plugin.readthedocs.io/en/latest/pages/). This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism](https://mkdocs-macros-plugin.readthedocs.io/en/latest/pages/#1-variable) works with this method. +You can also include content from the BeeWare Docs tools shared content directory using [Macros](https://mkdocs-macros-plugin.readthedocs.io/en/latest/pages/), which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism](https://mkdocs-macros-plugin.readthedocs.io/en/latest/pages/#1-variable) works with this method. There are options for including content using Macros: diff --git a/src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md b/src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md index 7db47ed0..1073f99b 100644 --- a/src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md +++ b/src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md @@ -2,7 +2,7 @@ You might have the best software in the world - but if nobody knows how to use i ## Documentation forms { #docs-form } -{{ formal_name }}'s documentation is written using [MkDocs and Markdown](https://www.markdownguide.org/basic-syntax/). We aim to follow the [Diataxis](https://diataxis.fr) framework for structuring documentation. +{{ formal_name }}'s documentation is written using [Zensical](https://zensical.org) and [Markdown](https://www.markdownguide.org/basic-syntax/). We aim to follow the [Diataxis](https://diataxis.fr) framework for structuring documentation. The Diataxis framework describes four "forms" of documentation: diff --git a/src/beeware_docs_tools/shared_content/locales/ar/translations.po b/src/beeware_docs_tools/shared_content/locales/ar/translations.po index 6871709b..39440905 100644 --- a/src/beeware_docs_tools/shared_content/locales/ar/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/ar/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -363,7 +363,7 @@ msgstr "يجب أن تستخدم أي إشارة إلى اسم منتج الأح msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "إذا كان المصطلح يستخدم \"ككود\"، فيجب اقتباسه حرفياً (`مثل هذا`) بدلاً من إضافته إلى القاموس." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 #, fuzzy msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1635,8 +1635,8 @@ msgstr "إذا كانت اللغة التي تخطط للمساعدة بها غ #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "قم بإنشاء ملف `/docs/mkdocs.language-code.yml`، مع محتوى خاص باللغة." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "قم بإنشاء ملف `/docs/zensical.language-code.toml`، مع محتوى خاص باللغة." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1645,8 +1645,8 @@ msgstr "قم بتحديث ملف `tox.ini` لتضمين أوامر إنشاء ا #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "قم بتحديث `/docs/config.yml` لتضمين اللغة تحت `extra: alternate:`." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "قم بتحديث `/docs/zensical.toml` لتضمين اللغة تحت `extra.alternate`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1655,54 +1655,35 @@ msgstr "فيما يلي توضيح للتغييرات اللازمة باستخ #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "ملف تكوين MkDocs جديد" +msgid "A new language configuration file" +msgstr "ملف تكوين Zensical جديد" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "أولاً، قم بإنشاء ملف جديد باسم `mkdocs.de.yml` في دليل `docs`، مع المحتوى التالي:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "أولاً، قم بإنشاء ملف جديد باسم `zensical.de.toml` في دليل `docs`، مع المحتوى التالي:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} الوثائق\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: حول\n" -" Documentation: الوثائق\n" -" Community: المجتمع\n" -" Contributing: المساهمة\n" -" News: الأخبار\n" -" Sponsor: الرعاة" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1710,9 +1691,8 @@ msgid "Here's what is going on in this file:" msgstr "إليك ما يحدث في هذا الملف:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "يرث هذا الملف محتوى التكوين من `config.yml`." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1721,201 +1701,188 @@ msgstr "يتم ترجمة قيمة `site_name`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "قيمة `site_url` هي عنوان URL لموقع المشروع، متبوعًا برمز اللغة." +msgid "The `docs_dir` should be the language code." +msgstr "يجب أن يكون `docs_dir` هو رمز اللغة." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "يجب أن يكون `docs_dir` هو رمز اللغة." +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "يجب أن تكون قيمة `theme.language` هي رمز اللغة، كما [محدد في سمة Zensical]{1}. بالنسبة لمعظم اللغات، سيكون هذا هو نفس رمز اللغة `docs_dir`؛ ولكن بالنسبة لبعض اللغات (خاصة اللغات التي لها متغيرات محلية مثل `zh_CN`)، هناك اختلافات." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "يجب أن تكون قيمة `theme: language:` هي رمز اللغة، كما [محدد في سمة MkDocs Material]{1}. بالنسبة لمعظم اللغات، سيكون هذا هو نفس رمز اللغة `docs_dir`؛ ولكن بالنسبة لبعض اللغات (خاصة اللغات التي لها متغيرات محلية مثل `zh_CN`)، هناك اختلافات." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "يجب أن يكون `extra.language_url` رمز اللغة، متبوعًا بشرطة مائلة واحدة، على سبيل المثال `de/` للألمانية." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "يجب أن يكون `extra: language_url:` رمز اللغة، متبوعًا بشرطة مائلة واحدة، على سبيل المثال `de/` للألمانية." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "يجب أن يكون `extra.translation_type` هو `machine` حتى تصل الترجمة إلى 100٪ لأول مرة، وعندها يجب أن يكون `human`. سيعود إلى `machine` من `human` إذا تراجع إلى أقل من 90٪." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "يجب أن يكون `extra: translation_type:` هو `machine` حتى تصل الترجمة إلى 100٪ لأول مرة، وعندها يجب أن يكون `human`. سيعود إلى `machine` من `human` إذا تراجع إلى أقل من 90٪." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "المحتوى الموجود تحت `extra: header` هو ترجمات العناوين التي تظهر في شريط العناوين. هذا التعريف *غير* مطلوب على الموقع الرئيسي لـ BeeWare؛ إنه مطلوب فقط على *المواقع الأخرى* (مثل البرنامج التعليمي أو وثائق المشروع)." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "المحتوى الموجود تحت `extra.header` هو ترجمات العناوين التي تظهر في شريط العناوين. هذا التعريف *غير* مطلوب على الموقع الرئيسي لـ BeeWare؛ إنه مطلوب فقط على *المواقع الأخرى* (مثل البرنامج التعليمي أو وثائق المشروع)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "تحديث `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "ستحتاج إلى إجراء عدة تغييرات على ملف `tox.ini`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "يمكنك إضافة ما يلي:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "علامة بيئة رمز اللغة الجديدة في سطر الرأس الذي يبدأ بـ `[testenv:docs`، مع رمز اللغة مسبوقًا بـ `-`، بدون مسافات، على سبيل المثال `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "استبعاد رمز اللغة الجديد من الأمر الأول، الذي يبدأ بـ `!lint`، يسبقه `-!`، بدون مسافات، على سبيل المثال `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "رمز اللغة الجديد للسطر الذي يبدأ بـ `translate : build_po_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "رمز اللغة الجديد للسطر الذي يبدأ بـ `translate : update_machine_translations`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "أمر جديد، يبدأ على سبيل المثال بـ `de : build_md_translations` للألمانية، أبجديًا ضمن الأوامر الحالية الخاصة باللغة والتي تتطابق مع محتوى تلك الأوامر، مع رمز اللغة الجديد." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "رمز اللغة الجديد للسطر الذي يبدأ بـ `all:`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "تحديث `config.yml`" +msgid "Update `zensical.toml`" +msgstr "تحديث `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "أضف اللغة إلى `config.yml` حتى تظهر في محدد اللغة في العنوان. ابحث عن القسم الذي يبدأ بـ `extra:`، ثم حدد القسم الفرعي الذي يبدأ بـ `alternate:`. بالنسبة للألمانية، يمكنك إضافة ما يلي:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- الاسم: الألمانية\n" -" الرابط: /de/\n" -" اللغة: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "يجب ترجمة اسم اللغة إلى اللغة. يجب أن يتضمن الرابط علامات `/`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "تشغيل `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "يمكنك الآن تشغيل `tox -e docs-translate`. سيؤدي ذلك إلى إنشاء ملف ترجمة فارغ؛ إذا كان لديك حساب DeepL، فيمكنك استخدام هذا الحساب لملء الترجمات الآلية الأولية. إذا لم يكن لديك حساب DeepL، فلا بأس - سنقوم بتشغيل الترجمات الأولية بأنفسنا قبل قبول طلب السحب." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "إرشادات الترجمة" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "بمجرد انضمامك إلى الفريق، حان الوقت لتسجيل الدخول إلى [Weblate]{1} والبدء في ترجمة السلاسل." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "الترجمة الحرفية مقابل الترجمة المعنوية" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "من الأهم الحفاظ على نبرة النص الإنجليزي بدلاً من السعي إلى ترجمة حرفية. نحاول أن نكون ودودين وأن نستخدم لغة عامية في محتوانا؛ حاول الحفاظ على روح ذلك في ترجماتك." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "إذا كان النص الإنجليزي يحتوي على تعبير إنجليزي قوي، فلا تشعر أنك ملزم بالحفاظ على هذا التعبير، إذا كان هناك تعبير مماثل في لغتك يعمل بنفس الكفاءة. إذا كان المصطلح أو العبارة في النص الإنجليزي تعبيرًا اصطلاحيًا أو عاميًا بشكل خاص، فلا تخف من إخبارنا بأننا يجب أن نفكر في إجراء تغيير. حتى بالنسبة للمتحدثين باللغة الإنجليزية، يمكن أن تشكل التعبيرات الاصطلاحية واللغة العامية صعوبة. في بعض الأحيان، نحتاج إلى تغيير النص الإنجليزي لجعله أكثر وضوحًا للمترجمين والقراء على حد سواء." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "هل يجب أن أترجمها؟" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "يجب *عدم* ترجمة أو تحديث العناصر التالية:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**الأوامر**. على سبيل المثال، في \"يجب عليك تشغيل \\`briefcase create\\`.\"، يجب ترجمة \"يجب عليك تشغيل\" فقط." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**مساحات الأسماء**، مثل أسماء الفئات أو الطرق أو السمات." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**عناوين URL للروابط**. يجب أن تظهر روابط Markdown القياسية في Weblate على النحو التالي: `[Link text]{1}`، حيث يمثل `1` موضع الرابط في السلسلة بالنسبة إلى الروابط الأخرى المحتملة. إذا تضمنت السلسلة عنوان URL الكامل، على النحو التالي: `[Link text](https://example.com/)`، فيجب تخطي عنوان URL هذا عند الترجمة." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**روابط مرجعية تحتوي على أسماء فئات أو طرق أو سمات**. يجب تركها كما هي، بما في ذلك علامات الاقتباس المائلة. لن يتم ترجمة أي جزء من رابط المثال الموضح هنا." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][سمة_الفئة]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**محتوى رابط مرجعي**. على سبيل المثال، سيتم تخطي `link-content` في ما يلي:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[نص الرابط][محتوى الرابط]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**توجيهات Jinja**. هذا هو أي محتوى محاط بزوجين من الأقواس المتعرجة المتطابقة، أو زوج من الأقواس المتعرجة المفردة المتطابقة مع علامات النسبة المئوية داخل كل طرف. ملاحظة: إدراج مثال على بناء الجملة هنا يؤدي إلى محاولة المكون الإضافي Macros عرضه؛ انظر [وثائق Macros]{1} للحصول على أمثلة." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**مثبتات مخصصة**. توجد بعد العناوين أو فوق بعض المحتويات، ويتم تنسيقها على النحو التالي: `{ #anchor }`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**صيغة التحذير**. في المثال التالي، لا ينبغي ترجمة كلمة \"admonition\" (تحذير). وينطبق هذا على جميع أنواع التحذيرات، بما في ذلك الملاحظات والتحذيرات وما إلى ذلك. انظر القسم التالي للحصول على معلومات حول ترجمة بقية المحتوى." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1930,52 +1897,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**العلامات المائلة**. من المفترض أن تظل على شكل علامات مائلة؛ وهي تُستخدم لتنسيق كل من الكود المضمن والكتل البرمجية." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**صيغة تضمين المحتوى الخارجي**. أي شيء موجود في نفس السطر الذي يحتوي على `-8<-`، أو في الأسطر بين اثنين من `-8<-` في أسطر منفصلة." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "يجب ترجمة العناصر التالية:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**نص الرابط**. في صيغة الرابط، يأتي النص قبل عنوان URL، ويُوضع بين قوسين، كما في `[نص الرابط](URL)`. يجب أن تظهر روابط Markdown القياسية في Weblate على النحو التالي: `[نص الرابط]{1}`، حيث `1` هو موضع الرابط في السلسلة مع الإشارة إلى الروابط الأخرى المحتملة." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**نص الرابط المرجعي**. على سبيل المثال، سيتم ترجمة `Link text` على النحو التالي:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**عناوين ومحتوى التحذيرات**. في مثال التحذير السابق، يجب ترجمة \"عنوان الصفحة\" و\"المحتوى\"." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "نحن نستخدم [Weblate]{1} لترجمة المحتوى الخاص بنا. عندما نضيف ترجمة جديدة، نستخدم [DeepL]{2} للترجمة الآلية لإنتاج ترجمة أولية. وهذا يعني، عادةً، أن المحتوى الذي ستترجمه قد تمت ترجمته آليًا بالفعل. ومن المتوقع أن تقوم أنت، كمترجم، بمراجعة الترجمة الآلية الحالية وتحريرها وتحسينها." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "يقوم Weblate بمعالجة كل شيء على أساس كل سلسلة على حدة. يقوم بتجميع التغييرات، وكل بضع ساعات، يرسل التزامًا جماعيًا بجميع السلاسل التي تم تغييرها في تلك الفترة. لذلك، قد يستغرق الأمر بضع ساعات حتى تظهر تغييراتك على الموقع الإلكتروني، ولكن يمكنك توقع ظهور التحديث في غضون أربع ساعات." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "إذا لم تظهر التغييرات بعد ذلك الوقت، فمن المحتمل أن يكون السبب هو وجود خطأ في الترميز، مما أدى إلى فشل إنشاء المستندات لتلك اللغة. أي مشكلة في الترميز في أي سلسلة ستمنع نشر الترجمة بالكامل. يمكنك مراقبة صفحة الإنشاء للغة الخاصة بك لمعرفة ما إذا تم إنشاؤها بنجاح. الرابط مشابه لهذا الرابط لصفحة الإنشاء باللغة الفرنسية {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; قم بتغيير رمز اللغة إلى لغتك لعرض صفحة البناء المناسبة. سيظهر هذا حالة أحدث بناء للموقع. إذا فشل البناء، انظر إلى سجل البناء، وحاول تحديد مصدر المشكلة." @@ -2379,36 +2346,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "ستحتاج إلى إنشاء المستند في الموقع المناسب داخل دليل `docs/en`. لغرض المناقشة، سنفترض أنك تضيف مستندًا جديدًا باسم الملف `new_doc.md`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "بعد ذلك، ستحتاج إلى تحديث ملف `docs/en/SUMMARY.md` لتضمين ملفك الجديد. يتم تنظيم ملف `SUMMARY.md` بحيث يعكس بشكل أساسي بنية دليل `docs/en`، ولكن الأهم من ذلك أنه يحدد بشكل مباشر بنية الشريط الجانبي الأيسر. إذا حددت المقطع الذي تريد تضمين `new_doc.md` فيه، فلن تحتاج إلى تغيير أي شيء في `SUMMARY.md` إذا رأيت مسارًا بديلًا مدرجًا. على سبيل المثال:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./مسار/إلى/المجلد/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "إذا كان القسم الذي تنوي تضمين `new_doc.md` فيه عبارة عن قائمة من روابط Markdown الفردية، فستحتاج إلى إضافة رابط صريح إلى رابطك. على سبيل المثال:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [مستندي الجديد](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "كتابة الوثائق الخاصة بك" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "يمكنك الآن فتح الملف المطلوب في محررك وبدء الكتابة." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "لدينا [دليل أسلوب التوثيق]{1} الذي يحدد إرشاداتنا لكتابة وثائق BeeWare." @@ -3179,8 +3144,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "يتضمن هذا الدليل معلومات عن الأسلوب المتوقع، وبنية MkDocs الخاصة، والأدوات المختلفة المطلوبة، وترجمة الوثائق، فيما يتعلق بكتابة محتوى جديد وترجمة المحتوى الموجود." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "يتضمن هذا الدليل معلومات عن الأسلوب المتوقع، وبنية Zensical الخاصة، والأدوات المختلفة المطلوبة، وترجمة الوثائق، فيما يتعلق بكتابة محتوى جديد وترجمة المحتوى الموجود." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3239,8 +3204,8 @@ msgstr "يجب عليك إجراء مراجعة مرجعية للمحتوى في #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "يقوم MkDocs بعرض الروابط المنسقة بتنسيق Markdown القياسي. فيما يلي الروابط التشعبية على الويب المنسقة بتنسيق Markdown القياسي:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "يقوم Zensical بعرض الروابط المنسقة بتنسيق Markdown القياسي. فيما يلي الروابط التشعبية على الويب المنسقة بتنسيق Markdown القياسي:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3259,8 +3224,8 @@ msgstr "[نص الرابط](مسار/إلى/الملف.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "للإشارة إلى أقسام محددة من الملفات أو وثائق API، يجب استخدام تنسيق رابط مرجع MkDocs." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "للإشارة إلى أقسام محددة من الملفات أو وثائق API، يجب استخدام تنسيق رابط مرجع Zensical." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3274,13 +3239,13 @@ msgstr "يُنشئ Markdown روابط لجميع العناوين (أي شيء #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "يدعم MkDocs عرض صيغة ارتباط مرجعي تسمح لك بالارتباط بالعديد من العناصر الأخرى في الوثائق باستخدام ارتباط Markdown معدل. ويشمل ذلك الارتباط، من بين أمور أخرى، برؤوس Markdown المخصصة ومثبتات النص." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "يدعم Zensical عرض صيغة ارتباط مرجعي تسمح لك بالارتباط بالعديد من العناصر الأخرى في الوثائق باستخدام ارتباط Markdown معدل. ويشمل ذلك الارتباط، من بين أمور أخرى، برؤوس Markdown المخصصة ومثبتات النص." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "روابط مرجعية MkDocs هي أي روابط منسقة على النحو التالي:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "روابط مرجعية Zensical هي أي روابط منسقة على النحو التالي:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3294,8 +3259,8 @@ msgstr "/// warning | يلزم وجود عناوين مخصصة ومحتويات #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "أي عنوان أو قسم محتوى يتم الإشارة إليه في محتوى نصي عبر رابط مرجعي MkDocs في وثائق BeeWare _يجب_ أن يكون مرفقًا به رابط مخصص. وإلا، فهناك احتمال لكسر الروابط عند ترجمة محتوى العنوان." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "أي عنوان أو قسم محتوى يتم الإشارة إليه في محتوى نصي عبر رابط مرجعي Zensical في وثائق BeeWare _يجب_ أن يكون مرفقًا به رابط مخصص. وإلا، فهناك احتمال لكسر الروابط عند ترجمة محتوى العنوان." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3354,8 +3319,8 @@ msgstr "[نص الرابط](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "يستخدم الارتباط بمرساة في مستند منفصل نمط ارتباط مرجعي MkDocs، والذي يتم تنسيقه على النحو التالي:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "يستخدم الارتباط بمرساة في مستند منفصل نمط ارتباط مرجعي Zensical، والذي يتم تنسيقه على النحو التالي:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3369,8 +3334,8 @@ msgstr "روابط مرجعية API" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "تدعم روابط مرجعية MkDocs أيضًا الإحالات المرجعية لوثائق واجهة برمجة التطبيقات (API)، بما في ذلك الفئات الموثقة وأساليب أو سمات الفئات، والإحالات المرجعية للوثائق الخارجية المحددة." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "تدعم روابط مرجعية Zensical أيضًا الإحالات المرجعية لوثائق واجهة برمجة التطبيقات (API)، بما في ذلك الفئات الموثقة وأساليب أو سمات الفئات، والإحالات المرجعية للوثائق الخارجية المحددة." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3945,8 +3910,8 @@ msgstr "استخدام الماكرو لإدراج محتوى من BeeWare Docs #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "يمكنك أيضًا تضمين محتوى من دليل المحتوى المشترك لأدوات BeeWare Docs باستخدام [المكوّن الإضافي Macros MkDocs]{1}. هذه الطريقة ضرورية إذا كان المستند يحتوي على توجيهات Jinja التي يجب تنفيذها، ويجب استخدامها فقط في هذه الحالة. لن تعمل مع المحتوى الخارجي عبر عنوان URL. تعمل [آلية استبدال المتغيرات Macros]{2} مع هذه الطريقة." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "يمكنك أيضًا تضمين محتوى من دليل المحتوى المشترك لأدوات BeeWare Docs باستخدام [Macros]{1}. هذه الطريقة ضرورية إذا كان المستند يحتوي على توجيهات Jinja التي يجب تنفيذها، ويجب استخدامها فقط في هذه الحالة. لن تعمل مع المحتوى الخارجي عبر عنوان URL. تعمل [آلية استبدال المتغيرات Macros]{2} مع هذه الطريقة." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4457,8 +4422,8 @@ msgstr "نماذج التوثيق { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "تمت كتابة وثائق {{ formal_name }} باستخدام [MkDocs و Markdown]{1}. نهدف إلى اتباع إطار عمل [Diataxis]{2} لتنظيم الوثائق." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "تمت كتابة وثائق {{ formal_name }} باستخدام [Zensical]{1} و [Markdown]{2}. نهدف إلى اتباع إطار عمل [Diataxis]{3} لتنظيم الوثائق." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/cs/translations.po b/src/beeware_docs_tools/shared_content/locales/cs/translations.po index 3f19aae3..94ea5186 100644 --- a/src/beeware_docs_tools/shared_content/locales/cs/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/cs/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: 2026-11-03 09:51+0000\n" "Last-Translator: Michal Várady <majkl82@users.noreply.hosted.weblate.org>\n" "Language-Team: Czech <https://hosted.weblate.org/projects/beeware/docs-tools-shared-content/cs/>\n" @@ -302,7 +302,7 @@ msgstr "Při odkazování na název produktu je třeba používat preferované v msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Pokud je termín používán „jako kód“, měl by být uveden v uvozovkách (`like this`) namísto přidání do slovníku." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1375,240 +1375,215 @@ msgid "If the language you plan to help out with doesn't already exist, there ar msgstr "Pokud jazyk, se kterým chcete pomáhat, ještě neexistuje, je třeba provést několik dalších kroků, než budete moci začít:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Vytvořte soubor `/docs/mkdocs.language-code.yml` s obsahem specifickým pro daný jazyk." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "Vytvořte soubor `/docs/zensical.language-code.toml` s obsahem specifickým pro daný jazyk." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 msgid "Update `tox.ini` to include the new language build commands." msgstr "Aktualizujte `tox.ini` tak, aby obsahoval nové příkazy pro sestavení jazyka." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "Aktualizujte `/docs/config.yml` tak, aby zahrnovalo jazyk pod `extra: alternate:`." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "Aktualizujte `/docs/zensical.toml` tak, aby zahrnovalo jazyk pod `extra.alternate`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 msgid "The following demonstrates the necessary changes using German as an example; a German translation already exists; replace the references to German, `de`, or other content for the language you're targeting." msgstr "Následující příklad ukazuje nezbytné změny na příkladu němčiny; německý překlad již existuje; nahraďte odkazy na němčinu, `de` nebo jiný obsah jazykem, na který se zaměřujete." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 -msgid "A new MkDocs configuration file" -msgstr "Nový konfigurační soubor MkDocs" +#, fuzzy +msgid "A new language configuration file" +msgstr "Nový konfigurační soubor Zensical" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "Nejprve vytvořte nový soubor s názvem `mkdocs.de.yml` v adresáři `docs` s následujícím obsahem:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "Nejprve vytvořte nový soubor s názvem `zensical.de.toml` v adresáři `docs` s následujícím obsahem:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" -"\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" +"\n" +"[project.theme]\n" +"language = \"de\"\n" +"\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" +"\n" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentace\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" -"\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: O nás\n" -" Documentation: Dokumentace\n" -" Community: Komunita\n" -" Contributing: Přispívání\n" -" News: Novinky\n" -" Sponsor: Sponzoři" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 msgid "Here's what is going on in this file:" msgstr "Toto se děje v tomto souboru:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Tento soubor dědí obsah konfigurace z `config.yml`." +#, fuzzy +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "Tento soubor dědí obsah konfigurace z `zensical.toml`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 msgid "The `site_name` value is translated." msgstr "Hodnota `site_name` je přeložena." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "Hodnota `site_url` je adresa URL webu projektu, za kterou následuje kód jazyka." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 msgid "The `docs_dir` should be the language code." msgstr "`docs_dir` by měl být kód jazyka." +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "Hodnota `theme.language` by měla být kód jazyka, jak je [specifikováno tématem Zensical]{1}. Pro většinu jazyků bude stejná jako kód jazyka `docs_dir`, ale u některých (zejména u jazyků s variantami locale, jako je `zh_CN`) existují rozdíly." + #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "Hodnota `theme: language:` by měla být kód jazyka, jak je [specifikováno tématem MkDocs Material]{1}. Pro většinu jazyků bude stejná jako kód jazyka `docs_dir`, ale u některých (zejména u jazyků s variantami locale, jako je `zh_CN`) existují rozdíly." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "`extra.language_url` by měl být kód jazyka, za nímž následuje jediná lomítka, např. `de/` pro němčinu." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "`extra: language_url:` by měl být kód jazyka, za nímž následuje jediná lomítka, např. `de/` pro němčinu." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "`extra.translation_type` by mělo být `machine`, dokud překlad poprvé nedosáhne 100 %; v tom okamžiku by mělo být `human`. Pokud překlad klesne pod 90 %, vrátí se z `human` zpět na `machine`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "`extra: translation_type:` by mělo být `machine`, dokud překlad poprvé nedosáhne 100 %; v tom okamžiku by mělo být `human`. Pokud překlad klesne pod 90 %, vrátí se z `human` zpět na `machine`." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "Obsah pod `extra.header` jsou překlady názvů, které se zobrazují v záhlaví. Tato definice *není* vyžadována na hlavní webové stránce BeeWare; je vyžadována pouze na *jiných* stránkách (například v tutoriálu nebo v dokumentaci k projektu)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "Obsah pod `extra: header` jsou překlady názvů, které se zobrazují v záhlaví. Tato definice *není* vyžadována na hlavní webové stránce BeeWare; je vyžadována pouze na *jiných* stránkách (například v tutoriálu nebo v dokumentaci k projektu)." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 msgid "Update `tox.ini`" msgstr "Aktualizovat `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 msgid "You'll need to make several changes to the `tox.ini` file." msgstr "Budete muset provést několik změn v souboru `tox.ini`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 msgid "You would add the following:" msgstr "Přidali byste následující:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "Nový příznak jazykového kódu v záhlaví řádku, který začíná `[testenv:docs`, s jazykovým kódem předcházejícím `-`, bez mezer, např. `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "Nové vyloučení jazykového kódu z prvního příkazu, který začíná znaky `!lint`, před nimiž jsou znaky `-!`, bez mezer, např. `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "Nový jazykový kód pro řádek začínající `translate : build_po_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "Nový jazykový kód pro řádek začínající znaky `translate : update_machine_translations`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "Nový příkaz, začínající například `de : build_md_translations` pro němčinu, abecedně v rámci stávajících příkazů specifických pro daný jazyk, který odpovídá obsahu těchto příkazů, s novým kódem jazyka." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 msgid "The new language code to the line beginning with `all:`." msgstr "Nový jazykový kód pro řádek začínající `all:`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 -msgid "Update `config.yml`" -msgstr "Aktualizace `config.yml`" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 +msgid "Update `zensical.toml`" +msgstr "Aktualizace `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Přidejte jazyk do `config.yml`, aby se zobrazil v nabídce pro výběr jazyka v záhlaví. Najděte sekci začínající `extra:`, a poté vyhledejte podsekci začínající `alternate:`. Pro němčinu byste přidali následující:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +#, fuzzy +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "Přidejte jazyk do `zensical.toml`, aby se zobrazil v nabídce pro výběr jazyka v záhlaví. Najděte sekci začínající `[project.extra]`, a poté vyhledejte podsekci začínající `alternate`. Pro němčinu byste přidali následující:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- název: Němčina\n" -" odkaz: /de/\n" -" jazyk: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "Název jazyka by měl být přeložen do daného jazyka. Odkaz musí obsahovat znaky `/`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 msgid "Run `tox translate`" msgstr "Spustit `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Nyní můžete spustit `tox -e docs-translate`. Tím se vygeneruje prázdný překladový soubor. Pokud máte účet DeepL, můžete jej použít k vyplnění počátečních strojových překladů. Pokud účet DeepL nemáte, nevadí – počáteční překlady provedeme sami, než přijmeme žádost o stažení." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 msgid "Translation guidelines" msgstr "Pokyny pro překlad" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "Jakmile budete přidáni do týmu, je čas se přihlásit do [Weblate]{1} a začít pracovat na překladu řetězců." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 msgid "Tone versus word-for-word translation" msgstr "Tón versus doslovný překlad" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "Je důležitější zachovat tón anglického textu než usilovat o doslovný překlad. Ve svém obsahu se snažíme být přátelští a trochu hovorní; snažte se zachovat tohoto ducha ve svých překladech." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "Pokud anglický text obsahuje silný anglický idiom, nemusíte se cítit povinni tento idiom zachovat, pokud ve vašem jazyce existuje ekvivalent, který by fungoval stejně dobře. Pokud je termín nebo fráze v anglickém textu obzvláště idiomatický nebo slangový, nebojte se nám sdělit, že bychom měli zvážit jeho změnu. I pro mluvčí angličtiny mohou idiomy a slang představovat obtíž. Někdy je třeba anglický text změnit, aby byl srozumitelnější jak pro překladatele, tak pro čtenáře." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 msgid "Should I translate it?" msgstr "Mám to přeložit?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 msgid "The following items should *not* be translated or updated:" msgstr "Následující položky by *neměly* být překládány ani aktualizovány:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Příkazy**. Například ve větě „Měli byste spustit \\`briefcase create\\`.“ by se mělo přeložit pouze „Měli byste spustit“." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Prostory jmen**, jako jsou názvy tříd, metod nebo atributů." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**URL odkazů**. Standardní odkazy ve formátu Markdown by se ve Weblate měly zobrazovat jako `[Link text]{1}`, kde `1` označuje pozici odkazu v řetězci vzhledem k ostatním možným odkazům. Pokud je v řetězci uvedena úplná URL adresa, například `[Link text](https://example.com/)`, měla by být při překladu vynechána." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Odkazy obsahující názvy tříd, metod nebo atributů**. Tyto odkazy by měly zůstat beze změny, včetně zpětných lomítek. Žádná část zde uvedeného příkladu odkazu by neměla být překládána." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Třída.atribut]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**Obsah odkazu Reference**. Například `link-content` by bylo v následujícím příkladu přeskočeno:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 msgid "[Link text][link-content]" msgstr "[Text odkazu][obsah odkazu]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Jinja direktivy**. Jedná se o jakýkoli obsah uzavřený mezi dvěma páry shodných složených závorek nebo mezi párem shodných jednoduchých složených závorek s procenty na obou koncích. Poznámka: Pokud sem vložíte příklad syntaxe, plugin Macros se pokusí jej vykreslit; příklady najdete v [dokumentaci k makrům]{1}." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Vlastní kotvy**. Nacházejí se za záhlavími nebo nad určitým obsahem a jsou formátovány jako `{ #anchor }`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Syntaxe napomenutí**. V následujícím příkladu by slovo „napomenutí“ nemělo být překládáno. To platí pro všechny styly napomenutí, včetně poznámek, varování atd. Informace o překladu zbytku obsahu naleznete v následující části." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 msgid "" "/// admonition | Page Title\n" "\n" @@ -1622,43 +1597,43 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Zpětné lomítko**. Mají zůstat jako zpětná lomítka; používají se pro formátování jak vloženého kódu, tak bloků kódu." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**Syntaxe pro zahrnutí externího obsahu**. Jedná se o cokoli na stejném řádku jako `-8<-` nebo na řádcích mezi dvěma `-8<-` na samostatných řádcích." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 msgid "The following items *should* be translated:" msgstr "Následující položky *by* měly být přeloženy:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Text odkazu**. V syntaxi odkazu se text uvádí před URL adresou a je uzavřen v závorkách, jako v `[Link text](URL)`. Standardní odkazy Markdown by se měly v Weblate zobrazovat jako `[Link text]{1}`, kde `1` je pozice odkazu v řetězci s odkazem na jiné možné odkazy." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Text odkazu**. Například `Link text` by bylo přeloženo následovně:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Názvy a obsah napomenutí**. V předchozím příkladu napomenutí je třeba přeložit „Název stránky“ a „Obsah“." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "Pro překlad obsahu používáme [Weblate]{1}. Když přidáváme nový překlad, používáme [DeepL]{2} pro strojový překlad, abychom vytvořili první verzi překladu. To znamená, že obsah, který budete překládat, je obvykle již strojově přeložen. Očekává se, že jako překladatel budete stávající strojový překlad zkontrolovat, upravit a vylepšit." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate zpracovává vše po jednotlivých řetězcích. Změny seskupuje a každých pár hodin odešle hromadný commit se všemi řetězci, které se v daném intervalu změnily. Může tedy trvat několik hodin, než se vaše změny projeví na webových stránkách, ale můžete očekávat, že aktualizace se objeví do čtyř hodin." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Pokud se vaše změny ani po uplynutí této doby nezobrazí, pravděpodobnou příčinou je chyba v značkách, která vede k selhání sestavení dokumentace pro daný jazyk. Jakýkoli problém se značkami v jakémkoli řetězci zablokuje zveřejnění celého překladu. Můžete sledovat stránku sestavení pro váš jazyk, abyste zjistili, zda se sestavení podařilo. Odkaz je formátován podobně jako tento odkaz na francouzskou stránku sestavení {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; změňte kód jazyka na svůj jazyk, abyste zobrazili příslušnou stránku sestavení. Zobrazí se stav nejnovějšího sestavení webu. Pokud sestavení selže, podívejte se do protokolu sestavení a zkuste zjistit příčinu problému." @@ -1999,30 +1974,32 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "Dokument budete muset vytvořit na příslušném místě v adresáři `docs/en`. Pro účely této diskuse budeme předpokládat, že přidáváte nový dokument s názvem `new_doc.md`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "Poté budete muset aktualizovat soubor `docs/en/SUMMARY.md`, aby zahrnoval váš nový soubor. Soubor `SUMMARY.md` je uspořádán tak, aby v zásadě odrážel strukturu adresáře `docs/en`, ale co je důležitější, přímo určuje strukturu levého postranního panelu. Pokud najdete sekci, do které chcete zahrnout `new_doc.md`, nemusíte v souboru `SUMMARY.md` nic měnit, pokud vidíte uvedenou cestu se zástupnými znaky. Například:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -msgid "- ./path/to/directory/*" -msgstr "- ./cesta/k/adresáři/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "Pokud je část, do které chcete vložit `new_doc.md`, seznamem jednotlivých odkazů Markdown, budete muset přidat explicitní odkaz na ten svůj. Například:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -msgid "- [My new document](new_doc.md)" -msgstr "- [Můj nový dokument](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 msgid "Writing your documentation" msgstr "Psaní dokumentace" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 msgid "You can now open the desired file into your editor, and begin writing." msgstr "Nyní můžete otevřít požadovaný soubor ve svém editoru a začít psát." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "Máme [průvodce stylem dokumentace]{1}, který popisuje naše pokyny pro psaní dokumentace pro BeeWare." @@ -2651,8 +2628,8 @@ msgstr "" " \"\"\"Testovací dokumentační řetězec vypadá takto (#123456).\"\"\"" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Tato příručka obsahuje informace o očekávaném stylu, syntaxi specifické pro MkDocs, různých požadovaných nástrojích a překladu dokumentace, s ohledem na psaní nového obsahu a překlad stávajícího obsahu." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Tato příručka obsahuje informace o očekávaném stylu, syntaxi specifické pro Zensical, různých požadovaných nástrojích a překladu dokumentace, s ohledem na psaní nového obsahu a překlad stávajícího obsahu." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 msgid "General style" @@ -2699,8 +2676,8 @@ msgid "You should cross-reference content in documentation whenever possible. Th msgstr "V dokumentaci byste měli pokud možno používat křížové odkazy na obsah. Tato část popisuje různé způsoby, jak toho dosáhnout, přičemž každý z nich závisí na typu informací, na které odkazujete." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs vykresluje standardní odkazy ve formátu Markdown. Standardní webové hypertextové odkazy ve formátu Markdown mají následující podobu:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical vykresluje standardní odkazy ve formátu Markdown. Standardní webové hypertextové odkazy ve formátu Markdown mají následující podobu:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 msgid "[Link text](https://example.com/)" @@ -2715,8 +2692,8 @@ msgid "[Link text](path/to/file.md)" msgstr "[Text odkazu](cesta/k/souboru.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Odkazování na konkrétní části souborů nebo dokumentace API vyžaduje použití formátu odkazů MkDocs." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Odkazování na konkrétní části souborů nebo dokumentace API vyžaduje použití formátu odkazů Zensical." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 msgid "Custom Markdown anchors and content cross-referencing" @@ -2727,12 +2704,12 @@ msgid "Markdown generates anchors for all headers (anything on a single line sta msgstr "Markdown generuje kotvy pro všechny záhlaví (vše, co je na jednom řádku a začíná jedním až šesti symboly `#`), na základě obsahu záhlaví. Například kotva generovaná pro tuto sekci je `custom-markdown-anchors-and-content-cross---referencing`. Avšak vzhledem k tomu, jak fungují naše překlady, musí mít každé záhlaví sekce, na které se odkazuje, vlastní kotvu." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs podporuje vykreslování syntaxe odkazů, která umožňuje propojit různé prvky v dokumentaci pomocí upraveného odkazu Markdown. To zahrnuje mimo jiné propojení s vlastními záhlavími Markdown a textovými kotvami." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical podporuje vykreslování syntaxe odkazů, která umožňuje propojit různé prvky v dokumentaci pomocí upraveného odkazu Markdown. To zahrnuje mimo jiné propojení s vlastními záhlavími Markdown a textovými kotvami." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "Odkazy MkDocs jsou jakékoli odkazy ve formátu:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Odkazy Zensical jsou jakékoli odkazy ve formátu:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 msgid "[Link text][link-target]" @@ -2743,8 +2720,8 @@ msgid "/// warning | Custom header and content anchors are required" msgstr "/// warning | Custom header and content anchors are required" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "Každá sekce záhlaví nebo obsahu, na kterou se odkazuje v textovém obsahu prostřednictvím odkazu MkDocs v dokumentaci BeeWare, musí mít připojenou vlastní kotvu. V opačném případě hrozí, že při překladu obsahu záhlaví dojde k poškození odkazů." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "Každá sekce záhlaví nebo obsahu, na kterou se odkazuje v textovém obsahu prostřednictvím odkazu Zensical v dokumentaci BeeWare, musí mít připojenou vlastní kotvu. V opačném případě hrozí, že při překladu obsahu záhlaví dojde k poškození odkazů." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 msgid "If you need to link to a header anchor, you will need to generate a custom anchor for the intended content. The general syntax for setting a custom anchor is as follows:" @@ -2793,8 +2770,8 @@ msgid "[Link text](#anchor-name)" msgstr "[Text odkazu](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "Odkaz na kotvu v samostatném dokumentu používá styl odkazu MkDocs, který je formátován následovně:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "Odkaz na kotvu v samostatném dokumentu používá styl odkazu Zensical, který je formátován následovně:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 msgid "[Link text][anchor-name]" @@ -2805,8 +2782,8 @@ msgid "API reference links" msgstr "Odkazy na referenční API" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "Odkazy MkDocs také podporují křížové odkazy na dokumentaci API, včetně dokumentovaných tříd, metod nebo atributů tříd a konkrétních odkazů na externí dokumentaci." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Odkazy Zensical také podporují křížové odkazy na dokumentaci API, včetně dokumentovaných tříd, metod nebo atributů tříd a konkrétních odkazů na externí dokumentaci." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 msgid "There are multiple options for linking to a documented class, or a class method or attribute, regardless of whether you are linking from the same file or a separate file. When linking to classes, etc., you must include backticks in the first set of square brackets to render the name as inline code. The backticks are not necessary only if you are using custom text that should not be rendered as inline code. Backticks should never be included in the second set of square brackets." @@ -3309,8 +3286,9 @@ msgid "Using Macros to include content from BeeWare Docs Tools shared content" msgstr "Použití maker k vložení obsahu z BeeWare Docs Tools sdílený obsah" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "Můžete také zahrnout obsah ze sdíleného adresáře nástrojů BeeWare Docs pomocí [pluginu Macros MkDocs]{1}. Tato metoda je nezbytná, pokud dokument obsahuje direktivy Jinja, které je třeba provést, a měla by být použita pouze v této situaci. Nefunguje s externím obsahem přes URL. S touto metodou funguje [mechanismus nahrazování proměnných Macros]{2}." +#, fuzzy +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "Můžete také zahrnout obsah ze sdíleného adresáře nástrojů BeeWare Docs pomocí [Macros]{1}. Tato metoda je nezbytná, pokud dokument obsahuje direktivy Jinja, které je třeba provést, a měla by být použita pouze v této situaci. Nefunguje s externím obsahem přes URL. S touto metodou funguje [mechanismus nahrazování proměnných Macros]{2}." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 msgid "There are options for including content using Macros:" @@ -3729,8 +3707,8 @@ msgid "Documentation forms { #docs-form }" msgstr "Formuláře dokumentace { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 msgid "The Diataxis framework describes four \"forms\" of documentation:" diff --git a/src/beeware_docs_tools/shared_content/locales/da/translations.po b/src/beeware_docs_tools/shared_content/locales/da/translations.po index 8795f3c9..b72a22ec 100644 --- a/src/beeware_docs_tools/shared_content/locales/da/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/da/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -363,7 +363,7 @@ msgstr "Enhver henvisning til et produktnavn skal bruge produktets foretrukne st msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Hvis et udtryk bruges \"som kode\", skal det angives som en bogstavelig angivelse (`like this`) i stedet for at blive tilføjet til ordbogen." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 #, fuzzy msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1631,8 +1631,8 @@ msgstr "Hvis det sprog, du planlægger at hjælpe med, ikke allerede findes, er #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Opret filen `/docs/mkdocs.language-code.yml` med sprogspecifikt indhold." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "Opret filen `/docs/zensical.language-code.toml` med sprogspecifikt indhold." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1641,8 +1641,8 @@ msgstr "Opdater `tox.ini` for at inkludere de nye sprogopbygningskommandoer." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "Opdater `/docs/config.yml` for at inkludere sproget under `extra: alternate:`." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "Opdater `/docs/zensical.toml` for at inkludere sproget under `extra.alternate`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1651,54 +1651,35 @@ msgstr "Følgende viser de nødvendige ændringer ved hjælp af tysk som eksempe #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "En ny MkDocs-konfigurationsfil" +msgid "A new language configuration file" +msgstr "En ny Zensical-konfigurationsfil" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "Opret først en ny fil med navnet `mkdocs.de.yml` i mappen `docs` med følgende indhold:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "Opret først en ny fil med navnet `zensical.de.toml` i mappen `docs` med følgende indhold:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Om\n" -" Documentation: Dokumentation\n" -" Community: Fællesskab\n" -" Contributing: Bidrag\n" -" News: Nyheder\n" -" Sponsor: Sponsor" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1706,9 +1687,8 @@ msgid "Here's what is going on in this file:" msgstr "Her er, hvad der foregår i denne fil:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Denne fil arver konfigurationsindholdet fra `config.yml`." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1717,201 +1697,188 @@ msgstr "Værdien `site_name` oversættes." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "Værdien `site_url` er projektets webadressen efterfulgt af sprogkoden." +msgid "The `docs_dir` should be the language code." +msgstr "`docs_dir` skal være sprogkoden." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "`docs_dir` skal være sprogkoden." +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "Værdien `theme.language` skal være sprogkoden, som [angivet af Zensical-temaet]{1}. For de fleste sprog vil dette være det samme som sprogkoden `docs_dir`, men for nogle sprog (især sprog med lokale varianter som `zh_CN`) er der forskelle." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "Værdien `theme: language:` skal være sprogkoden, som [angivet af MkDocs Material-temaet]{1}. For de fleste sprog vil dette være det samme som sprogkoden `docs_dir`, men for nogle sprog (især sprog med lokale varianter som `zh_CN`) er der forskelle." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "`extra.language_url` skal være sprogkoden efterfulgt af en enkelt skråstreg, f.eks. `de/` for tysk." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "`extra: language_url:` skal være sprogkoden efterfulgt af en enkelt skråstreg, f.eks. `de/` for tysk." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "`extra.translation_type` skal være `machine` indtil oversættelsen når 100 % for første gang, hvorefter den skal være `human`. Den vil vende tilbage til `machine` fra `human`, hvis den falder til under 90 %." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "`extra: translation_type:` skal være `machine` indtil oversættelsen når 100 % for første gang, hvorefter den skal være `human`. Den vil vende tilbage til `machine` fra `human`, hvis den falder til under 90 %." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "Indholdet under `extra: header` er oversættelserne af titler, der vises i overskriftsbjælken. Denne definition er *ikke* påkrævet på BeeWares hovedwebsted; den er kun påkrævet på *andre* websteder (f.eks. vejledningen eller projektdokumentationen)." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "Indholdet under `extra.header` er oversættelserne af titler, der vises i overskriftsbjælken. Denne definition er *ikke* påkrævet på BeeWares hovedwebsted; den er kun påkrævet på *andre* websteder (f.eks. vejledningen eller projektdokumentationen)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "Opdater `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "Du skal foretage flere ændringer i `tox.ini` filen." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "Du skal tilføje følgende:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "Det nye sprogkodeflag til header-linjen, der begynder med `[testenv:docs`, hvor sprogkoden er forud for en `-`, uden mellemrum, f.eks. `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "Den nye sprogkodeeksklusion til den første kommando, der begynder med `!lint`, forud for `-!`, uden mellemrum, f.eks. `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "Den nye sprogkode til linjen, der begynder med `translate : build_po_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "Den nye sprogkode til linjen, der begynder med `translate : update_machine_translations`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "En ny kommando, der begynder med f.eks. `de : build_md_translations` for tysk, alfabetisk inden for de eksisterende sprogspecifikke kommandoer, der matcher indholdet af disse kommandoer, med den nye sprogkode." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "Den nye sprogkode til linjen, der begynder med `all:`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "Opdater `config.yml`" +msgid "Update `zensical.toml`" +msgstr "Opdater `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Føj sproget til `config.yml`, så det vises i sprogvælgeren i overskriften. Find afsnittet, der begynder med `extra:`, og find derefter underafsnittet, der begynder med `alternate:`. For tysk skal du tilføje følgende:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- navn: Tysk\n" -" link: /de/\n" -" sprog: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "Sprognavnet skal oversættes til sproget. Linket skal indeholde `/`s." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "Kør `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Du kan nu køre `tox -e docs-translate`. Dette vil generere en tom oversættelsesfil. Hvis du har en DeepL-konto, kan du bruge den til at udfylde de første maskinoversættelser. Hvis du ikke har en DeepL-konto, er det ikke noget problem – vi kører selv de første oversættelser, før vi accepterer pull-anmodningen." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "Retningslinjer for oversættelse" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "Når du er blevet tilføjet til teamet, er det tid til at logge ind på [Weblate]{1} og begynde at oversætte strenge." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "Tone kontra ordret oversættelse" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "Det er vigtigere at bevare tonen i den engelske tekst end at stræbe efter en ordret oversættelse. Vi forsøger at være venlige og lidt uformelle i vores indhold; prøv at bevare den ånd i dine oversættelser." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "Hvis den engelske tekst indeholder et stærkt engelsk idiom, skal du ikke føle dig forpligtet til at bevare idiomet, hvis der findes et analogt udtryk på dit sprog, der fungerer lige så godt. Hvis udtrykket eller sætningen i den engelske tekst er et særligt idiomatisk udtryk eller slangudtryk, skal du ikke være bange for at fortælle os, at vi bør overveje at ændre det. Selv for engelsktalende kan idiomer og slang udgøre en vanskelighed. Nogle gange er vi nødt til at ændre den engelske tekst for at gøre den mere forståelig for både oversættere og læsere." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "Skal jeg oversætte det?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "Følgende punkter bør *ikke* oversættes eller opdateres:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Kommandoer**. For eksempel skal kun \"Du skal køre\" oversættes i \"Du skal køre \\`briefcase create\\`.\"." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Navneområder**, såsom klasse-, metode- eller attributnavne." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**Link-URL'er**. Standard Markdown-links skal i Weblate angives som `[Link text]{1}`, hvor `1` angiver linkets placering i teksten i forhold til eventuelle andre links. Hvis den fulde URL er inkluderet i teksten, f.eks. `[Link text](https://example.com/)`, skal denne URL udelades ved oversættelsen." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Referencelinks, der indeholder klasse-, metode- eller attributnavne**. Disse skal forblive uændrede, inklusive backticks. Ingen dele af det her viste eksempel på et link vil blive oversat." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Klasse.attribut]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**Indholdet af et referencelink**. For eksempel vil `link-content` blive sprunget over i følgende:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[Linktekst][linkindhold]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Jinja-direktiver**. Dette er ethvert indhold, der er indkapslet mellem to par matchende krøllede parenteser eller et matchende par enkelte krøllede parenteser med procenttegn i hver ende. Bemærk: Hvis du inkluderer et eksempel på syntaksen her, vil Macros-pluginet forsøge at gengive det. Se [Macros-dokumentationen]{1} for eksempler." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Brugerdefinerede ankre**. De findes efter overskrifter eller over noget indhold og er formateret som `{ #anchor }`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Admonition syntax**. I det følgende eksempel skal ordet \"admonition\" ikke oversættes. Dette gælder alle former for formaninger, herunder bemærkninger, advarsler osv. Se næste afsnit for information om oversættelse af resten af indholdet." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1926,52 +1893,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Backticks**. De skal forblive som backticks; de bruges til formatering af både indbygget kode og kodeblokke." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**Syntaksen for at inkludere eksternt indhold**. Dette er alt, der står på samme linje som `-8<-`, eller på linjerne mellem to `-8<-` på separate linjer." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "Følgende punkter *bør* oversættes:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Linktekst**. I linksyntaks kommer teksten før URL'en og er omgivet af parenteser, som i `[Link text](URL)`. Standard Markdown-links skal vises i Weblate som `[Link text]{1}`, hvor `1` er linkets position i strengen med henvisning til andre mulige links." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Referencelinktekst**. For eksempel vil `Link text` blive oversat som følger:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Advarselstitler og indhold**. I det foregående eksempel på en advarsel skal \"Sidens titel\" og \"Indhold\" oversættes." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "Vi bruger [Weblate]{1} til oversættelse af vores indhold. Når vi tilføjer en ny oversættelse, bruger vi [DeepL]{2} til maskinoversættelse for at få en første udgave af oversættelsen. Det betyder, at det indhold, du skal oversætte, typisk allerede er maskinoversat. Det forventes, at du som oversætter gennemgår, redigerer og forbedrer den eksisterende maskinoversættelse." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate behandler alt streng for streng. Det samler ændringer og sender hvert par timer en samlet commit med alle de strenge, der er ændret i det pågældende interval. Det kan derfor tage et par timer, før dine ændringer vises på hjemmesiden, men du kan forvente, at opdateringen vises inden for fire timer." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Hvis dine ændringer stadig ikke er blevet vist efter dette tidspunkt, er den sandsynlige årsag en markup-fejl, der har resulteret i en fejl i dokumentopbygningen for det pågældende sprog. Ethvert markup-problem i en streng vil forhindre, at hele oversættelsen bliver offentliggjort. Du kan holde øje med opbygningssiden for dit sprog for at se, om det er blevet opbygget korrekt. Linket er formateret på samme måde som dette link til den franske opbygningsside {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; Skift sprogkoden til dit sprog for at se den relevante build-side. Dette viser status for den seneste build af webstedet. Hvis buildet mislykkes, skal du se på build-loggen og se, om du kan identificere årsagen til problemet." @@ -2375,36 +2342,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "Du skal oprette dokumentet på det relevante sted i `docs/en` -mappen. For diskussionens skyld antager vi, at du tilføjer et nyt dokument med filnavnet `new_doc.md`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "Derefter skal du opdatere `docs/en/SUMMARY.md` filen for at inkludere din nye fil. `SUMMARY.md` er organiseret, så den grundlæggende afspejler `docs/en` mappestrukturen, men, hvad der er endnu vigtigere, den bestemmer direkte strukturen i venstre sidepanel. Hvis du finder det afsnit, hvor du ønsker at inkludere `new_doc.md`, behøver du ikke ændre noget i `SUMMARY.md`, hvis du ser en wildcard-sti angivet. For eksempel:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./sti/til/mappe/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "Hvis det afsnit, hvor du vil indsætte `new_doc.md`, er en liste over individuelle Markdown-links, skal du tilføje et eksplicit link til dit. For eksempel:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [Mit nye dokument](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "Skrivning af din dokumentation" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "Du kan nu åbne den ønskede fil i din editor og begynde at skrive." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "Vi har en [dokumentationsstilguide]{1}, der beskriver vores retningslinjer for skrivning af dokumentation til BeeWare." @@ -3175,8 +3140,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Denne vejledning indeholder oplysninger om forventet stil, MkDocs-specifik syntaks, forskellige nødvendige værktøjer og oversættelse af dokumentation med hensyn til at skrive nyt indhold og oversætte eksisterende indhold." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Denne vejledning indeholder oplysninger om forventet stil, Zensical-specifik syntaks, forskellige nødvendige værktøjer og oversættelse af dokumentation med hensyn til at skrive nyt indhold og oversætte eksisterende indhold." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3235,8 +3200,8 @@ msgstr "Du bør krydshenvise til indhold i dokumentationen, når det er muligt. #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs gengiver standard Markdown-formaterede links. Standard Markdown-formaterede webhyperlinks er som følger:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical gengiver standard Markdown-formaterede links. Standard Markdown-formaterede webhyperlinks er som følger:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3255,8 +3220,8 @@ msgstr "[Linktekst](sti/til/fil.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Henvisning til specifikke afsnit i filer eller API-dokumentation kræver brug af MkDocs-referencelinkformatet." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Henvisning til specifikke afsnit i filer eller API-dokumentation kræver brug af Zensical-referencelinkformatet." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3270,13 +3235,13 @@ msgstr "Markdown genererer ankre for alle overskrifter (alt på en enkelt linje, #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs understøtter gengivelse af en referencelinksyntaks, der giver dig mulighed for at linke til forskellige andre elementer i dokumentationen ved hjælp af et modificeret Markdown-link. Dette omfatter blandt andet linking til brugerdefinerede Markdown-overskrifter og tekstankre." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical understøtter gengivelse af en referencelinksyntaks, der giver dig mulighed for at linke til forskellige andre elementer i dokumentationen ved hjælp af et modificeret Markdown-link. Dette omfatter blandt andet linking til brugerdefinerede Markdown-overskrifter og tekstankre." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "MkDocs-referencelinks er alle links, der er formateret som følger:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Zensical-referencelinks er alle links, der er formateret som følger:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3290,8 +3255,8 @@ msgstr "/// warning | Brugerdefinerede overskrifter og indholdsankre er påkræv #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "Enhver overskrift eller indholdssektion, der henvises til i tekstindhold via et MkDocs-referencelink i BeeWare-dokumentationen, skal have et brugerdefineret anker knyttet til sig. Ellers er der risiko for, at linkene brydes, når overskriftsindholdet oversættes." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "Enhver overskrift eller indholdssektion, der henvises til i tekstindhold via et Zensical-referencelink i BeeWare-dokumentationen, skal have et brugerdefineret anker knyttet til sig. Ellers er der risiko for, at linkene brydes, når overskriftsindholdet oversættes." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3350,8 +3315,8 @@ msgstr "[Linktekst](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "Link til et anker i et separat dokument bruger MkDocs-referencelinkstilen, som er formateret som følger:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "Link til et anker i et separat dokument bruger Zensical-referencelinkstilen, som er formateret som følger:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3365,8 +3330,8 @@ msgstr "API-referencelinks" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "MkDocs-referencelinkning understøtter også krydshenvisninger til API-dokumentation, herunder dokumenterede klasser, klassemetoder eller attributter og specifikke eksterne dokumentationshenvisninger." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Zensical-referencelinkning understøtter også krydshenvisninger til API-dokumentation, herunder dokumenterede klasser, klassemetoder eller attributter og specifikke eksterne dokumentationshenvisninger." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3941,8 +3906,8 @@ msgstr "Brug af makroer til at inkludere indhold fra BeeWare Docs Tools delt ind #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "Du kan også inkludere indhold fra BeeWare Docs-værktøjernes delte indholdsmappe ved hjælp af [Macros MkDocs-plugin]{1}. Denne metode er nødvendig, hvis dokumentet indeholder Jinja-direktiver, der skal udføres, og bør kun bruges i denne situation. Den fungerer ikke med eksternt indhold via en URL. [Macros-variabeludskiftningsmekanismen]{2} fungerer med denne metode." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "Du kan også inkludere indhold fra BeeWare Docs-værktøjernes delte indholdsmappe ved hjælp af [Macros]{1}. Denne metode er nødvendig, hvis dokumentet indeholder Jinja-direktiver, der skal udføres, og bør kun bruges i denne situation. Den fungerer ikke med eksternt indhold via en URL. [Macros-variabeludskiftningsmekanismen]{2} fungerer med denne metode." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4452,8 +4417,8 @@ msgstr "Dokumentationsformularer { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "{{ formal_name }}'s dokumentation er skrevet ved hjælp af [MkDocs og Markdown]{1}. Vi tilstræber at følge [Diataxis]{2}-rammen for strukturering af dokumentation." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "{{ formal_name }}'s dokumentation er skrevet ved hjælp af [Zensical]{1} og [Markdown]{2}. Vi tilstræber at følge [Diataxis]{3}-rammen for strukturering af dokumentation." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/de/translations.po b/src/beeware_docs_tools/shared_content/locales/de/translations.po index da085e55..719fa9cb 100644 --- a/src/beeware_docs_tools/shared_content/locales/de/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/de/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: 2026-04-07 07:23+0000\n" "Last-Translator: Russell Keith-Magee <russell@keith-magee.com>\n" "Language-Team: German <https://hosted.weblate.org/projects/beeware/docs-tools-shared-content/de/>\n" @@ -364,7 +364,7 @@ msgstr "Jeder Verweis auf einen Produktnamen sollte die bevorzugte Großschreibu msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Wenn ein Begriff \"als Code\" verwendet wird, sollte er als Literal zitiert werden (`wie dies`) und nicht in das Wörterbuch aufgenommen werden." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1634,9 +1634,8 @@ msgid "If the language you plan to help out with doesn't already exist, there ar msgstr "Wenn die Sprache, in der Sie helfen wollen, noch nicht existiert, sind einige zusätzliche Schritte erforderlich, bevor Sie beginnen können:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 -#, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Erstellen Sie die Datei \"/docs/mkdocs.language-code.yml\" mit sprachspezifischen Inhalten." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1645,8 +1644,8 @@ msgstr "Aktualisieren Sie `tox.ini`, um die neuen Sprach-Build-Befehle aufzunehm #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "Aktualisieren Sie `/docs/config.yml`, um die Sprache unter `extra: alternate:` aufzunehmen." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "Aktualisieren Sie `/docs/zensical.toml`, um die Sprache unter `extra.alternate` aufzunehmen." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1655,54 +1654,35 @@ msgstr "Im Folgenden werden die erforderlichen Änderungen am Beispiel der deuts #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "Eine neue MkDocs-Konfigurationsdatei" +msgid "A new language configuration file" +msgstr "Eine neue Zensical-Konfigurationsdatei" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "Erstellen Sie zunächst eine neue Datei namens `mkdocs.de.yml` im Verzeichnis `docs` mit folgendem Inhalt:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "Erstellen Sie zunächst eine neue Datei namens `zensical.de.toml` im Verzeichnis `docs` mit folgendem Inhalt:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1710,9 +1690,8 @@ msgid "Here's what is going on in this file:" msgstr "In dieser Datei geht es um Folgendes:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Diese Datei erbt den Konfigurationsinhalt von `config.yml`." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1721,201 +1700,188 @@ msgstr "Der Wert `site_name` wird übersetzt." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "Der Wert \"site_url\" ist die URL der Projektseite, gefolgt vom Sprachcode." +msgid "The `docs_dir` should be the language code." +msgstr "Das `docs_dir` sollte der Sprachcode sein." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "Das `docs_dir` sollte der Sprachcode sein." +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "Der `theme.language` Wert sollte der Sprachcode sein, wie [durch das Zensical theme]{1} spezifiziert. Für die meisten Sprachen wird dies derselbe sein wie der `docs_dir` Sprachcode; aber für einige (insbesondere Sprachen mit Gebietsschema-Varianten wie `zh_CN`), gibt es Unterschiede." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "Der `theme: language:` Wert sollte der Sprachcode sein, wie [durch das MkDocs Material theme]{1} spezifiziert. Für die meisten Sprachen wird dies derselbe sein wie der `docs_dir` Sprachcode; aber für einige (insbesondere Sprachen mit Gebietsschema-Varianten wie `zh_CN`), gibt es Unterschiede." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "Die `extra.language_url` sollte der Sprachcode sein, gefolgt von einem einzelnen Schrägstrich, z. B. `de/` für Deutsch." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "Die `extra: language_url:` sollte der Sprachcode sein, gefolgt von einem einzelnen Schrägstrich, z. B. `de/` für Deutsch." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "Der `extra.translation_type` sollte `machine` sein, bis die Übersetzung zum ersten Mal 100% erreicht, dann sollte sie `human` sein. Sie wird von `human` auf `machine` zurückgesetzt, wenn sie auf unter 90% zurückfällt." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "Der `extra: translation_type:` sollte `machine` sein, bis die Übersetzung zum ersten Mal 100% erreicht, dann sollte sie `human` sein. Sie wird von `human` auf `machine` zurückgesetzt, wenn sie auf unter 90% zurückfällt." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "Der Inhalt unter `extra.header` sind die Übersetzungen für Titel, die in der Kopfzeile erscheinen. Diese Definition ist auf der Hauptwebsite von BeeWare *nicht* erforderlich, sondern nur auf *anderen* Websites (wie dem Tutorial oder der Projektdokumentation)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "Der Inhalt unter `extra: header` sind die Übersetzungen für Titel, die in der Kopfzeile erscheinen. Diese Definition ist auf der Hauptwebsite von BeeWare *nicht* erforderlich, sondern nur auf *anderen* Websites (wie dem Tutorial oder der Projektdokumentation)." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "Tox.ini\" aktualisieren" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "Sie müssen mehrere Änderungen an der Datei \"tox.ini\" vornehmen." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "Sie würden Folgendes hinzufügen:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "Das neue Sprachcode-Umgebungsflag in der Kopfzeile, die mit \"testv:docs\" beginnt, wobei dem Sprachcode ein \"-\" ohne Leerzeichen vorangestellt wird, z. B. \"de\"." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "Der neue Sprachcode schließt den ersten Befehl aus, der mit `!lint` beginnt, dem ein `-!` vorangestellt ist, ohne Leerzeichen, z.B. `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "Der neue Sprachcode für die Zeile, die mit `translate : build_po_translations` beginnt." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "Der neue Sprachcode für die Zeile, die mit `translate : update_machine_translations` beginnt" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "Ein neuer Befehl, beginnend beispielsweise mit `de : build_md_translations` für Deutsch, alphabetisch innerhalb der bestehenden sprachspezifischen Befehle, der dem Inhalt dieser Befehle entspricht, mit dem neuen Sprachcode." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "Der neue Sprachcode für die Zeile, die mit `all:` beginnt." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "Aktualisieren Sie `config.yml`" +msgid "Update `zensical.toml`" +msgstr "Aktualisieren Sie `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Fügen Sie die Sprache zu `config.yml` hinzu, damit sie in der Sprachauswahl in der Kopfzeile erscheint. Suchen Sie den Abschnitt, der mit `extra:` beginnt, und suchen Sie dann den Unterabschnitt, der mit `alternate:` beginnt. Für Deutsch würden Sie das Folgende hinzufügen:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "Der Name der Sprache sollte in die Sprache übersetzt werden. Der Link muss das `/` enthalten." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "Ausführen `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Sie können nun `tox -e docs-translate` ausführen. Dadurch wird eine leere Übersetzungsdatei erstellt. Wenn Sie über ein DeepL-Konto verfügen, können Sie dieses Konto verwenden, um erste maschinelle Übersetzungen zu erstellen. Wenn Sie kein DeepL-Konto haben, ist das kein Problem – wir führen die ersten Übersetzungen selbst durch, bevor wir den Pull-Request akzeptieren." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "Leitlinien für die Übersetzung" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "Sobald du zum Team hinzugefügt wurdest, kannst du dich bei [Weblate]{1} anmelden und mit der Übersetzung von Zeichenketten beginnen." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "Ton versus Wort-für-Wort-Übersetzung" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "Es ist wichtiger, den Ton des englischen Textes beizubehalten, als eine wortgetreue Übersetzung anzustreben. Wir versuchen, unsere Inhalte freundlich und ein wenig umgangssprachlich zu formulieren; versuchen Sie, diesen Geist in Ihren Übersetzungen beizubehalten." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "Wenn der englische Text ein starkes englisches Idiom enthält, fühlen Sie sich nicht verpflichtet, dieses Idiom beizubehalten, wenn es in Ihrer Sprache eine Entsprechung gibt, die genauso gut funktioniert. Wenn es sich bei dem Begriff oder der Phrase im englischen Text um einen besonders idiomatischen oder umgangssprachlichen Begriff handelt, scheuen Sie sich nicht, uns zu sagen, dass wir eine Änderung in Betracht ziehen sollten. Selbst für Englischsprachige können Redewendungen und Slang schwierig sein. Manchmal müssen wir den englischen Text ändern, um ihn für Übersetzer und Leser gleichermaßen verständlicher zu machen." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "Soll ich es übersetzen?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "Die folgenden Elemente sollten *nicht* übersetzt oder aktualisiert werden:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Befehle**. In \"You should run \\`briefcase create\\`.\" zum Beispiel sollte nur \"You should run\" übersetzt werden." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Namensräume**, wie Klassen-, Methoden- oder Attributnamen." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**Link-URLs**. Standardmäßige Markdown-Links sollten in Weblate als `[Link text]{1}` erscheinen, wobei `1` die Position des Links innerhalb der Zeichenfolge im Verhältnis zu anderen möglichen Links angibt. Wenn die vollständige URL in der Zeichenfolge enthalten ist, z. B. als `[Link text](https://example.com/)`, sollte diese URL bei der Übersetzung übersprungen werden." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Referenzlinks, die Klassen-, Methoden- oder Attributnamen enthalten**. Diese sollten so belassen werden, wie sie sind, einschließlich der Backticks. Jeder Teil des hier gezeigten Beispiel-Links würde nicht übersetzt werden." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Klassenattribut]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**Der Link-Inhalt eines Referenz-Links**. Beispielsweise würde `link-content` im Folgenden übersprungen werden:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[Linktext][Linkinhalt]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Jinja-Anweisungen**. Dies ist ein beliebiger Inhalt, der in zwei Paare passender geschweifter Klammern oder in ein passendes Paar einzelner geschweifter Klammern mit Prozentzeichen an beiden Enden eingeschlossen ist. Hinweis: Wenn Sie hier ein Beispiel für die Syntax einfügen, versucht das Macros-Plugin, diese zu rendern; Beispiele finden Sie in der [Macros-Dokumentation]{1}." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Benutzerdefinierte Anker**. Sie befinden sich nach Kopfzeilen oder über einem Inhalt und sind als `{ #anchor }` formatiert." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Syntax der Ermahnung**. Im folgenden Beispiel sollte das Wort \"admonition\" nicht übersetzt werden. Dies gilt für alle Arten von Ermahnungen, einschließlich Anmerkungen, Warnungen usw. Im nächsten Abschnitt finden Sie Informationen zur Übersetzung des restlichen Inhalts." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1930,52 +1896,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Backsticks**. Sie sollen als Backticks erhalten bleiben; sie werden zur Formatierung sowohl von Inline-Code als auch von Codeblöcken verwendet." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**Die Syntax für die Einbindung externer Inhalte**. Dies ist alles, was in derselben Zeile wie `-8<-` oder in den Zeilen zwischen zwei `-8<-` in getrennten Zeilen steht." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "Die folgenden Elemente *sollten* übersetzt werden:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Link-Text**. In der Linksyntax steht der Text vor der URL und ist in Klammern eingeschlossen, wie in `[Linktext](URL)`. Standard Markdown-Links sollten in Weblate als `[Linktext]{1}` erscheinen, wobei `1` die Position des Links in der Zeichenfolge mit Bezug auf andere mögliche Links ist." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Referenz-Linktext**. Beispielsweise würde `Link text` wie folgt übersetzt werden:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Abmahnungsüberschriften und -inhalte**. Im vorangegangenen Beispiel für eine Ermahnung sollten \"Seitentitel\" und \"Inhalt\" übersetzt werden." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "Wir verwenden [Weblate]{1} für unsere Inhaltsübersetzung. Wenn wir eine neue Übersetzung hinzufügen, verwenden wir [DeepL]{2} für die maschinelle Übersetzung, um einen ersten Durchgang an Übersetzungen zu erstellen. Das bedeutet, dass der Inhalt, den Sie übersetzen werden, in der Regel bereits maschinell übersetzt wurde. Es wird erwartet, dass Sie als Übersetzer die vorhandene maschinelle Übersetzung überprüfen, bearbeiten und verbessern." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate verarbeitet alles auf einer String-zu-String-Basis. Die Änderungen werden in Stapeln zusammengefasst, und alle paar Stunden wird eine Massenübertragung mit allen Strings, die sich in diesem Zeitraum geändert haben, durchgeführt. Es kann also ein paar Stunden dauern, bis Ihre Änderungen auf der Website erscheinen, aber Sie können davon ausgehen, dass die Aktualisierung innerhalb von vier Stunden erscheint." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Wenn Ihre Änderungen nach dieser Zeit immer noch nicht angezeigt werden, liegt wahrscheinlich ein Markup-Fehler vor, der zu einem Fehler beim Erstellen der Dokumentation für diese Sprache führt. Jedes Markup-Problem in einer beliebigen Zeichenfolge verhindert, dass die gesamte Übersetzung veröffentlicht wird. Sie können auf der Build-Seite für Ihre Sprache überprüfen, ob die Erstellung erfolgreich war. Der Link ist ähnlich wie dieser Link zur französischen Build-Seite formatiert {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; Ändern Sie den Sprachcode in Ihre Sprache, um die entsprechende Build-Seite anzuzeigen. Dort wird der Status des letzten Builds der Website angezeigt. Wenn der Build fehlschlägt, sehen Sie sich das Build-Protokoll an und versuchen Sie, die Ursache des Problems zu identifizieren." @@ -2379,36 +2345,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "Sie müssen das Dokument an der entsprechenden Stelle im Verzeichnis `docs/de` erstellen. Für die Diskussion nehmen wir an, Sie fügen ein neues Dokument mit dem Dateinamen \"new_doc.md\" hinzu." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "Dann müssen Sie die Datei `docs/de/SUMMARY.md` aktualisieren, um Ihre neue Datei aufzunehmen. Die Datei `SUMMARY.md` ist so organisiert, dass sie im Wesentlichen die Verzeichnisstruktur von `docs/de` widerspiegelt, aber, was noch wichtiger ist, sie bestimmt direkt die Struktur der linken Seitenleiste. Wenn Sie den Abschnitt finden, in den Sie `new_doc.md` einbinden wollen, brauchen Sie nichts in `SUMMARY.md` zu ändern, wenn Sie einen Platzhalterpfad aufgeführt sehen. Zum Beispiel:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./Pfad/zum/Verzeichnis/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "Wenn der Abschnitt, in den Sie `new_doc.md` einfügen wollen, eine Liste von einzelnen Markdown-Links ist, müssen Sie einen expliziten Link zu Ihrem eigenen hinzufügen. Zum Beispiel:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [Mein neues Dokument](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "Verfassen Ihrer Dokumentation" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "Sie können nun die gewünschte Datei in Ihrem Editor öffnen und mit dem Schreiben beginnen." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "Wir haben einen [Dokumentationsleitfaden]{1}, der unsere Richtlinien für die Erstellung der Dokumentation für BeeWare umreißt." @@ -3177,8 +3141,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Dieser Leitfaden enthält Informationen über den erwarteten Stil, die MkDocs-spezifische Syntax, verschiedene erforderliche Werkzeuge und die Übersetzung der Dokumentation im Hinblick auf das Schreiben neuer Inhalte und die Übersetzung vorhandener Inhalte." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Dieser Leitfaden enthält Informationen über den erwarteten Stil, die Zensical-spezifische Syntax, verschiedene erforderliche Werkzeuge und die Übersetzung der Dokumentation im Hinblick auf das Schreiben neuer Inhalte und die Übersetzung vorhandener Inhalte." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3237,8 +3201,8 @@ msgstr "Wann immer möglich, sollten Sie in der Dokumentation auf Inhalte verwei #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs rendert standardmäßig Markdown-formatierte Links. Standard Markdown-formatierte Web-Hyperlinks sind wie folgt:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical rendert standardmäßig Markdown-formatierte Links. Standard Markdown-formatierte Web-Hyperlinks sind wie folgt:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3257,8 +3221,8 @@ msgstr "[Linktext](Pfad/zur/Datei.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Um auf bestimmte Abschnitte von Dateien oder die API-Dokumentation zu verweisen, muss das MkDocs-Referenzlink-Format verwendet werden." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Um auf bestimmte Abschnitte von Dateien oder die API-Dokumentation zu verweisen, muss das Zensical-Referenzlink-Format verwendet werden." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3272,13 +3236,13 @@ msgstr "Markdown generiert Anker für alle Überschriften (alles in einer einzig #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs unterstützt die Darstellung einer Referenz-Link-Syntax, die es Ihnen ermöglicht, mit einem modifizierten Markdown-Link auf verschiedene andere Elemente in der Dokumentation zu verweisen. Dazu gehört unter anderem die Verknüpfung mit benutzerdefinierten Markdown-Kopfzeilen und Textankern." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical unterstützt die Darstellung einer Referenz-Link-Syntax, die es Ihnen ermöglicht, mit einem modifizierten Markdown-Link auf verschiedene andere Elemente in der Dokumentation zu verweisen. Dazu gehört unter anderem die Verknüpfung mit benutzerdefinierten Markdown-Kopfzeilen und Textankern." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "MkDocs-Referenzlinks sind alle Links, die wie folgt formatiert sind:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Zensical-Referenzlinks sind alle Links, die wie folgt formatiert sind:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3292,8 +3256,8 @@ msgstr "/// warning | Benutzerdefinierte Kopfzeilen und Inhaltsanker sind erford #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "Jede Kopfzeile oder jeder Inhaltsabschnitt, auf den im Textinhalt über einen MkDocs-Referenzlink in der BeeWare-Dokumentation verwiesen wird, _muss_ mit einem eigenen Anker versehen werden. Andernfalls besteht die Möglichkeit, dass die Links unterbrochen werden, wenn der Kopfzeileninhalt übersetzt wird." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "Jede Kopfzeile oder jeder Inhaltsabschnitt, auf den im Textinhalt über einen Zensical-Referenzlink in der BeeWare-Dokumentation verwiesen wird, _muss_ mit einem eigenen Anker versehen werden. Andernfalls besteht die Möglichkeit, dass die Links unterbrochen werden, wenn der Kopfzeileninhalt übersetzt wird." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3352,8 +3316,8 @@ msgstr "[Linktext](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "Für die Verknüpfung mit einem Anker in einem anderen Dokument wird der MkDocs-Stil für Referenzverknüpfungen verwendet, der wie folgt formatiert ist:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "Für die Verknüpfung mit einem Anker in einem anderen Dokument wird der Zensical-Stil für Referenzverknüpfungen verwendet, der wie folgt formatiert ist:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3367,8 +3331,8 @@ msgstr "API-Referenz-Links" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "Die MkDocs-Referenzverknüpfung unterstützt auch Querverweise auf die API-Dokumentation, einschließlich dokumentierter Klassen, Klassenmethoden oder -attribute und spezifischer externer Dokumentationsverweise." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Die Zensical-Referenzverknüpfung unterstützt auch Querverweise auf die API-Dokumentation, einschließlich dokumentierter Klassen, Klassenmethoden oder -attribute und spezifischer externer Dokumentationsverweise." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3943,8 +3907,8 @@ msgstr "Verwendung von Makros zur Einbindung von Inhalten aus BeeWare Docs Tools #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "Sie können auch Inhalte aus dem gemeinsamen Inhaltsverzeichnis der BeeWare Docs-Tools mit dem [Macros MkDocs-Plugin]{1} einfügen. Diese Methode ist notwendig, wenn das Dokument Jinja-Direktiven enthält, die ausgeführt werden müssen, und sollte nur in dieser Situation verwendet werden. Sie funktioniert nicht mit externen Inhalten über eine URL. Der [Macros-Variablen-Ersetzungsmechanismus]{2} funktioniert mit dieser Methode." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "Sie können auch Inhalte aus dem gemeinsamen Inhaltsverzeichnis der BeeWare Docs-Tools mit dem [Macros]{1} einfügen. Diese Methode ist notwendig, wenn das Dokument Jinja-Direktiven enthält, die ausgeführt werden müssen, und sollte nur in dieser Situation verwendet werden. Sie funktioniert nicht mit externen Inhalten über eine URL. Der [Macros-Variablen-Ersetzungsmechanismus]{2} funktioniert mit dieser Methode." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4452,8 +4416,8 @@ msgstr "Dokumentationsformulare { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "Die Dokumentation von {{ formal_name }} wird mit [MkDocs und Markdown]{1} geschrieben. Wir streben an, den [Diataxis]{2} Rahmen für die Strukturierung der Dokumentation zu befolgen." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "Die Dokumentation von {{ formal_name }} wird mit [Zensical]{1} und [Markdown]{2} geschrieben. Wir streben an, den [Diataxis]{3} Rahmen für die Strukturierung der Dokumentation zu befolgen." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/es/translations.po b/src/beeware_docs_tools/shared_content/locales/es/translations.po index 1c042707..ec61f818 100644 --- a/src/beeware_docs_tools/shared_content/locales/es/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/es/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: 2026-09-24 05:58+0000\n" "Last-Translator: Pablo Rodríguez <paproninja@gmail.com>\n" "Language-Team: Spanish <https://hosted.weblate.org/projects/beeware/docs-tools-shared-content/es/>\n" @@ -302,7 +302,7 @@ msgstr "Cualquier referencia a un nombre de producto utilizaría la capitalizaci msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Si un término se utiliza «como código», debe citarse como un literal (`como esto`) en lugar de ser añadido al diccionario." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1377,240 +1377,215 @@ msgid "If the language you plan to help out with doesn't already exist, there ar msgstr "Si el idioma en la que quiere colaborar aún no existe, hay algunos pasos adicionales necesarios antes que pueda comenzar:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Crea el archivo `/docs/mkdocs.language-code.yml`, con contenido específico para cada idioma." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "Crea el archivo `/docs/zensical.language-code.toml`, con contenido específico para cada idioma." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 msgid "Update `tox.ini` to include the new language build commands." msgstr "Actualice `tox.ini` para incluir los nuevos comandos de construcción de idioma." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "Actualice `/docs/config.yml` para incluir el idioma bajo `extra: alternate:`." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "Actualice `/docs/zensical.toml` para incluir el idioma bajo `extra.alternate`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 msgid "The following demonstrates the necessary changes using German as an example; a German translation already exists; replace the references to German, `de`, or other content for the language you're targeting." msgstr "Lo siguiente demuestra los cambios necesarios utilizando el alemán como un ejemplo; ya existe una traducción al alemán; sustituya las referencias al alemán, `de` u otro contenido para el idioma al que se dirija." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 -msgid "A new MkDocs configuration file" -msgstr "Un archivo de configuración nuevo de MkDocs" +#, fuzzy +msgid "A new language configuration file" +msgstr "Un archivo de configuración nuevo de Zensical" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "En primer lugar, cree un archivo nuevo llamado `mkdocs.de.yml` en el directorio `docs`, con el siguiente contenido:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "En primer lugar, cree un archivo nuevo llamado `zensical.de.toml` en el directorio `docs`, con el siguiente contenido:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" -"\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" +"\n" +"[project.theme]\n" +"language = \"de\"\n" +"\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" +"\n" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Documentación\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" -"\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Acerca de\n" -" Documentation: Documentación\n" -" Community: Comunidad\n" -" Contributing: Colaborar\n" -" News: Noticias\n" -" Sponsor: Patrocinadores" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 msgid "Here's what is going on in this file:" msgstr "Aquí está lo que ocurre en este archivo:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Este archivo hereda el contenido de configuración desde `config.yml`." +#, fuzzy +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "Este archivo hereda el contenido de configuración desde `zensical.toml`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 msgid "The `site_name` value is translated." msgstr "El valor `site_name` está traducido." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "El valor `site_url` es la URL del sitio del proyecto, seguida del código de idioma." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 msgid "The `docs_dir` should be the language code." msgstr "El `docs_dir` sería el código del idioma." +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "El valor `theme.language` sería el código del idioma, como [especificado por el tema Zensical]{1}. Para la mayoría de los idiomas, este será el mismo que el código de idioma `docs_dir`; pero para algunos (en particular idiomas con variantes locales como `zh_CN`), hay diferencias." + #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "El valor `theme: language:` sería el código del idioma, como [especificado por el tema MkDocs Material]{1}. Para la mayoría de los idiomas, este será el mismo que el código de idioma `docs_dir`; pero para algunos (en particular idiomas con variantes locales como `zh_CN`), hay diferencias." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "El `extra.language_url` sería el código del idioma, seguido de una sola barra torcida, p.e., `de/` para alemán." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "El `extra: language_url:` sería el código del idioma, seguido de una sola barra torcida, p.e., `de/` para alemán." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "El `extra.translation_type` sería `machine` hasta que la traducción alcance el 100% por primera vez, momento en el cual sería `human`. Se revertirá a `machine` desde `human` si retrocede por debajo del 90%." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "El `extra: translation_type:` sería `machine` hasta que la traducción alcance el 100% por primera vez, momento en el cual sería `human`. Se revertirá a `machine` desde `human` si retrocede por debajo del 90%." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "El contenido entre `extra: header` son las traducciones de los títulos que aparecen en la barra de encabezado. Esta definición *no* es necesaria en el sitio web principal de BeeWare; solo se requiere en *otros* sitios (como el tutorial, o la documentación del proyecto)." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "El contenido entre `extra.header` son las traducciones de los títulos que aparecen en la barra de encabezado. Esta definición *no* es necesaria en el sitio web principal de BeeWare; solo se requiere en *otros* sitios (como el tutorial, o la documentación del proyecto)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 msgid "Update `tox.ini`" msgstr "Actualizar `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 msgid "You'll need to make several changes to the `tox.ini` file." msgstr "Tendrás que hacer varios cambios en el archivo `tox.ini`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 msgid "You would add the following:" msgstr "Añadirías lo siguiente:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "El indicador nuevo del código de idioma del entorno a la línea de cabecera que comienza por `[testenv:docs`, con el código de idioma precedido por un `-`, sin espacios incluidos, p.e., `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "El nuevo código de idioma de exclusión al primer comando, que comienza con `!lint`, precedido por `-!`, sin espacios incluidos, por ejemplo, `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "El código de idioma nuevo para la línea que comienza con `translate : build_po_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "El código de idioma nuevo para la línea que comienza por `translate : update_machine_translations`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "Un comando nuevo, que comienza, por ejemplo, con `de : build_md_translations` para alemán, en orden alfabético dentro de los comandos específicos del idioma existentes que coinciden con el contenido de esos comandos, con el código nuevo de idioma." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 msgid "The new language code to the line beginning with `all:`." msgstr "El código nuevo de idioma para la línea que comienza con `all:`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 -msgid "Update `config.yml`" -msgstr "Actualizar `config.yml`" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 +msgid "Update `zensical.toml`" +msgstr "Actualizar `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Añade el idioma a `config.yml` para que aparezca en el selector de idioma de la cabecera. Busque la sección que empieza por `extra:` y, a continuación, localice la subsección que empieza por `alternate:`. Para el alemán, añada lo siguiente:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +#, fuzzy +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "Añade el idioma a `zensical.toml` para que aparezca en el selector de idioma de la cabecera. Busque la sección que empieza por `[project.extra]` y, a continuación, localice la subsección que empieza por `alternate`. Para el alemán, añada lo siguiente:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- nombre: Alemán\n" -" enlace: /de/\n" -" idioma: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "El nombre del idioma debe traducirse al idioma. El enlace debe incluir el `/`s." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 msgid "Run `tox translate`" msgstr "Ejecutar `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Ahora puede ejecutar `tox -e docs-translate`. Esto generará un archivo de traducción vacío; si tiene una cuenta DeepL, puede utilizarla para rellenar las traducciones automáticas iniciales. Si no tiene una cuenta DeepL, no se preocupe: nosotros mismos realizaremos las traducciones iniciales antes de aceptar la solicitud de incorporación de cambios." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 msgid "Translation guidelines" msgstr "Pautas de traducción" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "Una vez que te hayan añadido al equipo, es hora de iniciar sesión en [Weblate]{1} y empezar a trabajar en la traducción de cadenas." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 msgid "Tone versus word-for-word translation" msgstr "El tono frente a la traducción palabra por palabra" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "Es más importante mantener el tono del texto inglés que esforzarse por traducir palabra por palabra. Tratamos de ser amables y un poco coloquiales en nuestros contenidos; intenta mantener ese espíritu en tus traducciones." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "Si el texto en inglés contiene un modismo inglés fuerte, no se sienta obligado a mantener el modismo, si hay un análogo en su idioma que funcionaría igualmente bien. Si el término o frase del texto en inglés es especialmente idiomático o de argot, no tema decirnos que deberíamos considerar la posibilidad de cambiarlo. Incluso para los angloparlantes, los modismos y el argot pueden plantear dificultades. A veces tenemos que cambiar el texto inglés para que resulte más sencillo tanto para los traductores como para los lectores." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 msgid "Should I translate it?" msgstr "¿Debo traducirlo?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 msgid "The following items should *not* be translated or updated:" msgstr "Los siguientes elementos *no* serían traducidos ni actualizados:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Comandos**. Por ejemplo, en \"You should run \\`briefcase create\\`.\", sólo \"You should run\" sería traducido." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Espacios de nombres**, como nombres de clase, método o atributo." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**URL de enlaces**. Los enlaces estándar de Markdown deben aparecer en Weblate como `[Texto enlace{1}`, donde `1` es la posición del enlace en la cadena con respecto a otros posibles enlaces. Si la URL completa se incluye en la cadena, como `[Texto enlace](https://example.com/)`, dicha URL debe omitirse en la traducción." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Enlaces de referencia que contengan nombres de clase, método o atributo**. Deben dejarse como están, incluidos los puntos suspensivos. Todas las partes del enlace de ejemplo que se muestra aquí no sería traducido." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Class.attribute]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**El contenido del enlace de un enlace de Referencia**. Por ejemplo, `link-content` se omitiría en lo siguiente:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 msgid "[Link text][link-content]" msgstr "[Link text][link-content]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Directivas Jinja**. Se trata de cualquier contenido envuelto dentro de dos pares de llaves coincidentes, o un par de llaves coincidentes con signos de porcentaje en cada extremo. Nota: Incluir un ejemplo de la sintaxis aquí hace que el plugin Macros intente representarla; consulte la [documentación de Macros]{1} para ejemplos." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Anclas personalizadas**. Se encuentran tras cabeceras o encima de algún contenido, y se dan formato como `{ #anchor }`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Sintaxis de admonición**. En el ejemplo de a continuación, la palabra «admonición» no debe traducirse. Esto es válido para todos los estilos de amonestación, incluyendo notas, advertencias, etc. Consulte la siguiente sección para obtener información sobre la traducción del resto del contenido." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 msgid "" "/// admonition | Page Title\n" "\n" @@ -1624,43 +1599,43 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Tildes**. Están pensadas para permanecer como tildes graves; se utilizan para dar formato tanto al código en línea como a los bloques de código." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**La sintaxis para incluir contenido externo**. Esto es cualquier cosa en la misma línea que `-8<-`, o en las líneas entre dos `-8<-` en líneas separadas." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 msgid "The following items *should* be translated:" msgstr "Los siguientes elementos *serían* traducidos:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Texto del enlace**. En la sintaxis de los enlaces, el texto va antes de la URL, y están encerrados entre corchetes, como en `[Texto del enlace](URL)`. Los enlaces Markdown estándar aparecerían en Weblate como `[Texto del enlace]{1}`, donde `1` es la posición del enlace en la cadena con referencia a otros posibles enlaces." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Texto del enlace de referencia**. Por ejemplo, `Link text` sería traducida de la siguiente manera:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Títulos y contenido de la admonición**. En el ejemplo anterior de admonición, \"Título de la página\" y \"Contenido\" serían traducidas." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "Utilizamos [Weblate]{1} para la traducción de nuestros contenidos. Cuando añadimos una traducción nueva, utilizamos [DeepL]{2} para que la traducción automática produzca una primera pasada de las traducciones. Esto significa que, normalmente, el contenido que estás traduciendo ya está traducido automáticamente. La expectativa es que tú, como traductor, revises, edites y mejores la traducción automática existente." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate procesa todo cadena por cadena. Agrupa los cambios y, cada dos horas, envía una confirmación masiva con todas las cadenas que han cambiado en ese intervalo. Por lo tanto, los cambios pueden tardar un par de horas en aparecer en el sitio web, pero puede esperar que la actualización aparezca en cuatro horas." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Si después de ese tiempo, tus cambios aún no aparecen, la causa probable es un error de marcado, lo que provoca un fallo en la construcción de la documentación para ese idioma. Cualquier problema de marcado en cualquier cadena bloqueará la publicación de toda la traducción. Puedes estar atento a la página de compilación de tu idioma para ver si se ha compilado correctamente. El enlace tiene un formato similar a este enlace a la página de creación en francés {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; cambia el código de idioma por el de tu idioma para ver la página de creación correspondiente. Esto mostrará el estado de la construcción más reciente del sitio. Si la construcción falla, consulta el registro de compilación y comprueba si puedes identificar el origen del problema." @@ -2001,30 +1976,32 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "Necesitará crear el documento en la ubicación apropiada dentro del directorio `docs/es`. A modo de ejemplo, diremos que está añadiendo un documento nuevo con el nombre `nuevo_doc.md`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "A continuación, tendrás que actualizar el archivo `docs/es/SUMMARY.md` para incluir tu nuevo archivo. El archivo `SUMMARY.md` está organizado para reflejar básicamente la estructura de directorios de `docs/es`, pero, lo que es más importante, determina directamente la estructura de la barra lateral izquierda. Si localizas la sección donde pretendes incluir `nuevo_doc.md`, no necesitas cambiar nada en `SUMMARY.md` si ves una ruta comodín listada. Por ejemplo:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -msgid "- ./path/to/directory/*" -msgstr "- ./ruta/al/directorio/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "Si la sección en la que pretende incluir `nuevo_doc.md` es una lista de enlaces Markdown individuales, necesitará añadir un enlace explícito al suyo. Por ejemplo:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -msgid "- [My new document](new_doc.md)" -msgstr "- [Mi nuevo documento](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 msgid "Writing your documentation" msgstr "Redactar su documentación" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 msgid "You can now open the desired file into your editor, and begin writing." msgstr "Ahora puede abrir el archivo deseado en su editor, y empezar a escribir." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "Disponemos de una [guía de estilo de la documentación]{1} que describe nuestras directrices para escribir documentación para BeeWare." @@ -2653,8 +2630,8 @@ msgstr "" " \"\"\"Una cadena de documentación de prueba tiene este aspecto (#123456).\"\"\"" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Esta guía incluye información sobre el estilo esperado, la sintaxis específica de MkDocs, las distintas herramientas necesarias y la traducción de documentación, en lo que respecta a la redacción de nuevos contenidos y la traducción de contenidos existentes." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Esta guía incluye información sobre el estilo esperado, la sintaxis específica de Zensical, las distintas herramientas necesarias y la traducción de documentación, en lo que respecta a la redacción de nuevos contenidos y la traducción de contenidos existentes." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 msgid "General style" @@ -2701,8 +2678,8 @@ msgid "You should cross-reference content in documentation whenever possible. Th msgstr "Siempre que sea posible, debe hacer referencias cruzadas en la documentación. En esta sección se cubren distintas maneras de poder hacerse, cada cual está basada sobre el tipo de información que está siendo referenciada." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs muestra enlaces con formato Markdown estándar. Los hipervínculos web con formato Markdown estándar son los siguientes:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical muestra enlaces con formato Markdown estándar. Los hipervínculos web con formato Markdown estándar son los siguientes:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 msgid "[Link text](https://example.com/)" @@ -2717,8 +2694,8 @@ msgid "[Link text](path/to/file.md)" msgstr "[Texto del enlace](ruta/al/archivo.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Para hacer referencia a secciones concretas de archivos, o a la documentación del API es necesario utilizar el formato de enlace de referencia de MkDocs." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Para hacer referencia a secciones concretas de archivos, o a la documentación del API es necesario utilizar el formato de enlace de referencia de Zensical." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 msgid "Custom Markdown anchors and content cross-referencing" @@ -2729,12 +2706,12 @@ msgid "Markdown generates anchors for all headers (anything on a single line sta msgstr "Markdown genera anclas para todos los encabezados (cualquier cosa en una sola línea que empiece con entre uno y seis símbolos `#`), basándose en el contenido del encabezado. Por ejemplo, el ancla generado para esta sección es `custom-markdown-anchors-and-content-cross---referencing`. Sin embargo, debido a la forma en que funcionan nuestras traducciones, cada vez que se hace referencia a un encabezado de sección, debe tener un ancla personalizada." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs admite la representación de una sintaxis de enlace de referencia que permite enlazar con varios otros elementos de la documentación mediante un enlace Markdown modificado. Esto incluye enlazar a, entre otras cosas, encabezados Markdown personalizados y anclajes de texto." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical admite la representación de una sintaxis de enlace de referencia que permite enlazar con varios otros elementos de la documentación mediante un enlace Markdown modificado. Esto incluye enlazar a, entre otras cosas, encabezados Markdown personalizados y anclajes de texto." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "Los enlaces de referencia de MkDocs son cualquiera de los enlaces con el siguiente formato:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Los enlaces de referencia de Zensical son cualquiera de los enlaces con el siguiente formato:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 msgid "[Link text][link-target]" @@ -2745,8 +2722,8 @@ msgid "/// warning | Custom header and content anchors are required" msgstr "/// warning | Se requieren anclajes de cabecera y contenido personalizados" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "Cualquier encabezado o sección de contenido al que se haga referencia en el contenido de texto a través de un enlace de referencia MkDocs en la documentación de BeeWare _debe_ tener un ancla personalizada adjunta. De lo contrario, existe la posibilidad de romper los enlaces cuando se traduce el contenido del encabezado." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "Cualquier encabezado o sección de contenido al que se haga referencia en el contenido de texto a través de un enlace de referencia Zensical en la documentación de BeeWare _debe_ tener un ancla personalizada adjunta. De lo contrario, existe la posibilidad de romper los enlaces cuando se traduce el contenido del encabezado." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 msgid "If you need to link to a header anchor, you will need to generate a custom anchor for the intended content. The general syntax for setting a custom anchor is as follows:" @@ -2795,8 +2772,8 @@ msgid "[Link text](#anchor-name)" msgstr "[Texto del enlace](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "Para enlazar con un ancla de un documento independiente se utiliza el estilo de enlace de referencia de MkDocs, el cual está formateado como el siguiente:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "Para enlazar con un ancla de un documento independiente se utiliza el estilo de enlace de referencia de Zensical, el cual está formateado como el siguiente:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 msgid "[Link text][anchor-name]" @@ -2807,8 +2784,8 @@ msgid "API reference links" msgstr "Enlaces de referencia del API" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "El enlace de referencia de MkDocs también admite referencias cruzadas a la documentación del API, incluidas las clases documentadas, los métodos o atributos de las clases y las referencias a documentación externa específica." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "El enlace de referencia de Zensical también admite referencias cruzadas a la documentación del API, incluidas las clases documentadas, los métodos o atributos de las clases y las referencias a documentación externa específica." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 msgid "There are multiple options for linking to a documented class, or a class method or attribute, regardless of whether you are linking from the same file or a separate file. When linking to classes, etc., you must include backticks in the first set of square brackets to render the name as inline code. The backticks are not necessary only if you are using custom text that should not be rendered as inline code. Backticks should never be included in the second set of square brackets." @@ -3311,8 +3288,9 @@ msgid "Using Macros to include content from BeeWare Docs Tools shared content" msgstr "El uso de macros para incluir contenido compartido de BeeWare Docs Tools" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "También puedes incluir contenido del directorio de contenido compartido de las herramientas BeeWare Docs utilizando el [complemento de Macros MkDocs]{1}. Este método es necesario si el documento contiene directivas Jinja que deban ejecutarse, y sólo se utilizaría en esta situación. No funcionará con contenido externo a través de una URL. El [Mecanismo de reemplazo de variables macros]{2} funciona con este método." +#, fuzzy +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "También puedes incluir contenido del directorio de contenido compartido de las herramientas BeeWare Docs utilizando el [Macros]{1}. Este método es necesario si el documento contiene directivas Jinja que deban ejecutarse, y sólo se utilizaría en esta situación. No funcionará con contenido externo a través de una URL. El [Mecanismo de reemplazo de variables macros]{2} funciona con este método." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 msgid "There are options for including content using Macros:" @@ -3739,8 +3717,8 @@ msgid "Documentation forms { #docs-form }" msgstr "Formularios de documentación { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "La documentación de {{ formal_name }} está escrita usando [MkDocs y Markdown]{1}. Nuestro propósito es seguir el marco [Diataxis]{2} para estructurar la documentación." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "La documentación de {{ formal_name }} está escrita usando [Zensical]{1} y [Markdown]{2}. Nuestro propósito es seguir el marco [Diataxis]{3} para estructurar la documentación." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 msgid "The Diataxis framework describes four \"forms\" of documentation:" diff --git a/src/beeware_docs_tools/shared_content/locales/fa/translations.po b/src/beeware_docs_tools/shared_content/locales/fa/translations.po index e3e23aac..633d4389 100644 --- a/src/beeware_docs_tools/shared_content/locales/fa/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/fa/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -363,7 +363,7 @@ msgstr "هر ارجاع به نام یک محصول باید از شیوهٔ ن msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "اگر یک واژه به‌عنوان «کد» استفاده می‌شود، باید به‌صورت یک عبارت بستی (`like this`) نقل شود، نه اینکه به فرهنگ لغت اضافه شود." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 #, fuzzy msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1631,8 +1631,8 @@ msgstr "اگر زبان مورد نظرتان برای کمک کردن هنوز #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "فایل `/docs/mkdocs.language-code.yml` را با محتوای مخصوص به زبان ایجاد کنید." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "فایل `/docs/zensical.language-code.toml` را با محتوای مخصوص به زبان ایجاد کنید." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1641,8 +1641,8 @@ msgstr "`tox.ini` را به‌روزرسانی کنید تا دستورات سا #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "`/docs/config.yml` را به‌روزرسانی کنید تا زبان را زیر `extra: alternate:` قرار دهید." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "`/docs/zensical.toml` را به‌روزرسانی کنید تا زبان را زیر `extra.alternate` قرار دهید." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1651,54 +1651,35 @@ msgstr "مثال زیر تغییرات لازم را با استفاده از ز #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "یک فایل پیکربندی جدید MkDocs" +msgid "A new language configuration file" +msgstr "یک فایل پیکربندی جدید Zensical" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "ابتدا یک فایل جدید به نام `mkdocs.de.yml` را در دایرکتوری `docs` ایجاد کنید، با محتوای زیر:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "ابتدا یک فایل جدید به نام `zensical.de.toml` را در دایرکتوری `docs` ایجاد کنید، با محتوای زیر:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"میراث: config.yml\n" -"نام_سایت: {{ formal_name }} مستندات\n" -"آدرس_سایت: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: درباره\n" -" Documentation: مستندات\n" -" Community: جامعه\n" -" Contributing: مشارکت\n" -" News: اخبار\n" -" Sponsor: حامی" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1706,9 +1687,8 @@ msgid "Here's what is going on in this file:" msgstr "در این فایل اتفاق می‌افتد:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "این فایل محتوای پیکربندی را از `config.yml` به ارث می‌برد." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1717,201 +1697,187 @@ msgstr "مقدار `site_name` ترجمه می‌شود." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "مقدار `site_url` نشانی وب سایت پروژه است که پس از آن کد زبان قرار می‌گیرد." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 -#, fuzzy msgid "The `docs_dir` should be the language code." msgstr "`docs_dir` باید کد زبان باشد." +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "" + #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "مقدار `theme: language:` باید کد زبان باشد، همان‌طور که [توسط تم Material در MkDocs مشخص شده است]{1}. برای اکثر زبان‌ها، این کد با کد زبان `docs_dir` یکسان خواهد بود؛ اما برای برخی (به‌ویژه زبان‌هایی با گونه‌های منطقه‌ای مانند `zh_CN`)، تفاوت‌هایی وجود دارد." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "`extra.language_url` باید کد زبان باشد، و پس از آن یک اسلش قرار گیرد، مثلاً برای آلمانی `de/`" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "`extra: language_url:` باید کد زبان باشد، و پس از آن یک اسلش قرار گیرد، مثلاً برای آلمانی `de/`" +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "`extra.translation_type` باید تا زمانی که ترجمه برای اولین بار به ۱۰۰٪ برسد، به صورت `machine` باشد، در این نقطه باید به `human` تبدیل شود. اگر کیفیت ترجمه به زیر ۹۰٪ بازگردد، از `machine` به `human` بازمی‌گردد." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "`extra: translation_type:` باید تا زمانی که ترجمه برای اولین بار به ۱۰۰٪ برسد، به صورت `machine` باشد، در این نقطه باید به `human` تبدیل شود. اگر کیفیت ترجمه به زیر ۹۰٪ بازگردد، از `machine` به `human` بازمی‌گردد." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "محتوای داخل `extra.header` ترجمه‌های عناوینی است که در نوار سربرگ ظاهر می‌شوند. این تعریف در وب‌سایت اصلی BeeWare لازم نیست؛ تنها در سایت‌های دیگر (مانند آموزش یا مستندات پروژه) ضروری است." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "محتوای داخل `extra: header` ترجمه‌های عناوینی است که در نوار سربرگ ظاهر می‌شوند. این تعریف در وب‌سایت اصلی BeeWare لازم نیست؛ تنها در سایت‌های دیگر (مانند آموزش یا مستندات پروژه) ضروری است." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "به‌روزرسانی `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "شما باید چندین تغییر در فایل `tox.ini` ایجاد کنید." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "شما موارد زیر را اضافه می‌کنید:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "پرچم محیط کد زبان جدید در خط سربرگی که با `[testenv:docs` شروع می‌شود، با کد زبان که با `-` پیش‌فرض شده و بدون هیچ فاصله‌ای، مثلاً `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "استثنای جدید کد زبان برای دستور اول، که با `!lint` آغاز می‌شود و قبل از آن `-!` قرار دارد و هیچ فاصله‌ای در آن نیست، مثلاً `-!de`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "کد زبان جدید برای خطی که با `translate : build_po_translations` شروع می‌شود." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "کد زبان جدید برای خطی که با `translate : update_machine_translations` شروع می‌شود" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "یک فرمان جدید که برای مثال با `de : build_md_translations` برای زبان آلمانی آغاز می‌شود، به‌صورت الفبایی در میان فرمان‌های موجود مخصوص هر زبان قرار می‌گیرد و با کد زبان جدید مطابقت دارد." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "کد زبان جدید برای خطی که با `all:` شروع می‌شود." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "به‌روزرسانی `config.yml`" +msgid "Update `zensical.toml`" +msgstr "به‌روزرسانی `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "زبان را به `config.yml` اضافه کنید تا در انتخابگر زبان در هدر نمایش داده شود. بخش آغازشده با `extra:` را پیدا کنید، سپس زیربخشی را که با `alternate:` آغاز می‌شود بیابید. برای زبان آلمانی، موارد زیر را اضافه می‌کنید:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- نام: آلمانی\n" -" پیوند: /de/\n" -" زبان: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "نام زبان باید به آن زبان ترجمه شود. لینک باید شامل `/` باشد." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "اجرا کنید `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "اکنون می‌توانید `tox -e docs-translate` را اجرا کنید. این کار یک فایل ترجمهٔ خالی ایجاد می‌کند؛ اگر حساب DeepL دارید، می‌توانید از آن حساب برای پر کردن ترجمه‌های اولیهٔ ماشینی استفاده کنید. اگر حساب DeepL ندارید، مشکلی نیست – ما قبل از پذیرش درخواست کش، خودمان ترجمه‌های اولیه را انجام خواهیم داد." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "راهنمای ترجمه" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "پس از اینکه به تیم اضافه شدید، وقت آن است که وارد [Weblate]{1} شوید و کار ترجمه رشته‌ها را آغاز کنید." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "لحن در مقابل ترجمه کلمه‌به‌کلمه" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "حفظ لحن متن انگلیسی مهم‌تر از تلاش برای ترجمه کلمه‌به‌کلمه است. ما سعی می‌کنیم در محتوای خود صمیمی و کمی محاوره‌ای باشیم؛ در ترجمه‌هایتان سعی کنید روح همین سبک را حفظ کنید." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "اگر متن انگلیسی شامل یک اصطلاح رایج قوی باشد، لازم نیست حتماً آن را حفظ کنید، اگر در زبان خود معادلی دارید که به همان اندازه مناسب باشد. اگر واژه یا عبارت در متن انگلیسی اصطلاحی یا عامیانهٔ خاص باشد، از گفتن اینکه باید تغییر را در نظر بگیریم، نترسید. حتی برای انگلیسی‌زبانان نیز اصطلاحات و زبان عامیانه می‌توانند دشوار باشند. گاهی لازم است متن انگلیسی را تغییر دهیم تا برای مترجمان و خوانندگان یکسان ساده‌تر شود." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "آیا باید آن را ترجمه کنم؟" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "موارد زیر نباید ترجمه یا به‌روزرسانی شوند:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**دستورالعمل‌ها**. برای مثال، در «شما باید \\`briefcase create\\` را اجرا کنید.»، تنها «شما باید اجرا کنید» باید ترجمه شود." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "فضاهای نام، مانند نام کلاس، متد یا ویژگی." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**URLهای لینک**. لینک‌های استاندارد مارک‌داون باید در Weblate به‌صورت `[Link text]{1}` نمایش داده شوند، که در آن `1` موقعیت لینک در رشته را نسبت به سایر لینک‌های ممکن نشان می‌دهد. اگر URL کامل در رشته درج شده باشد، مانند `[Link text](https://example.com/)`، باید از ترجمه آن صرف‌نظر شود." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**پیوندهای مرجع حاوی نام کلاس، متد یا ویژگی**. این موارد باید بدون تغییر باقی بمانند، از جمله بک‌تیک‌ها. هر بخش از مثال لینک نمایش‌داده‌شده در اینجا ترجمه نخواهد شد." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][ویژگی.کلاس]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "محتوای پیوند مرجع. برای مثال، در موارد زیر `link-content` نادیده گرفته می‌شود:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[متن لینک][محتوای لینک]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "دستورهای جینجا. این هرگونه محتوایی است که بین دو جفت براکت منحنی متناسب، یا یک جفت براکت منحنی تک‌تایی متناسب با نشانه‌های درصد در هر انتها قرار گرفته باشد. توجه: درج یک مثال از این نحو در اینجا باعث می‌شود افزونهٔ Macros تلاش کند آن را رندر کند؛ برای مثال‌ها به [مستندات Macros]{1} مراجعه کنید." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**لنگرهای سفارشی**. آن‌ها پس از هدرها یا بالای برخی محتوا قرار می‌گیرند و به صورت `{ #anchor }` قالب‌بندی می‌شوند." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**دستور زبان تذکر**. در مثال زیر، واژه «admonition» نباید ترجمه شود. این قاعده برای همه انواع تذکرات، از جمله یادداشت‌ها، هشدارها و غیره نیز صادق است. برای کسب اطلاعات درباره ترجمه سایر بخش‌های محتوا، به بخش بعدی مراجعه کنید." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1926,52 +1892,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**بک‌تیک‌ها**. آن‌ها قرار است به‌عنوان بک‌تیک باقی بمانند؛ برای قالب‌بندی هم کدهای درون‌خطی و هم بلوک‌های کد استفاده می‌شوند." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**نحوه درج محتوای خارجی**. این هر چیزی است که در یک خط با `-8<-` قرار دارد، یا در خطوط بین دو `-8<-` در خطوط جداگانه." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "موارد زیر *باید* ترجمه شوند:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "متن لینک. در نحو لینک، متن قبل از URL قرار می‌گیرد و در کروشه‌ها محصور می‌شود، مانند `[Link text](URL)`. لینک‌های استاندارد مارک‌داون باید در Weblate به صورت `[Link text]{1}` نمایش داده شوند، جایی که `1` موقعیت لینک در رشته را با توجه به سایر لینک‌های ممکن نشان می‌دهد." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "متن پیوند مرجع. برای مثال، `Link text` به صورت زیر ترجمه می‌شود:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**عناوین و محتوای هشدار**. در مثال هشدار قبلی، «عنوان صفحه» و «محتوا.» باید ترجمه شوند." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "وب‌لت" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "ما از [Weblate]{1} برای ترجمه محتوای خود استفاده می‌کنیم. وقتی ترجمه جدیدی اضافه می‌کنیم، از [DeepL]{2} برای ترجمه ماشینی استفاده می‌کنیم تا اولین پیش‌نویس ترجمه‌ها را تولید کند. این بدان معناست که معمولاً محتوایی که قرار است ترجمه کنید، قبلاً توسط ماشین ترجمه شده است. انتظار می‌رود که شما به‌عنوان مترجم، ترجمه ماشینی موجود را بازبینی، ویرایش و بهبود ببخشید." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "وب‌لت همه چیز را به‌صورت رشته‌به‌رشته پردازش می‌کند. آن تغییرات را دسته‌ای جمع‌آوری می‌کند و هر چند ساعت یک‌بار یک commit دسته‌ای شامل همه رشته‌هایی که در آن بازه تغییر کرده‌اند را ارسال می‌کند. بنابراین ممکن است چند ساعت طول بکشد تا تغییرات شما در وب‌سایت نمایش داده شوند، اما می‌توانید انتظار داشته باشید که به‌روزرسانی ظرف چهار ساعت ظاهر شود." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "اگر پس از آن مدت تغییرات شما هنوز ظاهر نشده‌اند، علت احتمالی یک خطای نشانه‌گذاری است که منجر به شکست در ساخت مستندات برای آن زبان شده است. هر مشکل نشانه‌گذاری در هر رشته مانع از عمومی شدن کل ترجمه می‌شود. می‌توانید صفحهٔ ساخت زبان خود را زیر نظر داشته باشید تا ببینید آیا با موفقیت ساخته شده است یا خیر. این لینک به شکل مشابهی با این لینک به صفحه ساخت نسخه فرانسوی فرمت شده است: {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; کد زبان را به زبان خود تغییر دهید تا صفحه ساخت مناسب را مشاهده کنید. این کار وضعیت آخرین ساخت سایت را نشان می‌دهد. اگر ساخت با موفقیت انجام نشود، به گزارش ساخت (build log) نگاه کنید و ببینید آیا می‌توانید منبع مشکل را شناسایی کنید." @@ -2375,36 +2341,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "شما باید سند را در مکان مناسب درون دایرکتوری `docs/en` ایجاد کنید. برای بحث، فرض می‌کنیم شما یک سند جدید با نام فایل `new_doc.md` اضافه می‌کنید." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "سپس باید فایل `docs/en/SUMMARY.md` را به‌روزرسانی کنید تا فایل جدیدتان را شامل شود. `SUMMARY.md` اساساً برای بازتاب ساختار دایرکتوری `docs/en` سازمان‌دهی شده است، اما مهم‌تر از آن، ساختار نوار کناری سمت چپ را به‌طور مستقیم تعیین می‌کند. اگر بخشی را که قصد دارید `new_doc.md` را در آن درج کنید پیدا کنید و یک مسیر وایلدکارد را مشاهده کنید، نیازی نیست در `SUMMARY.md` هیچ تغییری ایجاد کنید. برای مثال:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./مسیر/به/دایرکتوری/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "اگر بخشی که قصد دارید `new_doc.md` را در آن قرار دهید شامل فهرستی از لینک‌های جداگانه مارک‌داون باشد، باید یک لینک صریح به لینک خود اضافه کنید. برای مثال:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [سند جدید من](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "نوشتن مستندات شما" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "اکنون می‌توانید فایل مورد نظر را در ویرایشگر خود باز کرده و شروع به نوشتن کنید." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "ما یک راهنمای سبک مستندسازی داریم که دستورالعمل‌های ما را برای نوشتن مستندسازی BeeWare تشریح می‌کند." @@ -3175,8 +3139,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "این راهنما شامل اطلاعاتی در مورد سبک مورد انتظار، نحو خاص MkDocs، ابزارهای مختلف مورد نیاز و ترجمه مستندات است، با توجه به نوشتن محتوای جدید و ترجمه محتوای موجود." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "این راهنما شامل اطلاعاتی در مورد سبک مورد انتظار، نحو خاص Zensical، ابزارهای مختلف مورد نیاز و ترجمه مستندات است، با توجه به نوشتن محتوای جدید و ترجمه محتوای موجود." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3235,8 +3199,8 @@ msgstr "شما باید هر زمان که ممکن است محتوای مستن #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs پیوندهای قالب‌بندی‌شده با مارک‌داون استاندارد را رندر می‌کند. پیوندهای وب قالب‌بندی‌شده با مارک‌داون استاندارد به شرح زیر هستند:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical پیوندهای قالب‌بندی‌شده با مارک‌داون استاندارد را رندر می‌کند. پیوندهای وب قالب‌بندی‌شده با مارک‌داون استاندارد به شرح زیر هستند:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3255,8 +3219,8 @@ msgstr "[متن لینک](مسیر/به/فایل.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "ارجاع به بخش‌های مشخصی از فایل‌ها یا مستندات API نیازمند استفاده از قالب لینک مرجع MkDocs است." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "ارجاع به بخش‌های مشخصی از فایل‌ها یا مستندات API نیازمند استفاده از قالب لینک مرجع Zensical است." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3270,13 +3234,13 @@ msgstr "Markdown برای همه سربرگ‌ها (هر چیزی در یک خط #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs از رندر کردن سینتکس لینک مرجع پشتیبانی می‌کند که به شما امکان می‌دهد با استفاده از یک لینک مارک‌داون اصلاح‌شده به عناصر مختلف مستندات لینک دهید. این شامل لینک دادن به، در میان موارد دیگر، سربرگ‌های سفارشی مارک‌داون و لنگرهای متنی می‌شود." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical از رندر کردن سینتکس لینک مرجع پشتیبانی می‌کند که به شما امکان می‌دهد با استفاده از یک لینک مارک‌داون اصلاح‌شده به عناصر مختلف مستندات لینک دهید. این شامل لینک دادن به، در میان موارد دیگر، سربرگ‌های سفارشی مارک‌داون و لنگرهای متنی می‌شود." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "پیوندهای مرجع MkDocs هر پیوندی هستند که به شکل زیر قالب‌بندی شده‌اند:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "پیوندهای مرجع Zensical هر پیوندی هستند که به شکل زیر قالب‌بندی شده‌اند:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3290,8 +3254,8 @@ msgstr "/// warning | سربرگ سفارشی و لنگرهای محتوا ال #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "هر سربرگ یا بخش محتوایی که از طریق لینک مرجع MkDocs در مستندات BeeWare در متن محتوا به آن ارجاع داده شده است، باید یک لنگر سفارشی به آن متصل شود. در غیر این صورت، هنگام ترجمه محتوای سربرگ احتمال شکسته شدن لینک‌ها وجود دارد." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "هر سربرگ یا بخش محتوایی که از طریق لینک مرجع Zensical در مستندات BeeWare در متن محتوا به آن ارجاع داده شده است، باید یک لنگر سفارشی به آن متصل شود. در غیر این صورت، هنگام ترجمه محتوای سربرگ احتمال شکسته شدن لینک‌ها وجود دارد." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3350,8 +3314,8 @@ msgstr "[متن لینک](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "لینک‌دادن به یک لنگر در سند جداگانه از سبک لینک مرجع MkDocs استفاده می‌کند که به شکل زیر قالب‌بندی می‌شود:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "لینک‌دادن به یک لنگر در سند جداگانه از سبک لینک مرجع Zensical استفاده می‌کند که به شکل زیر قالب‌بندی می‌شود:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3365,8 +3329,8 @@ msgstr "لینک‌های مرجع API" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "لینک‌گذاری مرجع MkDocs همچنین از ارجاع متقابل مستندات API پشتیبانی می‌کند، از جمله کلاس‌های مستندشده، متدها یا ویژگی‌های کلاس، و ارجاعات مستندات خارجی خاص." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "لینک‌گذاری مرجع Zensical همچنین از ارجاع متقابل مستندات API پشتیبانی می‌کند، از جمله کلاس‌های مستندشده، متدها یا ویژگی‌های کلاس، و ارجاعات مستندات خارجی خاص." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3941,8 +3905,8 @@ msgstr "استفاده از ماکروها برای درج محتوا از مح #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "شما همچنین می‌توانید با استفاده از افزونه [Macros MkDocs]{1} محتوای موجود در دایرکتوری محتوای مشترک ابزارهای BeeWare Docs را وارد کنید. این روش زمانی ضروری است که سند حاوی دستورهای Jinja باشد که نیاز به اجرا دارند و باید تنها در این شرایط استفاده شود. این روش با محتوای خارجی از طریق URL کار نخواهد کرد. مکانیزم جایگزینی متغیرهای [Macros]{2} با این روش کار می‌کند." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "شما همچنین می‌توانید با استفاده از افزونه [Macros]{1} محتوای موجود در دایرکتوری محتوای مشترک ابزارهای BeeWare Docs را وارد کنید. این روش زمانی ضروری است که سند حاوی دستورهای Jinja باشد که نیاز به اجرا دارند و باید تنها در این شرایط استفاده شود. این روش با محتوای خارجی از طریق URL کار نخواهد کرد. مکانیزم جایگزینی متغیرهای [Macros]{2} با این روش کار می‌کند." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4452,8 +4416,8 @@ msgstr "فرم‌های مستندسازی { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "مستندات {{ formal_name }} با استفاده از [MkDocs و Markdown]{1} نوشته می‌شود. ما قصد داریم از چارچوب [Diataxis]{2} برای ساختاردهی مستندات پیروی کنیم." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "مستندات {{ formal_name }} با استفاده از [Zensical]{1} و [Markdown]{2} نوشته می‌شود. ما قصد داریم از چارچوب [Diataxis]{3} برای ساختاردهی مستندات پیروی کنیم." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/fr/translations.po b/src/beeware_docs_tools/shared_content/locales/fr/translations.po index ad2c1218..a4bf9007 100644 --- a/src/beeware_docs_tools/shared_content/locales/fr/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/fr/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: 2026-04-06 22:32+0000\n" "Last-Translator: kursk140 <yannick.monnier.1@gmail.com>\n" "Language-Team: French <https://hosted.weblate.org/projects/beeware/docs-tools-shared-content/fr/>\n" @@ -364,7 +364,7 @@ msgstr "Toute référence à un nom de produit doit utiliser la majuscule préf msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Si un terme est utilisé \"comme un code\", il doit être cité comme un littéral (`comme ceci`) plutôt que d'être ajouté au dictionnaire." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1635,8 +1635,8 @@ msgstr "Si la langue pour laquelle vous souhaitez apporter votre aide n'existe p #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Créer le fichier `/docs/mkdocs.language-code.yml`, avec le contenu spécifique à la langue." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "Créer le fichier `/docs/zensical.language-code.toml`, avec le contenu spécifique à la langue." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1644,9 +1644,8 @@ msgid "Update `tox.ini` to include the new language build commands." msgstr "Mise à jour de `tox.ini` pour inclure les commandes de compilation dans les nouvelles langues." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 -#, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "Mise à jour de `/docs/config.yml` pour inclure la langue sous `extra : alternate:`." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1655,54 +1654,35 @@ msgstr "Les paragraphes suivants illustrent les changements nécessaires en pren #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "Un nouveau fichier de configuration MkDocs" +msgid "A new language configuration file" +msgstr "Un nouveau fichier de configuration Zensical" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "Tout d'abord, créez un nouveau fichier nommé `mkdocs.de.yml` dans le répertoire `docs`, avec le contenu suivant :" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "Tout d'abord, créez un nouveau fichier nommé `zensical.de.toml` dans le répertoire `docs`, avec le contenu suivant :" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Documentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/fr{% endif %}\n" -"docs_dir: fr\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"theme:\n" -" language: fr\n" -"\n" -"extra:\n" -" language_url: fr/\n" -" translation_type: machine\n" -" header:\n" -" About: À propos\n" -" Documentation: Documentation\n" -" Community: Communauté\n" -" Contributing: Contribuer\n" -" News: Actualités\n" -" Sponsor: Sponsors" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1710,9 +1690,8 @@ msgid "Here's what is going on in this file:" msgstr "Voici ce qui se passe dans ce dossier :" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Ce fichier hérite du contenu de la configuration de `config.yml`." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1721,201 +1700,186 @@ msgstr "La valeur `site_name` est traduite." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "La valeur `site_url` est l'URL du site du projet, suivie du code de la langue." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 -#, fuzzy msgid "The `docs_dir` should be the language code." msgstr "Le `docs_dir` doit être le code de la langue." +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "" + #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "La valeur `theme : language:` doit être le code de la langue, comme [spécifié par le thème MkDocs Material]{1}. Pour la plupart des langues, ce sera le même que le code de la langue `docs_dir` ; mais pour certaines (en particulier les langues avec des variantes locales comme `zh_CN`), il y a des différences." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "Le `extra.language_url` doit être le code de la langue, suivi d'une seule barre oblique, par exemple `de/` pour l'allemand." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 -#, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "Le `extra: language_url:` doit être le code de la langue, suivi d'une seule barre oblique, par exemple `de/` pour l'allemand." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "Le `extra : translation_type:` doit être `machine` jusqu'à ce que la traduction atteigne 100% pour la première fois, à ce moment-là il doit être `human`. Elle passera de `human` à `machine` si elle descend en dessous de 90%." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "Le contenu sous `extra.header` correspond aux traductions des titres qui apparaissent dans la barre d'en-tête. Cette définition n'est *pas* requise sur le site web principal de BeeWare ; elle n'est requise que sur *d'autres* sites (tels que le tutoriel ou la documentation du projet)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "Le contenu sous `extra: header` correspond aux traductions des titres qui apparaissent dans la barre d'en-tête. Cette définition n'est *pas* requise sur le site web principal de BeeWare ; elle n'est requise que sur *d'autres* sites (tels que le tutoriel ou la documentation du projet)." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "Mise à jour de `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "Vous devrez apporter plusieurs modifications au fichier `tox.ini`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "Vous ajouterez ce qui suit :" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "Le nouvel indicateur d'environnement de code de langue à la ligne d'en-tête qui commence par `[testenv:docs`, avec le code de langue précédé d'un `-`, sans espace, par exemple `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "Le nouveau code linguistique exclut la première commande, qui commence par `!lint`, précédée de `-!`, sans espace, par exemple `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "Le nouveau code de langue pour la ligne commençant par `translate : build_po_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "Le nouveau code de langue pour la ligne commençant par `translate : update_machine_translations`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "Une nouvelle commande, commençant par exemple par `de : build_md_translations` pour l'allemand, classée par ordre alphabétique parmi les commandes spécifiques à la langue existantes qui correspondent au contenu de ces commandes, avec le nouveau code de langue." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "Le nouveau code de langue pour la ligne commençant par `all:`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "Mise à jour de `config.yml`" +msgid "Update `zensical.toml`" +msgstr "Mise à jour de `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Ajoutez la langue à `config.yml` pour qu'elle apparaisse dans le sélecteur de langue de l'en-tête. Trouvez la section commençant par `extra:`, puis la sous-section commençant par `alternate:`. Pour l'allemand, vous devez ajouter ce qui suit :" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- nom : Allemand\n" -" lien : /fr/\n" -" langue : fr" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "Le nom de la langue doit être traduit dans la langue. Le lien doit inclure les `/`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "Exécuter `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Vous pouvez maintenant exécuter `tox -e docs-translate`. Cela générera un fichier de traduction vide ; si vous avez un compte DeepL, vous pouvez l'utiliser pour remplir les traductions automatiques initiales. Si vous n'avez pas de compte DeepL, ce n'est pas grave : nous effectuerons nous-mêmes les traductions initiales avant d'accepter la demande d'extraction." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "Lignes directrices pour la traduction" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "Une fois que vous avez été ajouté à l'équipe, il est temps de vous connecter à [Weblate]{1} et de commencer à travailler sur la traduction des chaînes de caractères." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "Le ton ou la traduction mot à mot" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "Il est plus important de conserver le ton du texte anglais que de s'efforcer de le traduire mot à mot. Nous essayons d'être amicaux et un peu familiers dans notre contenu ; essayez d'en conserver l'esprit dans vos traductions." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "Si le texte anglais contient une expression idiomatique forte, ne vous sentez pas obligé de conserver cette expression, s'il existe une expression analogue dans votre langue qui fonctionnerait tout aussi bien. Si le terme ou l'expression du texte anglais est particulièrement idiomatique ou argotique, n'hésitez pas à nous dire que nous devrions envisager de le modifier. Même pour les anglophones, les expressions idiomatiques et argotiques peuvent poser des difficultés. Il est parfois nécessaire de modifier le texte anglais afin de le rendre plus simple pour les traducteurs et les lecteurs." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "Dois-je le traduire ?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "Les éléments suivants ne doivent *pas* être traduits ou mis à jour :" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Commandes**. Par exemple, dans \"You should run \\`briefcase create\\`.\", seul \"You should run\" doit être traduit." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Espaces de noms**, tels que les noms de classes, de méthodes ou d'attributs." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**URL des liens**. Les liens Markdown standard doivent apparaître dans Weblate sous la forme `[Link text]{1}`, où `1` correspond à la position du lien dans la chaîne par rapport aux autres liens éventuels. Si l'URL complète est incluse dans la chaîne, sous la forme `[Link text](https://example.com/)`, celle-ci doit être ignorée lors de la traduction." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Liens de référence contenant des noms de classes, de méthodes ou d'attributs**. Ils doivent être laissés tels quels, y compris les antisèches. Toutes les parties de l'exemple de lien présenté ici ne seraient pas traduites." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Attribut de classe]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**Le contenu d'un lien de référence**. Par exemple, `link-content` serait ignoré dans l'exemple suivant :" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[Texte du lien][Contenu du lien]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Directives Jinja**. Il s'agit de tout contenu placé à l'intérieur de deux paires d'accolades correspondantes, ou d'une paire d'accolades correspondantes avec des signes de pourcentage à chaque extrémité. Note : L'inclusion d'un exemple de la syntaxe ici entraîne une tentative de rendu par le plugin Macros ; voir la [documentation Macros]{1} pour des exemples." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Ancres personnalisées**. Elles se trouvent après les en-têtes ou au-dessus d'un contenu, et sont formatées comme `{ #anchor }`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Syntaxe de l'admonition**. Dans l'exemple suivant, le mot \"admonition\" ne doit pas être traduit. Cela vaut pour tous les types d'admonitions, y compris les notes, les avertissements, etc. Voir la section suivante pour plus d'informations sur la traduction du reste du contenu." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1930,52 +1894,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Backticks**. Ils sont destinés à rester des backticks ; ils sont utilisés pour formater à la fois le code en ligne et les blocs de code." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**La syntaxe pour inclure du contenu externe**. Il s'agit de tout ce qui se trouve sur la même ligne que `-8<-`, ou sur les lignes entre deux `-8<-` sur des lignes séparées." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "Les éléments suivants *devraient* être traduits :" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Texte du lien**. Dans la syntaxe des liens, le texte vient avant l'URL, et est placé entre crochets, comme dans `[Texte du lien](URL)`. Les liens Markdown standards devraient apparaître dans Weblate comme `[Texte du lien]{1}`, où `1` est la position du lien dans la chaîne en référence à d'autres liens possibles." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Texte du lien de référence**. Par exemple, `Link text` serait traduit comme suit :" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Titres et contenu des admonitions**. Dans l'exemple précédent, les mots \"Titre de la page\" et \"Contenu\" doivent être traduits." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "Nous utilisons [Weblate]{1} pour la traduction du contenu. Lorsque nous ajoutons une nouvelle traduction, nous utilisons [DeepL]{2} pour la traduction automatique afin de produire une première série de traductions. En d'autres termes, le contenu que vous allez traduire est généralement déjà traduit par une machine. Nous attendons de vous, en tant que traducteur, que vous révisiez, corrigiez et amélioriez la traduction automatique existante." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate traite tout sur une base chaîne par chaîne. Il regroupe les changements, et toutes les deux heures, il soumettra un commit groupé avec toutes les chaînes qui ont été modifiées dans cet intervalle. Ainsi, il peut s'écouler quelques heures avant que vos changements n'apparaissent sur le site web, mais vous pouvez vous attendre à ce que la mise à jour apparaisse dans un délai de quatre heures." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Si, passé ce délai, vos modifications n'apparaissent toujours pas, la cause probable est une erreur de balisage, entraînant un échec de la compilation des documents pour cette langue. Tout problème de balisage dans une chaîne empêchera la publication de l'ensemble de la traduction. Vous pouvez surveiller la page de compilation de votre langue pour voir si elle a été compilée avec succès. Le lien est formaté de manière similaire à ce lien vers la page de compilation française {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; remplacez le code de langue par celui de votre langue pour afficher la page de compilation correspondante. Cela vous permettra de voir l'état de la dernière compilation du site. Si la compilation échoue, consultez le journal de compilation et essayez d'identifier la source du problème." @@ -2379,36 +2343,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "Vous devrez créer le document à l'emplacement approprié dans le répertoire `docs/en`. Pour la discussion, nous dirons que vous ajoutez un nouveau document avec le nom de fichier `new_doc.md`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "Ensuite, vous devrez mettre à jour le fichier `docs/fr/SUMMARY.md` pour y inclure votre nouveau fichier. Le fichier `SUMMARY.md` est organisé de manière à refléter la structure du répertoire `docs/en`, mais, plus important encore, il détermine directement la structure de la barre latérale gauche. Si vous localisez la section où vous avez l'intention d'inclure `new_doc.md`, vous n'avez pas besoin de changer quoi que ce soit dans `SUMMARY.md` si vous voyez un chemin joker listé. Par exemple :" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./chemin/vers/répertoire/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "Si la section dans laquelle vous avez l'intention d'inclure `new_doc.md` est une liste de liens Markdown individuels, vous devrez ajouter un lien explicite vers le vôtre. Par exemple :" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [Mon nouveau document](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "Rédiger votre documentation" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "Vous pouvez maintenant ouvrir le fichier souhaité dans votre éditeur et commencer à écrire." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "Nous disposons d'un [guide de style de la documentation]{1} qui décrit nos lignes directrices pour la rédaction de la documentation de BeeWare." @@ -3178,8 +3140,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Ce guide comprend des informations sur le style attendu, la syntaxe spécifique à MkDocs, les différents outils nécessaires et la traduction de la documentation, en ce qui concerne la rédaction d'un nouveau contenu et la traduction d'un contenu existant." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Ce guide comprend des informations sur le style attendu, la syntaxe spécifique à Zensical, les différents outils nécessaires et la traduction de la documentation, en ce qui concerne la rédaction d'un nouveau contenu et la traduction d'un contenu existant." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3238,8 +3200,8 @@ msgstr "Dans la mesure du possible, il est conseillé de faire des références #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs rend les liens standard au format Markdown. Les hyperliens web standard au format Markdown sont les suivants :" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical rend les liens standard au format Markdown. Les hyperliens web standard au format Markdown sont les suivants :" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3258,8 +3220,8 @@ msgstr "[Texte du lien](chemin/vers/fichier.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Le référencement de sections spécifiques de fichiers ou de la documentation de l'API nécessite l'utilisation du format de lien de référence MkDocs." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Le référencement de sections spécifiques de fichiers ou de la documentation de l'API nécessite l'utilisation du format de lien de référence Zensical." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3273,13 +3235,13 @@ msgstr "Markdown génère des ancres pour tous les en-têtes (tout ce qui se tro #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs prend en charge le rendu d'une syntaxe de lien de référence qui vous permet d'établir un lien vers divers autres éléments de la documentation à l'aide d'un lien Markdown modifié. Cela inclut les liens vers, entre autres, les en-têtes Markdown personnalisés et les ancres de texte." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical prend en charge le rendu d'une syntaxe de lien de référence qui vous permet d'établir un lien vers divers autres éléments de la documentation à l'aide d'un lien Markdown modifié. Cela inclut les liens vers, entre autres, les en-têtes Markdown personnalisés et les ancres de texte." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "Les liens de référence MkDocs sont des liens formatés comme suit :" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Les liens de référence Zensical sont des liens formatés comme suit :" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3293,8 +3255,8 @@ msgstr "/// warning | Des ancres d'en-tête et de contenu personnalisées sont n #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "Tout en-tête ou section de contenu qui est référencé dans le texte via un lien de référence MkDocs dans la documentation BeeWare _doit_ avoir une ancre personnalisée attachée. Dans le cas contraire, les liens risquent d'être rompus lors de la traduction du contenu de l'en-tête." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "Tout en-tête ou section de contenu qui est référencé dans le texte via un lien de référence Zensical dans la documentation BeeWare _doit_ avoir une ancre personnalisée attachée. Dans le cas contraire, les liens risquent d'être rompus lors de la traduction du contenu de l'en-tête." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3353,8 +3315,8 @@ msgstr "[Texte du lien](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "La création d'un lien vers une ancre dans un document séparé utilise le style de lien de référence MkDocs, qui est formaté comme suit :" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "La création d'un lien vers une ancre dans un document séparé utilise le style de lien de référence Zensical, qui est formaté comme suit :" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3368,8 +3330,8 @@ msgstr "Liens de référence de l'API" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "Le lien de référence MkDocs permet également d'établir des références croisées avec la documentation de l'API, y compris les classes documentées, les méthodes ou les attributs des classes, ainsi que des références spécifiques à la documentation externe." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Le lien de référence Zensical permet également d'établir des références croisées avec la documentation de l'API, y compris les classes documentées, les méthodes ou les attributs des classes, ainsi que des références spécifiques à la documentation externe." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3944,8 +3906,8 @@ msgstr "Utilisation de macros pour inclure le contenu de BeeWare Docs Tools dans #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "Vous pouvez également inclure du contenu provenant du répertoire de contenu partagé des outils BeeWare Docs en utilisant le [plugin Macros MkDocs]{1}. Cette méthode est nécessaire si le document contient des directives Jinja qui doivent être exécutées, et ne doit être utilisée que dans cette situation. Elle ne fonctionne pas avec du contenu externe via une URL. Le [mécanisme de remplacement des variables Macros]{2} fonctionne avec cette méthode." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "Vous pouvez également inclure du contenu provenant du répertoire de contenu partagé des outils BeeWare Docs en utilisant le [Macros]{1}. Cette méthode est nécessaire si le document contient des directives Jinja qui doivent être exécutées, et ne doit être utilisée que dans cette situation. Elle ne fonctionne pas avec du contenu externe via une URL. Le [mécanisme de remplacement des variables Macros]{2} fonctionne avec cette méthode." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4454,8 +4416,8 @@ msgstr "Documentation formulaires { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "La documentation de {{ formal_name }} est rédigée à l'aide de [MkDocs et Markdown]{1}. Nous nous efforçons de suivre le cadre [Diataxis]{2} pour structurer la documentation." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "La documentation de {{ formal_name }} est rédigée à l'aide de [Zensical]{1} et [Markdown]{2}. Nous nous efforçons de suivre le cadre [Diataxis]{3} pour structurer la documentation." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/it/translations.po b/src/beeware_docs_tools/shared_content/locales/it/translations.po index da29b933..bb55687a 100644 --- a/src/beeware_docs_tools/shared_content/locales/it/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/it/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: 2026-03-31 07:09+0000\n" "Last-Translator: tfr tint <tfrtint@gmail.com>\n" "Language-Team: Italian <https://hosted.weblate.org/projects/beeware/docs-tools-shared-content/it/>\n" @@ -364,7 +364,7 @@ msgstr "Qualsiasi riferimento al nome di un prodotto deve utilizzare la capitali msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Se un termine viene usato \"come codice\", allora dovrebbe essere citato come letterale (`come questo`) invece di essere aggiunto al dizionario." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1635,8 +1635,8 @@ msgstr "Se la lingua che si intende aiutare non esiste già, sono necessari alcu #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Creare il file `/docs/mkdocs.language-code.yml`, con il contenuto specifico della lingua." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "Creare il file `/docs/zensical.language-code.toml`, con il contenuto specifico della lingua." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1645,8 +1645,8 @@ msgstr "Aggiornare `tox.ini` per includere i comandi di compilazione della nuova #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "Aggiornare `/docs/config.yml` per includere la lingua sotto `extra: alternate:`." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "Aggiornare `/docs/zensical.toml` per includere la lingua sotto `extra.alternate`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1655,54 +1655,35 @@ msgstr "Di seguito vengono illustrate le modifiche necessarie, utilizzando come #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "Un nuovo file di configurazione di MkDocs" +msgid "A new language configuration file" +msgstr "Un nuovo file di configurazione di Zensical" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "Per prima cosa, creare un nuovo file chiamato `mkdocs.de.yml` nella cartella `docs`, con il seguente contenuto:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "Per prima cosa, creare un nuovo file chiamato `zensical.de.toml` nella cartella `docs`, con il seguente contenuto:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Documentazione\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Informazioni\n" -" Documentation: Documentazione\n" -" Community: Comunità\n" -" Contributing: Contribuisci\n" -" News: Notizie\n" -" Sponsor: Sponsor" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1710,9 +1691,8 @@ msgid "Here's what is going on in this file:" msgstr "Ecco cosa succede in questo file:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Questo file eredita il contenuto della configurazione da `config.yml`." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1721,201 +1701,186 @@ msgstr "Il valore `site_name` viene tradotto." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "Il valore `site_url` è l'URL del sito del progetto, seguito dal codice della lingua." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 -#, fuzzy msgid "The `docs_dir` should be the language code." msgstr "La `docs_dir` dovrebbe essere il codice della lingua." +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "" + #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "Il valore `tema: language:` dovrebbe essere il codice della lingua, come [specificato dal tema MkDocs Material]{1}. Per la maggior parte delle lingue, questo sarà uguale al codice della lingua `docs_dir`; ma per alcune (in particolare le lingue con varianti di locale come `zh_CN`), ci sono differenze." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "Il `extra.language_url` dovrebbe essere il codice della lingua, seguito da una singola barra, ad esempio `de/` per il tedesco." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "Il `extra: language_url:` dovrebbe essere il codice della lingua, seguito da una singola barra, ad esempio `de/` per il tedesco." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "L'opzione `extra.translation_type` dovrebbe essere `machine` fino a quando la traduzione non raggiunge il 100% per la prima volta, a quel punto dovrebbe essere `human`. Si tornerà a `machine` da `human` se si scende sotto il 90%." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "L'opzione `extra: translation_type:` dovrebbe essere `machine` fino a quando la traduzione non raggiunge il 100% per la prima volta, a quel punto dovrebbe essere `human`. Si tornerà a `machine` da `human` se si scende sotto il 90%." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "Il contenuto tra `extra.header` è la traduzione dei titoli che compaiono nella barra di intestazione. Questa definizione *non* è richiesta sul sito web principale di BeeWare; è richiesta solo su *altri* siti (come il tutorial o la documentazione del progetto)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "Il contenuto tra `extra: header` è la traduzione dei titoli che compaiono nella barra di intestazione. Questa definizione *non* è richiesta sul sito web principale di BeeWare; è richiesta solo su *altri* siti (come il tutorial o la documentazione del progetto)." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "Aggiornare `tox.ini" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "È necessario apportare diverse modifiche al file `tox.ini`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "Si aggiunge quanto segue:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "Il nuovo flag di ambiente del codice della lingua alla riga di intestazione che inizia con `[testenv:docs`, con il codice della lingua preceduto da un `-`, senza spazi inclusi, ad esempio `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "Il nuovo codice linguistico esclude il primo comando, che inizia con `!lint`, preceduto da `-!`, senza spazi, ad esempio `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "Il nuovo codice lingua alla riga che inizia con `translate : build_po_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "Il nuovo codice linguistico alla riga che inizia con `translate : update_machine_translations`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "Un nuovo comando, che inizia ad esempio con `de : build_md_translations` per il tedesco, in ordine alfabetico all'interno dei comandi specifici della lingua esistente che corrispondono al contenuto di tali comandi, con il nuovo codice lingua." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "Il nuovo codice lingua alla riga che inizia con `all:`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 -#, fuzzy -msgid "Update `config.yml`" -msgstr "Aggiornare `config.yml" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 +msgid "Update `zensical.toml`" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Aggiungere la lingua a `config.yml`, in modo che appaia nel selettore della lingua nell'intestazione. Trovare la sezione che inizia con `extra:` e quindi individuare la sottosezione che inizia con `alternate:`. Per il tedesco, si dovrebbe aggiungere quanto segue:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- nome: Tedesco\n" -" link: /de/\n" -" lingua: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "Il nome della lingua deve essere tradotto nella lingua. Il link deve includere le `/`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "Esegui `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Ora puoi eseguire `tox -e docs-translate`. Questo genererà un file di traduzione vuoto; se hai un account DeepL, puoi utilizzarlo per popolare le traduzioni automatiche iniziali. Se non hai un account DeepL, non preoccuparti: eseguiremo noi stessi le traduzioni iniziali prima di accettare la richiesta pull." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "Linee guida per la traduzione" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "Una volta aggiunti al team, è il momento di accedere a [Weblate]{1} e iniziare a tradurre le stringhe." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "Il tono rispetto alla traduzione parola per parola" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "È più importante mantenere il tono del testo inglese che sforzarsi di tradurre parola per parola. Cerchiamo di essere amichevoli e un po' colloquiali nei nostri contenuti; cercate di mantenere questo spirito nelle vostre traduzioni." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "Se il testo inglese contiene un forte idioma inglese, non sentitevi obbligati a mantenerlo, se esiste un analogo nella vostra lingua che funzionerebbe altrettanto bene. Se il termine o la frase del testo inglese è un termine particolarmente idiomatico o gergale, non abbiate paura di dirci che dovremmo prendere in considerazione una modifica. Anche per chi parla inglese, le espressioni idiomatiche e gergali possono creare difficoltà. A volte è necessario modificare il testo inglese per renderlo più semplice sia per i traduttori che per i lettori." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "Devo tradurlo?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "I seguenti elementi *non* devono essere tradotti o aggiornati:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Comandi**. Ad esempio, in \"You should run \\`briefcase create\\`\", solo \"You should run\" deve essere tradotto." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Spazi di nomi**, come i nomi di classi, metodi o attributi." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**URL dei link**. I link Markdown standard dovrebbero apparire in Weblate come `[Link text]{1}`, dove `1` indica la posizione del link nella stringa rispetto ad altri possibili link. Se nella stringa è presente l'URL completo, come `[Link text](https://example.com/)`, tale URL non deve essere tradotto." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Link di riferimento contenenti nomi di classi, metodi o attributi**. Questi dovrebbero essere lasciati così come sono, compresi i backtick. Tutte le parti del link di esempio qui mostrato non verrebbero tradotte." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Attributo di classe]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**Il contenuto del link di un link di riferimento**. Ad esempio, `link-content` verrebbe saltato nel seguente caso:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[Testo del link][Contenuto del link]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Direttive Jinja**. Si tratta di qualsiasi contenuto avvolto all'interno di due coppie di parentesi graffe corrispondenti, o di una coppia corrispondente di parentesi graffe singole con segni di percentuale all'interno di ciascuna estremità. Nota: l'inclusione di un esempio della sintassi provoca il tentativo di renderla da parte del plugin Macros; si veda la [documentazione di Macros]{1} per gli esempi." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Ancore personalizzate**. Si trovano dopo le intestazioni o sopra alcuni contenuti e sono formattati come `{ #ancora }`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Sintassi dell'ammonizione**. Nell'esempio seguente, la parola \"ammonizione\" non deve essere tradotta. Questo vale per tutti gli stili di ammonizione, comprese le note, gli avvertimenti, ecc. Vedere la sezione successiva per informazioni sulla traduzione del resto del contenuto." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1930,52 +1895,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Backticks**. Sono destinati a rimanere come backtick; sono usati per formattare sia il codice in linea che i blocchi di codice." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**La sintassi per includere contenuti esterni**. Si tratta di qualsiasi cosa sulla stessa riga di `-8<-`, o sulle righe tra due `-8<-` su righe separate." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "I seguenti elementi *dovrebbero* essere tradotti:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Testo del collegamento**. Nella sintassi dei link, il testo viene prima dell'URL ed è racchiuso tra parentesi, come in `[Link text](URL)`. I link Markdown standard dovrebbero apparire in Weblate come `[Testo del link]{1}`, dove `1` è la posizione del link nella stringa con riferimento ad altri possibili link." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Testo del link di riferimento**. Ad esempio, `Link text` verrebbe tradotto come segue:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Titoli e contenuti delle ammonizioni**. Nell'esempio precedente, \"Titolo della pagina\" e \"Contenuto\" devono essere tradotti." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "Utilizziamo [Weblate]{1} per la traduzione dei contenuti. Quando aggiungiamo una nuova traduzione, usiamo [DeepL]{2} per la traduzione automatica per produrre un primo passaggio di traduzioni. Ciò significa che, in genere, il contenuto che tradurrete è già tradotto automaticamente. L'aspettativa è che il traduttore riveda, modifichi e migliori la traduzione automatica esistente." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate elabora tutto su base stringa per stringa. Le modifiche vengono raggruppate e ogni due ore viene inviato un commit di massa con tutte le stringhe modificate in quell'intervallo. Quindi, potrebbero volerci un paio d'ore prima che le modifiche vengano visualizzate sul sito web, ma si può prevedere che l'aggiornamento venga visualizzato entro quattro ore." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Se dopo tale periodo le modifiche non sono ancora state pubblicate, la causa probabile è un errore di markup che ha causato un errore nella compilazione dei documenti per quella lingua. Qualsiasi problema di markup in una stringa bloccherà la pubblicazione dell'intera traduzione. È possibile tenere d'occhio la pagina di compilazione della propria lingua per verificare se la compilazione è stata completata con successo. Il link ha un formato simile a questo link alla pagina di compilazione francese {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; modifica il codice della lingua con quello della tua lingua per visualizzare la pagina di compilazione appropriata. Verrà mostrato lo stato della compilazione più recente del sito. Se la compilazione non va a buon fine, consulta il log di compilazione e verifica se riesci a identificare la causa del problema." @@ -2379,36 +2344,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "È necessario creare il documento nella posizione appropriata all'interno della cartella `docs/en`. A titolo di esempio, diciamo che stiamo aggiungendo un nuovo documento con il nome di file `new_doc.md`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "Quindi, è necessario aggiornare il file `docs/en/SUMMARY.md` per includere il nuovo file. Il file `SUMMARY.md` è organizzato in modo da riflettere la struttura della cartella `docs/en`, ma soprattutto determina direttamente la struttura della barra laterale sinistra. Se si individua la sezione in cui si intende includere `new_doc.md`, non è necessario modificare nulla in `SUMMARY.md` se si vede un percorso jolly. Ad esempio:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./percorso/della/directory/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "Se la sezione in cui si intende includere `new_doc.md` è un elenco di singoli collegamenti a Markdown, è necessario aggiungere un collegamento esplicito al proprio. Per esempio:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [Il mio nuovo documento](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "Scrivere la documentazione" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "A questo punto è possibile aprire il file desiderato nel proprio editor e iniziare a scrivere." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "Abbiamo una [guida allo stile della documentazione]{1} che delinea le nostre linee guida per la scrittura della documentazione di BeeWare." @@ -3177,8 +3140,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Questa guida contiene informazioni sullo stile previsto, sulla sintassi specifica di MkDocs, sui vari strumenti necessari e sulla traduzione della documentazione, per quanto riguarda la scrittura di nuovi contenuti e la traduzione di quelli esistenti." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Questa guida contiene informazioni sullo stile previsto, sulla sintassi specifica di Zensical, sui vari strumenti necessari e sulla traduzione della documentazione, per quanto riguarda la scrittura di nuovi contenuti e la traduzione di quelli esistenti." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3237,8 +3200,8 @@ msgstr "È consigliabile fare riferimenti incrociati ai contenuti della document #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs rende i collegamenti standard formattati in Markdown. I collegamenti ipertestuali web standard in formato Markdown sono i seguenti:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical rende i collegamenti standard formattati in Markdown. I collegamenti ipertestuali web standard in formato Markdown sono i seguenti:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3257,8 +3220,8 @@ msgstr "[Testo del link](percorso/verso/file.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Per fare riferimento a sezioni specifiche di file o alla documentazione API è necessario utilizzare il formato di collegamento di riferimento di MkDocs." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Per fare riferimento a sezioni specifiche di file o alla documentazione API è necessario utilizzare il formato di collegamento di riferimento di Zensical." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3272,13 +3235,13 @@ msgstr "Markdown genera ancore per tutte le intestazioni (qualsiasi cosa su una #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs supporta il rendering di una sintassi di collegamento di riferimento che consente di collegarsi a vari altri elementi della documentazione utilizzando un collegamento Markdown modificato. Questo include, tra l'altro, il collegamento a intestazioni e ancore di testo Markdown personalizzate." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical supporta il rendering di una sintassi di collegamento di riferimento che consente di collegarsi a vari altri elementi della documentazione utilizzando un collegamento Markdown modificato. Questo include, tra l'altro, il collegamento a intestazioni e ancore di testo Markdown personalizzate." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "I link di riferimento MkDocs sono tutti i link formattati come segue:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "I link di riferimento Zensical sono tutti i link formattati come segue:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3292,8 +3255,8 @@ msgstr "/// warning | Sono necessari ancoraggi personalizzati per l'intestazione #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "Qualsiasi intestazione o sezione di contenuto a cui si fa riferimento nel contenuto testuale tramite un link di riferimento MkDocs nella documentazione di BeeWare _deve_ avere un ancoraggio personalizzato. Altrimenti, è possibile che i collegamenti si interrompano quando il contenuto dell'intestazione viene tradotto." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "Qualsiasi intestazione o sezione di contenuto a cui si fa riferimento nel contenuto testuale tramite un link di riferimento Zensical nella documentazione di BeeWare _deve_ avere un ancoraggio personalizzato. Altrimenti, è possibile che i collegamenti si interrompano quando il contenuto dell'intestazione viene tradotto." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3352,8 +3315,8 @@ msgstr "[Testo del link](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "Il collegamento a un'ancora in un documento separato utilizza lo stile di riferimento di MkDocs, formattato come segue:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "Il collegamento a un'ancora in un documento separato utilizza lo stile di riferimento di Zensical, formattato come segue:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3367,8 +3330,8 @@ msgstr "Link di riferimento alle API" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "Il collegamento dei riferimenti di MkDocs supporta anche i riferimenti incrociati alla documentazione dell'API, comprese le classi documentate, i metodi o gli attributi delle classi e i riferimenti a documentazione esterna specifica." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Il collegamento dei riferimenti di Zensical supporta anche i riferimenti incrociati alla documentazione dell'API, comprese le classi documentate, i metodi o gli attributi delle classi e i riferimenti a documentazione esterna specifica." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3943,8 +3906,8 @@ msgstr "Utilizzo delle macro per includere il contenuto di BeeWare Docs Tools co #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "È anche possibile includere il contenuto della cartella dei contenuti condivisi degli strumenti BeeWare Docs utilizzando il plugin [Macros MkDocs]{1}. Questo metodo è necessario se il documento contiene direttive Jinja che devono essere eseguite e deve essere usato solo in questa situazione. Non funziona con il contenuto esterno tramite un URL. Il [meccanismo di sostituzione delle variabili di Macros]{2} funziona con questo metodo." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "È anche possibile includere il contenuto della cartella dei contenuti condivisi degli strumenti BeeWare Docs utilizzando il plugin [Macros]{1}. Questo metodo è necessario se il documento contiene direttive Jinja che devono essere eseguite e deve essere usato solo in questa situazione. Non funziona con il contenuto esterno tramite un URL. Il [meccanismo di sostituzione delle variabili di Macros]{2} funziona con questo metodo." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4453,8 +4416,8 @@ msgstr "Moduli di documentazione { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "La documentazione di {{nome_formale }} è scritta utilizzando [MkDocs e Markdown]{1}. Il nostro obiettivo è seguire il framework [Diataxis]{2} per la strutturazione della documentazione." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "La documentazione di {{nome_formale }} è scritta utilizzando [Zensical]{1} e [Markdown]{2}. Il nostro obiettivo è seguire il framework [Diataxis]{3} per la strutturazione della documentazione." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/ja/translations.po b/src/beeware_docs_tools/shared_content/locales/ja/translations.po index 9ef9b091..2b4ee660 100644 --- a/src/beeware_docs_tools/shared_content/locales/ja/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/ja/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -363,7 +363,7 @@ msgstr "製品名への言及は、製品が推奨する大文字表記を使用 msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "ある用語が「暗号として」使用されている場合、辞書に追加するのではなく、リテラル（`like this`）として引用すべきである。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 #, fuzzy msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1631,8 +1631,8 @@ msgstr "お手伝い予定の言語がまだ存在しない場合、開始前に #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "`/docs/mkdocs.language-code.yml` ファイルを作成し、言語固有の内容を記述してください。" +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "`/docs/zensical.language-code.toml` ファイルを作成し、言語固有の内容を記述してください。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1641,8 +1641,8 @@ msgstr "`tox.ini`を更新して、新しい言語ビルドコマンドを含め #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "`/docs/config.yml` を更新して、`extra: alternate:` 内の言語を含めるようにしてください。" +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "`/docs/zensical.toml` を更新して、`extra.alternate` 内の言語を含めるようにしてください。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1651,54 +1651,35 @@ msgstr "以下の例は、ドイツ語を例として必要な変更点を示し #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "新しいMkDocs設定ファイル" +msgid "A new language configuration file" +msgstr "新しいZensical設定ファイル" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "まず、`mkdocs.de.yml` ディレクトリ内に `docs` という名前の新しいファイルを作成し、以下の内容を入力します：" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "まず、`zensical.de.toml` ディレクトリ内に `docs` という名前の新しいファイルを作成し、以下の内容を入力します：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} ドキュメント\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: 概要\n" -" Documentation: ドキュメント\n" -" Community: コミュニティ\n" -" Contributing: 貢献\n" -" News: ニュース\n" -" Sponsor: スポンサー" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1706,9 +1687,8 @@ msgid "Here's what is going on in this file:" msgstr "このファイルでは以下の処理が行われています：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "このファイルは`config.yml`から設定内容を継承します。" +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1717,201 +1697,188 @@ msgstr "`site_name` の値は変換されます。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "`site_url`の値はプロジェクトサイトのURLであり、その後に言語コードが続きます。" +msgid "The `docs_dir` should be the language code." +msgstr "`docs_dir`は言語コードであるべきです。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "`docs_dir`は言語コードであるべきです。" +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "`theme.language` の値は言語コードである必要があります（Zensical テーマで指定されているとおり）。ほとんどの言語では、これは {1} の言語コードと同じですが、一部（特に `docs_dir` のようなロケールバリエーションを持つ言語）では差異があります。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "`theme: language:` の値は言語コードである必要があります（MkDocs Material テーマで指定されているとおり）。ほとんどの言語では、これは {1} の言語コードと同じですが、一部（特に `docs_dir` のようなロケールバリエーションを持つ言語）では差異があります。" +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "`extra.language_url` は言語コードであり、単一のスラッシュが続く。例：`de/` はドイツ語を表す。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "`extra: language_url:` は言語コードであり、単一のスラッシュが続く。例：`de/` はドイツ語を表す。" +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "`extra.translation_type` は、翻訳率が初めて 100% に達するまでは `machine` のままであるべきであり、その時点で `human` となるべきである。翻訳率が 90% 未満に後退した場合、`machine` から `human` に戻す。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "`extra: translation_type:` は、翻訳率が初めて 100% に達するまでは `machine` のままであるべきであり、その時点で `human` となるべきである。翻訳率が 90% 未満に後退した場合、`machine` から `human` に戻す。" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "`extra: header`内の内容は、ヘッダーバーに表示されるタイトルの翻訳です。この定義は、BeeWareのメインウェブサイトでは*不要*です。*他の*サイト（チュートリアルやプロジェクトドキュメントなど）でのみ必要です。" +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "`extra.header`内の内容は、ヘッダーバーに表示されるタイトルの翻訳です。この定義は、BeeWareのメインウェブサイトでは*不要*です。*他の*サイト（チュートリアルやプロジェクトドキュメントなど）でのみ必要です。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "更新 `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "`tox.ini`ファイルにいくつかの変更を加える必要があります。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "以下の内容を追加します：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "新しい言語コード環境フラグは、`[testenv:docs`で始まるヘッダー行に追加され、言語コードの前に`-`が置かれ、スペースを含まない。例：`-de`。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "最初のコマンドに対する新しい言語コード除外は、`!lint`で始まり、その前に`-!`が置かれ、スペースを含まない形式です。例：`-!de`。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "`translate : build_po_translations`で始まる行への新しい言語コード" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "`translate : update_machine_translations`で始まる行への新しい言語コード" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "新しいコマンドは、例えばドイツ語の場合は`de : build_md_translations`で始まり、既存の言語固有コマンド内でアルファベット順に配置され、それらのコマンドの内容と一致し、新しい言語コードを持つ。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "`all:`で始まる行への新しい言語コード" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "更新 `config.yml`" +msgid "Update `zensical.toml`" +msgstr "更新 `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "言語を`config.yml`に追加すると、ヘッダーの言語セレクターに表示されます。`extra:`で始まるセクションを見つけ、次に`alternate:`で始まるサブセクションを探します。ドイツ語の場合は、以下を追加します：" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- name: ドイツ語\n" -" link: /de/\n" -" lang: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "言語名は対象言語に翻訳する必要があります。リンクには`/`を含める必要があります。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "実行 `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "現在、`tox -e docs-translate`を実行できます。これにより空の翻訳ファイルが生成されます。DeepLアカウントをお持ちの場合は、そのアカウントを使用して初期機械翻訳を生成できます。DeepLアカウントをお持ちでない場合も問題ありません。プルリクエストを受け入れる前に、当社で初期翻訳を実行します。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "翻訳ガイドライン" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "チームに追加されたら、[Weblate]{1} にログインし、文字列の翻訳作業を開始してください。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "ニュアンス重視の翻訳と逐語訳" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "英語原文のトーンを維持することが、逐語訳を目指すことよりも重要です。当コンテンツでは親しみやすくやや口語的な表現を心がけています。翻訳においてもその精神を保つよう努めてください。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "英語の原文に強い英語の慣用句が含まれている場合、自国語で同等の効果を持つ類似表現があれば、その慣用句を無理に維持する必要はありません。英語の原文にある用語やフレーズが特に慣用的な表現やスラングである場合、変更を検討すべきだと遠慮なく伝えてください。英語話者にとっても、慣用句やスラングは理解が難しい場合があります。 翻訳者と読者双方にとって理解しやすくするため、英語原文を変更する必要が生じる場合もあります。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "翻訳すべきでしょうか？" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "以下の項目は翻訳または更新*しないでください*：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**コマンド**。例えば、「You should run \\`briefcase create\\`。」では、「You should run」のみを翻訳してください。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**名前空間**（クラス名、メソッド名、属性名など）。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**リンクURL**。標準的なMarkdown形式のリンクは、Weblateでは `[Link text]{1}` の形式で表示されます。ここで、`1` は、その文字列内の他のリンクとの位置関係を示します。もし文字列内に完全なURLが `[Link text](https://example.com/)` の形式で含まれている場合、そのURLは翻訳対象から除外されます。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**クラス名、メソッド名、属性名を含む参照リンク**。これらはバッククォートを含め、そのまま残す必要があります。ここに示された例リンクのどの部分も翻訳されません。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Class.attribute]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**参照リンクのリンク内容**。例えば、以下では`link-content`がスキップされます：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[リンクテキスト][リンク先の内容]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Jinjaディレクティブ**。これは、2組の対応する中括弧で囲まれた内容、または両端にパーセント記号が付いた対応する単一の中括弧で囲まれた内容です。注：ここに構文の例を含めると、Macrosプラグインがそれをレンダリングしようとします。例については[Macrosドキュメント]{1}を参照してください。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**カスタムアンカー**。ヘッダーの後ろや一部のコンテンツの上部に配置され、`{ #anchor }`でフォーマットされます。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**警告の構文**。以下の例において、「警告」という単語は翻訳しないでください。これは注記や警告など、あらゆる形式の警告に適用されます。その他のコンテンツの翻訳方法については、次のセクションを参照してください。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1926,52 +1893,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**バッククォート**。これらはバッククォートとして残す必要があります。インラインコードとコードブロックの両方の書式設定に使用されます。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**外部コンテンツを含める構文**。これは、`-8<-`と同じ行にあるもの、または別々の行にある2つの`-8<-`の間の行にあるもののいずれかです。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "以下の項目は翻訳されるべきです：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**リンクテキスト**。リンク構文では、テキストはURLの前に配置され、`[Link text](URL)`で囲まれます。標準的なMarkdownリンクはWeblate上で`[Link text]{1}`として表示されるべきであり、`1`は文字列内のリンクの位置（他のリンクとの相対位置）を示します。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**参照リンクテキスト**。例えば、`Link text` は以下のように翻訳されます：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**警告のタイトルと内容**。前の警告の例では、「ページタイトル」と「内容」を翻訳する必要があります。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "コンテンツ翻訳には[Weblate]{1}を利用しています。新規翻訳を追加する際は、機械翻訳ツール[DeepL]{2}を用いて一次翻訳を生成します。つまり、通常翻訳対象となるコンテンツは既に機械翻訳済みです。翻訳者である皆様には、既存の機械翻訳をレビュー・編集・改善していただくことが求められます。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblateは文字列単位で処理を行います。変更をバッチ処理し、数時間ごとにその間隔で変更された全文字列をまとめてコミットします。そのため、変更がウェブサイトに反映されるまで数時間かかる場合がありますが、更新は4時間以内に表示される見込みです。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "その後も変更が反映されない場合、原因はマークアップエラーである可能性が高く、その言語のドキュメントビルドが失敗しています。どの文字列のマークアップ問題でも、翻訳全体が公開されるのを妨げます。該当言語のビルドページを監視し、ビルドが正常に完了したかどうかを確認できます。 該当リンクは以下のような形式です：{% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %};このリンクを、ご自身の言語コードに置き換えてください。これにより該当言語のビルドページが表示され、サイトの最新ビルド状態を確認できます。ビルドが失敗した場合は、ビルドログを確認し問題の原因を特定してください。 言語コードを自分の言語に置き換えると、該当するビルドページが表示されます。ここにはサイトの最新ビルド状況が示されます。ビルドが失敗した場合は、ビルドログを確認し、問題の原因を特定できるか検討してください。" @@ -2375,36 +2342,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "`docs/en`ディレクトリ内の適切な場所にドキュメントを作成する必要があります。説明のため、ファイル名`new_doc.md`の新しいドキュメントを追加すると仮定します。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "次に、新しいファイルを含めるために`docs/en/SUMMARY.md`ファイルを更新する必要があります。`SUMMARY.md`は基本的に`docs/en`ディレクトリ構造を反映するように構成されていますが、より重要なのは左サイドバーの構造を直接決定する点です。`new_doc.md`を含めたいセクションを見つけたら、ワイルドカードパスが記載されている場合は`SUMMARY.md`内で何も変更する必要はありません。例：" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./ディレクトリへのパス/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "`new_doc.md`を含めようとするセクションが個別のMarkdownリンクのリストである場合、明示的なリンクを追加する必要があります。例：" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [新しいドキュメント](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "ドキュメントの作成" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "目的のファイルをエディタで開いて、書き始めることができます。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "BeeWareのドキュメント作成に関するガイドラインをまとめた[ドキュメントスタイルガイド]{1}を用意しています。" @@ -3175,8 +3140,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "このガイドには、新規コンテンツの作成および既存コンテンツの翻訳に関する、期待されるスタイル、MkDocs固有の構文、各種必須ツール、およびドキュメント翻訳についての情報が含まれています。" +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "このガイドには、新規コンテンツの作成および既存コンテンツの翻訳に関する、期待されるスタイル、Zensical固有の構文、各種必須ツール、およびドキュメント翻訳についての情報が含まれています。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3235,8 +3200,8 @@ msgstr "ドキュメント内のコンテンツは可能な限り相互参照す #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocsは標準的なMarkdown形式のリンクをレンダリングします。標準的なMarkdown形式のウェブハイパーリンクは以下の通りです：" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensicalは標準的なMarkdown形式のリンクをレンダリングします。標準的なMarkdown形式のウェブハイパーリンクは以下の通りです：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3255,8 +3220,8 @@ msgstr "[リンクテキスト](path/to/file.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "ファイルの特定セクションやAPIドキュメントを参照するには、MkDocsの参照リンク形式を使用する必要があります。" +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "ファイルの特定セクションやAPIドキュメントを参照するには、Zensicalの参照リンク形式を使用する必要があります。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3270,13 +3235,13 @@ msgstr "Markdownは、ヘッダーの内容に基づいて、すべてのヘッ #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocsは、修正されたMarkdownリンクを使用してドキュメント内の様々な要素へリンクできる参照リンク構文のレンダリングをサポートしています。これには、カスタムMarkdownヘッダーやテキストアンカーなどへのリンクが含まれます。" +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensicalは、修正されたMarkdownリンクを使用してドキュメント内の様々な要素へリンクできる参照リンク構文のレンダリングをサポートしています。これには、カスタムMarkdownヘッダーやテキストアンカーなどへのリンクが含まれます。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "MkDocs リファレンスリンクは、以下の形式で記述されたリンクです：" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Zensical リファレンスリンクは、以下の形式で記述されたリンクです：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3290,8 +3255,8 @@ msgstr "/// warning | カスタムヘッダーとコンテンツアンカーが #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "BeeWareドキュメントにおいて、テキストコンテンツ内でMkDocs参照リンクを介して参照されるヘッダーまたはコンテンツセクションには、必ずカスタムアンカーを添付する必要があります。そうしないと、ヘッダーコンテンツが翻訳された際にリンクが壊れる可能性があります。" +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "BeeWareドキュメントにおいて、テキストコンテンツ内でZensical参照リンクを介して参照されるヘッダーまたはコンテンツセクションには、必ずカスタムアンカーを添付する必要があります。そうしないと、ヘッダーコンテンツが翻訳された際にリンクが壊れる可能性があります。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3350,8 +3315,8 @@ msgstr "[リンクテキスト](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "別ドキュメント内のアンカーへのリンクには、MkDocsの参照リンクスタイルが使用されます。その書式は以下の通りです：" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "別ドキュメント内のアンカーへのリンクには、Zensicalの参照リンクスタイルが使用されます。その書式は以下の通りです：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3365,8 +3330,8 @@ msgstr "APIリファレンスリンク" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "MkDocsのリファレンスリンク機能は、APIドキュメントの相互参照もサポートしています。これには、ドキュメント化されたクラス、クラスメソッドまたは属性、および特定の外部ドキュメント参照が含まれます。" +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Zensicalのリファレンスリンク機能は、APIドキュメントの相互参照もサポートしています。これには、ドキュメント化されたクラス、クラスメソッドまたは属性、および特定の外部ドキュメント参照が含まれます。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3941,8 +3906,8 @@ msgstr "マクロを使用してBeeWare Docs Toolsの共有コンテンツを組 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "[Macros MkDocs plugin]{1} を使用すると、BeeWare Docs ツールの共有コンテンツディレクトリからコンテンツを含めることもできます。この方法は、ドキュメントに実行が必要な Jinja ディレクティブが含まれている場合に必要であり、この状況でのみ使用すべきです。URL 経由の外部コンテンツでは機能しません。[Macros variable-replacement mechanism]{2} はこの方法と互換性があります。" +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "[Macros]{1} を使用すると、BeeWare Docs ツールの共有コンテンツディレクトリからコンテンツを含めることもできます。この方法は、ドキュメントに実行が必要な Jinja ディレクティブが含まれている場合に必要であり、この状況でのみ使用すべきです。URL 経由の外部コンテンツでは機能しません。[Macros variable-replacement mechanism]{2} はこの方法と互換性があります。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4452,8 +4417,8 @@ msgstr "書類様式 { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/ko/translations.po b/src/beeware_docs_tools/shared_content/locales/ko/translations.po index c2ff241e..f7c0db7b 100644 --- a/src/beeware_docs_tools/shared_content/locales/ko/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/ko/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: 2026-05-28 05:11+0000\n" "Last-Translator: Trash Soul <trashtrash0909@gmail.com>\n" "Language-Team: Korean <https://hosted.weblate.org/projects/beeware/docs-tools-shared-content/ko/>\n" @@ -356,7 +356,7 @@ msgstr "제품명에 대한 모든 언급은 해당 제품의 권장 대소문 msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "어떤 용어가 \"암호\"로 사용되고 있다면, 사전(dictionary)에 추가하기보다는 리터럴(`like this`)로 인용해야 합니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 #, fuzzy msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1624,8 +1624,8 @@ msgstr "도움을 주려는 언어가 아직 존재하지 않는다면, 시작 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "`/docs/mkdocs.language-code.yml` 파일을 생성하고, 언어별 특정 내용을 포함시키세요." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "`/docs/zensical.language-code.toml` 파일을 생성하고, 언어별 특정 내용을 포함시키세요." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1634,8 +1634,8 @@ msgstr "`tox.ini`를 업데이트하여 새로운 언어 빌드 명령어를 포 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "`/docs/config.yml`를 업데이트하여 `extra: alternate:` 아래에 언어를 포함시키세요." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "`/docs/zensical.toml`를 업데이트하여 `extra.alternate` 아래에 언어를 포함시키세요." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1644,54 +1644,35 @@ msgstr "다음은 독일어를 예시로 필요한 변경 사항을 보여줍니 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "새로운 MkDocs 구성 파일" +msgid "A new language configuration file" +msgstr "새로운 Zensical 구성 파일" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "먼저, `mkdocs.de.yml` 디렉토리에 `docs`라는 새 파일을 생성하고 다음 내용을 입력하세요:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "먼저, `zensical.de.toml` 디렉토리에 `docs`라는 새 파일을 생성하고 다음 내용을 입력하세요:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} 문서\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: 소개\n" -" Documentation: 문서\n" -" Community: 커뮤니티\n" -" Contributing: 기여하기\n" -" News: 소식\n" -" Sponsor: 후원자" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1699,9 +1680,8 @@ msgid "Here's what is going on in this file:" msgstr "이 파일에서 진행 중인 내용은 다음과 같습니다:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "이 파일은 `config.yml`의 구성 내용을 상속합니다." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1710,201 +1690,188 @@ msgstr "`site_name` 값이 번역됩니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "`site_url` 값은 프로젝트 사이트 URL이며, 그 뒤에 언어 코드가 이어집니다." +msgid "The `docs_dir` should be the language code." +msgstr "`docs_dir`는 언어 코드여야 합니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "`docs_dir`는 언어 코드여야 합니다." +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "`theme.language` 값은 [Zensical 테마에서 지정된 대로]{1} 언어 코드여야 합니다. 대부분의 언어에서는 `docs_dir` 언어 코드와 동일하지만, 일부 언어(특히 `zh_CN`와 같이 로케일 변형이 있는 언어)에서는 차이가 있습니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "`theme: language:` 값은 [MkDocs Material 테마에서 지정된 대로]{1} 언어 코드여야 합니다. 대부분의 언어에서는 `docs_dir` 언어 코드와 동일하지만, 일부 언어(특히 `zh_CN`와 같이 로케일 변형이 있는 언어)에서는 차이가 있습니다." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "`extra.language_url`는 언어 코드여야 하며, 그 뒤에 단일 슬래시가 따라야 합니다. 예를 들어, `de/`는 독일어를 의미합니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "`extra: language_url:`는 언어 코드여야 하며, 그 뒤에 단일 슬래시가 따라야 합니다. 예를 들어, `de/`는 독일어를 의미합니다." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "`extra.translation_type`는 번역률이 처음 100%에 도달할 때까지 `machine`로 유지되어야 하며, 이때 `human`.로 변경됩니다. 번역률이 90% 미만으로 하락할 경우 `machine`.에서 `human`로 되돌아가게 됩니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "`extra: translation_type:`는 번역률이 처음 100%에 도달할 때까지 `machine`로 유지되어야 하며, 이때 `human`.로 변경됩니다. 번역률이 90% 미만으로 하락할 경우 `machine`.에서 `human`로 되돌아가게 됩니다." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "`extra: header` 안의 내용은 헤더 바에 표시되는 제목들의 번역입니다. 이 정의는 BeeWare 메인 웹사이트에서는 *필요하지 않습니다*; *다른* 사이트(예: 튜토리얼이나 프로젝트 문서)에서만 필요합니다." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "`extra.header` 안의 내용은 헤더 바에 표시되는 제목들의 번역입니다. 이 정의는 BeeWare 메인 웹사이트에서는 *필요하지 않습니다*; *다른* 사이트(예: 튜토리얼이나 프로젝트 문서)에서만 필요합니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "업데이트 `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "`tox.ini` 파일에 여러 가지 변경 사항을 적용해야 합니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "다음 내용을 추가하면 됩니다:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "새로운 언어 코드 환경 플래그는 `[testenv:docs`로 시작하는 헤더 라인에 적용되며, 언어 코드 앞에 `-`가 위치하고 공백은 포함되지 않습니다. 예를 들어 `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "첫 번째 명령어에 대한 새로운 언어 코드 제외 규칙은 `!lint`로 시작하며, 그 앞에 `-!`가 위치하고 공백을 포함하지 않습니다. 예를 들어 `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "`translate : build_po_translations`로 시작하는 줄에 대한 새로운 언어 코드." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "`translate : update_machine_translations`로 시작하는 줄에 대한 새로운 언어 코드" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "예를 들어 독일어의 경우 `de : build_md_translations`로 시작하는 새 명령어가 기존 언어별 명령어 내에서 알파벳 순으로 배치되며, 해당 명령어들의 내용과 일치하고 새 언어 코드를 포함합니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "`all:`로 시작하는 줄에 대한 새로운 언어 코드." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "업데이트 `config.yml`" +msgid "Update `zensical.toml`" +msgstr "업데이트 `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "언어를 `config.yml`에 추가하면 헤더의 언어 선택기에 표시됩니다. `extra:`로 시작하는 섹션을 찾은 후, `alternate:`로 시작하는 하위 섹션을 찾으세요. 독일어의 경우 다음과 같이 추가합니다:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- name: 독일어\n" -" link: /de/\n" -" lang: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "언어명은 해당 언어로 번역되어야 합니다. 링크에는 `/`가 반드시 포함되어야 합니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "`tox translate` 실행" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "이제 `tox -e docs-translate`를 실행할 수 있습니다. 이 명령은 빈 번역 파일을 생성합니다. DeepL 계정이 있다면 해당 계정을 사용하여 초기 기계 번역을 채울 수 있습니다. DeepL 계정이 없어도 괜찮습니다. 풀 리퀘스트를 승인하기 전에 저희가 직접 초기 번역을 실행할 예정입니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "번역 가이드라인" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "팀에 추가되면 [Weblate]{1}에 로그인하여 문자열 번역 작업을 시작할 차례입니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "어조 대 직역" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "영어 원문의 어조를 유지하는 것이 단어별 번역을 고집하는 것보다 더 중요합니다. 저희 콘텐츠는 친근하고 약간 구어체적인 어조를 지향합니다. 번역 시에도 이러한 정신을 유지해 주시기 바랍니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "영어 원문에 강한 영어 관용구가 포함되어 있다면, 해당 관용구를 반드시 유지해야 한다는 부담을 느끼지 마십시오. 여러분의 언어에 동등하게 효과적인 유사 표현이 있다면 사용해도 좋습니다. 영어 원문의 용어나 구문이 특히 관용적이거나 속어인 경우, 변경을 고려해야 한다고 주저 없이 알려주십시오. 영어 원어민에게도 관용구와 속어는 어려움을 줄 수 있습니다. 번역자와 독자 모두에게 더 직관적으로 전달하기 위해 영어 원문을 수정해야 할 때가 있습니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "번역해야 할까요?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "다음 항목들은 *번역하거나 업데이트해서는 안 됩니다*:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**명령어**. 예를 들어, \"You should run \\`briefcase create\\`.\", 에서 \"You should run\"만 번역해야 합니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**네임스페이스**, 예를 들어 클래스, 메서드 또는 속성 이름." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**링크 URL**. 표준 마크다운 링크는 Weblate에서 `[Link text]{1}` 형식으로 표시되어야 하며, 여기서 `1`는 문자열 내 다른 링크와의 상대적 위치를 나타냅니다. 만약 문자열에 `[Link text](https://example.com/)`와 같이 전체 URL이 포함되어 있다면, 해당 URL은 번역 대상에서 제외되어야 합니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**클래스, 메서드 또는 속성 이름이 포함된 참조 링크**. 백틱(`)을 포함한 이 링크들은 그대로 유지해야 합니다. 여기에 표시된 예시 링크의 모든 부분은 번역되지 않습니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][클래스 속성]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**참조 링크의 링크 내용**. 예를 들어, `link-content`는 다음에서 생략됩니다:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[링크 텍스트][링크 내용]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**진자 지시어**. 이는 두 쌍의 일치하는 중괄호로 감싸진 모든 콘텐츠, 또는 양 끝에 퍼센트 기호가 포함된 일치하는 한 쌍의 중괄호를 의미합니다. 참고: 여기에 구문 예시를 포함하면 매크로 플러그인이 이를 렌더링하려고 시도합니다. 예시는 [매크로 문서]{1}을 참조하십시오." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**사용자 정의 앵커**. 헤더 뒤나 특정 콘텐츠 위에 위치하며, `{ #anchor }` 형식으로 표시됩니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**주의 사항 구문**. 다음 예시에서 \"주의 사항\"이라는 단어는 번역하지 않아야 합니다. 이는 메모, 경고 등 모든 유형의 주의 사항에 적용됩니다. 나머지 내용 번역에 관한 정보는 다음 섹션을 참조하십시오." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1919,52 +1886,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**백틱**. 백틱은 그대로 유지되어야 하며, 인라인 코드와 코드 블록 양쪽의 서식을 지정하는 데 사용됩니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**외부 콘텐츠 포함 구문**. 이는 `-8<-`과 같은 줄에 있거나, 별도의 줄에 있는 두 `-8<-` 사이의 줄에 있는 모든 것을 의미합니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "다음 항목들은 *반드시* 번역되어야 합니다:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**링크 텍스트**. 링크 구문에서 텍스트는 URL 앞에 위치하며, `[Link text](URL)`와 같이 대괄호로 묶입니다. 표준 마크다운 링크는 Weblate에서 `[Link text]{1}`로 표시되어야 하며, 여기서 `1`는 문자열 내에서 다른 가능한 링크를 기준으로 한 링크의 위치를 나타냅니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**참조 링크 텍스트**. 예를 들어, `Link text`는 다음과 같이 번역됩니다:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**경고 제목과 내용**. 이전 경고 예시에서 \"페이지 제목\"과 \"내용\"은 번역되어야 합니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "웹레이트" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "저희는 콘텐츠 번역에 [Weblate]{1}을 사용합니다. 새 번역을 추가할 때 [DeepL]{2}의 기계 번역을 활용해 초안을 생성합니다. 즉, 일반적으로 번역하실 콘텐츠는 이미 기계 번역된 상태입니다. 번역가로서 기존 기계 번역을 검토하고 수정하며 개선해 주시길 기대합니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate는 모든 작업을 문자열 단위로 처리합니다. 변경 사항을 일괄 처리하여 몇 시간마다 해당 시간 동안 변경된 모든 문자열을 포함하는 대량 커밋을 제출합니다. 따라서 변경 사항이 웹사이트에 반영되기까지 몇 시간이 소요될 수 있으나, 최대 4시간 이내에 업데이트가 표시될 것으로 예상할 수 있습니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "해당 시간 이후에도 변경 사항이 반영되지 않았다면, 해당 언어의 문서 빌드 실패를 초래한 마크업 오류가 원인일 가능성이 높습니다. 어떤 문자열의 마크업 문제라도 전체 번역 공개를 차단합니다. 해당 언어의 빌드 페이지에서 빌드 성공 여부를 확인할 수 있습니다. 해당 링크는 프랑스어 빌드 페이지 링크와 유사한 형식입니다. {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; 언어 코드를 해당 언어로 변경하면 해당 언어의 빌드 페이지를 볼 수 있습니다. 이 페이지에는 사이트의 최신 빌드 상태가 표시됩니다. 빌드가 실패한 경우 빌드 로그를 확인하여 문제의 원인을 파악할 수 있는지 살펴보세요." @@ -2367,36 +2334,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "문서는 `docs/en` 디렉토리 내 적절한 위치에 생성해야 합니다. 설명을 위해, 파일명 `new_doc.md`로 새 문서를 추가한다고 가정하겠습니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "그런 다음, 새 파일을 포함하도록 `docs/en/SUMMARY.md` 파일을 업데이트해야 합니다. `SUMMARY.md`는 기본적으로 `docs/en` 디렉터리 구조를 반영하도록 구성되어 있지만, 더 중요한 것은 왼쪽 사이드바의 구조를 직접 결정한다는 점입니다. `new_doc.md`를 포함하려는 섹션을 찾았을 때, 와일드카드 경로가 나열되어 있다면 `SUMMARY.md`에서 아무것도 변경할 필요가 없습니다. 예를 들어:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./디렉터리 경로/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "`new_doc.md`를 포함하려는 섹션이 개별 마크다운 링크 목록인 경우, 해당 링크를 명시적으로 추가해야 합니다. 예를 들어:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [내 새 문서](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "문서 작성하기" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "이제 원하는 파일을 편집기로 열어 글을 쓰기 시작할 수 있습니다." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "BeeWare 문서 작성 지침을 설명하는 [문서 스타일 가이드]{1}이 마련되어 있습니다." @@ -3166,8 +3131,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "이 가이드에는 새 콘텐츠 작성 및 기존 콘텐츠 번역과 관련하여 예상되는 스타일, MkDocs 전용 구문, 다양한 필수 도구, 문서 번역에 대한 정보가 포함되어 있습니다." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "이 가이드에는 새 콘텐츠 작성 및 기존 콘텐츠 번역과 관련하여 예상되는 스타일, Zensical 전용 구문, 다양한 필수 도구, 문서 번역에 대한 정보가 포함되어 있습니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3226,8 +3191,8 @@ msgstr "문서에서 가능한 경우 항상 내용을 상호 참조해야 합 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs는 표준 마크다운 형식의 링크를 렌더링합니다. 표준 마크다운 형식의 웹 하이퍼링크는 다음과 같습니다:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical는 표준 마크다운 형식의 링크를 렌더링합니다. 표준 마크다운 형식의 웹 하이퍼링크는 다음과 같습니다:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3246,8 +3211,8 @@ msgstr "[링크 텍스트](path/to/file.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "파일의 특정 섹션이나 API 문서를 참조하려면 MkDocs 참조 링크 형식을 사용해야 합니다." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "파일의 특정 섹션이나 API 문서를 참조하려면 Zensical 참조 링크 형식을 사용해야 합니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3261,13 +3226,13 @@ msgstr "마크다운은 모든 헤더(한 줄에 1개에서 6개 사이의 `#` #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs는 수정된 마크다운 링크를 사용하여 문서 내 다양한 다른 요소로 연결할 수 있는 참조 링크 구문 렌더링을 지원합니다. 여기에는 사용자 정의 마크다운 헤더 및 텍스트 앵커로의 링크 등이 포함됩니다." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical는 수정된 마크다운 링크를 사용하여 문서 내 다양한 다른 요소로 연결할 수 있는 참조 링크 구문 렌더링을 지원합니다. 여기에는 사용자 정의 마크다운 헤더 및 텍스트 앵커로의 링크 등이 포함됩니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "MkDocs 참조 링크는 다음과 같이 형식화된 모든 링크입니다:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Zensical 참조 링크는 다음과 같이 형식화된 모든 링크입니다:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3281,8 +3246,8 @@ msgstr "/// warning | 사용자 정의 헤더 및 콘텐츠 앵커가 필요합 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "BeeWare 문서에서 MkDocs 참조 링크를 통해 텍스트 콘텐츠에서 참조되는 모든 헤더 또는 콘텐츠 섹션에는 반드시 사용자 정의 앵커가 첨부되어야 합니다. 그렇지 않으면 헤더 콘텐츠가 번역될 때 링크가 깨질 가능성이 있습니다." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "BeeWare 문서에서 Zensical 참조 링크를 통해 텍스트 콘텐츠에서 참조되는 모든 헤더 또는 콘텐츠 섹션에는 반드시 사용자 정의 앵커가 첨부되어야 합니다. 그렇지 않으면 헤더 콘텐츠가 번역될 때 링크가 깨질 가능성이 있습니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3341,8 +3306,8 @@ msgstr "[링크 텍스트](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "다른 문서의 앵커에 링크하는 것은 MkDocs 참조 링크 스타일을 사용하며, 다음과 같이 형식화됩니다:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "다른 문서의 앵커에 링크하는 것은 Zensical 참조 링크 스타일을 사용하며, 다음과 같이 형식화됩니다:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3356,8 +3321,8 @@ msgstr "API 참조 링크" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "MkDocs 참조 링크 기능은 문서화된 클래스, 클래스 메서드 또는 속성을 포함한 API 문서와 특정 외부 문서 참조 간의 상호 참조도 지원합니다." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Zensical 참조 링크 기능은 문서화된 클래스, 클래스 메서드 또는 속성을 포함한 API 문서와 특정 외부 문서 참조 간의 상호 참조도 지원합니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3932,8 +3897,8 @@ msgstr "BeeWare 문서 도구에서 공유된 콘텐츠를 매크로를 사용 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "[Macros MkDocs 플러그인]{1}을 사용하여 BeeWare Docs 도구의 공유 콘텐츠 디렉터리에서 콘텐츠를 포함할 수도 있습니다. 이 방법은 문서에 실행이 필요한 Jinja 지시어가 포함된 경우에만 사용해야 하며, 반드시 필요한 경우에만 사용하십시오. URL을 통한 외부 콘텐츠에는 작동하지 않습니다. [Macros 변수 대체 메커니즘]{2}은 이 방법과 호환됩니다." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "[Macros]{1}을 사용하여 BeeWare Docs 도구의 공유 콘텐츠 디렉터리에서 콘텐츠를 포함할 수도 있습니다. 이 방법은 문서에 실행이 필요한 Jinja 지시어가 포함된 경우에만 사용해야 하며, 반드시 필요한 경우에만 사용하십시오. URL을 통한 외부 콘텐츠에는 작동하지 않습니다. [Macros 변수 대체 메커니즘]{2}은 이 방법과 호환됩니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4443,8 +4408,8 @@ msgstr "문서 양식 { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "{{ formal_name }}'s 문서화는 [MkDocs와 Markdown]{1}을 사용하여 작성됩니다. 우리는 문서 구조화를 위해 [Diataxis]{2} 프레임워크를 따르도록 노력합니다." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "{{ formal_name }}'s 문서화는 [Zensical]{1}와 [Markdown]{2}을 사용하여 작성됩니다. 우리는 문서 구조화를 위해 [Diataxis]{3} 프레임워크를 따르도록 노력합니다." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/pl/translations.po b/src/beeware_docs_tools/shared_content/locales/pl/translations.po index 8e3deafe..41f971dc 100644 --- a/src/beeware_docs_tools/shared_content/locales/pl/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/pl/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: 2026-05-24 20:11+0000\n" "Last-Translator: Kat Wiążewska <248054891+kat-wiazewska@users.noreply.github.com>\n" "Language-Team: Polish <https://hosted.weblate.org/projects/beeware/docs-tools-shared-content/pl/>\n" @@ -360,7 +360,7 @@ msgstr "Wszelkie odniesienia do nazw produktów powinny być zapisywane zgodnie msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Jeśli termin jest używany „jako kod”, należy go cytować jako literał (`like this`), a nie dodawać do słownika." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 #, fuzzy msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1628,8 +1628,8 @@ msgstr "Jeśli język, w którym chcesz pomóc, jeszcze nie istnieje, musisz wyk #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Utwórz plik `/docs/mkdocs.language-code.yml`, zawierający treści specyficzne dla danego języka." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "Utwórz plik `/docs/zensical.language-code.toml`, zawierający treści specyficzne dla danego języka." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1638,8 +1638,8 @@ msgstr "Zaktualizuj `tox.ini` w celu uwzględnienia nowych poleceń kompilacji j #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "Zaktualizuj `/docs/config.yml`, aby uwzględnić język pod `extra: alternate:`." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "Zaktualizuj `/docs/zensical.toml`, aby uwzględnić język pod `extra.alternate`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1648,54 +1648,35 @@ msgstr "Poniżej przedstawiono niezbędne zmiany na przykładzie języka niemiec #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "Nowy plik konfiguracyjny MkDocs" +msgid "A new language configuration file" +msgstr "Nowy plik konfiguracyjny Zensical" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "Najpierw utwórz nowy plik o nazwie `mkdocs.de.yml` w katalogu `docs`, zawierający następującą treść:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "Najpierw utwórz nowy plik o nazwie `zensical.de.toml` w katalogu `docs`, zawierający następującą treść:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentacja\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: O nas\n" -" Documentation: Dokumentacja\n" -" Community: Społeczność\n" -" Contributing: Współpraca\n" -" News: Aktualności\n" -" Sponsor: Sponsor" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1703,9 +1684,8 @@ msgid "Here's what is going on in this file:" msgstr "Oto, co dzieje się w tym pliku:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Ten plik dziedziczy zawartość konfiguracji z `config.yml`." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1714,201 +1694,188 @@ msgstr "Wartość `site_name` jest tłumaczona." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "Wartość `site_url` to adres URL witryny projektu, po którym następuje kod języka." +msgid "The `docs_dir` should be the language code." +msgstr "`docs_dir` powinno być kodem języka." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "`docs_dir` powinno być kodem języka." +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "Wartość `theme.language` powinna być kodem języka, zgodnie z [specyfikacją motywu Zensical]{1}. W przypadku większości języków będzie to ten sam kod języka co `docs_dir`, ale w przypadku niektórych (w szczególności języków z wariantami lokalnymi, takimi jak `zh_CN`) występują różnice." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "Wartość `theme: language:` powinna być kodem języka, zgodnie z [specyfikacją motywu MkDocs Material]{1}. W przypadku większości języków będzie to ten sam kod języka co `docs_dir`, ale w przypadku niektórych (w szczególności języków z wariantami lokalnymi, takimi jak `zh_CN`) występują różnice." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "`extra.language_url` powinno być kodem języka, po którym następuje pojedynczy ukośnik, np. `de/` dla języka niemieckiego." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "`extra: language_url:` powinno być kodem języka, po którym następuje pojedynczy ukośnik, np. `de/` dla języka niemieckiego." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "`extra.translation_type` powinno pozostać `machine` do momentu, gdy tłumaczenie osiągnie po raz pierwszy 100%, a wtedy powinno stać się `human`. Powróci do `machine` z `human`, jeśli spadnie poniżej 90%." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "`extra: translation_type:` powinno pozostać `machine` do momentu, gdy tłumaczenie osiągnie po raz pierwszy 100%, a wtedy powinno stać się `human`. Powróci do `machine` z `human`, jeśli spadnie poniżej 90%." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "Treść pod `extra: header` to tłumaczenia tytułów pojawiających się w pasku nagłówkowym. Definicja ta nie jest wymagana na głównej stronie BeeWare; jest wymagana tylko na innych stronach (takich jak samouczek lub dokumentacja projektu)." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "Treść pod `extra.header` to tłumaczenia tytułów pojawiających się w pasku nagłówkowym. Definicja ta nie jest wymagana na głównej stronie BeeWare; jest wymagana tylko na innych stronach (takich jak samouczek lub dokumentacja projektu)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "Aktualizacja `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "Musisz wprowadzić kilka zmian w pliku `tox.ini`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "Dodajesz następujące informacje:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "Nowa flaga środowiska kodu języka w linii nagłówka, która zaczyna się od `[testenv:docs`, z kodem języka poprzedzonym znakiem `-`, bez spacji, np. `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "Nowe wykluczenie kodu języka dla pierwszego polecenia, które zaczyna się od `!lint`, poprzedzone `-!`, bez spacji, np. `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "Nowy kod języka do linii zaczynającej się od `translate : build_po_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "Nowy kod języka dla linii zaczynającej się od `translate : update_machine_translations`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "Nowe polecenie, zaczynające się na przykład od `de : build_md_translations` dla języka niemieckiego, alfabetycznie w ramach istniejących poleceń specyficznych dla danego języka, które pasują do treści tych poleceń, z nowym kodem języka." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "Nowy kod języka do linii zaczynającej się od `all:`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "Aktualizacja `config.yml`" +msgid "Update `zensical.toml`" +msgstr "Aktualizacja `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Dodaj język do `config.yml`, aby pojawił się on w selektorze języka w nagłówku. Znajdź sekcję zaczynającą się od `extra:`, a następnie zlokalizuj podsekcję zaczynającą się od `alternate:`. W przypadku języka niemieckiego należy dodać następujący wpis:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- nazwa: niemiecki\n" -" link: /de/\n" -" język: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "Nazwa języka powinna być przetłumaczona na dany język. Link musi zawierać symbole `/`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "Uruchom `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Teraz możesz uruchomić `tox -e docs-translate`. Spowoduje to wygenerowanie pustego pliku tłumaczenia; jeśli posiadasz konto DeepL, możesz użyć go do wypełnienia wstępnych tłumaczeń maszynowych. Jeśli nie posiadasz konta DeepL, nie ma problemu — sami wykonamy wstępne tłumaczenia przed zaakceptowaniem pull requestu." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "Wytyczne dotyczące tłumaczenia" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "Po dodaniu do zespołu należy zalogować się do [Weblate]{1} i rozpocząć pracę nad tłumaczeniem ciągów znaków." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "Tłumaczenie dosłowne a tłumaczenie oddające sens" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "Ważniejsze jest zachowanie tonu tekstu angielskiego niż dążenie do dosłownego tłumaczenia. Staramy się, aby nasze treści były przyjazne i nieco potoczne; postaraj się zachować ten charakter w swoich tłumaczeniach." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "Jeśli tekst angielski zawiera mocne idiomy, nie czuj się zobowiązany do ich zachowania, jeśli w Twoim języku istnieje analogiczne wyrażenie, które sprawdzi się równie dobrze. Jeśli termin lub fraza w tekście angielskim jest szczególnie idiomatyczna lub slangowa, nie wahaj się poinformować nas, że powinniśmy rozważyć wprowadzenie zmiany. Nawet dla osób posługujących się językiem angielskim idiomy i slang mogą stanowić trudność. Czasami musimy zmienić tekst angielski, aby był bardziej zrozumiały zarówno dla tłumaczy, jak i czytelników." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "Czy powinienem to przetłumaczyć?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "Następujące elementy nie powinny być tłumaczone ani aktualizowane:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Polecenia**. Na przykład w zdaniu „You should run \\`briefcase create\\`” należy przetłumaczyć tylko „You should run”." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Przestrzenie nazw**, takie jak nazwy klas, metod lub atrybutów." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**Adresy URL**. Standardowe linki w formacie Markdown powinny być wyświetlane w Weblate jako `[Link text]{1}`, gdzie `1` oznacza pozycję linku w ciągu tekstowym względem innych ewentualnych linków. Jeśli w ciągu tekstowym znajduje się pełny adres URL, np. `[Link text](https://example.com/)`, adres ten należy pominąć podczas tłumaczenia." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Linki referencyjne zawierające nazwy klas, metod lub atrybutów**. Należy je pozostawić bez zmian, łącznie z znakami backtick. Żadna część przykładowego linku pokazanego tutaj nie zostanie przetłumaczona." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Atrybut klasy]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**Treść linku odsyłającego**. Na przykład `link-content` zostanie pominięte w poniższym przykładzie:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[Tekst linku][treść linku]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Dyrektywy Jinja**. Jest to dowolna treść ujęta w dwie pary dopasowanych nawiasów klamrowych lub dopasowaną parę pojedynczych nawiasów klamrowych z znakami procentowymi na każdym końcu. Uwaga: Umieszczenie tutaj przykładu składni powoduje, że wtyczka Makra próbuje ją renderować; przykłady można znaleźć w [dokumentacji Makr]{1}." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Niestandardowe kotwice**. Znajdują się one po nagłówkach lub nad niektórymi treściami i mają format `{ #anchor }`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Składnia upomnienia**. W poniższym przykładzie słowo „upomnienie” nie powinno być tłumaczone. Dotyczy to wszystkich rodzajów upomnień, w tym uwag, ostrzeżeń itp. Informacje na temat tłumaczenia pozostałej części treści znajdują się w następnej sekcji." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1923,52 +1890,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Backticks**. Powinny pozostać jako backticks; służą do formatowania zarówno kodu wbudowanego, jak i bloków kodu." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**Składnia służąca do włączania treści zewnętrznych**. Jest to wszystko, co znajduje się w tym samym wierszu co `-8<-`, lub w wierszach pomiędzy dwoma `-8<-` w oddzielnych wierszach." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "Następujące elementy *powinny* zostać przetłumaczone:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Tekst linku**. W składni linku tekst znajduje się przed adresem URL i jest ujęty w nawiasy, tak jak w `[Link text](URL)`. Standardowe linki Markdown powinny pojawiać się w Weblate jako `[Link text]{1}`, gdzie `1` jest pozycją linku w ciągu znaków w odniesieniu do innych możliwych linków." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Tekst linku referencyjnego**. Na przykład `Link text` zostanie przetłumaczone w następujący sposób:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Tytuły i treść upomnień**. W poprzednim przykładzie upomnienia należy przetłumaczyć „Tytuł strony” i „Treść”." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "Do tłumaczenia treści używamy [Weblate]{1}. Kiedy dodajemy nowe tłumaczenie, używamy [DeepL]{2} do tłumaczenia maszynowego, aby uzyskać wstępną wersję tłumaczenia. Oznacza to, że zazwyczaj tłumaczona treść jest już przetłumaczona maszynowo. Oczekuje się, że jako tłumacz przejrzysz, edytujesz i poprawisz istniejące tłumaczenie maszynowe." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate przetwarza wszystko na zasadzie ciągów znaków. Gromadzi zmiany i co kilka godzin przesyła zbiorcze zatwierdzenie wszystkich ciągów znaków, które uległy zmianie w tym okresie. Dlatego też może minąć kilka godzin, zanim zmiany pojawią się na stronie internetowej, ale można oczekiwać, że aktualizacja pojawi się w ciągu czterech godzin." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Jeśli po upływie tego czasu zmiany nadal nie zostaną wyświetlone, prawdopodobną przyczyną jest błąd znaczników, powodujący niepowodzenie kompilacji dokumentacji dla tego języka. Każdy problem ze znacznikami w dowolnym ciągu znaków blokuje publiczne udostępnienie całego tłumaczenia. Możesz śledzić stronę kompilacji dla swojego języka, aby sprawdzić, czy kompilacja zakończyła się powodzeniem. Link jest sformatowany podobnie do tego linku do francuskiej strony kompilacji {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; zmień kod języka na swój język, aby wyświetlić odpowiednią stronę kompilacji. Wyświetli to stan najnowszej kompilacji witryny. Jeśli kompilacja nie powiedzie się, sprawdź dziennik kompilacji i spróbuj zidentyfikować źródło problemu." @@ -2372,36 +2339,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "Musisz utworzyć dokument w odpowiedniej lokalizacji w katalogu `docs/en`. Dla celów dyskusji załóżmy, że dodajesz nowy dokument o nazwie `new_doc.md`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "Następnie należy zaktualizować plik `docs/en/SUMMARY.md`, aby uwzględnić nowy plik. Plik `SUMMARY.md` jest zorganizowany w sposób zasadniczo odzwierciedlający strukturę katalogów `docs/en`, ale co ważniejsze, bezpośrednio określa strukturę lewego paska bocznego. Jeśli zlokalizujesz sekcję, w której zamierzasz umieścić `new_doc.md`, nie musisz nic zmieniać w pliku `SUMMARY.md`, jeśli widzisz wymienioną ścieżkę z symbolem wieloznacznym. Na przykład:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./ścieżka/do/katalogu/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "Jeśli sekcja, w której zamierzasz umieścić `new_doc.md`, jest listą poszczególnych linków Markdown, musisz dodać wyraźny link do swojego. Na przykład:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [Mój nowy dokument](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "Pisanie dokumentacji" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "Teraz możesz otworzyć wybrany plik w edytorze i rozpocząć pisanie." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "Posiadamy [przewodnik stylistyczny dotyczący dokumentacji]{1}, który zawiera wytyczne dotyczące pisania dokumentacji dla BeeWare." @@ -3172,8 +3137,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Niniejszy przewodnik zawiera informacje dotyczące oczekiwanego stylu, składni specyficznej dla MkDocs, różnych wymaganych narzędzi oraz tłumaczenia dokumentacji, w odniesieniu do pisania nowych treści i tłumaczenia istniejących treści." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Niniejszy przewodnik zawiera informacje dotyczące oczekiwanego stylu, składni specyficznej dla Zensical, różnych wymaganych narzędzi oraz tłumaczenia dokumentacji, w odniesieniu do pisania nowych treści i tłumaczenia istniejących treści." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3232,8 +3197,8 @@ msgstr "W miarę możliwości należy umieszczać odniesienia do treści w dokum #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs renderuje standardowe linki sformatowane w Markdown. Standardowe hiperłącza internetowe sformatowane w Markdown wyglądają następująco:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical renderuje standardowe linki sformatowane w Markdown. Standardowe hiperłącza internetowe sformatowane w Markdown wyglądają następująco:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3252,8 +3217,8 @@ msgstr "[Tekst linku](ścieżka/do/pliku.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Odwołania do konkretnych sekcji plików lub dokumentacji API wymagają użycia formatu linków referencyjnych MkDocs." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Odwołania do konkretnych sekcji plików lub dokumentacji API wymagają użycia formatu linków referencyjnych Zensical." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3267,13 +3232,13 @@ msgstr "Markdown generuje kotwice dla wszystkich nagłówków (wszystko w jednej #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs obsługuje renderowanie składni linków referencyjnych, która umożliwia tworzenie linków do różnych innych elementów dokumentacji przy użyciu zmodyfikowanego linku Markdown. Obejmuje to między innymi linkowanie do niestandardowych nagłówków Markdown i kotwic tekstowych." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical obsługuje renderowanie składni linków referencyjnych, która umożliwia tworzenie linków do różnych innych elementów dokumentacji przy użyciu zmodyfikowanego linku Markdown. Obejmuje to między innymi linkowanie do niestandardowych nagłówków Markdown i kotwic tekstowych." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "Linki referencyjne MkDocs to wszelkie linki sformatowane w następujący sposób:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Linki referencyjne Zensical to wszelkie linki sformatowane w następujący sposób:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3287,8 +3252,8 @@ msgstr "/// warning | Wymagane są niestandardowe nagłówki i kotwice treści." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "Każdy nagłówek lub sekcja treści, do której odwołuje się treść tekstowa za pomocą linku odniesienia MkDocs w dokumentacji BeeWare, musi mieć dołączoną niestandardową kotwicę. W przeciwnym razie istnieje ryzyko uszkodzenia linków podczas tłumaczenia treści nagłówka." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "Każdy nagłówek lub sekcja treści, do której odwołuje się treść tekstowa za pomocą linku odniesienia Zensical w dokumentacji BeeWare, musi mieć dołączoną niestandardową kotwicę. W przeciwnym razie istnieje ryzyko uszkodzenia linków podczas tłumaczenia treści nagłówka." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3347,8 +3312,8 @@ msgstr "[Tekst linku](#nazwa-ankry)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "Łącze do kotwicy w oddzielnym dokumencie wykorzystuje styl odnośnika MkDocs, który ma następujący format:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "Łącze do kotwicy w oddzielnym dokumencie wykorzystuje styl odnośnika Zensical, który ma następujący format:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3362,8 +3327,8 @@ msgstr "Linki do dokumentacji API" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "Linkowanie referencyjne MkDocs obsługuje również odsyłanie do dokumentacji API, w tym do udokumentowanych klas, metod lub atrybutów klas oraz konkretnych odniesień do dokumentacji zewnętrznej." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Linkowanie referencyjne Zensical obsługuje również odsyłanie do dokumentacji API, w tym do udokumentowanych klas, metod lub atrybutów klas oraz konkretnych odniesień do dokumentacji zewnętrznej." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3938,8 +3903,8 @@ msgstr "Wykorzystanie makr do włączenia treści z BeeWare Docs Tools udostępn #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "Możesz również dołączyć treści z katalogu treści udostępnianych przez narzędzia BeeWare Docs, korzystając z [wtyczki Macros MkDocs]{1}. Metoda ta jest konieczna, jeśli dokument zawiera dyrektywy Jinja, które muszą zostać wykonane, i powinna być stosowana wyłącznie w tej sytuacji. Nie będzie działać w przypadku treści zewnętrznych udostępnianych za pośrednictwem adresu URL. Mechanizm [zastępowania zmiennych Macros]{2} działa w połączeniu z tą metodą." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "Możesz również dołączyć treści z katalogu treści udostępnianych przez narzędzia BeeWare Docs, korzystając z [Macros]{1}. Metoda ta jest konieczna, jeśli dokument zawiera dyrektywy Jinja, które muszą zostać wykonane, i powinna być stosowana wyłącznie w tej sytuacji. Nie będzie działać w przypadku treści zewnętrznych udostępnianych za pośrednictwem adresu URL. Mechanizm [zastępowania zmiennych Macros]{2} działa w połączeniu z tą metodą." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4449,8 +4414,8 @@ msgstr "Formularze dokumentacji { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "Dokumentacja {{ formal_name }}'s została napisana przy użyciu [MkDocs i Markdown]{1}. Staramy się stosować framework [Diataxis]{2} do strukturyzowania dokumentacji." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "Dokumentacja {{ formal_name }}'s została napisana przy użyciu [Zensical]{1} i [Markdown]{2}. Staramy się stosować framework [Diataxis]{3} do strukturyzowania dokumentacji." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/pt/translations.po b/src/beeware_docs_tools/shared_content/locales/pt/translations.po index ef3b95ed..b821ee9d 100644 --- a/src/beeware_docs_tools/shared_content/locales/pt/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/pt/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: 2026-11-02 07:49+0000\n" "Last-Translator: Américo Monteiro <a-monteiro@users.noreply.hosted.weblate.org>\n" "Language-Team: Portuguese <https://hosted.weblate.org/projects/beeware/docs-tools-shared-content/pt/>\n" @@ -302,7 +302,7 @@ msgstr "Qualquer referência a um nome de um produto deve usar a capitalização msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Se um termo estiver a ser usado \"como código\", ele deverá ser citado como literal (`assim`) em vez de ser adicionado ao dicionário." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1375,240 +1375,215 @@ msgid "If the language you plan to help out with doesn't already exist, there ar msgstr "Se o idioma com o qual pretende ajudar ainda não existir, há alguns passos adicionais necessários para poder começar:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Crie o ficheiro `/docs/mkdocs.language-code.yml`, com conteúdo específico do idioma." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "Crie o ficheiro `/docs/zensical.language-code.toml`, com conteúdo específico do idioma." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 msgid "Update `tox.ini` to include the new language build commands." msgstr "Atualize o `tox.ini` para incluir os comandos de compilação da nova linguagem." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "Atualize `/docs/config.yml` para incluir o idioma sob `extra: alternate:`." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "Atualize `/docs/zensical.toml` para incluir o idioma sob `extra.alternate`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 msgid "The following demonstrates the necessary changes using German as an example; a German translation already exists; replace the references to German, `de`, or other content for the language you're targeting." msgstr "O seguinte demonstra as alterações necessárias usando o alemão como exemplo; já existe uma tradução para Alemão; substitua as referências ao Alemão, `de` ou outro conteúdo para o idioma que está a visar." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 -msgid "A new MkDocs configuration file" -msgstr "Um novo ficheiro de configuração do MkDocs" +#, fuzzy +msgid "A new language configuration file" +msgstr "Um novo ficheiro de configuração do Zensical" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "Primeiro, crie um novo ficheiro chamado `mkdocs.de.yml` no diretório `docs`, com o seguinte conteúdo:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "Primeiro, crie um novo ficheiro chamado `zensical.de.toml` no diretório `docs`, com o seguinte conteúdo:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" -"\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" +"\n" +"[project.theme]\n" +"language = \"de\"\n" +"\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" +"\n" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" -"\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 msgid "Here's what is going on in this file:" msgstr "Veja o que está a acontecer nesse ficheiro:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Este ficheiro herda o conteúdo da configuração de `config.yml`." +#, fuzzy +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "Este ficheiro herda o conteúdo da configuração de `zensical.toml`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 msgid "The `site_name` value is translated." msgstr "O valor de `site_name` é traduzido." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "O valor de `site_url` é o URL do sítio do projeto, seguido pelo código do idioma." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 msgid "The `docs_dir` should be the language code." msgstr "O `docs_dir` deve ser o código do idioma." +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "O valor de `theme.language` deve ser o código do idioma, conforme [especificado pelo tema Zensical]{1}. Para a maioria dos idiomas, esse será o mesmo código de idioma do `docs_dir`, mas para alguns (em particular idiomas com variantes de localidade como `pt_BR`), há diferenças." + #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "O valor de `theme: language:` deve ser o código do idioma, conforme [especificado pelo tema MkDocs Material]{1}. Para a maioria dos idiomas, esse será o mesmo código de idioma do `docs_dir`, mas para alguns (em particular idiomas com variantes de localidade como `pt_BR`), há diferenças." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "O `extra.language_url` deve ser o código do idioma, seguido por uma única barra, por exemplo, `pt/` para Português." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "O `extra: language_url:` deve ser o código do idioma, seguido por uma única barra, por exemplo, `pt/` para Português." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "O `extra.translation_type` deve ser `machine` até que a tradução atinja 100% pela primeira vez, momento em que deve ser `human`. Ele será revertido para `machine` de `human` se regressar para menos de 90%." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "O `extra: translation_type:` deve ser `machine` até que a tradução atinja 100% pela primeira vez, momento em que deve ser `human`. Ele será revertido para `machine` de `human` se regressar para menos de 90%." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "O conteúdo sob `extra.header` é a tradução dos títulos que aparecem na barra de cabeçalho. Esta definição *não* é necessária no site principal do BeeWare; ela só é necessária em *outros* sites (como o tutorial ou a documentação do projeto)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "O conteúdo sob `extra: header` é a tradução dos títulos que aparecem na barra de cabeçalho. Esta definição *não* é necessária no site principal do BeeWare; ela só é necessária em *outros* sites (como o tutorial ou a documentação do projeto)." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 msgid "Update `tox.ini`" msgstr "Atualizar o `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 msgid "You'll need to make several changes to the `tox.ini` file." msgstr "Vai precisar de fazer várias alterações no ficheiro `tox.ini`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 msgid "You would add the following:" msgstr "Deveria acrescentar o seguinte:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "A nova bandeira de ambiente de código de idioma para a linha de cabeçalho que começa `[testenv:docs`, com o código de idioma precedido por um `-`, sem espaços incluídos, por exemplo, `-pt`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "A exclusão do novo código de idioma para o primeiro comando, que começa com `!lint`, precedido por `-!`, sem espaços, por exemplo, `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "O novo código de idioma para a linha que começa com `translate : build_po_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "O novo código de idioma para a linha que começa com `translate : update_machine_translations`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "Um novo comando, começando com, por exemplo, `de : build_md_translations` para Alemão, em ordem alfabética dentro dos comandos específicos do idioma existente que correspondem ao conteúdo desses comandos, com o novo código de idioma." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 msgid "The new language code to the line beginning with `all:`." msgstr "O novo código de idioma para a linha que começa com `all:`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 -msgid "Update `config.yml`" -msgstr "Atualizar `config.yml`" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 +msgid "Update `zensical.toml`" +msgstr "Atualizar `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Adicione o idioma a `config.yml` para que ele apareça no seletor de idioma no cabeçalho. Localize a secção que começa com `extra:`, e depois localize a subsecção que começa com `alternate:`. Para Português, adicionaria o seguinte:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +#, fuzzy +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "Adicione o idioma a `zensical.toml` para que ele apareça no seletor de idioma no cabeçalho. Localize a secção que começa com `[project.extra]`, e depois localize a subsecção que começa com `alternate`. Para Português, adicionaria o seguinte:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- name: Português\n" -" link: /pt/\n" -" lang: pt" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "O nome do idioma deve ser traduzido para o idioma. O link deve incluir as barras `/`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 msgid "Run `tox translate`" msgstr "Executar `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Agora pode executar `tox -e docs-translate`. Isto irá gerar um ficheiro de tradução vazio; se tiver uma conta DeepL, poderá usa-la para preencher as traduções automáticas iniciais. Se não tiver uma conta DeepL, não se preocupe — nós mesmos faremos as traduções iniciais antes de aceitar o pedido de puxar." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 msgid "Translation guidelines" msgstr "Diretrizes de tradução" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "Depois de ter sido adicionado à equipa, é hora de iniciar sessão no [Weblate]{1} e começar a trabalhar na tradução das mensagens." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 msgid "Tone versus word-for-word translation" msgstr "Contexto contra tradução palavra-por-palavra" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "É mais importante manter o tom do texto em Inglês do que se esforçar para fazer uma tradução palavra por palavra. Tentamos ser amigáveis e um pouco coloquiais no nosso conteúdo; tente manter o espírito disso nas suas traduções." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "Se o texto em inglês conter uma expressão idiomática forte em Inglês, não se sinta obrigado a manter essa expressão se houver um análogo no seu idioma que funcione igualmente bem. Se o termo ou a frase no texto em Inglês for um termo particularmente idiomático ou uma gíria, não tenha medo de nos dizer que devemos considerar fazer uma alteração. Mesmo para os faladores de Inglês, expressões idiomáticas e gírias podem causar dificuldades. Às vezes, precisamos alterar o texto em Inglês para torna-lo mais direto para tradutores e leitores." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 msgid "Should I translate it?" msgstr "Devo traduzir isto?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 msgid "The following items should *not* be translated or updated:" msgstr "Os seguintes items *não* devem ser traduzidos nem atualizados:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Comandos**. Por exemplo, em \"You should run \\`briefcase create\\`.\", apenas a parte \"You should run\" deve ser traduzida." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Espaços de nomes**, tais como nomes de classes, métodos ou atributos." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**URLs de atalhos**. Os atalhos Standard do Markdown devem aparecer no Weblate como `[Link text]{1}`, em que `1` representa a posição do atalho na sequência de texto em relação a outros atalhos possíveis. Se o URL completo estiver incluído na sequência de texto, como `[Link text](https://example.com/)`, esse URL deve ser ignorado na tradução." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Ligações de referência que contêm nomes de classes, métodos ou atributos**. Devem ser deixados como estão, inclusive as aspas. Todas as partes do atalho de exemplo mostrado aqui não seriam traduzidas." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Class.attribute]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**O conteúdo do atalho de um atalho de Referência**. Por exemplo, `link-content` seria ignorado no seguinte:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 msgid "[Link text][link-content]" msgstr "[Texto do atalho][link-content]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Diretivas Jinja**. Trata-se de qualquer conteúdo envolvido em dois pares de chavetas correspondentes ou num par correspondente de chavetas simples com sinais de percentagem em cada extremidade. Nota: O incluir de um exemplo da sintaxe aqui faz com que o plug-in Macros tente renderiza-la; veja a [documentação do Macros]{1} para obter exemplos." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Âncoras personalizadas**. Elas são encontradas após os cabeçalhos ou acima de algum conteúdo e são formatadas como `{ #anchor }`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Sintaxe de advertência**. No exemplo a seguir, a palavra \"admonition\" não deve ser traduzida. Isso vale para todos os estilos de advertências, incluindo notas, avisos etc. Consulte a próxima secção para obter informações sobre como traduzir o restante do conteúdo." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 msgid "" "/// admonition | Page Title\n" "\n" @@ -1622,43 +1597,43 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Aspas invertidas**. Elas devem permanecer como aspas invertidas; são usadas para formatar código em linha e blocos de código." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**A sintaxe para incluir conteúdo externo**. Trata-se de qualquer coisa na mesma linha que `-8<-`, ou nas linhas entre dois `-8<-` em linhas separadas." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 msgid "The following items *should* be translated:" msgstr "Os seguintes items *devem* ser traduzidos:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Texto do atalho**. Na sintaxe de atalho, o texto vem antes da URL e é colocado entre colchetes, como em `[Link text](URL)`. Os atalhos Standard de Markdown devem aparecer no Weblate como `[Link text]{1}`, em que `1` é a posição do link na string com referência a outros links possíveis." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Texto do atalho de referência**. Por exemplo, `Link text` seria traduzido da seguinte forma:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Títulos e conteúdo da advertência**. No exemplo da advertência anterior, \"Page Title\" (Título da página) e \"Content\" (Conteúdo) devem ser traduzidos." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "Usamos [Weblate]{1} para a tradução de nosso conteúdo. Quando adicionamos uma nova tradução, usamos [DeepL]{2} para a tradução automática, a fim de produzir uma primeira passagem nas traduções. Isso significa que, normalmente, o conteúdo que vai traduzir já está traduzido por máquina. A expectativa é que, como tradutor, reveja, edite e melhore a tradução automática existente." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "O Weblate processa tudo numa base de palavra por palavra. Ele agrupa as alterações e, a cada duas horas, submete um bolo com todas as sequências que foram alteradas nesse intervalo. Assim, pode levar algumas horas para que as suas alterações apareçam no sítio web, mas pode esperar que a atualização apareça dentro de quatro horas." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Se, após esse tempo, suas alterações ainda não tiverem aparecido, a causa provável é um erro de marcação, resultando numa falha na compilação dos documentos para esse idioma. Qualquer problema de marcação em qualquer sequência vai impedir que toda a tradução seja publicada. Pode ficar atento à página de compilação do seu idioma para ver se ela foi compilada com sucesso. O atalho tem um formato semelhante a este atalho para a página de compilação em francês {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; Altere o código do idioma para o seu idioma para ver a página de compilação apropriada. Isto vai mostrar o estado da compilação mais recente do sítio. Se a compilação falhar, consulte o relatório de compilação e veja se consegue identificar a origem do problema." @@ -1999,30 +1974,32 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "Vai precisar criar o documento no local apropriado dentro do diretório `docs/en`. Para fins de discussão, digamos que esteja a adicionar um novo documento com o nome de ficheiro `new_doc.md`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "Depois, vai precisar atualizar o ficheiro `docs/en/SUMMARY.md` para incluir o novo ficheiro. O `SUMMARY.md` é organizado para refletir basicamente a estrutura do diretório `docs/en`, mas, o que é mais importante, determina diretamente a estrutura da barra lateral esquerda. Se localizar a secção onde pretende incluir o `new_doc.md`, não vai precisar alterar nada no `SUMMARY.md` caso veja um caminho com wildcard listado. Por exemplo:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -msgid "- ./path/to/directory/*" -msgstr "- ./caminho/para/diretório/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "Se a secção em que pretende incluir `new_doc.md` for uma lista de atalhos Markdown individuais, será necessário adicionar um atalho explícito para o seu. Por exemplo:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -msgid "- [My new document](new_doc.md)" -msgstr "- [Meu novo documento](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 msgid "Writing your documentation" msgstr "Escrever a sua documentação" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 msgid "You can now open the desired file into your editor, and begin writing." msgstr "Agora pode abrir o ficheiro desejado no seu editor, e começar a escrever." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "Temos um [guia de estilo de documentação]{1} que descreve as nossas diretrizes para escrever documentação para o BeeWare." @@ -2651,8 +2628,8 @@ msgstr "" " \"\"\"Uma string de documentação de teste tem este formato (#123456).\"\"\"" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Este guia inclui informações sobre o estilo esperado, a sintaxe específica do MkDocs, as várias ferramentas necessárias e a tradução da documentação, com relação à redação de novos conteúdos e à tradução de conteúdos existentes." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Este guia inclui informações sobre o estilo esperado, a sintaxe específica do Zensical, as várias ferramentas necessárias e a tradução da documentação, com relação à redação de novos conteúdos e à tradução de conteúdos existentes." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 msgid "General style" @@ -2699,8 +2676,8 @@ msgid "You should cross-reference content in documentation whenever possible. Th msgstr "Deve fazer referência cruzada ao conteúdo da documentação sempre que possível. Esta secção aborda as várias maneiras de fazer isso, cada uma delas baseada no tipo de informação que está a ser referenciada." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "O MkDocs renderiza atalhos formatados em norma Markdown. Os hiperlinks Web com formatação Markdown standard são os seguintes:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "O Zensical renderiza atalhos formatados em norma Markdown. Os hiperlinks Web com formatação Markdown standard são os seguintes:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 msgid "[Link text](https://example.com/)" @@ -2715,8 +2692,8 @@ msgid "[Link text](path/to/file.md)" msgstr "[Texto do link](caminho/para/ficheiro.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Para fazer referência a secções específicas de ficheiros ou à documentação da API, é necessário usar o formato de atalho de referência do MkDocs." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Para fazer referência a secções específicas de ficheiros ou à documentação da API, é necessário usar o formato de atalho de referência do Zensical." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 msgid "Custom Markdown anchors and content cross-referencing" @@ -2727,12 +2704,12 @@ msgid "Markdown generates anchors for all headers (anything on a single line sta msgstr "O Markdown gera âncoras para todos os cabeçalhos (qualquer coisa em uma única linha que comece com um a seis símbolos `#`), com base no conteúdo do cabeçalho. Por exemplo, a âncora gerada para esta secção é `custom-markdown-anchors-and-content-cross---referencing`. No entanto, devido à maneira como as nossas traduções funcionam, sempre que um cabeçalho de secção for referenciado, ele deve ter uma âncora personalizada." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "O MkDocs suporta a renderização de sintaxe de link de referência que permite que crie links para vários outros elementos na documentação usando um link Markdown modificado. Isso inclui links para, entre outras coisas, cabeçalhos Markdown personalizados e âncoras de texto." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "O Zensical suporta a renderização de sintaxe de link de referência que permite que crie links para vários outros elementos na documentação usando um link Markdown modificado. Isso inclui links para, entre outras coisas, cabeçalhos Markdown personalizados e âncoras de texto." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "Os links de referência do MkDocs são quaisquer links formatados da seguinte forma:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Os links de referência do Zensical são quaisquer links formatados da seguinte forma:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 msgid "[Link text][link-target]" @@ -2743,8 +2720,8 @@ msgid "/// warning | Custom header and content anchors are required" msgstr "/// warning | São obrigatórias âncoras personalizadas de cabeçalho e conteúdo" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "Qualquer cabeçalho ou secção de conteúdo que seja referenciada no conteúdo de texto por meio de um link de referência MkDocs na documentação do BeeWare _tem de_ ter uma âncora personalizada anexada. Caso contrário, há a possibilidade de quebrar os links quando o conteúdo do cabeçalho for traduzido." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "Qualquer cabeçalho ou secção de conteúdo que seja referenciada no conteúdo de texto por meio de um link de referência Zensical na documentação do BeeWare _tem de_ ter uma âncora personalizada anexada. Caso contrário, há a possibilidade de quebrar os links quando o conteúdo do cabeçalho for traduzido." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 msgid "If you need to link to a header anchor, you will need to generate a custom anchor for the intended content. The general syntax for setting a custom anchor is as follows:" @@ -2793,8 +2770,8 @@ msgid "[Link text](#anchor-name)" msgstr "[Texto do link](#nome-de-âncora)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "O link para uma âncora num documento separado usa o estilo de link de referência do MkDocs, que é formatado da seguinte forma:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "O link para uma âncora num documento separado usa o estilo de link de referência do Zensical, que é formatado da seguinte forma:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 msgid "[Link text][anchor-name]" @@ -2805,8 +2782,8 @@ msgid "API reference links" msgstr "Links de referência da API" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "A vinculação de referência do MkDocs também oferece suporte à referência cruzada da documentação da API, incluindo classes documentadas, métodos ou atributos de classe e referências específicas de documentação externa." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "A vinculação de referência do Zensical também oferece suporte à referência cruzada da documentação da API, incluindo classes documentadas, métodos ou atributos de classe e referências específicas de documentação externa." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 msgid "There are multiple options for linking to a documented class, or a class method or attribute, regardless of whether you are linking from the same file or a separate file. When linking to classes, etc., you must include backticks in the first set of square brackets to render the name as inline code. The backticks are not necessary only if you are using custom text that should not be rendered as inline code. Backticks should never be included in the second set of square brackets." @@ -3309,8 +3286,9 @@ msgid "Using Macros to include content from BeeWare Docs Tools shared content" msgstr "Usar de macros para incluir conteúdo partilhado do BeeWare Docs Tools" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "Também pode incluir conteúdo do diretório de conteúdo partilhado das ferramentas do BeeWare Docs usando o [plugin Macros MkDocs]{1}. Este método é necessário se o documento conter diretivas Jinja que precisem ser executadas e só deve ser usado nessa situação. Ele não vai funcionar com conteúdo externo por meio de um URL. O mecanismo [Macros variable-replacement mechanism]{2} funciona com este método." +#, fuzzy +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "Também pode incluir conteúdo do diretório de conteúdo partilhado das ferramentas do BeeWare Docs usando o [Macros]{1}. Este método é necessário se o documento conter diretivas Jinja que precisem ser executadas e só deve ser usado nessa situação. Ele não vai funcionar com conteúdo externo por meio de um URL. O mecanismo [Macros variable-replacement mechanism]{2} funciona com este método." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 msgid "There are options for including content using Macros:" @@ -3729,8 +3707,8 @@ msgid "Documentation forms { #docs-form }" msgstr "Formulários de documentação { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "A documentação de {{ formal_name }} é escrita usando [MkDocs e Markdown]{1}. O nosso objetivo é seguir a estrutura [Diataxis]{2} para estruturar a documentação." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "A documentação de {{ formal_name }} é escrita usando [Zensical]{1} e [Markdown]{2}. O nosso objetivo é seguir a estrutura [Diataxis]{3} para estruturar a documentação." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 msgid "The Diataxis framework describes four \"forms\" of documentation:" diff --git a/src/beeware_docs_tools/shared_content/locales/ru/translations.po b/src/beeware_docs_tools/shared_content/locales/ru/translations.po index 0f28c5e5..81687e31 100644 --- a/src/beeware_docs_tools/shared_content/locales/ru/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/ru/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: 2026-04-14 20:09+0000\n" "Last-Translator: Nizyaev Ilya <nizaevila@gmail.com>\n" "Language-Team: Russian <https://hosted.weblate.org/projects/beeware/docs-tools-shared-content/ru/>\n" @@ -364,7 +364,7 @@ msgstr "При упоминании названия продукта следу msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Если термин используется «в качестве кода», то его следует указывать в кавычках (`like this`) вместо добавления в словарь." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 #, fuzzy msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1632,8 +1632,8 @@ msgstr "Если язык, с которым вы планируете рабо #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Создайте файл `/docs/mkdocs.language-code.yml`, с содержанием, специфичным для языка." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "Создайте файл `/docs/zensical.language-code.toml`, с содержанием, специфичным для языка." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1642,8 +1642,8 @@ msgstr "Обновите `tox.ini` , чтобы включить новые ко #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "Обновите `/docs/config.yml` , чтобы включить язык под `extra: alternate:`." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "Обновите `/docs/zensical.toml` , чтобы включить язык под `extra.alternate`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1652,54 +1652,35 @@ msgstr "Ниже приведены необходимые изменения н #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "Новый файл конфигурации MkDocs" +msgid "A new language configuration file" +msgstr "Новый файл конфигурации Zensical" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "Сначала создайте новый файл с именем `mkdocs.de.yml` в каталоге `docs` со следующим содержанием:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "Сначала создайте новый файл с именем `zensical.de.toml` в каталоге `docs` со следующим содержанием:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Документация\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: О нас\n" -" Documentation: Документация\n" -" Community: Сообщество\n" -" Contributing: Участие\n" -" News: Новости\n" -" Sponsor: Спонсоры" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1707,9 +1688,8 @@ msgid "Here's what is going on in this file:" msgstr "Вот что происходит в этом файле:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Этот файл наследует содержимое конфигурации из `config.yml`." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1718,201 +1698,188 @@ msgstr "Значение `site_name` переводится." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "Значение `site_url` — это URL-адрес сайта проекта, за которым следует код языка." +msgid "The `docs_dir` should be the language code." +msgstr "`docs_dir` должен быть кодом языка." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "`docs_dir` должен быть кодом языка." +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "Значение `theme.language` должно быть кодом языка, как [указано в теме Zensical]{1}. Для большинства языков это будет то же самое, что и код языка `docs_dir`, но для некоторых (в частности, для языков с локальными вариантами, такими как `zh_CN`), есть различия." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "Значение `theme: language:` должно быть кодом языка, как [указано в теме MkDocs Material]{1}. Для большинства языков это будет то же самое, что и код языка `docs_dir`, но для некоторых (в частности, для языков с локальными вариантами, такими как `zh_CN`), есть различия." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "`extra.language_url` должен быть кодом языка, за которым следует один косой слеш, например, `de/` для немецкого языка." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "`extra: language_url:` должен быть кодом языка, за которым следует один косой слеш, например, `de/` для немецкого языка." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "`extra.translation_type` должно быть `machine` до тех пор, пока перевод не достигнет 100% в первый раз, после чего оно должно стать `human`. Оно вернется к `machine` из `human`, если регрессирует ниже 90%." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "`extra: translation_type:` должно быть `machine` до тех пор, пока перевод не достигнет 100% в первый раз, после чего оно должно стать `human`. Оно вернется к `machine` из `human`, если регрессирует ниже 90%." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "Содержимое под `extra: header` представляет собой переводы названий, которые появляются в верхней панели. Это определение *не* требуется на главном веб-сайте BeeWare; оно требуется только на *других* сайтах (таких как учебник или документация по проекту)." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "Содержимое под `extra.header` представляет собой переводы названий, которые появляются в верхней панели. Это определение *не* требуется на главном веб-сайте BeeWare; оно требуется только на *других* сайтах (таких как учебник или документация по проекту)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "Обновление `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "Вам нужно будет внести несколько изменений в файл `tox.ini`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "Вы бы добавили следующее:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "Новый флаг языкового кода в строке заголовка, которая начинается с `[testenv:docs`, с кодом языка, предваряемым символом `-`, без пробелов, например `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "Новое исключение языкового кода для первой команды, которая начинается с `!lint`, предшествующей `-!`, без пробелов, например `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "Новый языковой код в строке, начинающейся с `translate : build_po_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "Новый языковой код для строки, начинающейся с `translate : update_machine_translations`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "Новая команда, начинающаяся, например, с `de : build_md_translations` для немецкого языка, в алфавитном порядке в пределах существующих языковых команд, которые соответствуют содержанию этих команд, с новым кодом языка." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "Новый языковой код в строке, начинающейся с `all:`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "Обновление `config.yml`" +msgid "Update `zensical.toml`" +msgstr "Обновление `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Добавьте язык в `config.yml`, чтобы он отображался в выпадающем списке языков в заголовке. Найдите раздел, начинающийся с `extra:`, а затем найдите подраздел, начинающийся с `alternate:`. Для немецкого языка необходимо добавить следующее:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- name: Немецкий\n" -" link: /de/\n" -" lang: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "Название языка должно быть переведено на этот язык. Ссылка должна содержать символы `/`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "Запустить `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Теперь вы можете запустить `tox -e docs-translate`. Это сгенерирует пустой файл перевода; если у вас есть учетная запись DeepL, вы можете использовать ее для заполнения первоначальных машинных переводов. Если у вас нет учетной записи DeepL, не беспокойтесь — мы сами выполним первоначальные переводы, прежде чем принять запрос на вытягивание." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "Руководство по переводу" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "После того, как вы были добавлены в команду, пора войти в [Weblate]{1} и приступить к переводу строк." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "Тон против дословного перевода" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "Важнее сохранить тон английского текста, чем стремиться к дословному переводу. Мы стараемся быть дружелюбным и немного разговорчивым в наших текстах; постарайтесь сохранить этот дух в своих переводах." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "Если английский текст содержит сильную английскую идиому, не считайте себя обязанным сохранять эту идиому, если в вашем языке есть аналог, который будет работать так же хорошо. Если термин или фраза в английском тексте является особенно идиоматическим или сленговым термином, не бойтесь сказать нам, что мы должны рассмотреть возможность внесения изменений. Даже для англоговорящих идиомы и сленг могут представлять трудность. Иногда нам приходится изменять английский текст, чтобы он был более понятным как для переводчиков, так и для читателей." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "Мне перевести это?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "Следующие элементы *не* должны переводиться или обновляться:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Команды**. Например, в предложении «Вы должны запустить \\`briefcase create\\`.» следует переводить только «Вы должны запустить»." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Пространства имен**, такие как имена классов, методов или атрибутов." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**URL-адреса ссылок**. Стандартные ссылки в формате Markdown должны отображаться в Weblate в виде `[Link text]{1}`, где `1` обозначает положение ссылки в строке относительно других возможных ссылок. Если в строке указан полный URL-адрес, например `[Link text](https://example.com/)`, этот URL-адрес следует пропустить при переводе." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Ссылки, содержащие имена классов, методов или атрибутов**. Их следует оставить без изменений, включая обратные кавычки. Ни одна часть приведенного здесь примера ссылки не будет переведена." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Class.attribute]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**Содержание ссылки Reference**. Например, `link-content` будет пропущено в следующем случае:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[Текст ссылки][содержимое ссылки]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Директивы Jinja**. Это любой контент, заключенный в две пары одинаковых фигурных скобок или в пару одинаковых фигурных скобок с процентными знаками на каждом конце. Примечание: включение примера синтаксиса в данном месте приводит к тому, что плагин Macros пытается его отобразить; примеры см. в [документации по макросам]{1}." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Пользовательские анкоры**. Они находятся после заголовков или над некоторым контентом и имеют формат `{ #anchor }`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Синтаксис предупреждений**. В следующем примере слово «admonition» не следует переводить. Это относится ко всем типам предупреждений, включая заметки, предупреждения и т. д. Информацию о переводе остальной части текста см. в следующем разделе." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1927,52 +1894,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Обратные кавычки**. Они должны оставаться обратными кавычками; они используются для форматирования как встроенного кода, так и блоков кода." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**Синтаксис для включения внешнего контента**. Это все, что находится в одной строке с `-8<-` или в строках между двумя `-8<-` в отдельных строках." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "Следующие элементы *должны* быть переведены:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Текст ссылки**. В синтаксисе ссылки текст предшествует URL-адресу и заключается в скобки, как в `[Link text](URL)`. Стандартные ссылки Markdown должны отображаться в Weblate как `[Link text]{1}`, где `1` — это положение ссылки в строке по отношению к другим возможным ссылкам." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Текст ссылки**. Например, `Link text` будет переведено следующим образом:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Названия и содержание предупреждений**. В предыдущем примере предупреждения необходимо перевести «Название страницы» и «Содержание»." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "Для перевода контента мы используем [Weblate]{1}. При добавлении нового перевода мы используем [DeepL]{2} для машинного перевода, чтобы получить первую версию перевода. Это означает, что, как правило, контент, который вы будете переводить, уже переведен машиной. Ожидается, что вы, как переводчик, будете проверять, редактировать и улучшать существующий машинный перевод." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate обрабатывает все построчно. Он группирует изменения и каждые несколько часов отправляет массовую фиксацию со всеми строками, которые были изменены за этот промежуток времени. Таким образом, может пройти несколько часов, прежде чем ваши изменения появятся на веб-сайте, но вы можете ожидать, что обновление появится в течение четырех часов." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Если после этого времени ваши изменения все еще не отображаются, вероятной причиной является ошибка разметки, приводящая к сбою в сборке документации для данного языка. Любая проблема с разметкой в любой строке блокирует публикацию всего перевода. Вы можете следить за страницей сборки для вашего языка, чтобы увидеть, успешно ли она собрана. Ссылка имеет формат, аналогичный этой ссылке на страницу сборки для французского языка {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; измените код языка на ваш язык, чтобы просмотреть соответствующую страницу сборки. Это покажет состояние самой последней сборки сайта. Если сборка не удалась, посмотрите журнал сборки и попробуйте определить источник проблемы." @@ -2376,36 +2343,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "Вам нужно будет создать документ в соответствующем месте в каталоге `docs/en`. Для удобства обсуждения предположим, что вы добавляете новый документ с именем файла `new_doc.md`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "Затем вам нужно будет обновить файл `docs/en/SUMMARY.md`, чтобы включить в него новый файл. `SUMMARY.md` организован таким образом, чтобы в основном отражать структуру каталога `docs/en`, но, что более важно, он напрямую определяет структуру левой боковой панели. Если вы найдете раздел, в который хотите включить `new_doc.md`, вам не нужно ничего менять в `SUMMARY.md`, если вы видите перечень путей с подстановочными знаками. Например:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./путь/к/каталогу/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "Если раздел, в который вы собираетесь включить `new_doc.md`, представляет собой список отдельных ссылок Markdown, вам необходимо добавить явную ссылку на свою. Например:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [Мой новый документ](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "Написание документации" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "Теперь вы можете открыть нужный файл в редакторе и приступить к написанию." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "У нас есть [руководство по стилю документации]{1}, в котором изложены наши рекомендации по написанию документации для BeeWare." @@ -3176,8 +3141,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Это руководство содержит информацию об ожидаемом стиле, синтаксисе MkDocs, различных необходимых инструментах и переводе документации, касающейся написания нового контента и перевода существующего контента." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Это руководство содержит информацию об ожидаемом стиле, синтаксисе Zensical, различных необходимых инструментах и переводе документации, касающейся написания нового контента и перевода существующего контента." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3236,8 +3201,8 @@ msgstr "По возможности следует делать перекрес #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs отображает стандартные ссылки в формате Markdown. Стандартные веб-гиперссылки в формате Markdown выглядят следующим образом:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical отображает стандартные ссылки в формате Markdown. Стандартные веб-гиперссылки в формате Markdown выглядят следующим образом:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3256,8 +3221,8 @@ msgstr "[Текст ссылки](path/to/file.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Для ссылки на конкретные разделы файлов или документацию API необходимо использовать формат ссылки MkDocs." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Для ссылки на конкретные разделы файлов или документацию API необходимо использовать формат ссылки Zensical." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3271,13 +3236,13 @@ msgstr "Markdown генерирует анкоры для всех заголо #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs поддерживает рендеринг синтаксиса ссылочных ссылок, который позволяет вам создавать ссылки на различные другие элементы в документации с помощью модифицированной ссылки Markdown. Это включает в себя, среди прочего, ссылки на пользовательские заголовки Markdown и текстовые анкоры." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical поддерживает рендеринг синтаксиса ссылочных ссылок, который позволяет вам создавать ссылки на различные другие элементы в документации с помощью модифицированной ссылки Markdown. Это включает в себя, среди прочего, ссылки на пользовательские заголовки Markdown и текстовые анкоры." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "Ссылки MkDocs — это любые ссылки, оформленные следующим образом:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Ссылки Zensical — это любые ссылки, оформленные следующим образом:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3291,8 +3256,8 @@ msgstr "/// warning | Требуются пользовательские заг #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "Любой заголовок или раздел содержания, на который есть ссылка в текстовом содержании через ссылку MkDocs в документации BeeWare, _должен_ иметь прикрепленную пользовательскую анкорную ссылку. В противном случае существует вероятность, что ссылки будут нарушены при переводе содержания заголовка." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "Любой заголовок или раздел содержания, на который есть ссылка в текстовом содержании через ссылку Zensical в документации BeeWare, _должен_ иметь прикрепленную пользовательскую анкорную ссылку. В противном случае существует вероятность, что ссылки будут нарушены при переводе содержания заголовка." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3351,8 +3316,8 @@ msgstr "[Текст ссылки](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "Ссылка на анкор в отдельном документе использует стиль ссылки MkDocs, который форматируется следующим образом:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "Ссылка на анкор в отдельном документе использует стиль ссылки Zensical, который форматируется следующим образом:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3366,8 +3331,8 @@ msgstr "Ссылки на справочник API" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "Ссылка MkDocs также поддерживает перекрестные ссылки на документацию API, включая документированные классы, методы или атрибуты классов, а также конкретные ссылки на внешнюю документацию." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Ссылка Zensical также поддерживает перекрестные ссылки на документацию API, включая документированные классы, методы или атрибуты классов, а также конкретные ссылки на внешнюю документацию." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3942,8 +3907,8 @@ msgstr "Использование макросов для включения к #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "Вы также можете включить контент из общего каталога инструментов BeeWare Docs с помощью [плагина Macros MkDocs]{1}. Этот метод необходим, если документ содержит директивы Jinja, которые необходимо выполнить, и должен использоваться только в этой ситуации. Он не будет работать с внешним контентом через URL. [Механизм замены переменных Macros]{2} работает с этим методом." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "Вы также можете включить контент из общего каталога инструментов BeeWare Docs с помощью [Macros]{1}. Этот метод необходим, если документ содержит директивы Jinja, которые необходимо выполнить, и должен использоваться только в этой ситуации. Он не будет работать с внешним контентом через URL. [Механизм замены переменных Macros]{2} работает с этим методом." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4453,8 +4418,8 @@ msgstr "Формы документации { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "Документация {{ formal_name }} написана с использованием [MkDocs и Markdown]{1}. Мы стремимся следовать структуре [Diataxis]{2} при составлении документации." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "Документация {{ formal_name }} написана с использованием [Zensical]{1} и [Markdown]{2}. Мы стремимся следовать структуре [Diataxis]{3} при составлении документации." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/ta/translations.po b/src/beeware_docs_tools/shared_content/locales/ta/translations.po index b0d35966..6b5782d6 100644 --- a/src/beeware_docs_tools/shared_content/locales/ta/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/ta/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -363,7 +363,7 @@ msgstr "ஒரு தயாரிப்புப் பெயரைக் கு msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "ஒரு சொல் \"குறியீடாக\" பயன்படுத்தப்பட்டால், அதை அகராதியில் சேர்ப்பதற்குப் பதிலாக, ஒரு நேரியல் (`like this`) ஆக மேற்கோள் காட்ட வேண்டும்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 #, fuzzy msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1631,8 +1631,8 @@ msgstr "நீங்கள் உதவத் திட்டமிடும் #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "மொழி-குறிப்பிட்ட உள்ளடக்கத்துடன் `/docs/mkdocs.language-code.yml` கோப்பை உருவாக்கவும்." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "மொழி-குறிப்பிட்ட உள்ளடக்கத்துடன் `/docs/zensical.language-code.toml` கோப்பை உருவாக்கவும்." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1641,8 +1641,8 @@ msgstr "புதிய மொழி பில்ட் கட்டளைகள #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "`/docs/config.yml` என்பதன் கீழ் மொழியைச் சேர்க்க `extra: alternate:` ஐப் புதுப்பிக்கவும்." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "`/docs/zensical.toml` என்பதன் கீழ் மொழியைச் சேர்க்க `extra.alternate` ஐப் புதுப்பிக்கவும்." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1651,54 +1651,35 @@ msgstr "பின்வருவது, ஜெர்மன் மொழியை #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "ஒரு புதிய MkDocs உள்ளமைவுக் கோப்பு" +msgid "A new language configuration file" +msgstr "ஒரு புதிய Zensical உள்ளமைவுக் கோப்பு" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "முதலில், `mkdocs.de.yml` கோப்பகத்தில் `docs` எனப் பெயரிடப்பட்ட ஒரு புதிய கோப்பை உருவாக்கவும், பின்வரும் உள்ளடக்கத்துடன்:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "முதலில், `zensical.de.toml` கோப்பகத்தில் `docs` எனப் பெயரிடப்பட்ட ஒரு புதிய கோப்பை உருவாக்கவும், பின்வரும் உள்ளடக்கத்துடன்:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"வாரிசு: config.yml\n" -"தளப் பெயர்: {{ formal_name }} ஆவணங்கள்\n" -"தள முகவரி: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"ஆவணங்கள் கோப்புறை: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"தீம்:\n" -" மொழி: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"கூடுதல்:\n" -" மொழி_இணைப்பு: de/\n" -" மொழிபெயர்ப்பு_வகை: இயந்திரம்\n" -" தலைப்பு:\n" -" பற்றி: பற்றி\n" -" ஆவணக்காப்பு: ஆவணக்காப்பு\n" -" சமூகம்: சமூகம்\n" -" பங்களித்தல்: பங்களிக்கவும்\n" -" செய்திகள்: செய்திகள்\n" -" விளம்பரதாரர்: விளம்பரதாரர்கள்" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1706,9 +1687,8 @@ msgid "Here's what is going on in this file:" msgstr "இந்த கோப்பில் நடப்பவை இதோ:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "இந்தக் கோப்பு `config.yml`-இலிருந்து உள்ளமைவு உள்ளடக்கத்தைப் பெறுகிறது." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1717,201 +1697,188 @@ msgstr "`site_name` மதிப்பு மொழிபெயர்க்க #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "`site_url` மதிப்பு என்பது திட்ட தளத்தின் URL ஆகும், அதைத் தொடர்ந்து மொழி குறியீடு வரும்." +msgid "The `docs_dir` should be the language code." +msgstr "`docs_dir` மொழி குறியீடாக இருக்க வேண்டும்." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "`docs_dir` மொழி குறியீடாக இருக்க வேண்டும்." +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "`theme.language` மதிப்பு, [Zensical தீம் மூலம் குறிப்பிடப்பட்டுள்ளபடி]{1}, மொழி குறியீடாக இருக்க வேண்டும். பெரும்பாலான மொழிகளுக்கு, இது `docs_dir` மொழி குறியீட்டைப் போலவே இருக்கும்; ஆனால் சிலவற்றில் (குறிப்பாக `zh_CN` போன்ற உள்ளூர்மயமாக்கல் மாறுபாடுகளைக் கொண்ட மொழிகளில்), வேறுபாடுகள் உள்ளன." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "`theme: language:` மதிப்பு, [MkDocs Material தீம் மூலம் குறிப்பிடப்பட்டுள்ளபடி]{1}, மொழி குறியீடாக இருக்க வேண்டும். பெரும்பாலான மொழிகளுக்கு, இது `docs_dir` மொழி குறியீட்டைப் போலவே இருக்கும்; ஆனால் சிலவற்றில் (குறிப்பாக `zh_CN` போன்ற உள்ளூர்மயமாக்கல் மாறுபாடுகளைக் கொண்ட மொழிகளில்), வேறுபாடுகள் உள்ளன." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "`extra.language_url` என்பது மொழி குறியீடாக இருக்க வேண்டும், அதைத் தொடர்ந்து ஒரு தனிப்பட்ட சல்தரகு வர வேண்டும், எ.கா. ஜெர்மன் மொழிக்கு `de/`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "`extra: language_url:` என்பது மொழி குறியீடாக இருக்க வேண்டும், அதைத் தொடர்ந்து ஒரு தனிப்பட்ட சல்தரகு வர வேண்டும், எ.கா. ஜெர்மன் மொழிக்கு `de/`." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "மொழிபெயர்ப்பு முதல் முறையாக 100% அடையும் வரை `extra.translation_type` என்பது `machine` ஆக இருக்க வேண்டும், அந்த நேரத்தில் அது `human` ஆக மாற வேண்டும். அது 90% க்கும் கீழே சரிந்தால் `machine` என்பதிலிருந்து `human` ஆக மீண்டும் மாறும்." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "மொழிபெயர்ப்பு முதல் முறையாக 100% அடையும் வரை `extra: translation_type:` என்பது `machine` ஆக இருக்க வேண்டும், அந்த நேரத்தில் அது `human` ஆக மாற வேண்டும். அது 90% க்கும் கீழே சரிந்தால் `machine` என்பதிலிருந்து `human` ஆக மீண்டும் மாறும்." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "`extra: header` என்பதன் கீழ் உள்ள உள்ளடக்கம், தலைப்புப் பட்டியில் தோன்றும் தலைப்புகளுக்கான மொழிபெயர்ப்புகளாகும். இந்த வரையறை பிரதான BeeWare இணையதளத்தில் தேவையில்லை; இது பயிற்சி அல்லது திட்ட ஆவணங்கள் போன்ற *மற்ற* தளங்களில் மட்டுமே தேவைப்படுகிறது." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "`extra.header` என்பதன் கீழ் உள்ள உள்ளடக்கம், தலைப்புப் பட்டியில் தோன்றும் தலைப்புகளுக்கான மொழிபெயர்ப்புகளாகும். இந்த வரையறை பிரதான BeeWare இணையதளத்தில் தேவையில்லை; இது பயிற்சி அல்லது திட்ட ஆவணங்கள் போன்ற *மற்ற* தளங்களில் மட்டுமே தேவைப்படுகிறது." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "புதுப்பி `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "நீங்கள் `tox.ini` கோப்பில் பல மாற்றங்களைச் செய்ய வேண்டும்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "பின்வருவனவற்றை நீங்கள் சேர்ப்பீர்கள்:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "புதிய மொழி குறியீட்டு சூழல் கொடியானது, `[testenv:docs` எனத் தொடங்கும் தலைப்பு வரிக்குச் சேர்க்கப்படுகிறது. இதில் மொழி குறியீட்டிற்கு முன் ஒரு `-` வருகிறது, இடைவெளிகள் சேர்க்கப்படாது, எ.கா. `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "முதல் கட்டளைக்கான புதிய மொழி குறியீட்டு விலக்கு, இது `!lint` உடன் தொடங்கி, `-!` ஆல் முன்னொட்டுப்பட்டு, இடைவெளிகள் எதுவும் சேர்க்கப்படாமல், எ.கா. `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "`translate : build_po_translations` உடன் தொடங்கும் வரிக்கு புதிய மொழி குறியீடு." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "`translate : update_machine_translations` என்று தொடங்கும் வரிக்கு புதிய மொழிக்குறிப்பு" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "அல்லது, ஏற்கனவே உள்ள மொழி-குறிப்பிட்ட கட்டளைகளுக்குள், அந்தக் கட்டளைகளின் உள்ளடக்கத்துடன் பொருந்தக்கூடிய, புதிய மொழி குறியீட்டுடன் தொடங்கும் ஒரு புதிய கட்டளை, உதாரணமாக, ஜெர்மன் மொழிக்கு `de : build_md_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "`all:` உடன் தொடங்கும் வரிக்கு புதிய மொழி குறியீடு." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "புதுப்பி `config.yml`" +msgid "Update `zensical.toml`" +msgstr "புதுப்பி `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "மொழியை `config.yml` இல் சேர்க்கவும், அப்போதுதான் அது தலைப்பில் உள்ள மொழித் தேர்வானதில் தோன்றும். `extra:` என்று தொடங்கும் பகுதியைக் கண்டறிந்து, பின்னர் `alternate:` என்று தொடங்கும் துணைப் பகுதியைக் கண்டறியவும். ஜெர்மன் மொழிக்கு, பின்வருவனவற்றைச் சேர்க்க வேண்டும்:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- பெயர்: ஜெர்மன்\n" -" இணைப்பு: /de/\n" -" மொழி: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "மொழிப் பெயர் அந்த மொழியிலேயே மொழிபெயர்க்கப்பட வேண்டும். இணைப்பில் `/`கள் கட்டாயம் இருக்க வேண்டும்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "நடத்து `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "நீங்கள் இப்போது `tox -e docs-translate`-ஐ இயக்கலாம். இது ஒரு வெற்று மொழிபெயர்ப்புக் கோப்பை உருவாக்கும்; உங்களிடம் DeepL கணக்கு இருந்தால், ஆரம்ப இயந்திர மொழிபெயர்ப்புகளை நிரப்ப அந்தக் கணக்கைப் பயன்படுத்தலாம். உங்களிடம் DeepL கணக்கு இல்லையென்றால் பரவாயில்லை - புல் கோரிக்கையை ஏற்றுக்கொள்வதற்கு முன்பு நாங்கள் ஆரம்ப மொழிபெயர்ப்புகளை நாங்களே செய்து கொள்வோம்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "மொழிபெயர்ப்பு வழிகாட்டுதல்கள்" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "நீங்கள் குழுவில் சேர்க்கப்பட்டவுடன், [Weblate]{1}-இல் உள்நுழைந்து, சரங்களை மொழிபெயர்க்கத் தொடங்க வேண்டிய நேரம் இது." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "பொருள் மொழிபெயர்ப்பு எதிர் வார்த்தைக்கு வார்த்தை மொழிபெயர்ப்பு" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "சொல் வாரியாக மொழிபெயர்க்க முயற்சிப்பதை விட, ஆங்கில உரையின் தொனியைப் பேணுவது மிகவும் முக்கியம். எங்கள் உள்ளடக்கத்தில் நாங்கள் நட்பாகவும், சற்று பேச்சு வழக்கிலும் இருக்க முயற்சிக்கிறோம்; உங்கள் மொழிபெயர்ப்புகளில் அந்த உணர்வைத் தக்க வைத்துக் கொள்ள முயற்சி செய்யுங்கள்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "ஆங்கில உரையில் ஒரு வலுவான ஆங்கில சொற்றொடர் இருந்தால், உங்கள் மொழியில் சமமாகப் பொருந்தக்கூடிய ஒரு சொற்றொடர் இருந்தால், அதை அப்படியே வைத்திருக்க வேண்டிய கட்டாயம் இல்லை. ஆங்கில உரையில் உள்ள சொல் அல்லது சொற்றொடர் ஒரு குறிப்பிட்ட சொற்றொடர் அல்லது வட்டார வழக்குச் சொல்லாக இருந்தால், நாம் ஒரு மாற்றம் செய்ய வேண்டும் என்று பரிந்துரைக்கத் தயங்காதீர்கள். ஆங்கிலம் பேசுபவர்களுக்கே கூட, சொலவடைகளும் வழக்குச் சொற்களும் சிரமத்தை ஏற்படுத்தக்கூடும். சில நேரங்களில், மொழிபெயர்ப்பாளர்கள் மற்றும் வாசகர்கள் இருவருக்குமே ஆங்கில உரையை மேலும் எளிமையாக மாற்ற, நாம் அதை மாற்ற வேண்டியிருக்கும்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "நான் அதை மொழிபெயர்க்க வேண்டுமா?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "பின்வரும் உருப்படிகள் மொழிபெயர்க்கப்படவோ அல்லது புதுப்பிக்கப்படவோ *கூடாது*:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**கட்டளைகள்**. உதாரணமாக, \"You should run \\`briefcase create\\`.\" என்பதில், \"You should run\" மட்டுமே மொழிபெயர்க்கப்பட வேண்டும்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "வகுப்பு, முறை அல்லது பண்புக்கூறு பெயர்கள் போன்ற **பெயரகங்கள்**." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**இணைப்பு URL-கள்**. நிலையான மார்க் டவுன் இணைப்புகள் Weblate-இல் `[Link text]{1}` எனத் தோன்ற வேண்டும், இதில் `1` என்பது மற்ற சாத்தியமான இணைப்புகளுடன் ஒப்பிடுகையில் சரத்தில் இணைப்பின் இருப்பிடத்தைக் குறிக்கிறது. சரத்தில் முழு URL `[Link text](https://example.com/)` என சேர்க்கப்பட்டிருந்தால், அந்த URL மொழிபெயர்ப்புக்காகத் தவிர்க்கப்பட வேண்டும்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**வகுப்பு, முறை அல்லது பண்புக்கூறு பெயர்களைக் கொண்ட குறிப்பு இணைப்புகள்**. இவற்றை, பின்னோக்கி குறியீடுகளுடன் சேர்த்து, அப்படியே விட்டுவிட வேண்டும். இங்கே காட்டப்பட்டுள்ள எடுத்துக்காட்டு இணைப்பின் ஒவ்வொரு பகுதியும் மொழிபெயர்க்கப்படாது." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][வகுப்பு.பண்பு]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**ஒரு குறிப்பு இணைப்பின் இணைப்பு உள்ளடக்கம்**. உதாரணமாக, பின்வருவனவற்றில் `link-content` தவிர்க்கப்படும்:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[இணைப்பு உரை][இணைப்பு உள்ளடக்கம்]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**ஜின்ஜா வழிமுறைகள்**. இது பொருந்தக்கூடிய வளைந்த அடைப்புக்குறிகளின் இரண்டு ஜோடிக்கு உள்ளே, அல்லது ஒவ்வொரு முனையிலும் சதவீதக் குறியீடுகளுடன் பொருந்தக்கூடிய ஒற்றை வளைந்த அடைப்புக்குறிகளுக்கு உள்ளே சுற்றப்பட்ட எந்தவொரு உள்ளடக்கமாகும். குறிப்பு: இங்கே சொற்றொடரியலின் ஒரு எடுத்துக்காட்டைச் சேர்ப்பது, மேக்ரோஸ் செருகுநிரலை அதைக் காட்ட முயற்சி செய்ய வைக்கும்; எடுத்துக்காட்டுகளுக்கு [மேக்ரோஸ் ஆவணங்கள்]{1}-ஐப் பார்க்கவும்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**தனிப்பயன் நங்கூரங்கள்**. அவை தலைப்புகளுக்குப் பிறகு அல்லது சில உள்ளடக்கத்திற்கு மேலே காணப்படுகின்றன, மேலும் அவை `{ #anchor }` என வடிவமைக்கப்பட்டுள்ளன." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**எச்சரிக்கை இலக்கணம்**. பின்வரும் எடுத்துக்காட்டில், \"admonition\" என்ற சொல் மொழிபெயர்க்கப்படக்கூடாது. குறிப்புகள், எச்சரிக்கைகள் போன்ற அனைத்து வகையான எச்சரிக்கைகளுக்கும் இது பொருந்தும். மீதமுள்ள உள்ளடக்கத்தை மொழிபெயர்ப்பது குறித்த தகவல்களுக்கு அடுத்த பகுதியைப் பார்க்கவும்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1926,52 +1893,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**பேக்டிக்ஸ்**. அவை பேக்டிக்ஸ்களாகவே இருக்க வேண்டும்; அவை இன்லைன் கோட் மற்றும் கோட் பிளாக்குகள் இரண்டையும் வடிவமைக்கப் பயன்படுகின்றன." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**வெளியிடப்பட்ட உள்ளடக்கத்தைச் சேர்ப்பதற்கான சொற்றொடர் அமைப்பு**. இது `-8<-` உடன் ஒரே வரியில் உள்ள எதுவாகவும், அல்லது தனித்தனி வரிகளில் உள்ள இரண்டு `-8<-` களுக்கு இடையில் உள்ள வரிகளில் எதுவாகவும் இருக்கலாம்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "பின்வரும் உருப்படிகள் மொழிபெயர்க்கப்பட *வேண்டும*்:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**இணைப்பு உரை**. இணைப்பு இலக்கணத்தில், உரை URL-க்கு முன்பு வருகிறது, மேலும் அது அடைப்புக்குறிகளுக்குள் மூடப்பட்டிருக்கும், அதாவது `[Link text](URL)`. நிலையான மார்க் டவுன் இணைப்புகள் Weblate-ல் `[Link text]{1}` எனத் தோன்ற வேண்டும், இதில் `1` என்பது மற்ற சாத்தியமான இணைப்புகளுடன் ஒப்பிடுகையில் சரத்தில் இணைப்பின் இருப்பிடத்தைக் குறிக்கிறது." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**குறிப்பு இணைப்பு உரை**. உதாரணமாக, `Link text` பின்வருமாறு மொழிபெயர்க்கப்படும்:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**எச்சரிக்கை தலைப்புகள் மற்றும் உள்ளடக்கம்**. முந்தைய எச்சரிக்கை எடுத்துக்காட்டில், \"பக்கத் தலைப்பு\" மற்றும் \"உள்ளடக்கம்\" மொழிபெயர்க்கப்பட வேண்டும்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "வெப்லேட்" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "எங்கள் உள்ளடக்க மொழிபெயர்ப்பிற்காக நாங்கள் [Weblate]{1}-ஐப் பயன்படுத்துகிறோம். நாங்கள் ஒரு புதிய மொழிபெயர்ப்பைச் சேர்க்கும்போது, மொழிபெயர்ப்புகளின் முதல் வரைவை உருவாக்க இயந்திர மொழிபெயர்ப்பிற்காக [DeepL]{2}-ஐப் பயன்படுத்துகிறோம். அதாவது, பொதுவாக, நீங்கள் மொழிபெயர்க்கும் உள்ளடக்கம் ஏற்கனவே இயந்திரத்தால் மொழிபெயர்க்கப்பட்டிருக்கும். ஒரு மொழிபெயர்ப்பாளராக, நீங்கள் ஏற்கனவே உள்ள இயந்திர மொழிபெயர்ப்பை மதிப்பாய்வு செய்து, திருத்தி, மேம்படுத்துவீர்கள் என்பதே எதிர்பார்ப்பு." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "வெப்லேட் எல்லாவற்றையும் வரிசை வாரியாகச் செயலாக்குகிறது. அது மாற்றங்களைத் தொகுத்து, ஒவ்வொரு இரண்டு மணி நேரத்திற்கும் ஒருமுறை, அந்த இடைவெளியில் மாறிய அனைத்து வரிகளுடன் ஒரு மொத்த மாற்றத்தைச் சமர்ப்பிக்கும். எனவே, உங்கள் மாற்றங்கள் இணையதளத்தில் தோன்ற இரண்டு மணி நேரம் ஆகலாம், ஆனால் அந்தப் புதுப்பிப்பு நான்கு மணி நேரத்திற்குள் தோன்றும் என்று நீங்கள் எதிர்பார்க்கலாம்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "அந்த நேரத்திற்குப் பிறகும், உங்கள் மாற்றங்கள் இன்னும் தோன்றவில்லை என்றால், அதற்கான சாத்தியமான காரணம் ஒரு மார்க்அப் பிழைதான், இது அந்த மொழிக்கான ஆவண உருவாக்கத் தோல்விக்கு வழிவகுக்கிறது. எந்தவொரு சரத்திலும் உள்ள எந்தவொரு மார்க்அப் பிரச்சனையும் முழு மொழிபெயர்ப்பும் பொதுவெளியில் வெளியாவதைத் தடுக்கும். உங்கள் மொழிக்கான பில்ட் பக்கம் வெற்றிகரமாக உருவாக்கப்பட்டதா என்பதைப் பார்க்க, நீங்கள் அதைக் கண்காணிக்கலாம். இணைப்பு பிரெஞ்சு பில்ட் பக்கத்திற்கான இந்த இணைப்பைப் போலவே வடிவமைக்கப்பட்டுள்ளது {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; பொருத்தமான பில்ட் பக்கத்தைப் பார்க்க, மொழி குறியீட்டை உங்கள் மொழிக்கு மாற்றவும். இது தளத்தின் மிகச் சமீபத்திய பில்டின் நிலையைக் காண்பிக்கும். பில்ட் தோல்வியுற்றால், பில்ட் பதிவேட்டைப் பார்த்து, சிக்கலின் மூலத்தைக் கண்டறிய முடியுமா என்று பாருங்கள்." @@ -2375,36 +2342,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "நீங்கள் `docs/en` கோப்பகத்திற்குள் பொருத்தமான இடத்தில் ஆவணத்தை உருவாக்க வேண்டும். விவாதத்திற்காக, நீங்கள் `new_doc.md` என்ற கோப்புப் பெயரில் ஒரு புதிய ஆவணத்தைச் சேர்க்கிறீர்கள் என்று கொள்வோம்." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "பின்னர், உங்கள் புதிய கோப்பைச் சேர்க்க `docs/en/SUMMARY.md` கோப்பை நீங்கள் புதுப்பிக்க வேண்டும். `SUMMARY.md` கோப்பு அடிப்படையில் `docs/en` கோப்பக அமைப்பைப் பிரதிபலிக்கும் வகையில் ஒழுங்கமைக்கப்பட்டுள்ளது, ஆனால், மிக முக்கியமாக, இது இடது பக்கப்பட்டியின் அமைப்பை நேரடியாகத் தீர்மானிக்கிறது. நீங்கள் `new_doc.md`-ஐச் சேர்க்க விரும்பும் பிரிவைக் கண்டறிந்தால், அங்கு ஒரு வைல்ட்கார்டு பாதை பட்டியலிடப்பட்டிருந்தால், `SUMMARY.md`-இல் எதையும் மாற்றத் தேவையில்லை. எடுத்துக்காட்டாக:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- கோப்பகப் பாதை/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "நீங்கள் `new_doc.md`-ஐச் சேர்க்க விரும்பும் பகுதி தனிப்பட்ட மார்க்அப் இணைப்புகளின் பட்டியலாக இருந்தால், உங்கள் இணைப்பிற்கு ஒரு வெளிப்படையான இணைப்பைச் சேர்க்க வேண்டும். உதாரணமாக:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [எனது புதிய ஆவணம்](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "உங்கள் ஆவணங்களை எழுதுதல்" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "நீங்கள் இப்போது விரும்பிய கோப்பை உங்கள் எடிட்டரில் திறந்து, எழுதத் தொடங்கலாம்." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "BeeWare-க்கான ஆவணங்களை எழுதுவதற்கான எங்கள் வழிகாட்டுதல்களை விவரிக்கும் ஒரு [ஆவணப்படுத்தல் பாணி வழிகாட்டி]{1} எங்களிடம் உள்ளது." @@ -3174,8 +3139,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "புதிய உள்ளடக்கத்தை எழுதுதல் மற்றும் ஏற்கனவே உள்ள உள்ளடக்கத்தை மொழிபெயர்த்தல் ஆகியவற்றுடன் தொடர்புடைய, எதிர்பார்க்கப்படும் பாணி, MkDocs-க்கான பிரத்யேக இலக்கண அமைப்பு, பல்வேறு தேவையான கருவிகள் மற்றும் ஆவண மொழிபெயர்ப்பு ஆகியவை குறித்த தகவல்கள் இந்த வழிகாட்டியில் அடங்கும்." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "புதிய உள்ளடக்கத்தை எழுதுதல் மற்றும் ஏற்கனவே உள்ள உள்ளடக்கத்தை மொழிபெயர்த்தல் ஆகியவற்றுடன் தொடர்புடைய, எதிர்பார்க்கப்படும் பாணி, Zensical-க்கான பிரத்யேக இலக்கண அமைப்பு, பல்வேறு தேவையான கருவிகள் மற்றும் ஆவண மொழிபெயர்ப்பு ஆகியவை குறித்த தகவல்கள் இந்த வழிகாட்டியில் அடங்கும்." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3234,8 +3199,8 @@ msgstr "முடிந்தவரை ஆவணங்களில் உள் #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs, நிலையான மார்க் டவுன் வடிவமைப்புள்ள இணைப்புகளைக் காட்டுகிறது. நிலையான மார்க் டவுன் வடிவமைப்புள்ள இணைய இணைப்புகள் பின்வருமாறு:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical, நிலையான மார்க் டவுன் வடிவமைப்புள்ள இணைப்புகளைக் காட்டுகிறது. நிலையான மார்க் டவுன் வடிவமைப்புள்ள இணைய இணைப்புகள் பின்வருமாறு:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3254,8 +3219,8 @@ msgstr "[இணைப்பு உரை](path/to/file.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "கோப்புகளின் குறிப்பிட்ட பிரிவுகளை அல்லது ஏபிஐ ஆவணங்களைக் குறிப்பிட, MkDocs குறிப்பு இணைப்பு வடிவத்தைப் பயன்படுத்த வேண்டும்." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "கோப்புகளின் குறிப்பிட்ட பிரிவுகளை அல்லது ஏபிஐ ஆவணங்களைக் குறிப்பிட, Zensical குறிப்பு இணைப்பு வடிவத்தைப் பயன்படுத்த வேண்டும்." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3269,13 +3234,13 @@ msgstr "மார்க்‌டவுன், தலைப்பின் உள #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs, மாற்றியமைக்கப்பட்ட மார்க் டவுன் இணைப்பைப் பயன்படுத்தி ஆவணத்தில் உள்ள பல்வேறு பிற கூறுகளுக்கு இணைக்க அனுமதிக்கும் ஒரு குறிப்பு இணைப்பு இலக்கணத்தை வழங்குகிறது. இதில், மற்றவற்றுடன், தனிப்பயன் மார்க் டவுன் தலைப்புகள் மற்றும் உரை நங்கூரங்களுக்கு இணைப்பது ஆகியவை அடங்கும்." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical, மாற்றியமைக்கப்பட்ட மார்க் டவுன் இணைப்பைப் பயன்படுத்தி ஆவணத்தில் உள்ள பல்வேறு பிற கூறுகளுக்கு இணைக்க அனுமதிக்கும் ஒரு குறிப்பு இணைப்பு இலக்கணத்தை வழங்குகிறது. இதில், மற்றவற்றுடன், தனிப்பயன் மார்க் டவுன் தலைப்புகள் மற்றும் உரை நங்கூரங்களுக்கு இணைப்பது ஆகியவை அடங்கும்." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "MkDocs குறிப்பு இணைப்புகள் என்பவை பின்வருமாறு வடிவமைக்கப்பட்ட எந்தவொரு இணைப்புகளாகும்:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Zensical குறிப்பு இணைப்புகள் என்பவை பின்வருமாறு வடிவமைக்கப்பட்ட எந்தவொரு இணைப்புகளாகும்:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3289,8 +3254,8 @@ msgstr "/// warning | தனிப்பயன் தலைப்பு மற #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "BeeWare ஆவணத்தில் உள்ள MkDocs குறிப்பு இணைப்பு வழியாக உரை உள்ளடக்கத்தில் குறிப்பிடப்படும் எந்தவொரு தலைப்பு அல்லது உள்ளடக்கப் பகுதியிலும் ஒரு தனிப்பயன் ஆங்கர் இணைக்கப்பட்டிருக்க _வேண்டும்_. இல்லையெனில், தலைப்பு உள்ளடக்கம் மொழிபெயர்க்கப்படும்போது இணைப்புகள் உடையக்கூடிய வாய்ப்புள்ளது." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "BeeWare ஆவணத்தில் உள்ள Zensical குறிப்பு இணைப்பு வழியாக உரை உள்ளடக்கத்தில் குறிப்பிடப்படும் எந்தவொரு தலைப்பு அல்லது உள்ளடக்கப் பகுதியிலும் ஒரு தனிப்பயன் ஆங்கர் இணைக்கப்பட்டிருக்க _வேண்டும்_. இல்லையெனில், தலைப்பு உள்ளடக்கம் மொழிபெயர்க்கப்படும்போது இணைப்புகள் உடையக்கூடிய வாய்ப்புள்ளது." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3349,8 +3314,8 @@ msgstr "[இணைப்பு உரை](#ஆங்கர்-பெயர்)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "பிரிவான ஆவணத்தில் உள்ள ஒரு ஆங்கருக்கு இணைப்பது, MkDocs குறிப்பு இணைப்பு பாணியைப் பயன்படுத்துகிறது, அது பின்வருமாறு வடிவமைக்கப்பட்டுள்ளது:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "பிரிவான ஆவணத்தில் உள்ள ஒரு ஆங்கருக்கு இணைப்பது, Zensical குறிப்பு இணைப்பு பாணியைப் பயன்படுத்துகிறது, அது பின்வருமாறு வடிவமைக்கப்பட்டுள்ளது:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3364,8 +3329,8 @@ msgstr "ஏபிஐ குறிப்பு இணைப்புகள்" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "MkDocs குறிப்பு இணைப்பு, ஆவணப்படுத்தப்பட்ட வகுப்புகள், வகுப்பு முறைகள் அல்லது பண்புகள், மற்றும் குறிப்பிட்ட வெளிப்புற ஆவணக் குறிப்புகள் உட்பட, குறுக்கு-குறிப்பு API ஆவணங்களையும் ஆதரிக்கிறது." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Zensical குறிப்பு இணைப்பு, ஆவணப்படுத்தப்பட்ட வகுப்புகள், வகுப்பு முறைகள் அல்லது பண்புகள், மற்றும் குறிப்பிட்ட வெளிப்புற ஆவணக் குறிப்புகள் உட்பட, குறுக்கு-குறிப்பு API ஆவணங்களையும் ஆதரிக்கிறது." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3940,8 +3905,8 @@ msgstr "BeeWare Docs Tools பகிரப்பட்ட உள்ளடக் #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "நீங்கள் [Macros MkDocs செருகுநிரலை]{1} பயன்படுத்தி BeeWare Docs கருவிகளின் பகிரப்பட்ட உள்ளடக்க கோப்பகத்திலிருந்து உள்ளடக்கத்தைச் சேர்க்கலாம். ஆவணத்தில் செயல்படுத்தப்பட வேண்டிய ஜின்ஜா வழிமுறைகள் இருந்தால் இந்த முறை அவசியமானது, மேலும் இந்தச் சூழ்நிலையில் மட்டுமே இதைப் பயன்படுத்த வேண்டும். இது ஒரு URL வழியாக வெளிப்புற உள்ளடக்கத்துடன் வேலை செய்யாது. [மேக்ரோஸ் மாறி-மாற்றுதல் வழிமுறை]{2} இந்த முறையுடன் செயல்படுகிறது." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "நீங்கள் [Macros]{1} பயன்படுத்தி BeeWare Docs கருவிகளின் பகிரப்பட்ட உள்ளடக்க கோப்பகத்திலிருந்து உள்ளடக்கத்தைச் சேர்க்கலாம். ஆவணத்தில் செயல்படுத்தப்பட வேண்டிய ஜின்ஜா வழிமுறைகள் இருந்தால் இந்த முறை அவசியமானது, மேலும் இந்தச் சூழ்நிலையில் மட்டுமே இதைப் பயன்படுத்த வேண்டும். இது ஒரு URL வழியாக வெளிப்புற உள்ளடக்கத்துடன் வேலை செய்யாது. [மேக்ரோஸ் மாறி-மாற்றுதல் வழிமுறை]{2} இந்த முறையுடன் செயல்படுகிறது." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4451,8 +4416,8 @@ msgstr "ஆவணப்படுத்தல் படிவங்கள் { #d #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "{{ formal_name }}-இன் ஆவணப்படுத்தல் [MkDocs மற்றும் Markdown]{1} பயன்படுத்தி எழுதப்படுகிறது. ஆவணப்படுத்தலை கட்டமைக்க [Diataxis]{2} கட்டமைப்பைப் பின்பற்ற நாங்கள் இலக்கு வைத்துள்ளோம்." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "{{ formal_name }}-இன் ஆவணப்படுத்தல் [Zensical]{1} மற்றும் [Markdown]{2} பயன்படுத்தி எழுதப்படுகிறது. ஆவணப்படுத்தலை கட்டமைக்க [Diataxis]{3} கட்டமைப்பைப் பின்பற்ற நாங்கள் இலக்கு வைத்துள்ளோம்." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/tr/translations.po b/src/beeware_docs_tools/shared_content/locales/tr/translations.po index 4337efa0..a5112097 100644 --- a/src/beeware_docs_tools/shared_content/locales/tr/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/tr/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: 2026-09-05 02:51+0000\n" "Last-Translator: yldzyagz <yldzyagz@icloud.com>\n" "Language-Team: Turkish <https://hosted.weblate.org/projects/beeware/docs-tools-shared-content/tr/>\n" @@ -359,7 +359,7 @@ msgstr "Ürün adına yapılan her türlü atıfta, ürünün tercih edilen büy msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Bir terim \"kod olarak\" kullanılıyorsa, sözlüğe eklenmek yerine kelime olarak (`like this`) alıntılanmalıdır." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 #, fuzzy msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1627,8 +1627,8 @@ msgstr "Yardım etmeyi planladığınız dil henüz mevcut değilse, başlamadan #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Dile özgü içerikle `/docs/mkdocs.language-code.yml` dosyasını oluşturun." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "Dile özgü içerikle `/docs/zensical.language-code.toml` dosyasını oluşturun." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1637,8 +1637,8 @@ msgstr "Yeni dil derleme komutlarını eklemek için `tox.ini`'yi güncelleyin." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "`/docs/config.yml`'yi güncelleyerek `extra: alternate:` altındaki dili ekleyin." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "`/docs/zensical.toml`'yi güncelleyerek `extra.alternate` altındaki dili ekleyin." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1647,54 +1647,35 @@ msgstr "Aşağıda, Almanca örneği kullanılarak gerekli değişiklikler göst #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "Yeni bir MkDocs yapılandırma dosyası" +msgid "A new language configuration file" +msgstr "Yeni bir Zensical yapılandırma dosyası" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "İlk olarak, `mkdocs.de.yml` dizininde `docs` adlı yeni bir dosya oluşturun ve içine aşağıdaki içeriği ekleyin:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "İlk olarak, `zensical.de.toml` dizininde `docs` adlı yeni bir dosya oluşturun ve içine aşağıdaki içeriği ekleyin:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Belgeler\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Hakkında\n" -" Documentation: Belgeler\n" -" Community: Topluluk\n" -" Contributing: Katkıda Bulunmak\n" -" News: Haberler\n" -" Sponsor: Sponsorlar" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1702,9 +1683,8 @@ msgid "Here's what is going on in this file:" msgstr "Bu dosyada neler olduğunu aşağıda görebilirsiniz:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Bu dosya, `config.yml` dosyasından yapılandırma içeriğini devralır." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1713,201 +1693,188 @@ msgstr "`site_name` değeri çevrilir." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "`site_url` değeri, proje sitesinin URL'sidir ve ardından dil kodu gelir." +msgid "The `docs_dir` should be the language code." +msgstr "`docs_dir` dil kodu olmalıdır." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "`docs_dir` dil kodu olmalıdır." +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "`theme.language` değeri, [Zensical teması tarafından belirtildiği gibi]{1} dil kodu olmalıdır. Çoğu dil için bu, `docs_dir` dil koduyla aynı olacaktır; ancak bazı dillerde (özellikle `zh_CN` gibi yerel varyantları olan dillerde) farklılıklar vardır." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "`theme: language:` değeri, [MkDocs Material teması tarafından belirtildiği gibi]{1} dil kodu olmalıdır. Çoğu dil için bu, `docs_dir` dil koduyla aynı olacaktır; ancak bazı dillerde (özellikle `zh_CN` gibi yerel varyantları olan dillerde) farklılıklar vardır." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "`extra.language_url` dil kodu olmalı ve ardından tek bir eğik çizgi gelmelidir, örneğin Almanca için `de/`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "`extra: language_url:` dil kodu olmalı ve ardından tek bir eğik çizgi gelmelidir, örneğin Almanca için `de/`." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "Çeviri ilk kez %100'e ulaşana kadar `extra.translation_type` olmalıdır, bu noktada `machine` olmalıdır. %90'ın altına düşerse `human`'den `machine`'ye geri dönecektir." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "Çeviri ilk kez %100'e ulaşana kadar `extra: translation_type:` olmalıdır, bu noktada `machine` olmalıdır. %90'ın altına düşerse `human`'den `machine`'ye geri dönecektir." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "`extra: header` altındaki içerik, başlık çubuğunda görünen başlıkların çevirileridir. Bu tanım, BeeWare ana web sitesinde *gerekli değildir*; yalnızca *diğer* sitelerde (örneğin, öğretici veya proje belgeleri) gereklidir." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "`extra.header` altındaki içerik, başlık çubuğunda görünen başlıkların çevirileridir. Bu tanım, BeeWare ana web sitesinde *gerekli değildir*; yalnızca *diğer* sitelerde (örneğin, öğretici veya proje belgeleri) gereklidir." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "Güncelle `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "`tox.ini` dosyasında birkaç değişiklik yapmanız gerekecektir." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "Aşağıdakileri ekleyebilirsiniz:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "`[testenv:docs` ile başlayan başlık satırına yeni dil kodu ortamı bayrağı, dil kodunun önüne `-` eklenir ve boşluk içermez, örneğin `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "İlk komuta eklenen yeni dil kodu hariç tutma, `!lint` ile başlar, önünde `-!` bulunur ve boşluk içermez, örneğin `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "`translate : build_po_translations` ile başlayan satıra yeni dil kodu." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "`translate : update_machine_translations` ile başlayan satıra yeni dil kodu" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "Örneğin Almanca için `de : build_md_translations` ile başlayan, mevcut dile özgü komutlar içinde alfabetik sırayla, bu komutların içeriğiyle eşleşen ve yeni dil kodunu içeren yeni bir komut." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "`all:` ile başlayan satıra yeni dil kodu." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "Güncelle `config.yml`" +msgid "Update `zensical.toml`" +msgstr "Güncelle `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Dili `config.yml` içine ekleyin, böylece başlıktaki dil seçicide görünecektir. `extra:` ile başlayan bölümü bulun ve ardından `alternate:` ile başlayan alt bölümü bulun. Almanca için aşağıdakileri ekleyin:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- adı: Almanca\n" -" bağlantı: /de/\n" -" dil: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "Dil adı, ilgili dile çevrilmelidir. Bağlantı, `/`s içermelidir." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "Çalıştır `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Artık `tox -e docs-translate` komutunu çalıştırabilirsiniz. Bu, boş bir çeviri dosyası oluşturacaktır; DeepL hesabınız varsa, bu hesabı kullanarak ilk makine çevirilerini doldurabilirsiniz. DeepL hesabınız yoksa sorun değil - pull isteğini kabul etmeden önce ilk çevirileri biz yapacağız." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "Çeviri kuralları" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "Ekibe eklendikten sonra, [Weblate]{1} adresine giriş yapın ve dizeleri çevirmeye başlayın." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "Ton ve kelime kelime çeviri" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "İngilizce metnin üslubunu korumak, kelime kelime çeviri yapmaya çalışmaktan daha önemlidir. İçeriğimizde samimi ve biraz da konuşma diline yakın bir üslup kullanmaya çalışıyoruz; çevirilerinizde de bu ruhu korumaya çalışın." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "İngilizce metin güçlü bir İngilizce deyim içeriyorsa, kendi dilinizde aynı anlamı taşıyan bir eşdeğer varsa, bu deyimi korumak zorunda olduğunuzu düşünmeyin. İngilizce metindeki terim veya ifade özellikle deyimsel veya argo bir terimse, değişiklik yapmayı düşünmemiz gerektiğini bize söylemekten çekinmeyin. İngilizce konuşanlar için bile deyimler ve argo zorluk yaratabilir. Bazen, çevirmenler ve okuyucular için daha anlaşılır hale getirmek için İngilizce metni değiştirmemiz gerekir." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "Çevirmeli miyim?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "Aşağıdaki öğeler *çevrilmemeli* veya güncellenmemelidir:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Komutlar**. Örneğin, \"You should run \\`briefcase create\\`.\", sadece \"You should run\" kısmı çevrilmelidir." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Ad alanları**, örneğin sınıf, yöntem veya öznitelik adları." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**Bağlantı URL'leri**. Standart Markdown bağlantıları Weblate'te `[Link text]{1}` şeklinde görünmelidir; burada `1`, diğer olası bağlantılara göre dizgedeki bağlantının konumunu belirtir. Dizgede `[Link text](https://example.com/)` şeklinde tam URL yer alıyorsa, bu URL çeviri sırasında atlanmalıdır." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Sınıf, yöntem veya öznitelik adlarını içeren referans bağlantıları**. Bunlar, ters eğik çizgiler dahil olmak üzere olduğu gibi bırakılmalıdır. Burada gösterilen örnek bağlantının hiçbir kısmı çevrilmeyecektir." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Sınıf.özelliği]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**Referans bağlantısının bağlantı içeriği**. Örneğin, aşağıdaki örnekte `link-content` atlanacaktır:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[Bağlantı metni][bağlantı içeriği]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Jinja yönergeleri**. Bu, iki çift eşleşen küme parantezi veya her iki ucunda yüzde işareti bulunan bir çift eşleşen tek küme parantezi içinde yer alan herhangi bir içeriktir. Not: Buraya sözdizimi örneği eklemek, Makrolar eklentisinin bunu işleme almaya çalışmasına neden olur; örnekler için [Makrolar belgelerine]{1} bakın." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Özel bağlantılar**. Başlıkların ardından veya bazı içeriklerin üzerinde bulunurlar ve `{ #anchor }` biçiminde düzenlenirler." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Uyarı sözdizimi**. Aşağıdaki örnekte, \"uyarı\" kelimesi çevrilmemelidir. Bu, notlar, uyarılar vb. dahil olmak üzere tüm uyarı türleri için geçerlidir. İçeriğin geri kalanının çevirisiyle ilgili bilgiler için sonraki bölüme bakın." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1922,52 +1889,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Ters eğik çizgiler**. Bunlar ters eğik çizgi olarak kalmalıdır; hem satır içi kodları hem de kod bloklarını biçimlendirmek için kullanılırlar." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**Harici içeriği dahil etmek için kullanılan sözdizimi**. Bu, `-8<-` ile aynı satırda veya ayrı satırlarda iki `-8<-` arasında bulunan her şeydir." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "Aşağıdaki öğeler *çevrilmelidir*:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Bağlantı metni**. Bağlantı sözdiziminde, metin URL'den önce gelir ve `[Link text](URL)` gibi köşeli parantezler içine alınır. Standart Markdown bağlantıları Weblate'te `[Link text]{1}` olarak görünmelidir; burada `1` diğer olası bağlantılara göre dizgedeki bağlantının konumudur." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Referans bağlantı metni**. Örneğin, `Link text` aşağıdaki şekilde çevrilir:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Uyarı başlıkları ve içeriği**. Önceki uyarı örneğinde, \"Sayfa Başlığı\" ve \"İçerik\" çevrilmelidir." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "İçerik çevirilerimiz için [Weblate]{1} kullanıyoruz. Yeni bir çeviri eklediğimizde, ilk çeviri denemesini yapmak için makine çevirisi için [DeepL]{2} kullanıyoruz. Bu, genellikle çevireceğiniz içeriğin zaten makine çevirisi yapılmış olduğu anlamına gelir. Sizden, çevirmen olarak, mevcut makine çevirisini gözden geçirip, düzenleyip ve iyileştirmeniz beklenir." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate her şeyi dize bazında işler. Değişiklikleri toplu olarak işler ve birkaç saatte bir, o aralıkta değişen tüm dizeleri içeren toplu bir gönderim yapar. Bu nedenle, değişikliklerinizin web sitesinde görünmesi birkaç saat sürebilir, ancak güncellemenin dört saat içinde görünmesini bekleyebilirsiniz." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Bu süreden sonra değişiklikleriniz hala görünmüyorsa, bunun muhtemel nedeni bir işaretleme hatasıdır ve bu da o dil için belgelerin oluşturulmasında bir hataya neden olur. Herhangi bir dizede bulunan herhangi bir işaretleme sorunu, çevirinin tamamının yayınlanmasını engeller. Dilinizin oluşturulma sayfasını takip ederek, oluşturma işleminin başarılı olup olmadığını görebilirsiniz. Bağlantı, Fransızca oluşturma sayfasına giden bu bağlantıya benzer şekilde biçimlendirilmiştir {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; uygun derleme sayfasını görüntülemek için dil kodunu kendi dilinize değiştirin. Bu, sitenin en son derleme durumunu gösterecektir. Derleme başarısız olursa, derleme günlüğüne bakın ve sorunun kaynağını belirleyip belirleyemeyeceğinize bakın." @@ -2371,36 +2338,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "Belgeyi `docs/en` dizinindeki uygun konumda oluşturmanız gerekir. Tartışma için, `new_doc.md` dosya adıyla yeni bir belge eklediğinizi varsayalım." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "Ardından, yeni dosyanızı eklemek için `docs/en/SUMMARY.md` dosyasını güncellemeniz gerekir. `SUMMARY.md` temel olarak `docs/en` dizin yapısını yansıtacak şekilde düzenlenmiştir, ancak daha da önemlisi, sol kenar çubuğunun yapısını doğrudan belirler. `new_doc.md` eklemek istediğiniz bölümü bulursanız, joker karakter içeren bir yol listeleniyorsa `SUMMARY.md` içinde herhangi bir değişiklik yapmanız gerekmez. Örneğin:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./dizin/yolu/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "`new_doc.md` eklemek istediğiniz bölüm, tek tek Markdown bağlantılarının bir listesi ise, bağlantınıza açık bir bağlantı eklemeniz gerekir. Örneğin:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [Yeni belgem](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "Dokümantasyonunuzu yazma" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "Artık istediğiniz dosyayı editörünüzde açabilir ve yazmaya başlayabilirsiniz." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "BeeWare için dokümantasyon yazma kurallarımızı özetleyen bir [dokümantasyon stil kılavuzu]{1} bulunmaktadır." @@ -3170,8 +3135,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Bu kılavuz, yeni içerik yazma ve mevcut içeriği çevirme ile ilgili olarak beklenen stil, MkDocs'a özgü sözdizimi, çeşitli gerekli araçlar ve dokümantasyon çevirisi hakkında bilgiler içerir." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Bu kılavuz, yeni içerik yazma ve mevcut içeriği çevirme ile ilgili olarak beklenen stil, Zensical'a özgü sözdizimi, çeşitli gerekli araçlar ve dokümantasyon çevirisi hakkında bilgiler içerir." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3230,8 +3195,8 @@ msgstr "Mümkün olduğunda belgelerdeki içeriği çapraz referanslamalısını #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs, standart Markdown biçimli bağlantıları görüntüler. Standart Markdown biçimli web hiper bağlantıları aşağıdaki gibidir:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical, standart Markdown biçimli bağlantıları görüntüler. Standart Markdown biçimli web hiper bağlantıları aşağıdaki gibidir:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3250,8 +3215,8 @@ msgstr "[Bağlantı metni](dosya.md'nin yolu)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Dosyaların belirli bölümlerine veya API belgelerine referans vermek için MkDocs referans bağlantı formatını kullanmanız gerekir." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Dosyaların belirli bölümlerine veya API belgelerine referans vermek için Zensical referans bağlantı formatını kullanmanız gerekir." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3265,13 +3230,13 @@ msgstr "Markdown, başlığın içeriğine göre tüm başlıklar için (bir sat #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs, değiştirilmiş Markdown bağlantısı kullanarak belgedeki çeşitli diğer öğelere bağlantı vermenizi sağlayan bir referans bağlantı sözdiziminin oluşturulmasını destekler. Bu, diğer şeylerin yanı sıra, özel Markdown başlıklarına ve metin bağlantılarına bağlantı vermeyi de içerir." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical, değiştirilmiş Markdown bağlantısı kullanarak belgedeki çeşitli diğer öğelere bağlantı vermenizi sağlayan bir referans bağlantı sözdiziminin oluşturulmasını destekler. Bu, diğer şeylerin yanı sıra, özel Markdown başlıklarına ve metin bağlantılarına bağlantı vermeyi de içerir." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "MkDocs referans bağlantıları, aşağıdaki şekilde biçimlendirilmiş tüm bağlantılardır:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Zensical referans bağlantıları, aşağıdaki şekilde biçimlendirilmiş tüm bağlantılardır:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3285,8 +3250,8 @@ msgstr "/// warning | Özel başlık ve içerik bağlantıları gereklidir" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "BeeWare belgelerinde MkDocs referans bağlantısı aracılığıyla metin içeriğinde referans verilen herhangi bir başlık veya içerik bölümüne özel bir bağlantı eklenmelidir. Aksi takdirde, başlık içeriği çevrildiğinde bağlantılar bozulabilir." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "BeeWare belgelerinde Zensical referans bağlantısı aracılığıyla metin içeriğinde referans verilen herhangi bir başlık veya içerik bölümüne özel bir bağlantı eklenmelidir. Aksi takdirde, başlık içeriği çevrildiğinde bağlantılar bozulabilir." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3345,8 +3310,8 @@ msgstr "[Bağlantı metni](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "Ayrı bir belgedeki bir bağlantıya bağlanmak için MkDocs referans bağlantı stili kullanılır. Bu stil aşağıdaki şekilde biçimlendirilir:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "Ayrı bir belgedeki bir bağlantıya bağlanmak için Zensical referans bağlantı stili kullanılır. Bu stil aşağıdaki şekilde biçimlendirilir:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3360,8 +3325,8 @@ msgstr "API referans bağlantıları" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "MkDocs referans bağlantısı, belgelenmiş sınıflar, sınıf yöntemleri veya öznitelikler ve belirli harici belgeleme referansları dahil olmak üzere API belgelerinin çapraz referanslamasını da destekler." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Zensical referans bağlantısı, belgelenmiş sınıflar, sınıf yöntemleri veya öznitelikler ve belirli harici belgeleme referansları dahil olmak üzere API belgelerinin çapraz referanslamasını da destekler." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3936,8 +3901,8 @@ msgstr "BeeWare Docs Tools paylaşılan içeriğinden içerik eklemek için Makr #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "[Macros MkDocs eklentisi]{1} kullanarak BeeWare Docs araçlarının paylaşılan içerik dizininden içerik ekleyebilirsiniz. Bu yöntem, belge içinde yürütülmesi gereken Jinja yönergeleri varsa gereklidir ve yalnızca bu durumda kullanılmalıdır. URL aracılığıyla harici içerikle çalışmaz. [Macros değişken değiştirme mekanizması]{2} bu yöntemle çalışır." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "[Macros]{1} kullanarak BeeWare Docs araçlarının paylaşılan içerik dizininden içerik ekleyebilirsiniz. Bu yöntem, belge içinde yürütülmesi gereken Jinja yönergeleri varsa gereklidir ve yalnızca bu durumda kullanılmalıdır. URL aracılığıyla harici içerikle çalışmaz. [Macros değişken değiştirme mekanizması]{2} bu yöntemle çalışır." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4447,8 +4412,8 @@ msgstr "Dokümantasyon formları { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "{{ formal_name }}'nin belgeleri [MkDocs ve Markdown]{1} kullanılarak yazılmıştır. Belgeleri yapılandırmak için [Diataxis]{2} çerçevesini takip etmeyi hedefliyoruz." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "{{ formal_name }}'nin belgeleri [Zensical]{1} ve [Markdown]{2} kullanılarak yazılmıştır. Belgeleri yapılandırmak için [Diataxis]{3} çerçevesini takip etmeyi hedefliyoruz." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/uk/translations.po b/src/beeware_docs_tools/shared_content/locales/uk/translations.po index 6acb8bb5..62612ff6 100644 --- a/src/beeware_docs_tools/shared_content/locales/uk/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/uk/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -363,7 +363,7 @@ msgstr "У будь-якому згадуванні назви продукту msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Якщо термін використовується «як код», його слід взяти в лапки як літерал (`like this`), а не додавати до словника." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 #, fuzzy msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1631,8 +1631,8 @@ msgstr "Якщо мова, з якою ви плануєте допомагат #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Створіть файл `/docs/mkdocs.language-code.yml`, у якому буде вміст, специфічний для певної мови." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "Створіть файл `/docs/zensical.language-code.toml`, у якому буде вміст, специфічний для певної мови." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1641,8 +1641,8 @@ msgstr "Оновіть `tox.ini` з метою включення нових к #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "Оновіть `/docs/config.yml`, щоб додати мову до `extra: alternate:`." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "Оновіть `/docs/zensical.toml`, щоб додати мову до `extra.alternate`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1651,54 +1651,35 @@ msgstr "Нижче наведено необхідні зміни на прик #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "Новий файл конфігурації MkDocs" +msgid "A new language configuration file" +msgstr "Новий файл конфігурації Zensical" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "Спочатку створіть у каталозі `mkdocs.de.yml` новий файл із назвою `docs`, вміст якого має бути таким:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "Спочатку створіть у каталозі `zensical.de.toml` новий файл із назвою `docs`, вміст якого має бути таким:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Документація\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Про\n" -" Documentation: Документація\n" -" Community: Спільнота\n" -" Contributing: Участь\n" -" News: Новини\n" -" Sponsor: Спонсори" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1706,9 +1687,8 @@ msgid "Here's what is going on in this file:" msgstr "Ось що відбувається в цьому файлі:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Цей файл успадковує вміст конфігурації з `config.yml`." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1717,201 +1697,188 @@ msgstr "Значення `site_name` перекладено." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "Значення `site_url` — це URL-адреса сайту проєкту, за якою йде код мови." +msgid "The `docs_dir` should be the language code." +msgstr "У `docs_dir` має бути вказано код мови." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "У `docs_dir` має бути вказано код мови." +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "Значенням `theme.language` має бути код мови, як [зазначено в темі Zensical]{1}. Для більшості мов це значення збігатиметься з кодом мови `docs_dir`, але для деяких (зокрема, для мов із варіантами локалі, таких як `zh_CN`), існують відмінності." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "Значенням `theme: language:` має бути код мови, як [зазначено в темі MkDocs Material]{1}. Для більшості мов це значення збігатиметься з кодом мови `docs_dir`, але для деяких (зокрема, для мов із варіантами локалі, таких як `zh_CN`), існують відмінності." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "У `extra.language_url` має бути вказано код мови, за яким слідує одна коса риска, наприклад, `de/` для німецької мови." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "У `extra: language_url:` має бути вказано код мови, за яким слідує одна коса риска, наприклад, `de/` для німецької мови." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "Значення `extra.translation_type` має залишатися `machine` доти, доки переклад вперше не досягне 100%; після цього воно має стати `human`. Якщо рівень перекладу знизиться нижче 90%, значення `machine` знову зміниться на `human`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "Значення `extra: translation_type:` має залишатися `machine` доти, доки переклад вперше не досягне 100%; після цього воно має стати `human`. Якщо рівень перекладу знизиться нижче 90%, значення `machine` знову зміниться на `human`." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "Вміст у блоці `extra: header` — це переклади заголовків, що відображаються у верхній панелі. Це визначення *не* є обов’язковим на головному веб-сайті BeeWare; воно потрібне лише на *інших* сайтах (наприклад, у посібнику або документації до проєкту)." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "Вміст у блоці `extra.header` — це переклади заголовків, що відображаються у верхній панелі. Це визначення *не* є обов’язковим на головному веб-сайті BeeWare; воно потрібне лише на *інших* сайтах (наприклад, у посібнику або документації до проєкту)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "Оновлення `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "Вам потрібно буде внести кілька змін у файл `tox.ini`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "Вам слід додати таке:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "Новий прапор коду мови слід додати до рядка заголовка, що починається з `[testenv:docs`, причому код мови повинен передувати символу `-`, без пробілів, наприклад `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "Нове виключення коду мови для першої команди, яка починається з `!lint`, перед якою стоїть `-!`, без пробілів, наприклад `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "Новий мовний код у рядку, що починається з `translate : build_po_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "Новий мовний код у рядку, що починається з `translate : update_machine_translations`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "Нова команда, що починається, наприклад, з `de : build_md_translations` для німецької мови, розміщена в алфавітному порядку серед існуючих команд для конкретної мови, яка відповідає змісту цих команд, із новим кодом мови." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "Новий мовний код у рядку, що починається з `all:`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "Оновлення `config.yml`" +msgid "Update `zensical.toml`" +msgstr "Оновлення `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Додайте мову до `config.yml`, щоб вона з’явилася у меню вибору мови в заголовку. Знайдіть розділ, що починається з `extra:`, а потім знайдіть підрозділ, що починається з `alternate:`. Для німецької мови потрібно додати таке:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- name: Німецька\n" -" link: /de/\n" -" lang: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "Назва мови має бути перекладена на цю мову. Посилання має містити символи `/`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "Виконати `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Тепер ви можете запустити `tox -e docs-translate`. Це створить порожній файл перекладу; якщо у вас є обліковий запис DeepL, ви можете використати його для заповнення початкових машинних перекладів. Якщо у вас немає облікового запису DeepL, це не проблема — ми самі виконаємо початкові переклади перед тим, як прийняти запит на злиття." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "Рекомендації щодо перекладу" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "Як тільки вас додадуть до команди, настав час увійти в [Weblate]{1} і приступити до перекладу рядків." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "Переклад, що передає загальний зміст, проти дослівного перекладу" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "Важливіше зберегти стиль англійського тексту, ніж прагнути до дослівного перекладу. У наших матеріалах ми намагаємося використовувати дружній та дещо розмовний стиль; постарайтеся зберегти цей дух у своїх перекладах." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "Якщо англійський текст містить виразну англійську ідіому, не вважайте за обов’язок зберігати її, якщо у вашій мові є аналог, який підійде не гірше. Якщо термін або фраза в англійському тексті є особливо ідіоматичним або сленговим, не соромтеся повідомити нам, що варто розглянути можливість внесення змін. Навіть для носіїв англійської мови ідіоми та сленг можуть становити певну складність. Іноді нам доводиться змінювати англійський текст, щоб зробити його зрозумілішим як для перекладачів, так і для читачів." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "Чи варто мені це перекласти?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "Наступні елементи *не* слід перекладати чи оновлювати:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Команди**. Наприклад, у реченні «You should run \\`briefcase create\\`.» слід перекласти лише частину «You should run»." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Простори імен**, такі як імена класів, методів або атрибутів." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**URL-адреси посилань**. Стандартні посилання у форматі Markdown повинні відображатися в Weblate у вигляді `[Link text]{1}`, де `1` — це позиція посилання в рядку відносно інших можливих посилань. Якщо повна URL-адреса вказана в рядку у вигляді `[Link text](https://example.com/)`, її слід пропустити під час перекладу." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Посилання, що містять назви класів, методів або атрибутів**. Їх слід залишати без змін, включаючи зворотні лапки. Жодна частина наведеного тут прикладу посилання не перекладатиметься." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Class.attribute]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**Вміст посилання «Reference»**. Наприклад, у наведеному нижче прикладі `link-content` буде пропущено:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[Текст посилання][вміст посилання]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Директиви Jinja**. Це будь-який вміст, укладений у дві пари відповідних фігурних дужок або в одну пару фігурних дужок, у кожній з яких на початку та в кінці стоїть знак відсотка. Примітка: Включення прикладу синтаксису в цьому місці призведе до того, що плагін «Macros» спробує його відтворити; приклади див. у [документації до плагіна «Macros»]{1}." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Користувацькі анкори**. Вони розміщуються після заголовків або над певним вмістом і мають вигляд `{ #anchor }`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Синтаксис зауважень**. У наведеному нижче прикладі слово «зауваження» не слід перекладати. Це стосується всіх видів зауважень, зокрема приміток, попереджень тощо. Інформацію щодо перекладу решти тексту див. у наступному розділі." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1926,52 +1893,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Зворотні лапки**. Вони повинні залишатися зворотними лапками; їх використовують для форматування як вбудованого коду, так і блоків коду." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**Синтаксис для вставлення зовнішнього вмісту**. Це будь-що, що знаходиться в тому ж рядку, що й `-8<-`, або в рядках між двома символами `-8<-`, розташованими в окремих рядках." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "Наступні елементи *повинні* бути перекладені:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Текст посилання**. У синтаксисі посилань текст розміщується перед URL-адресою та береться в дужки, наприклад `[Link text](URL)`. Стандартні посилання у форматі Markdown повинні відображатися в Weblate у вигляді `[Link text]{1}`, де `1` позначає положення посилання в рядку відносно інших можливих посилань." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Текст посилання**. Наприклад, `Link text` перекладатиметься так:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Заголовки та вміст нагадувань**. У наведеному вище прикладі нагадування слід перекласти «Заголовок сторінки» та «Вміст»." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "Для перекладу наших матеріалів ми використовуємо [Weblate]{1}. Коли ми додаємо новий переклад, ми використовуємо [DeepL]{2} для машинного перекладу, щоб отримати попередній варіант перекладу. Це означає, що, як правило, матеріал, який ви будете перекладати, вже перекладено машиною. Очікується, що ви, як перекладач, перевірите, відредагуєте та вдосконалите існуючий машинний переклад." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate обробляє всі дані по черзі, рядок за рядком. Система об’єднує зміни в пакети, і кожні кілька годин відправляє масове оновлення, що містить усі рядки, які змінилися за цей проміжок часу. Тому може знадобитися кілька годин, перш ніж ваші зміни з’являться на веб-сайті, але, як правило, оновлення з’являється протягом чотирьох годин." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Якщо після закінчення цього часу ваші зміни все ще не з’явилися, ймовірною причиною є помилка у розмітці, що призвела до збою під час формування документації для цієї мови. Будь-яка проблема з розміткою в будь-якому рядку заблокує оприлюднення всього перекладу. Ви можете стежити за сторінкою збірки для вашої мови, щоб перевірити, чи збірка пройшла успішно. Посилання має такий самий формат, як і це посилання на сторінку збірки французької мови {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; замініть код мови на код вашої мови, щоб перейти на відповідну сторінку збірки. Там ви побачите стан останньої збірки сайту. Якщо збірка завершилася невдало, перегляньте журнал збірки та спробуйте визначити джерело проблеми." @@ -2375,36 +2342,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "Вам потрібно створити документ у відповідній папці каталогу `docs/en`. Для прикладу припустимо, що ви додаєте новий документ з іменем `new_doc.md`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "Далі вам потрібно буде оновити файл `docs/en/SUMMARY.md`, щоб додати до нього ваш новий файл. Файл `SUMMARY.md` побудований таким чином, щоб, по суті, віддзеркалювати структуру каталогів `docs/en`, але, що важливіше, він безпосередньо визначає структуру лівої бічної панелі. Якщо ви знайдете розділ, куди плануєте додати `new_doc.md`, вам не потрібно нічого змінювати у файлі `SUMMARY.md`, якщо там вказано шлях із символами-замінниками. Наприклад:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./шлях/до/каталогу/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "Якщо розділ, у який ви плануєте вставити `new_doc.md`, є списком окремих посилань у форматі Markdown, вам потрібно буде додати явне посилання на ваше посилання. Наприклад:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [Мій новий документ](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "Складання документації" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "Тепер ви можете відкрити потрібний файл у редакторі та почати писати." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "У нас є [посібник зі стилю документації]{1}, в якому викладено наші рекомендації щодо написання документації для BeeWare." @@ -3175,8 +3140,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Цей посібник містить інформацію щодо рекомендованого стилю, синтаксису, характерного для MkDocs, різних необхідних інструментів та перекладу документації, що стосується створення нового контенту та перекладу існуючого контенту." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Цей посібник містить інформацію щодо рекомендованого стилю, синтаксису, характерного для Zensical, різних необхідних інструментів та перекладу документації, що стосується створення нового контенту та перекладу існуючого контенту." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3235,8 +3200,8 @@ msgstr "Слід, по можливості, вказувати перехрес #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs відображає посилання, відформатовані за стандартом Markdown. Веб-гіперпосилання, відформатовані за стандартом Markdown, мають такий вигляд:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical відображає посилання, відформатовані за стандартом Markdown. Веб-гіперпосилання, відформатовані за стандартом Markdown, мають такий вигляд:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3255,8 +3220,8 @@ msgstr "[Текст посилання](шлях/до/файлу.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Для посилання на конкретні розділи файлів або документацію API необхідно використовувати формат посилань MkDocs." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Для посилання на конкретні розділи файлів або документацію API необхідно використовувати формат посилань Zensical." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3270,13 +3235,13 @@ msgstr "Markdown генерує анкори для всіх заголовкі #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs підтримує відображення синтаксису посилань на елементи, що дозволяє створювати посилання на різні інші елементи в документації за допомогою модифікованого посилання Markdown. Це, зокрема, включає створення посилань на користувацькі заголовки Markdown та текстові анкори." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical підтримує відображення синтаксису посилань на елементи, що дозволяє створювати посилання на різні інші елементи в документації за допомогою модифікованого посилання Markdown. Це, зокрема, включає створення посилань на користувацькі заголовки Markdown та текстові анкори." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "Посилання на довідку MkDocs — це будь-які посилання, оформлені у такому вигляді:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Посилання на довідку Zensical — це будь-які посилання, оформлені у такому вигляді:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3290,8 +3255,8 @@ msgstr "/// warning | Необхідно вказати власні анкор #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "Будь-який заголовок або розділ вмісту, на який у текстовому вмісті посилається посилання MkDocs у документації BeeWare, _повинен_ мати прив’язану власну прив’язку. В іншому разі існує ризик, що посилання перестануть працювати під час перекладу вмісту заголовка." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "Будь-який заголовок або розділ вмісту, на який у текстовому вмісті посилається посилання Zensical у документації BeeWare, _повинен_ мати прив’язану власну прив’язку. В іншому разі існує ризик, що посилання перестануть працювати під час перекладу вмісту заголовка." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3350,8 +3315,8 @@ msgstr "[Текст посилання](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "Для створення посилання на анкор у окремому документі використовується стиль посилання MkDocs, який має такий вигляд:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "Для створення посилання на анкор у окремому документі використовується стиль посилання Zensical, який має такий вигляд:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3365,8 +3330,8 @@ msgstr "Посилання на довідку щодо API" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "Функція посилань у довідці MkDocs також підтримує перехресні посилання на документацію API, зокрема на описані класи, методи класів або атрибути, а також на конкретні зовнішні джерела документації." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Функція посилань у довідці Zensical також підтримує перехресні посилання на документацію API, зокрема на описані класи, методи класів або атрибути, а також на конкретні зовнішні джерела документації." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3941,8 +3906,8 @@ msgstr "Використання макросів для вставлення в #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "Ви також можете включити вміст із каталогу спільного доступу інструментів BeeWare Docs за допомогою [плагіна Macros MkDocs]{1}. Цей метод необхідний, якщо документ містить директиви Jinja, які потрібно виконати, і його слід використовувати лише в цій ситуації. Він не працюватиме із зовнішнім вмістом, на який посилається URL-адреса. З цим методом сумісний [механізм заміни змінних Macros]{2}." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "Ви також можете включити вміст із каталогу спільного доступу інструментів BeeWare Docs за допомогою [Macros]{1}. Цей метод необхідний, якщо документ містить директиви Jinja, які потрібно виконати, і його слід використовувати лише в цій ситуації. Він не працюватиме із зовнішнім вмістом, на який посилається URL-адреса. З цим методом сумісний [механізм заміни змінних Macros]{2}." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4452,8 +4417,8 @@ msgstr "Форми документації { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "Документація {{ formal_name }} написана з використанням [MkDocs та Markdown]{1}. Ми прагнемо дотримуватися фреймворку [Diataxis]{2} для структурування документації." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "Документація {{ formal_name }} написана з використанням [Zensical]{1} та [Markdown]{2}. Ми прагнемо дотримуватися фреймворку [Diataxis]{3} для структурування документації." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/vi/translations.po b/src/beeware_docs_tools/shared_content/locales/vi/translations.po index 48617dc9..74a6d84a 100644 --- a/src/beeware_docs_tools/shared_content/locales/vi/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/vi/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -352,7 +352,7 @@ msgstr "Khi đề cập đến tên sản phẩm, cần tuân thủ quy tắc vi msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "Nếu một thuật ngữ được sử dụng \"như một đoạn mã\", thì nó nên được đặt trong dấu ngoặc kép (`like this`) thay vì được thêm vào từ điển." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 #, fuzzy msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1614,8 +1614,8 @@ msgstr "Nếu ngôn ngữ mà bạn dự định hỗ trợ chưa có sẵn, b #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "Tạo tệp `/docs/mkdocs.language-code.yml`, với nội dung dành riêng cho ngôn ngữ đó." +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "Tạo tệp `/docs/zensical.language-code.toml`, với nội dung dành riêng cho ngôn ngữ đó." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1624,8 +1624,8 @@ msgstr "Cập nhật `tox.ini` để bổ sung các lệnh xây dựng ngôn ng #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "Cập nhật `/docs/config.yml` để bao gồm ngôn ngữ trong `extra: alternate:`." +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "Cập nhật `/docs/zensical.toml` để bao gồm ngôn ngữ trong `extra.alternate`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1634,53 +1634,35 @@ msgstr "Phần sau đây trình bày các thay đổi cần thiết bằng cách #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "Một tệp cấu hình MkDocs mới" +msgid "A new language configuration file" +msgstr "Một tệp cấu hình Zensical mới" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "Đầu tiên, hãy tạo một tệp mới có tên `mkdocs.de.yml` trong thư mục `docs`, với nội dung như sau:" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "Đầu tiên, hãy tạo một tệp mới có tên `zensical.de.toml` trong thư mục `docs`, với nội dung như sau:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1688,9 +1670,8 @@ msgid "Here's what is going on in this file:" msgstr "Đây là những gì đang diễn ra trong tệp này:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "Tệp này kế thừa nội dung cấu hình từ `config.yml`." +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1699,199 +1680,187 @@ msgstr "Giá trị `site_name` đã được dịch." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "Giá trị `site_url` là URL của trang web dự án, kèm theo mã ngôn ngữ." +msgid "The `docs_dir` should be the language code." +msgstr "Dấu `docs_dir` phải là mã ngôn ngữ." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "Dấu `docs_dir` phải là mã ngôn ngữ." +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "Giá trị `theme.language` phải là mã ngôn ngữ, như [được quy định trong chủ đề Zensical]{1}. Đối với hầu hết các ngôn ngữ, giá trị này sẽ giống với mã ngôn ngữ `docs_dir`; nhưng đối với một số ngôn ngữ (đặc biệt là những ngôn ngữ có các biến thể vùng như `zh_CN`), sẽ có sự khác biệt." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "Giá trị `theme: language:` phải là mã ngôn ngữ, như [được quy định trong chủ đề MkDocs Material]{1}. Đối với hầu hết các ngôn ngữ, giá trị này sẽ giống với mã ngôn ngữ `docs_dir`; nhưng đối với một số ngôn ngữ (đặc biệt là những ngôn ngữ có các biến thể vùng như `zh_CN`), sẽ có sự khác biệt." +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "Dấu `extra.language_url` phải là mã ngôn ngữ, tiếp theo là một dấu gạch chéo, ví dụ: `de/` cho tiếng Đức." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "Dấu `extra: language_url:` phải là mã ngôn ngữ, tiếp theo là một dấu gạch chéo, ví dụ: `de/` cho tiếng Đức." +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "`extra.translation_type` sẽ giữ nguyên là `machine` cho đến khi bản dịch đạt 100% lần đầu tiên; khi đó, nó sẽ chuyển thành `human`. Nó sẽ quay trở lại `machine` từ `human` nếu tỷ lệ dịch giảm xuống dưới 90%." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "`extra: translation_type:` sẽ giữ nguyên là `machine` cho đến khi bản dịch đạt 100% lần đầu tiên; khi đó, nó sẽ chuyển thành `human`. Nó sẽ quay trở lại `machine` từ `human` nếu tỷ lệ dịch giảm xuống dưới 90%." - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "Nội dung trong `extra: header` là bản dịch của các tiêu đề xuất hiện trên thanh tiêu đề. Định nghĩa này *không* bắt buộc trên trang web chính của BeeWare; nó chỉ bắt buộc trên *các* trang web khác (chẳng hạn như trang hướng dẫn hoặc tài liệu dự án)." +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "Nội dung trong `extra.header` là bản dịch của các tiêu đề xuất hiện trên thanh tiêu đề. Định nghĩa này *không* bắt buộc trên trang web chính của BeeWare; nó chỉ bắt buộc trên *các* trang web khác (chẳng hạn như trang hướng dẫn hoặc tài liệu dự án)." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "Cập nhật `tox.ini`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "Bạn sẽ cần thực hiện một số thay đổi đối với tệp `tox.ini`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "Bạn sẽ thêm nội dung sau:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "Thêm cờ mã ngôn ngữ mới vào dòng tiêu đề bắt đầu bằng `[testenv:docs`, trong đó mã ngôn ngữ được đặt trước dấu `-`, không có khoảng trắng, ví dụ: `-de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "Quy tắc loại trừ mã ngôn ngữ mới đối với lệnh đầu tiên, bắt đầu bằng `!lint`, được đặt trước bởi `-!`, không có khoảng trắng, ví dụ: `-!de`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "Thêm mã ngôn ngữ mới vào dòng bắt đầu bằng `translate : build_po_translations`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "Thêm mã ngôn ngữ mới vào dòng bắt đầu bằng `translate : update_machine_translations`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "Một lệnh mới, bắt đầu bằng, ví dụ như `de : build_md_translations` cho tiếng Đức, được sắp xếp theo thứ tự bảng chữ cái trong danh sách các lệnh dành riêng cho ngôn ngữ hiện có và có nội dung tương ứng với các lệnh đó, kèm theo mã ngôn ngữ mới." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "Thêm mã ngôn ngữ mới vào dòng bắt đầu bằng `all:`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "Cập nhật `config.yml`" +msgid "Update `zensical.toml`" +msgstr "Cập nhật `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "Thêm ngôn ngữ vào `config.yml` để nó xuất hiện trong trình chọn ngôn ngữ ở đầu trang. Tìm phần bắt đầu bằng `extra:`, sau đó tìm phần con bắt đầu bằng `alternate:`. Đối với tiếng Đức, bạn cần thêm đoạn sau:" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "Tên ngôn ngữ cần được dịch sang ngôn ngữ đó. Liên kết phải bao gồm các dấu `/`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "Chạy `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "Bây giờ bạn có thể chạy `tox -e docs-translate`. Thao tác này sẽ tạo ra một tệp dịch trống; nếu bạn có tài khoản DeepL, bạn có thể sử dụng tài khoản đó để điền các bản dịch máy ban đầu. Nếu bạn không có tài khoản DeepL, cũng không sao — chúng tôi sẽ tự thực hiện các bản dịch ban đầu trước khi chấp nhận yêu cầu pull." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "Hướng dẫn dịch thuật" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "Sau khi bạn đã được thêm vào nhóm, đã đến lúc đăng nhập vào [Weblate]{1} và bắt đầu dịch các chuỗi văn bản." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "Dịch theo ngữ cảnh so với dịch từng từ" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "Việc giữ nguyên giọng điệu của bản gốc tiếng Anh quan trọng hơn là cố gắng dịch từng từ một. Chúng tôi cố gắng viết nội dung một cách thân thiện và hơi mang tính khẩu ngữ; mong bạn cũng cố gắng giữ nguyên tinh thần đó trong bản dịch của mình." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "Nếu văn bản tiếng Anh chứa một thành ngữ tiếng Anh mang tính đặc trưng mạnh mẽ, đừng cảm thấy bắt buộc phải giữ nguyên thành ngữ đó nếu trong ngôn ngữ của bạn có một cách diễn đạt tương đương mà vẫn truyền tải ý nghĩa tốt không kém. Nếu thuật ngữ hoặc cụm từ trong văn bản tiếng Anh là một thành ngữ hoặc từ lóng đặc biệt, đừng ngần ngại đề xuất với chúng tôi rằng nên xem xét điều chỉnh. Ngay cả với người nói tiếng Anh, thành ngữ và từ lóng cũng có thể gây khó khăn. Đôi khi chúng tôi cần điều chỉnh văn bản tiếng Anh để làm cho nó dễ hiểu hơn cho cả người dịch lẫn người đọc." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "Tôi có nên dịch nó không?" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "Các mục sau đây *không* nên được dịch hoặc cập nhật:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**Lệnh**. Ví dụ, trong câu \"Bạn nên chạy \\`briefcase create\\`.\", chỉ phần \"Bạn nên chạy\" mới cần được dịch." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**Không gian tên**, chẳng hạn như tên lớp, phương thức hoặc thuộc tính." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**URL liên kết**. Các liên kết Markdown tiêu chuẩn nên được hiển thị trong Weblate dưới dạng `[Link text]{1}`, trong đó `1` là vị trí của liên kết trong chuỗi so với các liên kết khác có thể có. Nếu URL đầy đủ được bao gồm trong chuỗi, như `[Link text](https://example.com/)`, thì URL đó nên được bỏ qua khi dịch." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "**Các liên kết tham chiếu chứa tên lớp, phương thức hoặc thuộc tính**. Những liên kết này nên được giữ nguyên, bao gồm cả dấu gạch chéo ngược. Mọi phần của liên kết ví dụ được hiển thị ở đây sẽ không được dịch." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Class.attribute]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**Nội dung của một liên kết tham chiếu**. Ví dụ, `link-content` sẽ bị bỏ qua trong đoạn sau:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[Nội dung liên kết][link-content]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Hướng dẫn Jinja**. Đây là bất kỳ nội dung nào được bao bọc bởi hai cặp dấu ngoặc nhọn đối xứng, hoặc một cặp dấu ngoặc nhọn đơn đối xứng có chứa ký hiệu phần trăm ở mỗi đầu. Lưu ý: Việc đưa ví dụ về cú pháp vào đây sẽ khiến plugin Macros cố gắng hiển thị nó; hãy xem [tài liệu về Macros]{1} để tham khảo các ví dụ." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**Điểm neo tùy chỉnh**. Chúng thường xuất hiện sau các tiêu đề hoặc phía trên một số nội dung, và được định dạng dưới dạng `{ #anchor }`." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**Cấu trúc câu cảnh báo**. Trong ví dụ sau, từ \"cảnh báo\" không nên được dịch. Quy tắc này áp dụng cho tất cả các dạng cảnh báo, bao gồm chú thích, cảnh báo, v.v. Vui lòng tham khảo phần tiếp theo để biết thông tin về cách dịch phần nội dung còn lại." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1906,52 +1875,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**Dấu nháy đơn**. Chúng được thiết kế để hiển thị dưới dạng dấu nháy đơn; chúng được sử dụng để định dạng cả mã trong dòng và khối mã." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**Cú pháp để nhúng nội dung bên ngoài**. Đây là bất kỳ nội dung nào nằm trên cùng một dòng với `-8<-`, hoặc nằm trên các dòng nằm giữa hai cặp `-8<-` trên các dòng riêng biệt." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "Các mục sau đây *nên* được dịch:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**Văn bản liên kết**. Trong cú pháp liên kết, văn bản được đặt trước URL và được bao quanh bởi dấu ngoặc nhọn, như `[Link text](URL)`. Các liên kết Markdown tiêu chuẩn nên xuất hiện trong Weblate dưới dạng `[Link text]{1}`, trong đó `1` là vị trí của liên kết trong chuỗi văn bản so với các liên kết khác có thể có." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**Văn bản liên kết tham chiếu**. Ví dụ: `Link text` sẽ được dịch như sau:" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**Tiêu đề và nội dung của lời khuyên**. Trong ví dụ về lời khuyên trước đó, \"Tiêu đề trang\" và \"Nội dung\" cần được dịch." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "Chúng tôi sử dụng [Weblate]{1} để dịch nội dung. Khi thêm bản dịch mới, chúng tôi sử dụng [DeepL]{2} để dịch máy nhằm tạo ra bản dịch sơ bộ. Điều đó có nghĩa là, thông thường, nội dung mà bạn sẽ dịch đã được dịch máy sẵn. Chúng tôi mong rằng bạn, với tư cách là người dịch, sẽ rà soát, chỉnh sửa và hoàn thiện bản dịch máy hiện có." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate xử lý mọi thứ theo từng chuỗi. Hệ thống sẽ gom các thay đổi lại và cứ sau vài giờ, nó sẽ gửi một bản cập nhật hàng loạt bao gồm tất cả các chuỗi đã thay đổi trong khoảng thời gian đó. Do đó, có thể mất vài giờ để các thay đổi của bạn hiển thị trên trang web, nhưng bạn có thể mong đợi bản cập nhật sẽ xuất hiện trong vòng bốn giờ." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "Nếu sau khoảng thời gian đó, các thay đổi của bạn vẫn chưa hiển thị, nguyên nhân có thể là do lỗi định dạng, dẫn đến việc quá trình biên dịch tài liệu cho ngôn ngữ đó bị lỗi. Bất kỳ lỗi định dạng nào trong bất kỳ chuỗi văn bản nào cũng sẽ ngăn toàn bộ bản dịch được công khai. Bạn có thể theo dõi trang biên dịch của ngôn ngữ mình để xem liệu quá trình biên dịch đã thành công hay chưa. Liên kết được định dạng tương tự như liên kết này đến trang xây dựng tiếng Pháp {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; hãy thay đổi mã ngôn ngữ thành ngôn ngữ của bạn để xem trang xây dựng tương ứng. Điều này sẽ hiển thị trạng thái của bản xây dựng mới nhất của trang web. Nếu quá trình xây dựng thất bại, hãy xem nhật ký xây dựng và xem liệu bạn có thể xác định được nguyên nhân của vấn đề hay không." @@ -2353,35 +2322,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "Bạn cần tạo tài liệu tại vị trí thích hợp trong thư mục `docs/en`. Để tiện thảo luận, chúng ta sẽ giả định rằng bạn đang thêm một tài liệu mới có tên tệp là `new_doc.md`." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "Sau đó, bạn cần cập nhật tệp `docs/en/SUMMARY.md` để thêm tệp mới của bạn vào. Tệp `SUMMARY.md` được tổ chức sao cho phản ánh cơ bản cấu trúc thư mục `docs/en`, nhưng quan trọng hơn, nó quyết định trực tiếp cấu trúc của thanh bên trái. Nếu bạn tìm thấy phần mà bạn định thêm tệp `new_doc.md`, bạn không cần thay đổi bất cứ điều gì trong tệp `SUMMARY.md` nếu thấy đường dẫn có ký hiệu đại diện được liệt kê. Ví dụ:" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -msgid "- ./path/to/directory/*" -msgstr "- ./path/to/directory/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "Nếu phần mà bạn định chèn `new_doc.md` là một danh sách các liên kết Markdown riêng lẻ, bạn sẽ cần thêm một liên kết cụ thể đến liên kết của mình. Ví dụ:" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [Tài liệu mới của tôi](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "Viết tài liệu" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "Bây giờ bạn có thể mở tệp mong muốn trong trình soạn thảo của mình và bắt đầu viết." -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "Chúng tôi có một [hướng dẫn phong cách tài liệu]{1} nêu rõ các nguyên tắc về việc soạn thảo tài liệu cho BeeWare." @@ -3148,8 +3116,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "Hướng dẫn này bao gồm thông tin về phong cách được mong đợi, cú pháp đặc thù của MkDocs, các công cụ cần thiết và việc dịch tài liệu, liên quan đến việc viết nội dung mới và dịch nội dung hiện có." +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "Hướng dẫn này bao gồm thông tin về phong cách được mong đợi, cú pháp đặc thù của Zensical, các công cụ cần thiết và việc dịch tài liệu, liên quan đến việc viết nội dung mới và dịch nội dung hiện có." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3208,8 +3176,8 @@ msgstr "Bạn nên tham chiếu chéo nội dung trong tài liệu bất cứ kh #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs hiển thị các liên kết được định dạng theo chuẩn Markdown. Các liên kết web được định dạng theo chuẩn Markdown như sau:" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical hiển thị các liên kết được định dạng theo chuẩn Markdown. Các liên kết web được định dạng theo chuẩn Markdown như sau:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3228,8 +3196,8 @@ msgstr "[Văn bản liên kết](path/to/file.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "Để trích dẫn các phần cụ thể trong tệp hoặc tài liệu API, bạn cần sử dụng định dạng liên kết tham chiếu của MkDocs." +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "Để trích dẫn các phần cụ thể trong tệp hoặc tài liệu API, bạn cần sử dụng định dạng liên kết tham chiếu của Zensical." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3243,13 +3211,13 @@ msgstr "Markdown tạo các liên kết neo cho tất cả các tiêu đề (b #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs hỗ trợ hiển thị cú pháp liên kết tham chiếu, cho phép bạn liên kết đến các thành phần khác nhau trong tài liệu bằng cách sử dụng liên kết Markdown đã được điều chỉnh. Điều này bao gồm việc liên kết đến, trong số những thứ khác, các tiêu đề Markdown tùy chỉnh và các điểm neo văn bản." +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical hỗ trợ hiển thị cú pháp liên kết tham chiếu, cho phép bạn liên kết đến các thành phần khác nhau trong tài liệu bằng cách sử dụng liên kết Markdown đã được điều chỉnh. Điều này bao gồm việc liên kết đến, trong số những thứ khác, các tiêu đề Markdown tùy chỉnh và các điểm neo văn bản." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "Các liên kết tham khảo trong MkDocs là những liên kết được định dạng như sau:" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Các liên kết tham khảo trong Zensical là những liên kết được định dạng như sau:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3263,8 +3231,8 @@ msgstr "/// warning | Yêu cầu phải có tiêu đề tùy chỉnh và các li #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "Bất kỳ phần tiêu đề hoặc nội dung nào được trích dẫn trong nội dung văn bản thông qua liên kết tham chiếu MkDocs trong tài liệu BeeWare _phải_ được gắn một điểm neo tùy chỉnh. Nếu không, các liên kết có thể bị hỏng khi nội dung tiêu đề được dịch." +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "Bất kỳ phần tiêu đề hoặc nội dung nào được trích dẫn trong nội dung văn bản thông qua liên kết tham chiếu Zensical trong tài liệu BeeWare _phải_ được gắn một điểm neo tùy chỉnh. Nếu không, các liên kết có thể bị hỏng khi nội dung tiêu đề được dịch." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3323,8 +3291,8 @@ msgstr "[Nội dung liên kết](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "Để tạo liên kết đến một điểm neo trong một tài liệu khác, hãy sử dụng kiểu liên kết tham chiếu của MkDocs, được định dạng như sau:" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "Để tạo liên kết đến một điểm neo trong một tài liệu khác, hãy sử dụng kiểu liên kết tham chiếu của Zensical, được định dạng như sau:" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3338,8 +3306,8 @@ msgstr "Các liên kết tham khảo API" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "Tính năng liên kết tham chiếu của MkDocs cũng hỗ trợ liên kết chéo đến tài liệu API, bao gồm các lớp, phương thức lớp hoặc thuộc tính đã được tài liệu hóa, cũng như các tham chiếu đến tài liệu bên ngoài cụ thể." +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Tính năng liên kết tham chiếu của Zensical cũng hỗ trợ liên kết chéo đến tài liệu API, bao gồm các lớp, phương thức lớp hoặc thuộc tính đã được tài liệu hóa, cũng như các tham chiếu đến tài liệu bên ngoài cụ thể." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3912,8 +3880,8 @@ msgstr "Sử dụng Macro để chèn nội dung từ nội dung được chia s #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "Bạn cũng có thể chèn nội dung từ thư mục nội dung chia sẻ của các công cụ BeeWare Docs bằng cách sử dụng [tiện ích mở rộng Macros MkDocs]{1}. Phương pháp này là cần thiết nếu tài liệu chứa các chỉ thị Jinja cần được thực thi, và chỉ nên được sử dụng trong trường hợp này. Phương pháp này sẽ không hoạt động với nội dung bên ngoài thông qua URL. [Cơ chế thay thế biến của Macros]{2} hoạt động với phương pháp này." +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "Bạn cũng có thể chèn nội dung từ thư mục nội dung chia sẻ của các công cụ BeeWare Docs bằng cách sử dụng [Macros]{1}. Phương pháp này là cần thiết nếu tài liệu chứa các chỉ thị Jinja cần được thực thi, và chỉ nên được sử dụng trong trường hợp này. Phương pháp này sẽ không hoạt động với nội dung bên ngoài thông qua URL. [Cơ chế thay thế biến của Macros]{2} hoạt động với phương pháp này." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4423,8 +4391,8 @@ msgstr "Mẫu đơn { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "Tài liệu của {{ formal_name }} được viết bằng [MkDocs và Markdown]{1}. Chúng tôi hướng đến việc tuân theo khung [Diataxis]{2} để tổ chức cấu trúc tài liệu." +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "Tài liệu của {{ formal_name }} được viết bằng [Zensical]{1} và [Markdown]{2}. Chúng tôi hướng đến việc tuân theo khung [Diataxis]{3} để tổ chức cấu trúc tài liệu." #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/zh_CN/translations.po b/src/beeware_docs_tools/shared_content/locales/zh_CN/translations.po index 586a4ce1..3366d1d0 100644 --- a/src/beeware_docs_tools/shared_content/locales/zh_CN/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/zh_CN/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: 2026-07-15 07:01+0000\n" "Last-Translator: reducedradius <137701630+flytothehighest@users.noreply.github.com>\n" "Language-Team: Chinese (Simplified Han script) <https://hosted.weblate.org/projects/beeware/docs-tools-shared-content/zh_Hans/>\n" @@ -304,7 +304,7 @@ msgstr "任何对产品名称的引用都应使用该产品的首选大写方式 msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "如果一个术语被“作为代码”使用，那么它就应该作为字面格式（`像这样`）被引用，而不是被添加到拼写词典中。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1495,8 +1495,8 @@ msgstr "如果您计划提供帮助的语言还不存在，那么在开始之前 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "创建包含特定语言内容的 `/docs/mkdocs.language-code.yml` 文件。" +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "创建包含特定语言内容的 `/docs/zensical.language-code.toml` 文件。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1505,8 +1505,8 @@ msgstr "更新 `tox.ini` 以包含新的语言构建命令。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "更新 `/docs/config.yml`，在 `extra: alternate:` 中包含语言。" +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "更新 `/docs/zensical.toml`，在 `extra.alternate` 中包含语言。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1515,54 +1515,35 @@ msgstr "下面以德语为例说明必要的更改；德语翻译已经存在； #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "新的 MkDocs 配置文件" +msgid "A new language configuration file" +msgstr "新的 Zensical 配置文件" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "首先，在 `docs` 目录中新建一个名为 `mkdocs.de.yml` 的文件，内容如下：" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "首先，在 `docs` 目录中新建一个名为 `zensical.de.toml` 的文件，内容如下：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} 文档\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: 关于\n" -" Documentation: 文档\n" -" Community: 社区\n" -" Contributing: 贡献\n" -" News: 新闻\n" -" Sponsor: 赞助商" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1570,9 +1551,8 @@ msgid "Here's what is going on in this file:" msgstr "下面是这个文件的内容：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "该文件继承了 `config.yml` 中的配置内容。" +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1581,201 +1561,186 @@ msgstr "网站名称 \"值将被翻译。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "site_url \"值是项目网站的 URL，后面是语言代码。" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 -#, fuzzy msgid "The `docs_dir` should be the language code." msgstr "docs_dir \"应为语言代码。" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "" + #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "theme:language:`值应该是[MkDocs Material theme指定的]{1}语言代码。对于大多数语言来说，这与 `docs_dir` 语言代码相同；但对于某些语言（尤其是像 `zh_CN` 这样有本地化变体的语言）来说，则存在差异。" +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "`extra.language_url` 应为语言代码，后跟单斜杠，例如 `de/` 表示德语。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 -#, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "`extra: language_url:` 应为语言代码，后跟单斜杠，例如 `de/` 表示德语。" +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "在翻译首次达到 100% 之前，\"extra: translation_type: \"应为 \"machine\"，此时应为 \"human\"。如果低于 90%，它将从 \"人 \"返回到 \"机器\"。" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "`extra: header` 下的内容是标题栏中显示的标题的翻译。此定义在 BeeWare 官网上*不需要*；仅在*其他*网站（如教程或项目文档）上需要。" +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "`extra.header` 下的内容是标题栏中显示的标题的翻译。此定义在 BeeWare 官网上*不需要*；仅在*其他*网站（如教程或项目文档）上需要。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "更新 `tox.ini" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "您需要对 `tox.ini` 文件进行几处修改。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "您可以添加以下内容：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "新语言代码环境标志到以 `[testenv:docs`]开头的页眉行，语言代码前加 `-`，不含空格，例如 `-de`。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "新语言代码不包括第一条命令，该命令以 `!lint` 开头，前面加上 `-!`，不含空格，例如 `-!de`。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "新语言代码对应以`translate : build_po_translations`开头的行。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "从 `translate : update_machine_translations` 开头的行开始的新语言代码" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "新增命令，例如以 `de : build_md_translations` 开头（代表德语），在现有语言专属命令中按字母顺序排列，其内容需与现有命令匹配，并使用新的语言代码。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "新语言代码对应以`all:`开头的行。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "更新 `config.yml`" +msgid "Update `zensical.toml`" +msgstr "更新 `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "将语言添加到 `config.yml` 中，使其显示在页眉的语言选择器中。找到以 `extra:` 开头的部分，然后找到以 `alternate:` 开头的小节。对于德语，您可以添加以下内容：" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- name: 德语\n" -" link: /de/\n" -" lang: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "语言名称应翻译成该语言。链接必须包括 `/`。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "运行 `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "现在您可以运行`tox -e docs-translate`命令。这将生成一个空的翻译文件；如果您拥有DeepL账户，可使用该账户填充初始机器翻译内容。若您没有DeepL账户也无妨——在接受拉取请求前，我们会自行执行初始翻译。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "翻译指南" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "加入团队后，您就可以登录 [Weblate]{1} 并开始翻译字符串。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "语气翻译与逐字翻译" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "保持英文文本的语气比一字不差地翻译更重要。我们在内容上尽量友好，有点口语化；在翻译中尽量保持这种精神。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "如果英文文本中包含一个很强的英语习惯用语，如果您的语言中也有类似的习惯用语，请不要觉得必须保留该习惯用语。如果英文文本中的术语或短语是一个特别成语或俚语，不要害怕告诉我们应该考虑进行修改。即使对英语使用者来说，成语和俚语也会造成困难。有时，我们需要对英文文本进行修改，以便让译者和读者都能更直观地理解。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "我应该翻译吗？" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "以下项目*不应*进行翻译或更新：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**命令**。例如，在 \"You should run \\`briefcase create\\`.\" 中，只需翻译 \"You should run\"。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**命名空间**，例如类名、方法名或属性名。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**链接 URL**。标准 Markdown 链接在 Weblate 中应显示为 `[Link text]{1}`，其中 `1` 表示该链接在字符串中相对于其他可能链接的位置。如果字符串中包含完整的 URL（如 `[Link text](https://example.com/)`），则应跳过该 URL 不进行翻译。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "** 包含类名、方法名或属性名的引用链接**。这些链接应保持原样，包括反标。此处所示示例链接的每一部分都不会被翻译。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][类.属性]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**引用链接的链接内容**。例如，在以下内容中，`link-content` 将被跳过：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[链接文本][链接内容]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**忍者指令**。这是指包在两对匹配的大括号内的任何内容，或一对匹配的单个大括号内的任何内容，两端均带有百分号。注：在此处包含语法示例会导致 Macros 插件尝试呈现该语法；有关示例，请参阅 [Macros 文档]{1}。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "**自定义锚点**。它们位于标题之后或某些内容之上，格式为 `{ #anchor }`。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**训诫语法**。在下面的例子中，\"训诫 \"一词不应翻译。这适用于所有类型的训诫，包括注释、警告等。有关翻译其余内容的信息，请参阅下一节。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1790,52 +1755,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**反标**。它们应保持为反标；用于格式化内联代码和代码块。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**包含外部内容的语法**。这是指与 `-8<-` 在同一行的任何内容，或在两个独立行的 `-8<-` 之间的任何内容。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "以下项目*应*进行翻译：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "**链接文本**。在链接语法中，文本位于URL之前，并用括号括起来，如`[链接文本](URL)`。标准的Markdown链接在Weblate中应显示为`[链接文本]{1}`，其中`1`是链接在字符串中的位置，与其他可能的链接相对应。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**参考链接文本**。例如，`Link text`将在以下内容中被翻译：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**告诫标题和内容**。在前面的训诫示例中，应翻译 \"页面标题 \"和 \"内容\"。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "网络版" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "我们使用 [Weblate]{1} 进行内容翻译。当我们添加新的翻译时，我们会使用 [DeepL]{2} 进行机器翻译，以生成第一遍翻译。这意味着，通常情况下，您要翻译的内容已经过机器翻译。我们希望您作为译员能够审阅、编辑和改进现有的机器翻译。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate 以字符串为单位处理所有内容。它对更改进行批量处理，每隔几个小时就会提交一次批量提交，其中包括在该时间段内更改过的所有字符串。因此，您的更改可能需要几个小时才能显示在网站上，但您可以期待更新在四个小时内出现。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "若在此之后您的修改仍未显示，很可能是标记错误导致该语言的文档构建失败。任何字符串中的标记问题都会阻碍整个翻译版本的发布。您可随时查看您语言的构建页面，确认是否构建成功。 链接格式与法语构建页面类似：{% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; 将语言代码替换为您对应的语言代码即可查看该语言的构建页面。该页面将显示网站最近一次构建的状态。若构建失败，请查阅构建日志以定位问题根源。" @@ -2239,36 +2204,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "您需要在 `docs/en` 目录中的适当位置创建文档。为了便于讨论，我们假设你要添加一个文件名为 `new_doc.md` 的新文档。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "然后，你需要更新 `docs/en/SUMMARY.md` 文件以包含你的新文件。`SUMMARY.md` 的组织结构基本上反映了 `docs/en` 目录的结构，但更重要的是，它直接决定了左侧边栏的结构。如果您找到了打算包含 `new_doc.md` 的部分，如果看到列出的通配符路径，则无需更改 `SUMMARY.md` 中的任何内容。例如" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./路径/到/目录/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "如果您打算包含 `new_doc.md` 的部分是一个单独的 Markdown 链接列表，您需要为您的链接添加一个明确的链接。例如" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [我的新文档](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "编写文件" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "现在，您可以在编辑器中打开所需的文件，开始写作。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "我们有一份[文档风格指南]{1}，概述了我们为 BeeWare 编写文档的指导方针。" @@ -3037,8 +3000,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "本指南包括有关编写新内容和翻译现有内容的预期风格、MkDocs 特定语法、各种所需工具和文档翻译的信息。" +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "本指南包括有关编写新内容和翻译现有内容的预期风格、Zensical 特定语法、各种所需工具和文档翻译的信息。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3097,8 +3060,8 @@ msgstr "应尽可能交叉引用文档中的内容。本节将介绍各种交叉 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs 可渲染标准 Markdown 格式的链接。标准 Markdown 格式的网络超链接如下：" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical 可渲染标准 Markdown 格式的链接。标准 Markdown 格式的网络超链接如下：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3117,8 +3080,8 @@ msgstr "[链接文本](path/to/file.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "引用文件的特定部分或 API 文档需要使用 MkDocs 引用链接格式。" +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "引用文件的特定部分或 API 文档需要使用 Zensical 引用链接格式。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3132,13 +3095,13 @@ msgstr "Markdown 会根据标题的内容为所有标题（单行中以 1 到 6 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs 支持呈现引用链接语法，允许您使用修改后的 Markdown 链接来链接文档中的各种其他元素。这包括链接到自定义 Markdown 标题和文本锚点等。" +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical 支持呈现引用链接语法，允许您使用修改后的 Markdown 链接来链接文档中的各种其他元素。这包括链接到自定义 Markdown 标题和文本锚点等。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "MkDocs 引用链接是格式如下的任何链接：" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Zensical 引用链接是格式如下的任何链接：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3152,8 +3115,8 @@ msgstr "/// warning |需要自定义标题和内容锚点" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "任何通过 BeeWare 文档中的 MkDocs 引用链接在文本内容中引用的页眉或内容部分都必须附加自定义锚点。否则，在翻译页眉内容时可能会破坏链接。" +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "任何通过 BeeWare 文档中的 Zensical 引用链接在文本内容中引用的页眉或内容部分都必须附加自定义锚点。否则，在翻译页眉内容时可能会破坏链接。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3212,8 +3175,8 @@ msgstr "[链接文本](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "使用 MkDocs 引用链接样式链接到单独文档中的锚点，其格式如下：" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "使用 Zensical 引用链接样式链接到单独文档中的锚点，其格式如下：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3227,8 +3190,8 @@ msgstr "应用程序接口参考链接" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "MkDocs 引用链接还支持交叉引用 API 文档，包括文档中的类、类方法或属性，以及特定的外部文档引用。" +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Zensical 引用链接还支持交叉引用 API 文档，包括文档中的类、类方法或属性，以及特定的外部文档引用。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3803,8 +3766,8 @@ msgstr "使用宏将 BeeWare 文档工具共享内容包含在内" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "您还可以使用 [Macros MkDocs 插件]{1}，从 BeeWare Docs 工具共享内容目录中添加内容。如果文档中包含需要执行的 Jinja 指令，则必须使用此方法，并且只能在这种情况下使用。该方法不适用于通过 URL 发送的外部内容。Macros 变量替换机制]{2} 与此方法配合使用。" +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "您还可以使用 [Macros]{1}，从 BeeWare Docs 工具共享内容目录中添加内容。如果文档中包含需要执行的 Jinja 指令，则必须使用此方法，并且只能在这种情况下使用。该方法不适用于通过 URL 发送的外部内容。Macros 变量替换机制]{2} 与此方法配合使用。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4313,8 +4276,8 @@ msgstr "文档表单 { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "{{ formal_name }} 的文档使用 [MkDocs 和 Markdown]{1} 编写。我们的目标是遵循 [Diataxis]{2} 框架来构建文档。" +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "{{ formal_name }} 的文档使用 [Zensical]{1} 和 [Markdown]{2} 编写。我们的目标是遵循 [Diataxis]{3} 框架来构建文档。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/src/beeware_docs_tools/shared_content/locales/zh_TW/translations.po b/src/beeware_docs_tools/shared_content/locales/zh_TW/translations.po index c59d448f..d57938ff 100644 --- a/src/beeware_docs_tools/shared_content/locales/zh_TW/translations.po +++ b/src/beeware_docs_tools/shared_content/locales/zh_TW/translations.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-11-03 09:52+0000\n" +"POT-Creation-Date: 2026-11-05 22:33-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -362,7 +362,7 @@ msgstr "任何對產品名稱的引用都應該使用該產品名稱的首字母 msgid "If a term is being used \"as code\", then it should be quoted as a literal (`like this`) rather than being added to the dictionary." msgstr "如果一個詞語是 「作為代碼 」使用的，那麼它應該被引用為字面意義（`like this`），而不是被添加到字典中。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:35 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/build-docs.md:241 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/propose-feature.md:31 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/reproduce-issue.md:34 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md:299 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-code.md:408 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:36 msgid "{% block end_matter %} {% endblock %}" msgstr "{% block end_matter %} {% endblock %}" @@ -1633,8 +1633,8 @@ msgstr "如果您打算幫忙的語言還未存在，在開始之前還需要一 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:21 #, fuzzy -msgid "Create the `/docs/mkdocs.language-code.yml` file, with language-specific content." -msgstr "建立 `/docs/mkdocs.language-code.yml` 檔案，其中包含特定語言的內容。" +msgid "Create the `/docs/zensical.language-code.toml` file, with language-specific content." +msgstr "建立 `/docs/zensical.language-code.toml` 檔案，其中包含特定語言的內容。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:22 #, fuzzy @@ -1643,8 +1643,8 @@ msgstr "更新 `tox.ini` 以包含新的語言建立指令。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:23 #, fuzzy -msgid "Update `/docs/config.yml` to include the language under `extra: alternate:`." -msgstr "更新 `/docs/config.yml`，將語言包含在 `extra: alternate:` 下。" +msgid "Update `/docs/zensical.toml` to include the language in `extra.alternate`." +msgstr "更新 `/docs/zensical.toml`，將語言包含在 `extra.alternate` 下。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:25 #, fuzzy @@ -1653,54 +1653,35 @@ msgstr "以下以德語為例，示範必要的變更；德語翻譯版已經存 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:27 #, fuzzy -msgid "A new MkDocs configuration file" -msgstr "新的 MkDocs 設定檔" +msgid "A new language configuration file" +msgstr "新的 Zensical 設定檔" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:29 #, fuzzy -msgid "First, create a new file named `mkdocs.de.yml` in the `docs` directory, with the following content:" -msgstr "首先，在 `docs` 目錄中建立一個名為 `mkdocs.de.yml` 的新檔案，內容如下：" +msgid "First, create a new file named `zensical.de.toml` in the `docs` directory, with the following content:" +msgstr "首先，在 `docs` 目錄中建立一個名為 `zensical.de.toml` 的新檔案，內容如下：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:31 -#, fuzzy msgid "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} Dokumentation\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" -"\n" -"theme:\n" -" language: de\n" +"[project]\n" +"site_name = \"{{ formal_name }} Dokumentation\"\n" +"docs_dir = \"de\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: Über\n" -" Documentation: Dokumentation\n" -" Community: Gemeinschaft\n" -" Contributing: Mitwirken\n" -" News: Neuigkeiten\n" -" Sponsor: Förderer" -msgstr "" -"INHERIT: config.yml\n" -"site_name: {{ formal_name }} 文件說明\n" -"site_url: {% if config.extra.website %}https://beeware.org/de{% else %}https://{{ project_name }}.beeware.org/de{% endif %}\n" -"docs_dir: de\n" +"[project.theme]\n" +"language = \"de\"\n" "\n" -"theme:\n" -" language: de\n" +"[project.extra]\n" +"language_url = \"de/\"\n" +"translation_type = \"machine\"\n" "\n" -"extra:\n" -" language_url: de/\n" -" translation_type: machine\n" -" header:\n" -" About: 關於\n" -" Documentation: 文件\n" -" Community: 社群\n" -" Contributing: 貢獻\n" -" News: 最新消息\n" -" Sponsor: 贊助者" +"[project.extra.header]\n" +"About = \"Über\"\n" +"Documentation = \"Dokumentation\"\n" +"Community = \"Gemeinschaft\"\n" +"Contributing = \"Mitwirken\"\n" +"News = \"Neuigkeiten\"\n" +"Sponsor = \"Förderer\"" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:52 #, fuzzy @@ -1708,9 +1689,8 @@ msgid "Here's what is going on in this file:" msgstr "以下是此檔案的內容：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:54 -#, fuzzy -msgid "This file inherits the configuration content from `config.yml`." -msgstr "這個檔案繼承了 `config.yml` 的設定內容。" +msgid "The settings in this file are applied on top of the configuration in `zensical.toml`. Only settings that are specific to the language should be included." +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:55 #, fuzzy @@ -1719,201 +1699,188 @@ msgstr "會翻譯 `site_name` 值。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:56 #, fuzzy -msgid "The `site_url` value is the project site URL, followed by the language code." -msgstr "`site_url` 值是專案網站的 URL，接著是語言代碼。" +msgid "The `docs_dir` should be the language code." +msgstr "docs_dir` 應該是語言代碼。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:57 #, fuzzy -msgid "The `docs_dir` should be the language code." -msgstr "docs_dir` 應該是語言代碼。" +msgid "The `theme.language` value should be the language code, as [specified by the Zensical theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." +msgstr "`theme.language` 值應該是 [Zensical theme]{1} 所指定的語言代碼。對大多數語言而言，這與 `docs_dir` 語言代碼相同；但對某些語言 (尤其是像 `zh_CN` 這種有區域性變異的語言) 而言，則會有差異。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:58 #, fuzzy -msgid "The `theme: language:` value should be the language code, as [specified by the MkDocs Material theme]{1}. For most languages, this will be the same as the `docs_dir` language code; but for some (in particular languages with locale variants like `zh_CN`), there are differences." -msgstr "`theme: language:` 值應該是 [MkDocs Material theme]{1} 所指定的語言代碼。對大多數語言而言，這與 `docs_dir` 語言代碼相同；但對某些語言 (尤其是像 `zh_CN` 這種有區域性變異的語言) 而言，則會有差異。" +msgid "The `extra.language_url` should be the language code, followed by a single slash, e.g. `de/` for German." +msgstr "`extra.language_url` 應為語言代碼，後接單斜線，例如 `de/` 代表德語。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:59 #, fuzzy -msgid "The `extra: language_url:` should be the language code, followed by a single slash, e.g. `de/` for German." -msgstr "`extra: language_url:` 應為語言代碼，後接單斜線，例如 `de/` 代表德語。" +msgid "The `extra.translation_type` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." +msgstr "`extra.translation_type` 應該是 `machine`，直到翻譯首次達到 100%，此時它應該是 `human`。如果它倒退到低於 90%，就會從 `human` 回復到 `machine`。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:60 #, fuzzy -msgid "The `extra: translation_type:` should be `machine` until the translation reaches 100% for the first time, at which point it should be `human`. It will revert to `machine` from `human` if it regresses to below 90%." -msgstr "`extra: translation_type:` 應該是 `machine`，直到翻譯首次達到 100%，此時它應該是 `human`。如果它倒退到低於 90%，就會從 `human` 回復到 `machine`。" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:61 -#, fuzzy -msgid "The content under `extra: header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." -msgstr "`extra: header` 下的內容是標題列中出現的標題翻譯。此定義在 BeeWare 主要網站上*非*必要；僅在*其他*網站（例如教學文件或專案文件）上需要此定義。" +msgid "The content under `extra.header` is the translations for titles that appear in the header bar. This definition is *not* required on the main BeeWare website; it is only required on *other* sites (such as the tutorial, or project documentation)." +msgstr "`extra.header` 下的內容是標題列中出現的標題翻譯。此定義在 BeeWare 主要網站上*非*必要；僅在*其他*網站（例如教學文件或專案文件）上需要此定義。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:63 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:62 #, fuzzy msgid "Update `tox.ini`" msgstr "更新 `tox.ini" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:65 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:64 #, fuzzy msgid "You'll need to make several changes to the `tox.ini` file." msgstr "您需要對 `tox.ini` 檔案進行幾項變更。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:67 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:66 #, fuzzy msgid "You would add the following:" msgstr "您可以添加以下內容：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:68 #, fuzzy msgid "The new language code environment flag to the header line which begins `[testenv:docs`, with the language code preceded by a `-`, with no spaces included, e.g. `-de`." msgstr "新的語言代碼環境標誌到以 `[testenv:docs` 開頭的標頭行，語言代碼前面加上 `-`，不含空格，例如 `-de`。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:69 #, fuzzy msgid "The new language code exclusion to the first command, which begins with `!lint`, preceded by `-!`, with no spaces included, e.g. `-!de`." msgstr "新的語言代碼排除到第一個指令，以 `!lint` 開頭，前面加上 `-!`，不含空格，例如 `-!de`。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:70 #, fuzzy msgid "The new language code to the line beginning with `translate : build_po_translations`." msgstr "新的語言代碼對應至以 `translate : build_po_translations` 開頭的行。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:71 #, fuzzy msgid "The new language code to the line beginning with `translate : update_machine_translations`" msgstr "新的語言代碼對應至以 `translate : update_machine_translations` 開頭的行" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:72 #, fuzzy msgid "A new command, beginning with, for example, `de : build_md_translations` for German, alphabetically within the existing language-specific commands that matches the content of those commands, with the new language code." msgstr "新增指令，例如以 `de : build_md_translations` 為德語指令開頭，在現有語言專屬指令中按字母順序排列，其內容需與這些指令相符，並採用新的語言代碼。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:74 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:73 #, fuzzy msgid "The new language code to the line beginning with `all:`." msgstr "新的語言代碼對應至以 `all:` 開頭的行。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:76 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:75 #, fuzzy -msgid "Update `config.yml`" -msgstr "更新 `config.yml`" +msgid "Update `zensical.toml`" +msgstr "更新 `zensical.toml`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:78 -#, fuzzy -msgid "Add the language to `config.yml` so it will show up in the language selector in the header. Find the section beginning with `extra:`, and then locate the subsection beginning with `alternate:`. For German, you would add the following:" -msgstr "將語言加入 `config.yml` 中，使其顯示在標頭的語言選擇器中。找到以`extra:`開頭的部分，然後再找到以`alternate:`開頭的小節。對於德語，您可以新增以下內容：" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:77 +msgid "Add the language to `zensical.toml` so it will show up in the language selector in the header. Find the section beginning with `[project.extra]`, and then locate the `alternate` setting. For German, you would add the following:" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:80 -#, fuzzy -msgid "" -"- name: Deutsch\n" -" link: /de/\n" -" lang: de" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:79 +msgid "{ name = \"Deutsch\", link = \"/de/\", lang = \"de\" }," msgstr "" -"- name: 德語\n" -" link: /de/\n" -" lang: de" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:86 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:83 #, fuzzy msgid "The language name should be translated into the language. The link must include the `/`s." msgstr "語言名稱應翻譯為該語言。連結必須包含 `/`。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:88 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:85 #, fuzzy msgid "Run `tox translate`" msgstr "執行 `tox translate`" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:90 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:87 #, fuzzy msgid "You can now run `tox -e docs-translate`. This will generate an empty translation file; if you have a DeepL account, you can use that account to populate initial machine translations. If you don't have a DeepL account, that's fine - we'll run initial translations ourselves before accepting the pull request." msgstr "現在您可以執行 `tox -e docs-translate`。這會產生一個空的翻譯檔案；如果您有 DeepL 帳戶，可以使用該帳戶來填入初步的機器翻譯內容。如果您沒有 DeepL 帳戶也沒關係——我們會在接受拉取請求之前自行執行初步翻譯。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:92 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:89 #, fuzzy msgid "Translation guidelines" msgstr "翻譯指引" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:94 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:91 #, fuzzy msgid "Once you've been added to the team, it's time to log into [Weblate]{1} and begin working through translating strings." msgstr "當您加入團隊後，就可以登入 [Weblate]{1} 並開始進行翻譯字串的工作。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:96 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:93 #, fuzzy msgid "Tone versus word-for-word translation" msgstr "語調與逐字翻譯" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:98 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:95 #, fuzzy msgid "It's more important to maintain the tone of the English text than to strive for a word-for-word translation. We try to be friendly and a bit colloquial in our content; try to maintain the spirit of that in your translations." msgstr "保持英文文本的語調比追求一字不差的翻譯更重要。我們嘗試在內容上表現得友善且有點口語化；在您的翻譯中嘗試維持這種精神。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:100 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:97 #, fuzzy msgid "If the English text contains a strong English idiom, don't feel beholden to maintain the idiom, if there is an analog in your language that would work equally well. If the term or phrase in the English text is a particularly idiomatic or slang term, don't be afraid to tell us we should consider making a change. Even for English speakers, idioms and slang can pose difficulty. Sometimes we need to change the English text to make it more straightforward for translators and readers alike." msgstr "如果英文文本中包含強烈的英文慣用語，如果您的語言中有類似的慣用語也同樣適用，請不要覺得必須保留該慣用語。如果英文文本中的詞彙或詞組是特別的成語或俚語，請不要害怕告訴我們應該考慮做出修改。即使對於英語使用者而言，成語和俚語也會造成困難。有時我們需要修改英文原文，讓翻譯者和讀者都能更直覺地理解。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:102 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:99 #, fuzzy msgid "Should I translate it?" msgstr "我應該翻譯嗎？" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:101 #, fuzzy msgid "The following items should *not* be translated or updated:" msgstr "下列項目*不應*進行翻譯或更新：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:103 #, fuzzy msgid "**Commands**. For example, in \"You should run \\`briefcase create\\`.\", only \"You should run\" should be translated." msgstr "**命令**。例如，在 \"You should run `briefcase create\\`.「 中，應只翻譯 」You should run\"。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:107 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:104 #, fuzzy msgid "**Namespaces**, such as class, method, or attribute names." msgstr "**名稱空間**，例如類別、方法或屬性名稱。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:108 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:105 #, fuzzy msgid "**Link URLs**. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links. If the full URL is included in the string, as `[Link text](https://example.com/)`, the URL should be skipped for translation." msgstr "**連結網址**。標準 Markdown 連結在 Weblate 中應以 `[Link text]{1}` 形式呈現，其中 `1` 代表該連結在字串中相對於其他可能連結的位置。若字串中已包含完整的網址（例如 `[Link text](https://example.com/)`），則該網址應跳過不進行翻譯。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "**Reference links containing class, method or attribute names**. These should be left as-is, including the backticks. Every part of the example link shown here would not be translated." msgstr "** 包含類別、方法或屬性名稱的參考連結**。這些連結應保持原樣，包括反標記。這裡顯示的範例連結的每個部分都不會被翻譯。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:109 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:106 #, fuzzy msgid "[`Class.attribute`][Class.attribute]" msgstr "[`Class.attribute`][Class.attribute]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 #, fuzzy msgid "**The link content of a Reference link**. For example, `link-content` would be skipped in the following:" msgstr "**參考連結的連結內容**。例如，以下內容中的 `link-content` 將被跳過：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:115 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:112 src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "[Link text][link-content]" msgstr "[連結文字][連結內容]" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:121 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:118 #, fuzzy msgid "**Jinja directives**. This is any content wrapped inside two pairs of matching curly braces, or a matching pair of single curly braces with percent signs inside each end. Note: Including an example of the syntax here causes the Macros plugin to attempt to render it; see the [Macros documentation]{1} for examples." msgstr "**Jinja 指令**。這是包裝在兩對相對的大括弧內的任何內容，或是包裝在一對相對的單一大括弧內的任何內容，兩端都有百分號。注意：在此加入語法範例會導致 Macros 外掛嘗試渲染該語法；範例請參閱 [Macros 文件]{1}。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:122 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:119 #, fuzzy msgid "**Custom anchors**. They are found after headers or above some content, and are formatted as `{ #anchor }`." msgstr "** 自訂錨點**。它們會出現在標題之後或某些內容之上，格式為 `{ #anchor }`。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "**Admonition syntax**. In the following example, the word \"admonition\" should not be translated. This goes for all styles of admonitions, including notes, warnings, etc. See the next section for information on translating the rest of the content." msgstr "**訓誡語法**。在下面的範例中，「訓誡」一詞不應該被翻譯。這適用於所有樣式的訓誡，包括註解、警告等。有關翻譯其他內容的資訊，請參閱下一節。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:123 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:120 #, fuzzy msgid "" "/// admonition | Page Title\n" @@ -1928,52 +1895,52 @@ msgstr "" "\n" "///" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:130 #, fuzzy msgid "**Backticks**. They are meant to stay as backticks; they are used for formatting both inline code and code blocks." msgstr "**反標記**。它們應保持為反標記；它們用於格式化內嵌程式碼和程式碼區塊。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:134 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:131 #, fuzzy msgid "**The syntax for including external content**. This is anything on the same line as `-8<-`, or on the lines between two `-8<-` on separate lines." msgstr "**包含外部內容的語法**。這是與 `-8<-` 在同一行的任何內容，或是在兩行分開的 `-8<-` 之間的內容。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:133 #, fuzzy msgid "The following items *should* be translated:" msgstr "下列項目*應*予翻譯：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:138 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:135 #, fuzzy msgid "**Link text**. In link syntax, the text comes before the URL, and is enclosed in brackets, as in `[Link text](URL)`. Standard Markdown links should appear in Weblate as `[Link text]{1}`, where `1` is the position of the link in the string with reference to other possible links." msgstr "** 連結文字**。在連結語法中，文字在URL之前，並用括弧括起，如`[連結文字](URL)`。標準的 Markdown 連結應該在 Weblate 中顯示為 `[連結文字]{1}`，其中 `1` 是連結在字串中的位置，並參照其他可能的連結。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:139 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:136 #, fuzzy msgid "**Reference link text**. For example, `Link text` would be translated in the following:" msgstr "**參考連結文字**。例如，`Link text` 將在以下內容中被翻譯為：" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:145 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:142 #, fuzzy msgid "**Admonition titles and content**. In the previous admonition example, \"Page Title\" and \"Content.\" should be translated." msgstr "**告誡標題和內容**。在前面的訓誡範例中，「頁面標題」和「內容」應該被翻譯。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:147 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:144 #, fuzzy msgid "Weblate" msgstr "Weblate" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:149 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:146 #, fuzzy msgid "We use [Weblate]{1} for our content translation. When we add a new translation, we use [DeepL]{2} for machine translation to produce a first pass at translations. That means, typically, the content you'll be translating is already machine translated. The expectation is that you, as a translator, will review, edit, and improve the existing machine translation." msgstr "我們使用 [Weblate]{1} 進行內容翻譯。當我們新增翻譯時，我們會使用 [DeepL]{2} 進行機器翻譯，以產生第一遍翻譯。這表示，一般而言，您要翻譯的內容已經由機器翻譯完成。我們的期望是，身為譯者的您將審閱、編輯並改善現有的機器翻譯。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:151 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:148 #, fuzzy msgid "Weblate processes everything on a string-by-string basis. It batches changes, and every couple of hours, it will submit a bulk commit with all the strings that have changed in that interval. So, it may take a couple of hours for your changes to show up on the website, but you can expect the update to appear within four hours." msgstr "Weblate 會逐個字串處理。它會對變更進行批次處理，每隔幾小時就會提交一次批量提交，其中包含在該時間間隔內發生變更的所有字串。因此，您的變更可能需要幾小時才能顯示在網站上，但您可以預期更新會在四小時內出現。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:153 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/translate.md:150 #, fuzzy msgid "If after that time, your changes still haven't appeared, the likely cause is a markup error, resulting in a failure in the docs build for that language. Any markup problem in any string will block the entire translation from being public. You can keep an eye on the build page for your language to see whether it has successfully built. The link is formatted similarly to this link to the French build page {% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; change the language code to your language to view the appropriate build page. This will show the state of the most recent build of the site. If the build fails, look at the build log, and see if you can identify the source of the problem." msgstr "若超過上述時間後，您的修改仍未顯示，可能原因在於標記錯誤導致該語言的文件建置失敗。任何字串中的標記問題都會阻擋整個翻譯版本公開發布。您可持續關注您語言的建置頁面，確認是否已成功建置。 連結格式類似此法語建置頁面連結：{% if config.extra.website %}[https://app.readthedocs.org/projects/beewareorg/]{1}{% else %}[https://app.readthedocs.org/projects/{{ project_name }}/](https://app.readthedocs.org/projects/{{ project_name }}/){% endif %}; 請將語言代碼替換為您所屬語言，即可查看對應的建置頁面。此頁面將顯示網站最新建置狀態。若建置失敗，請查閱建置日誌以釐清問題根源。" @@ -2377,36 +2344,34 @@ msgid "You'll need to create the document in the appropriate location within the msgstr "您需要在 `docs/en` 目錄中的適當位置建立文件。為了方便討論，我們假設您要新增一個文件名為 `new_doc.md`的新文件。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:17 -#, fuzzy -msgid "Then, you'll need to update the `docs/en/SUMMARY.md` file to include your new file. `SUMMARY.md` is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. If you locate the section where you intend to include `new_doc.md`, you do not need to change anything in `SUMMARY.md` if you see a wildcard path listed. For example:" -msgstr "然後，您需要更新 `docs/en/SUMMARY.md` 檔案，以包含您的新檔案。`SUMMARY.md` 的組織基本上反映了 `docs/en` 目錄的結構，但更重要的是，它直接決定了左側欄的結構。如果您找到打算包含 `new_doc.md` 的部分，如果看到列出的通配符路徑，您不需要在 `SUMMARY.md` 中做任何修改。例如" +msgid "Then, you'll need to add your new file to the `nav` setting in `docs/zensical.toml`. The `nav` setting is organized to basically reflect the `docs/en` directory structure, but, more importantly, directly determines the structure of the left sidebar. Locate the section where you intend to include `new_doc.md`, and add an entry for it, with the title you want to appear in the sidebar, and the path to the file, relative to `docs/en`. For example:" +msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:19 -#, fuzzy -msgid "- ./path/to/directory/*" -msgstr "- ./路徑/至/目錄/*" - -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:23 -#, fuzzy -msgid "If the section where you intend to include `new_doc.md` is a list of individual Markdown links, you'll need to add an explicit link to yours. For example:" -msgstr "如果您打算包含 `new_doc.md` 的部分是個別 Markdown 連結的清單，您就需要在您的部分加入明確的連結。例如" +msgid "" +"nav = [\n" +" { \"Existing section\" = [\n" +" { \"Existing document\" = \"path/to/existing_doc.md\" },\n" +" { \"My new document\" = \"path/to/new_doc.md\" },\n" +" ] },\n" +"]" +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:25 -#, fuzzy -msgid "- [My new document](new_doc.md)" -msgstr "- [我的新文件](new_doc.md)" +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:28 +msgid "The titles in the `nav` setting are translated along with the rest of the documentation." +msgstr "" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:29 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:30 #, fuzzy msgid "Writing your documentation" msgstr "撰寫您的文件" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:31 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:32 #, fuzzy msgid "You can now open the desired file into your editor, and begin writing." msgstr "現在您可以在編輯器中開啟所需的檔案，並開始撰寫。" -#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:33 +#: src/beeware_docs_tools/shared_content/en/_shared/contribute/how/write-docs.md:34 #, fuzzy msgid "We have a [documentation style guide]{1} that outlines our guidelines for writing documentation for BeeWare." msgstr "我們有一份 [文件風格指南]{1}，概述了我們為 BeeWare 撰寫文件的準則。" @@ -3176,8 +3141,8 @@ msgstr "" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:1 #, fuzzy -msgid "This guide includes information on expected style, MkDocs-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." -msgstr "本指南包括有關撰寫新內容和翻譯現有內容的預期風格、MkDocs 特定語法、各種所需工具和文檔翻譯等資訊。" +msgid "This guide includes information on expected style, Zensical-specific syntax, various required tools, and documentation translation, with regard to writing new content and translating existing content." +msgstr "本指南包括有關撰寫新內容和翻譯現有內容的預期風格、Zensical 特定語法、各種所需工具和文檔翻譯等資訊。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:3 #, fuzzy @@ -3236,8 +3201,8 @@ msgstr "您應該盡可能交叉引用文件中的內容。本節將介紹您可 #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:18 #, fuzzy -msgid "MkDocs renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" -msgstr "MkDocs 會渲染標準 Markdown 格式的連結。標準 Markdown 格式的網頁超連結如下：" +msgid "Zensical renders standard Markdown formatted links. Standard Markdown formatted web hyperlinks are as follows:" +msgstr "Zensical 會渲染標準 Markdown 格式的連結。標準 Markdown 格式的網頁超連結如下：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:20 #, fuzzy @@ -3256,8 +3221,8 @@ msgstr "[連結文字](path/to/file.md)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:30 #, fuzzy -msgid "Referencing specific sections of files, or API documentation requires using the MkDocs reference link format." -msgstr "參考檔案的特定區段或 API 文件需要使用 MkDocs 參考連結格式。" +msgid "Referencing specific sections of files, or API documentation requires using the Zensical reference link format." +msgstr "參考檔案的特定區段或 API 文件需要使用 Zensical 參考連結格式。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:32 #, fuzzy @@ -3271,13 +3236,13 @@ msgstr "Markdown 會根據標題的內容，為所有標題 (以一到六個 `#` #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:36 #, fuzzy -msgid "MkDocs supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." -msgstr "MkDocs 支援渲染參考連結語法，可讓您使用修改過的 Markdown 連結來連結到文件中的各種其他元素。這包括連結到自訂 Markdown 標題和文字錨點等。" +msgid "Zensical supports rendering a reference link syntax that allows you to link to various other elements in the documentation using a modified Markdown link. This includes linking to, among other things, custom Markdown headers and text anchors." +msgstr "Zensical 支援渲染參考連結語法，可讓您使用修改過的 Markdown 連結來連結到文件中的各種其他元素。這包括連結到自訂 Markdown 標題和文字錨點等。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:38 #, fuzzy -msgid "MkDocs reference links are any links formatted as follows:" -msgstr "MkDocs 參考連結是格式如下的任何連結：" +msgid "Zensical reference links are any links formatted as follows:" +msgstr "Zensical 參考連結是格式如下的任何連結：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:40 #, fuzzy @@ -3291,8 +3256,8 @@ msgstr "/// warning |需要自訂標題和內容錨點" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:46 #, fuzzy -msgid "Any header or content section that is referenced in text content via a MkDocs reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." -msgstr "在BeeWare文檔中，通過MkDocs參考鏈接在文本內容中引用的任何標題或內容部分_must_都必須附加自定義錨點。否則，在翻譯標題內容時，有可能會破壞連結。" +msgid "Any header or content section that is referenced in text content via a Zensical reference link in the BeeWare documentation _must_ have a custom anchor attached. Otherwise, there is the potential to break the links when header content is translated." +msgstr "在BeeWare文檔中，通過Zensical參考鏈接在文本內容中引用的任何標題或內容部分_must_都必須附加自定義錨點。否則，在翻譯標題內容時，有可能會破壞連結。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:50 #, fuzzy @@ -3351,8 +3316,8 @@ msgstr "[連結文字](#anchor-name)" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:80 #, fuzzy -msgid "Linking to an anchor in a separate document uses the MkDocs reference link style, which is formatted as follows:" -msgstr "連結至獨立文件中的錨點使用 MkDocs 參考連結樣式，其格式如下：" +msgid "Linking to an anchor in a separate document uses the Zensical reference link style, which is formatted as follows:" +msgstr "連結至獨立文件中的錨點使用 Zensical 參考連結樣式，其格式如下：" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:82 #, fuzzy @@ -3366,8 +3331,8 @@ msgstr "API 參考連結" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:88 #, fuzzy -msgid "The MkDocs reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." -msgstr "MkDocs 參考連結也支援交叉參考 API 文件，包括已記錄的類、類方法或屬性，以及特定的外部文件參考。" +msgid "Zensical reference linking also supports cross-referencing API documentation, including documented classes, class methods or attributes, and specific external documentation references." +msgstr "Zensical 參考連結也支援交叉參考 API 文件，包括已記錄的類、類方法或屬性，以及特定的外部文件參考。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:90 #, fuzzy @@ -3942,8 +3907,8 @@ msgstr "使用巨集從 BeeWare Docs Tools 共用內容中包含內容" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:371 #, fuzzy -msgid "You can also include content from the BeeWare Docs tools shared content directory using the [Macros MkDocs plugin]{1}. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." -msgstr "您也可以使用 [Macros MkDocs plugin]{1} 包含 BeeWare Docs tools 共享內容目錄中的內容。如果文件中包含需要執行的Jinja指令，則必須使用此方法，並且只能在這種情況下使用。對於透過 URL 取得的外部內容則無法使用。Macros 變數替代機制]{2}可與此方法一起使用。" +msgid "You can also include content from the BeeWare Docs tools shared content directory using [Macros]{1}, which Zensical supports natively. This method is necessary if the document contains Jinja directives that need to be executed, and should only be used in this situation. It will not work with external content via a URL. The [Macros variable-replacement mechanism]{2} works with this method." +msgstr "您也可以使用 [Macros]{1} 包含 BeeWare Docs tools 共享內容目錄中的內容。如果文件中包含需要執行的Jinja指令，則必須使用此方法，並且只能在這種情況下使用。對於透過 URL 取得的外部內容則無法使用。Macros 變數替代機制]{2}可與此方法一起使用。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/style/docs-style-guide.md:373 #, fuzzy @@ -4452,8 +4417,8 @@ msgstr "文件表單 { #docs-form }" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:5 #, fuzzy -msgid "{{ formal_name }}'s documentation is written using [MkDocs and Markdown]{1}. We aim to follow the [Diataxis]{2} framework for structuring documentation." -msgstr "{{ formal_name }} 的文件是使用 [MkDocs and Markdown]{1} 寫成的。我們的目標是遵循 [Diataxis]{2} 架構文件。" +msgid "{{ formal_name }}'s documentation is written using [Zensical]{1} and [Markdown]{2}. We aim to follow the [Diataxis]{3} framework for structuring documentation." +msgstr "{{ formal_name }} 的文件是使用 [Zensical]{1} and [Markdown]{2} 寫成的。我們的目標是遵循 [Diataxis]{3} 架構文件。" #: src/beeware_docs_tools/shared_content/en/_shared/contribute/what/write-docs.md:7 #, fuzzy diff --git a/tests/test_api_blocks.py b/tests/test_api_blocks.py new file mode 100644 index 00000000..a6323254 --- /dev/null +++ b/tests/test_api_blocks.py @@ -0,0 +1,218 @@ +import shutil +import subprocess + +import polib +import pytest + +from beeware_docs_tools.api_directives import ( + api_blocks, + blank_api_blocks, + restore_api_blocks, +) +from beeware_docs_tools.build_pot_translations import generate_pot_files + +ENGLISH = """\ +# Colors + +Some text to translate. + +::: toga.colors.Color + options: + show_root_heading: false + + members_order: source + +::: toga.colors.rgb + +1. A list item. + + ::: toga.colors.hsl + options: + heading_level: 4 + +```markdown +::: example.in_a.code_block + options: + show_source: true +``` + +::: toga.colors.Color + options: + members: [rgb] + +More text. +""" + +needs_translate_toolkit = pytest.mark.skipif( + not (shutil.which("md2po") and shutil.which("po2md")), + reason="translate-toolkit is not installed", +) + + +def directives(text): + """The API directives in some Markdown content, with their indentation removed.""" + lines = text.splitlines() + return [ + (identifier, [line.removeprefix(indent) for line in lines[start:end]]) + for start, end, indent, identifier in api_blocks(lines) + ] + + +def test_api_blocks(): + """API directives are found with their options, but not in code blocks.""" + lines = ENGLISH.splitlines() + + assert [ + (indent, identifier, lines[start:end]) + for start, end, indent, identifier in api_blocks(lines) + ] == [ + ( + "", + "toga.colors.Color", + [ + "::: toga.colors.Color", + " options:", + " show_root_heading: false", + "", + " members_order: source", + ], + ), + ("", "toga.colors.rgb", ["::: toga.colors.rgb"]), + ( + " ", + "toga.colors.hsl", + [ + " ::: toga.colors.hsl", + " options:", + " heading_level: 4", + ], + ), + ( + "", + "toga.colors.Color", + ["::: toga.colors.Color", " options:", " members: [rgb]"], + ), + ] + + +def test_blank_api_blocks(tmp_path): + """API directives are blanked out, keeping the line numbers the same.""" + (tmp_path / "sub").mkdir() + (tmp_path / "sub/colors.md").write_text(ENGLISH, encoding="utf-8") + (tmp_path / "plain.md").write_text("# Plain\n", encoding="utf-8") + + assert [str(path) for path in blank_api_blocks(tmp_path)] == ["sub/colors.md"] + + blanked = (tmp_path / "sub/colors.md").read_text(encoding="utf-8") + assert len(blanked.splitlines()) == len(ENGLISH.splitlines()) + assert directives(blanked) == [] + # Translatable text and code blocks are untouched. + assert "Some text to translate." in blanked + assert "::: example.in_a.code_block\n options:" in blanked + assert (tmp_path / "plain.md").read_text(encoding="utf-8") == "# Plain\n" + + +def test_restore_api_blocks(tmp_path): + """API directives are restored, keeping the translation's indentation.""" + en = tmp_path / "en" + fr = tmp_path / "fr" + en.mkdir() + fr.mkdir() + (en / "colors.md").write_text(ENGLISH, encoding="utf-8") + (en / "plain.md").write_text("# Plain\n", encoding="utf-8") + (fr / "plain.md").write_text("# Simple\n", encoding="utf-8") + # This is what po2md produces from ENGLISH (with the text translated). + (fr / "colors.md").write_text( + """\ +# Couleurs + +Du texte à traduire. + +::: toga.colors.Color options: show_root_heading: false + + members_order: source + +::: toga.colors.rgb + +1. Un élément de liste. + + ::: toga.colors.hsl options: heading_level: 4 + +```markdown +::: example.in_a.code_block + options: + show_source: true +``` + +::: toga.colors.Color options: members: [rgb] + +Plus de texte. +""", + encoding="utf-8", + ) + + assert [str(path) for path in restore_api_blocks(en, fr)] == ["colors.md"] + + restored = (fr / "colors.md").read_text(encoding="utf-8") + assert directives(restored) == directives(ENGLISH) + # The list item keeps the indentation that po2md gave it. + assert "\n ::: toga.colors.hsl\n options:\n heading_level: 4\n" in ( + restored + ) + # The translation and the code block are untouched. + assert "Du texte à traduire." in restored + assert "::: example.in_a.code_block\n options:" in restored + assert (fr / "plain.md").read_text(encoding="utf-8") == "# Simple\n" + # A second run changes nothing. + assert restore_api_blocks(en, fr) == [] + + +@needs_translate_toolkit +def test_round_trip(tmp_path, monkeypatch): + """API directives don't reach the POT file, and survive a po2md round trip.""" + monkeypatch.chdir(tmp_path) + docs = tmp_path / "docs" + (docs / "en/api").mkdir(parents=True) + (docs / "en/api/colors.md").write_text(ENGLISH, encoding="utf-8") + (docs / "en/api/image.png").write_bytes(b"not really a PNG") + + generate_pot_files(docs.relative_to(tmp_path), excludes=[]) + + pot = docs / "locales/template/translations.pot" + msgids = [entry.msgid for entry in polib.pofile(pot)] + assert "Some text to translate." in msgids + assert not [ + msgid for msgid in msgids if "toga.colors" in msgid or "members_order" in msgid + ] + # Locations still point at the original content and line numbers. + entry = polib.pofile(pot).find("More text.") + assert entry.occurrences == [ + ("docs/en/api/colors.md", str(ENGLISH.splitlines().index("More text.") + 1)) + ] + # The English content itself wasn't modified. + assert (docs / "en/api/colors.md").read_text(encoding="utf-8") == ENGLISH + + fr = tmp_path / "fr" + subprocess.run( + [ + "po2md", + f"--input={pot}", + f"--template={docs / 'en'}", + f"--output={fr}", + "--fuzzy", + "--maxlinelength=0", + "--progress=none", + ], + check=True, + ) + # po2md squashes the directives... + assert "::: toga.colors.Color options:" in (fr / "api/colors.md").read_text( + encoding="utf-8" + ) + + restore_api_blocks(docs / "en", fr) + + # ... and they are restored. + assert directives((fr / "api/colors.md").read_text(encoding="utf-8")) == ( + directives(ENGLISH) + ) diff --git a/tests/test_build_config.py b/tests/test_build_config.py index 6380fdf5..dd068eb6 100644 --- a/tests/test_build_config.py +++ b/tests/test_build_config.py @@ -156,6 +156,50 @@ def test_load_config_site_url(tmp_path): assert config["site_url"] == "https://fr.example.com/" +@pytest.mark.parametrize( + "base, env, expected", + [ + # From the environment (Read the Docs) + ( + BASE, + {"READTHEDOCS_CANONICAL_URL": "https://example.com/en/latest/"}, + "https://example.com/en/latest/zh_CN/", + ), + # Configured in the base file, with and without a trailing slash + ( + '[project]\nsite_url = "https://beeware.org/"\n', + {}, + "https://beeware.org/zh_CN/", + ), + ( + '[project]\nsite_url = "https://beeware.org"\n', + {}, + "https://beeware.org/zh_CN/", + ), + # No site URL at all + (BASE, {}, None), + ], +) +def test_load_config_translated_site_url(tmp_path, base, env, expected): + """A translation's site URL is in the language's subdirectory.""" + project = make_project( + tmp_path, + base, + { + "en": '[project]\nsite_name = "Docs"\n', + "zh_CN": '[project]\nsite_name = "Docs"\ndocs_dir = "zh_CN"\n', + }, + ) + + assert load_config(project, "zh_CN", env=env).get("site_url") == expected + # English is published at the root of the site, so its URL is unchanged. + english = load_config(project, "en", env=env).get("site_url") + if expected: + assert english.rstrip("/") == expected.removesuffix("/zh_CN/") + else: + assert english is None + + def test_load_config_unexpected_key(tmp_path): """A setting that isn't a per-language setting produces a warning.""" project = make_project( diff --git a/tests/test_convert_mkdocs_config.py b/tests/test_convert_mkdocs_config.py index cace73a0..cbae28d8 100644 --- a/tests/test_convert_mkdocs_config.py +++ b/tests/test_convert_mkdocs_config.py @@ -12,6 +12,7 @@ toml_key, toml_string, ) +from beeware_docs_tools.nav_translations import NAV_CONTEXT CONFIG_YML = """\ # yaml-language-server: $schema=https://squidfunk.github.io/mkdocs-material/schema.json @@ -213,31 +214,35 @@ def test_convert(project): def test_convert_translations(project): - """Navigation title translations are migrated to plain titles.""" + """Navigation title translations are migrated to navigation entries.""" messages = [] assert convert(project / "docs", out=messages.append) po = polib.pofile(str(project / "docs/locales/fr/translations.po")) - entries = {entry.msgid: entry for entry in po if not entry.obsolete} - - # Link titles become plain titles, keeping their flags. - assert entries["Home"].msgstr == "Accueil" - assert entries["Home"].fuzzy - assert entries["Home"].occurrences == [("docs/en/titles.md", "")] - # An existing plain title (a section title) keeps its translation. - assert entries["Guide"].msgstr == "Guide FR" - # An existing, untranslated entry (a page heading) is filled in, and keeps - # its own source reference. - assert entries["Reference"].msgstr == "Référence" - assert ("docs/en/reference/index.md", "1") in entries["Reference"].occurrences - # An untranslated link title becomes an untranslated plain title. - assert entries["API"].msgstr == "" + nav = {e.msgid: e for e in po if not e.obsolete and e.msgctxt == NAV_CONTEXT} + plain = {e.msgid: e for e in po if not e.obsolete and not e.msgctxt} + + # Link titles become navigation entries, keeping their flags. + assert nav["Home"].msgstr == "Accueil" + assert nav["Home"].fuzzy + assert nav["Home"].occurrences == [("docs/en/titles.md", "")] + # The link text translation is used, as that's what the navigation showed. + assert nav["Guide"].msgstr == "Le guide" + assert not nav["Guide"].fuzzy + # A navigation title gets the link text translation, even though the page + # heading with the same text is untranslated; the heading is unchanged. + assert nav["Reference"].msgstr == "Référence" + assert plain["Reference"].msgstr == "" + assert plain["Reference"].occurrences == [("docs/en/reference/index.md", "1")] + # An untranslated link title becomes an untranslated navigation entry. + assert nav["API"].msgstr == "" # Entries that were only used by the navigation file are removed. - assert not any("{1}" in msgid for msgid in entries) - assert "./guide/*" not in entries + assert not any("{1}" in msgid for msgid in plain) + assert "./guide/*" not in plain + assert "Guide" not in plain output = "\n".join(messages) - assert "Conflict: 'Guide': kept 'Guide FR', not 'Le guide'" in output + assert "3 navigation titles migrated, 1 untranslated" in output def test_check_doesnt_write(project): diff --git a/tests/test_nav_translations.py b/tests/test_nav_translations.py new file mode 100644 index 00000000..9d074fa2 --- /dev/null +++ b/tests/test_nav_translations.py @@ -0,0 +1,93 @@ +import polib + +from beeware_docs_tools.build_config import translate +from beeware_docs_tools.nav_translations import ( + NAV_CONTEXT, + add_nav_context, + seed_nav_translations, +) + + +def catalog(*entries): + po = polib.POFile(wrapwidth=100000) + for entry in entries: + po.append(entry) + return po + + +def test_add_nav_context(): + """Navigation titles get their own context, split from page headings.""" + po = catalog( + polib.POEntry( + msgid="Building documentation", + occurrences=[ + ("docs/en/how/build-docs.md", "1"), + ("docs/en/titles.md", "7"), + ], + ), + polib.POEntry(msgid="Section one", occurrences=[("docs/en/titles.md", "3")]), + polib.POEntry(msgid="Some text.", occurrences=[("docs/en/index.md", "5")]), + ) + + assert add_nav_context(po) == 2 + + assert [(e.msgctxt, e.msgid, e.occurrences) for e in po] == [ + (None, "Building documentation", [("docs/en/how/build-docs.md", "1")]), + (NAV_CONTEXT, "Building documentation", [("docs/en/titles.md", "7")]), + (NAV_CONTEXT, "Section one", [("docs/en/titles.md", "3")]), + (None, "Some text.", [("docs/en/index.md", "5")]), + ] + # Running it again changes nothing. + assert add_nav_context(po) == 0 + assert len(po) == 4 + + +def test_seed_nav_translations(): + """Navigation entries are filled in from the translations they used before.""" + previous = catalog( + # A literate-nav link: what the navigation displayed. + polib.POEntry(msgid="[Section one]{1}", msgstr="[Section 1]{1}"), + polib.POEntry(msgid="Section one", msgstr="Section un"), + # A navigation title from before the context existed (or a heading). + polib.POEntry(msgid="About", msgstr="À propos", flags=["fuzzy"]), + # A link translation that has lost its markup isn't used. + polib.POEntry(msgid="[Broken]{1}", msgstr="Cassé"), + polib.POEntry(msgid="Untranslated", msgstr=""), + ) + po = catalog( + polib.POEntry(msgid="Section one", msgctxt=NAV_CONTEXT), + polib.POEntry(msgid="About", msgctxt=NAV_CONTEXT), + polib.POEntry(msgid="Broken", msgctxt=NAV_CONTEXT), + polib.POEntry(msgid="Untranslated", msgctxt=NAV_CONTEXT), + polib.POEntry(msgid="Kept", msgctxt=NAV_CONTEXT, msgstr="Gardé"), + polib.POEntry(msgid="Section one", msgstr=""), + ) + + assert seed_nav_translations(po, previous) == ["Section one", "About"] + + nav = {e.msgid: e for e in po if e.msgctxt == NAV_CONTEXT} + assert nav["Section one"].msgstr == "Section 1" + assert nav["About"].msgstr == "À propos" + assert nav["About"].fuzzy + assert nav["Broken"].msgstr == "" + assert nav["Untranslated"].msgstr == "" + assert nav["Kept"].msgstr == "Gardé" + # Entries without the navigation context aren't touched. + assert po.find("Section one", msgctxt=None).msgstr == "" + + +def test_translate_prefers_nav_context(): + """The navigation translation is used, falling back to one without context.""" + po = catalog( + polib.POEntry(msgid="Section one", msgstr="Section un"), + polib.POEntry(msgid="Section one", msgctxt=NAV_CONTEXT, msgstr="Section 1"), + polib.POEntry(msgid="About", msgstr="À propos"), + polib.POEntry(msgid="Help", msgctxt=NAV_CONTEXT, msgstr=""), + polib.POEntry(msgid="Help", msgstr="Aide"), + ) + tr = translate(po) + + assert tr("Section one") == "Section 1" + assert tr("About") == "À propos" + assert tr("Help") == "Aide" + assert tr("Missing") == "Missing" From c257eb2f0d4ec4418b912f41c444edd26e56cc47 Mon Sep 17 00:00:00 2001 From: Kattni <kattni@kattni.com> Date: Thu, 5 Nov 2026 22:49:44 -0500 Subject: [PATCH 4/5] Remove the MkDocs conversion tooling. The converter is only needed once per repository, and relies on private Zensical APIs, so it isn't part of docs-tools. Repositories are converted from a separate branch before this is merged. --- README.md | 27 - pyproject.toml | 7 - .../convert_mkdocs_config.py | 1246 ----------------- tests/test_convert_mkdocs_config.py | 319 ----- tox.ini | 1 - 5 files changed, 1600 deletions(-) delete mode 100644 src/beeware_docs_tools/convert_mkdocs_config.py delete mode 100644 tests/test_convert_mkdocs_config.py diff --git a/README.md b/README.md index e3b7c766..a2b2eb7f 100644 --- a/README.md +++ b/README.md @@ -54,33 +54,6 @@ The language file is merged over `zensical.toml` with the same rule MkDocs used During a build, docs-tools writes the complete configuration for each language to `docs/_build.<lang>.toml`, and generated content (translated Markdown, and the built site) to `docs/_build/build/`. The live server (`live_serve_en`) uses `docs/_build.live.en.toml` and `docs/_build/live/` instead, so a build can run while the live server is running. These are removed when the build or live server finishes; add `docs/_build.*.toml` and `_build` to `.gitignore` in case a build is interrupted. Zensical also keeps a cache in `docs/.cache`, which includes its own `.gitignore`. -## Converting from MkDocs - -The `convert_mkdocs_config` command converts a repository's MkDocs configuration into this format: - -* `docs/config.yml` becomes `docs/zensical.toml`. -* Each `docs/mkdocs.<lang>.yml` becomes `docs/zensical.<lang>.toml`. -* The literate-nav navigation file (`docs/en/SUMMARY.md`) becomes the `nav` setting in `docs/zensical.toml`, and the literate-nav plugin is removed. The navigation is resolved with literate-nav's own parser, so wildcards are expanded to the pages they matched. -* Translations of navigation titles in `docs/locales/<lang>/translations.po` are migrated to the plain titles used by `nav`. If a title already has its own translation (for example, because it is also a page heading), that translation is kept, and the difference is reported. -* `site_url: !ENV ...` is removed, as `site_url` is set at build time. -* Comments in the YAML files are carried over. - -Before writing anything, the converter checks that, for every language, the TOML configuration is the same as the configuration Zensical reads from the YAML files, apart from the intended differences listed above (and the order of the Markdown extensions, which is reported). If there are any other differences, it lists them and doesn't change any files. - -To convert a repository, install docs-tools with the `convert` extra (which adds literate-nav), and run the converter from the root of the repository: - -```console -$ python -m pip install -e "/path/to/beeware-docs-tools[convert]" -$ convert_mkdocs_config --check -$ convert_mkdocs_config -``` - -`--check` reports what would change without writing any files. By default, the converter deletes the original YAML and `SUMMARY.md` files; use `--keep-old` to keep them. Review the output, then: - -* Update any `tox.ini` settings that refer to MkDocs (for example, remove `DISABLE_MKDOCS_2_WARNING` and `NO_MKDOCS_2_WARNING`). -* Add `docs/_build.*.toml` to `.gitignore`. -* Recreate your tox environments (`tox -r`), as the dependencies have changed. - ## Adding a new language Weblate is able to generate a new language, however, adding a new language also requires a few changes to the documentation repository. diff --git a/pyproject.toml b/pyproject.toml index cdad1419..a557e08a 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -45,12 +45,6 @@ dependencies = [ "zensical==0.1.0", # Pre-1.0; pin exactly. ] -[project.optional-dependencies] -# Needed by `convert_mkdocs_config` to convert a literate-nav navigation file. -convert = [ - "mkdocs-literate-nav==0.6.3", -] - [dependency-groups] # Extras used by developers *of* beeware-docs-tools are pinned to specific versions to # ensure environment consistency. @@ -90,7 +84,6 @@ Source = "https://github.com/beeware/beeware-docs-tools/" [project.scripts] build_md_translations = "beeware_docs_tools.build_md_translations:main" build_po_translations = "beeware_docs_tools.build_po_translations:main" -convert_mkdocs_config = "beeware_docs_tools.convert_mkdocs_config:main" build_pot_translations = "beeware_docs_tools.build_pot_translations:main" live_serve_en = "beeware_docs_tools.live_serve_en:main" update_machine_translations = "beeware_docs_tools.update_machine_translations:main" diff --git a/src/beeware_docs_tools/convert_mkdocs_config.py b/src/beeware_docs_tools/convert_mkdocs_config.py deleted file mode 100644 index 174672c8..00000000 --- a/src/beeware_docs_tools/convert_mkdocs_config.py +++ /dev/null @@ -1,1246 +0,0 @@ -"""Convert a project's MkDocs configuration to Zensical's native TOML format. - -This converts: - -* ``docs/config.yml`` into ``docs/zensical.toml``; -* each ``docs/mkdocs.<lang>.yml`` into ``docs/zensical.<lang>.toml``; and -* the literate-nav navigation file (``docs/en/SUMMARY.md``) into a ``nav`` - setting in ``docs/zensical.toml``. - -Comments in the YAML files are carried over to the TOML files. - -Before anything is written, the converted configuration for every language is -checked against the configuration Zensical reads from the original YAML files. -The only differences allowed are the intended ones (see ``compare_configs()``). -If there are any others, nothing is written. - -Navigation titles that were translated as part of ``SUMMARY.md`` are migrated -in each ``docs/locales/<lang>/translations.po``, so the translations carry over -to the titles in the new ``nav`` setting. -""" - -import datetime -import json -import math -import re -import sys -import tempfile -import tomllib -from argparse import ArgumentParser -from pathlib import Path - -import polib -import yaml - -from .build_config import ( - BASE_CONFIG, - language_config_name, - merge_config, - process_nav, - read_toml, - unexpected_language_keys, -) -from .nav_translations import ( - LINK_RE, - NAV_CONTEXT, - TITLES_FILE, - previous_translation, -) - - -class ConversionError(Exception): - pass - - -########################################################################### -# Reading YAML -########################################################################### - - -class PythonName(str): - """A reference to a Python object (a ``!!python/name:`` tag).""" - - -class EnvTag: - """An ``!ENV`` tag, which has no equivalent in TOML.""" - - def __init__(self, value): - self.value = value - - def __repr__(self): - return f"!ENV {self.value!r}" - - -def _extension_alias(name): - from zensical.config import _extension_alias - - return _extension_alias(name) - - -class _Loader(yaml.SafeLoader): - pass - - -def _construct_env(loader, node): - if isinstance(node, yaml.ScalarNode): - return EnvTag(loader.construct_scalar(node)) - return EnvTag(loader.construct_sequence(node)) - - -_Loader.add_constructor("!ENV", _construct_env) -_Loader.add_multi_constructor( - "tag:yaml.org,2002:python/name:", - lambda loader, suffix, node: PythonName(_extension_alias(suffix)), -) - - -def _walk_nodes(node, path, starts, ends): - """Record the lines on which each node of a YAML document starts and ends.""" - - def note_end(n): - line = n.end_mark.line - ends[line] = max(ends.get(line, 0), n.end_mark.column) - - if isinstance(node, yaml.MappingNode): - for key_node, value_node in node.value: - child = (*path, key_node.value) - starts.setdefault(key_node.start_mark.line, []).append(child) - note_end(key_node) - _walk_nodes(value_node, child, starts, ends) - if node.flow_style: - note_end(node) - elif isinstance(node, yaml.SequenceNode): - for index, item in enumerate(node.value): - child = (*path, index) - starts.setdefault(item.start_mark.line, []).append(child) - _walk_nodes(item, child, starts, ends) - if node.flow_style: - note_end(node) - else: - note_end(node) - - -def extract_comments(text): - """Find the comments in a YAML document, and the setting each describes. - - A comment on its own line describes the setting that follows it. A comment - at the end of a line describes the setting on that line. - - :param text: The YAML document. - :returns: A tuple of a dictionary mapping a key path (a tuple of keys and - list indices) to ``{"before": [lines], "trailing": text}``, and a list - of comments that couldn't be attached to a setting. - """ - root = yaml.compose(text, Loader=_Loader) - comments = {} - unplaced = [] - if root is None: - return comments, unplaced - - starts = {} - ends = {} - _walk_nodes(root, (), starts, ends) - - pending = [] - for number, line in enumerate(text.splitlines()): - stripped = line.strip() - if stripped.startswith("#"): - comment = stripped[1:].removeprefix(" ").rstrip() - # Editor directives for YAML (such as the MkDocs schema) don't - # apply to TOML. - if not comment.startswith("yaml-language-server:"): - pending.append(comment) - continue - if not stripped: - continue - if number in starts and pending: - comments.setdefault(starts[number][0], {}).setdefault("before", []).extend( - pending - ) - pending = [] - if number in ends: - match = re.match(r"^[\s:]*#\s?(.*)$", line[ends[number] :]) - if match: - if number in starts: - comments.setdefault(starts[number][-1], {})["trailing"] = ( - match.group(1).rstrip() - ) - else: - unplaced.append(match.group(1)) - unplaced.extend(pending) - return comments, unplaced - - -def load_yaml(path): - """Load a YAML configuration file, and its comments.""" - text = Path(path).read_text(encoding="utf-8") - try: - data = yaml.load(text, Loader=_Loader) or {} - except yaml.YAMLError as e: - raise ConversionError(f"Unable to read {path}: {e}") from e - comments, unplaced = extract_comments(text) - return data, comments, unplaced - - -########################################################################### -# Converting values -########################################################################### - - -def _rename_comments(comments, old_prefix, new_prefix): - """Move the comments under one key path to another key path.""" - for path in list(comments): - if path[: len(old_prefix)] == old_prefix: - comments[(*new_prefix, *path[len(old_prefix) :])] = comments.pop(path) - - -def normalize_named_items(value, path, comments): - """Convert a `markdown_extensions` or `plugins` setting to a table. - - MkDocs allows these settings to be a list of names, or of single-key - mappings; TOML needs a table. A missing configuration becomes an empty - table. - """ - if value is None: - return {} - if isinstance(value, dict): - return {name: {} if conf is None else conf for name, conf in value.items()} - if not isinstance(value, list): - raise ConversionError(f"{'.'.join(path)} must be a list or a mapping") - - result = {} - for index, item in enumerate(value): - if isinstance(item, str): - name, conf = item, {} - _rename_comments(comments, (*path, index), (*path, name)) - elif isinstance(item, dict) and len(item) == 1: - [(name, conf)] = item.items() - conf = {} if conf is None else conf - # Comments on the item, and on its key, both describe the setting. - item_comments = comments.pop((*path, index), {}) - _rename_comments(comments, (*path, index, name), (*path, name)) - if item_comments: - merged = comments.setdefault((*path, name), {}) - merged["before"] = item_comments.get("before", []) + merged.get( - "before", [] - ) - if "trailing" in item_comments and "trailing" not in merged: - merged["trailing"] = item_comments["trailing"] - else: - raise ConversionError(f"Unexpected entry in {'.'.join(path)}: {item!r}") - result[name] = conf - return result - - -def to_toml_data(value, path, notes, python_names): - """Convert a value loaded from YAML into a value that can be written as TOML. - - :param value: The value to convert. - :param path: The key path of the value, for messages. - :param notes: A list to which notes about the conversion are added. - :param python_names: A set to which the strings converted from Python - names are added. - """ - name = ".".join(str(part) for part in path) - if isinstance(value, PythonName): - notes.append(f"{name}: Python name converted to the string {str(value)!r}") - python_names.add(str(value)) - return str(value) - if isinstance(value, EnvTag): - raise ConversionError( - f"{name} uses !ENV, which isn't supported in TOML. Remove it from the " - "YAML configuration, and convert again." - ) - if isinstance(value, dict): - result = {} - for key, child in value.items(): - if not isinstance(key, str): - raise ConversionError(f"{name} has a non-string key: {key!r}") - if child is None: - notes.append( - f"{name}.{key}: dropped, because it has no value (null), which " - "Zensical treats the same as not setting it" - ) - continue - result[key] = to_toml_data(child, (*path, key), notes, python_names) - return result - if isinstance(value, list): - if any(item is None for item in value): - raise ConversionError(f"{name} contains a null value") - return [ - to_toml_data(item, (*path, index), notes, python_names) - for index, item in enumerate(value) - ] - if isinstance(value, (str, bool, int, float, datetime.date)): - return value - raise ConversionError(f"{name} has a value that can't be converted: {value!r}") - - -########################################################################### -# Navigation -########################################################################### - - -def resolve_literate_nav(docs_dir, plugin_config, yaml_nav, exclude_globs=()): - """Resolve the navigation the literate-nav plugin would have generated. - - This uses literate-nav's own parser, so the result is the navigation that - MkDocs used. - - :param docs_dir: The directory containing the (English) Markdown content. - :param plugin_config: The configuration of the literate-nav plugin. - :param yaml_nav: The `nav` setting from the configuration, if any. - :param exclude_globs: Glob patterns (as used by the `exclude` plugin) of - files that are removed from the site before literate-nav runs. - :returns: A tuple of the resolved navigation, and the list of navigation - files (relative to the docs directory) that were used. - """ - try: - from mkdocs.structure.files import Files, InclusionLevel, get_files - from mkdocs_literate_nav.plugin import resolve_directories_in_nav - except ImportError as e: - raise ConversionError( - "Converting a literate-nav navigation file requires mkdocs-literate-nav. " - "Install it with `python -m pip install mkdocs-literate-nav==0.6.3`, or " - "install beeware-docs-tools with the `convert` extra." - ) from e - - unsupported = set(plugin_config) - {"nav_file", "implicit_index", "tab_length"} - if unsupported: - raise ConversionError( - f"Unsupported literate-nav settings: {', '.join(sorted(unsupported))}" - ) - - import fnmatch - - with tempfile.TemporaryDirectory() as site_dir: - files = get_files( - { - "docs_dir": str(docs_dir), - "site_dir": site_dir, - "use_directory_urls": True, - "exclude_docs": None, - "draft_docs": None, - "not_in_nav": None, - } - ) - if exclude_globs: - files = Files( - [ - file - for file in files - if not any(fnmatch.fnmatch(file.src_path, g) for g in exclude_globs) - ] - ) - - nav_file = plugin_config.get("nav_file", "SUMMARY.md") - nav = resolve_directories_in_nav( - yaml_nav, - files, - nav_file_name=nav_file, - implicit_index=plugin_config.get("implicit_index", False), - markdown_config={ - "extensions": [], - "extension_configs": {}, - "tab_length": plugin_config.get("tab_length", 4), - }, - ) - nav_files = [ - file.src_uri - for file in files - if file.name == Path(nav_file).stem - and file.inclusion == InclusionLevel.NOT_IN_NAV - ] - nav_comments = {} - return _clean_nav(nav, nav_comments), nav_files, nav_comments - - -_HTML_COMMENT = re.compile(r"<!--(.*?)-->", re.DOTALL) - - -def _clean_nav(nav, comments=None, path=()): - """Convert a resolved navigation into plain lists, strings and mappings. - - literate-nav represents an untitled page as ``{None: path}``; in a `nav` - setting, that is written as the bare path. - - An HTML comment in a navigation file becomes part of the title of the item - it follows (where it isn't visible, because it's rendered as a comment). - These are removed from the title, and recorded in ``comments``. - - :param nav: The resolved navigation. - :param comments: A dictionary that will map the index path of an item to - the comments that were removed from its title. - :param path: The index path of ``nav``. - """ - if comments is None: - comments = {} - result = [] - for index, item in enumerate(nav): - if isinstance(item, dict): - if len(item) != 1: - raise ConversionError(f"Unexpected navigation entry: {item!r}") - [(title, value)] = item.items() - if isinstance(value, list): - value = _clean_nav(value, comments, (*path, index)) - if title is not None: - found = [c.strip() for c in _HTML_COMMENT.findall(title)] - if found: - comments[(*path, index)] = found - title = " ".join(_HTML_COMMENT.sub(" ", title).split()) - result.append(value if title is None else {title: value}) - else: - result.append(item) - return result - - -def nav_titles(nav): - """The set of titles in a `nav` setting.""" - titles = set() - - def accumulate(entry): - titles.add(entry) - return entry - - process_nav(nav, accumulate) - return titles - - -########################################################################### -# Writing TOML -########################################################################### - -_BARE_KEY = re.compile(r"^[A-Za-z0-9_-]+$") -_LINE_LENGTH = 88 -_INDENT = " " - - -def _escape(text): - """Escape text for use in a TOML basic string.""" - text = json.dumps(text, ensure_ascii=False)[1:-1] - return text.replace("\x7f", "\\u007f") - - -def toml_key(key): - """Format a key, quoting it if necessary. Keys are always on a single line.""" - return key if _BARE_KEY.match(key) else f'"{_escape(key)}"' - - -def toml_string(value): - """Format a string as a TOML basic string (multi-line if it contains newlines).""" - if "\n" in value.rstrip("\n") or value.endswith("\n") and len(value) > 1: - lines = value.split("\n") - body = "\n".join(_escape(line) for line in lines) - return f'"""\n{body}"""' - return f'"{_escape(value)}"' - - -def toml_scalar(value): - if isinstance(value, bool): - return "true" if value else "false" - if isinstance(value, int): - return str(value) - if isinstance(value, float): - if math.isnan(value): - return "nan" - if math.isinf(value): - return "inf" if value > 0 else "-inf" - return repr(value) - if isinstance(value, str): - return toml_string(value) - if isinstance(value, datetime.date): - return value.isoformat() - raise ConversionError(f"Can't write {value!r} as TOML") - - -def toml_inline(value): - """Format a value on a single line.""" - if isinstance(value, dict): - if not value: - return "{}" - items = ", ".join(f"{toml_key(k)} = {toml_inline(v)}" for k, v in value.items()) - return f"{{ {items} }}" - if isinstance(value, list): - return "[" + ", ".join(toml_inline(v) for v in value) + "]" - return toml_scalar(value) - - -def _is_table(value): - return isinstance(value, dict) and bool(value) - - -def _is_array_of_tables(value): - return ( - isinstance(value, list) - and bool(value) - and all(isinstance(item, dict) for item in value) - and any(any(isinstance(v, dict) for v in item.values()) for item in value) - ) - - -class TomlWriter: - """Write configuration data as TOML, with comments. - - :param comments: The comments to include, keyed by key path, as returned - by ``extract_comments()``. - :param path_map: A function that maps a key path in the TOML data to the key - path of the original YAML setting (for finding comments). - :param nav_comments: Comments for items in the `nav` setting, keyed by - the index path of the item. - """ - - def __init__(self, comments, path_map=lambda path: path, nav_comments=None): - self.comments = comments - self.path_map = path_map - self.nav_comments = nav_comments or {} - self.used = set() - self.lines = [] - - def _comments(self, path): - yaml_path = self.path_map(path) - found = self.comments.get(yaml_path) - if found: - self.used.add(yaml_path) - return found - return {} - - def _before(self, path, indent=""): - for line in self._comments(path).get("before", []): - self.lines.append(f"{indent}# {line}".rstrip()) - - def _trailing(self, path): - trailing = self._comments(path).get("trailing") - return f" # {trailing}" if trailing else "" - - def unused_comments(self): - return { - path: comment - for path, comment in self.comments.items() - if path not in self.used - } - - def blank(self): - if self.lines and self.lines[-1] != "": - self.lines.append("") - - def text(self): - while self.lines and self.lines[-1] == "": - self.lines.pop() - return "\n".join(self.lines) + "\n" - - # Values - - def key_value(self, key, value, path, indent=""): - """Write `key = value`, where `key` may be a dotted key.""" - self._before(path, indent) - trailing = self._trailing(path) - if isinstance(value, list) and self._multiline_array(value, path, key, indent): - line = f"{indent}{key} = [" - self.lines.append(line + trailing) - self._array_items(value, path, indent + _INDENT) - self.lines.append(f"{indent}]") - return - if isinstance(value, str) and "\n" in value: - self.lines.append(f"{indent}{key} = {toml_string(value)}{trailing}") - return - self.lines.append(f"{indent}{key} = {toml_inline(value)}{trailing}") - - def _multiline_array(self, value, path, key, indent): - if not value: - return False - if any(isinstance(item, (dict, list)) for item in value): - return True - if any(self._comments((*path, index)) for index in range(len(value))): - return True - return len(f"{indent}{key} = {toml_inline(value)}") > _LINE_LENGTH - - def _array_items(self, value, path, indent): - for index, item in enumerate(value): - item_path = (*path, index) - self._before(item_path, indent) - if isinstance(item, list) and item: - self.lines.append(f"{indent}[{self._trailing(item_path)}") - self._array_items(item, item_path, indent + _INDENT) - self.lines.append(f"{indent}],") - else: - self.lines.append( - f"{indent}{toml_inline(item)},{self._trailing(item_path)}" - ) - - def dotted_values(self, prefix, value, path, indent=""): - """Write a table as dotted keys (`a.b.c = value`) in the current table.""" - if not _is_table(value): - self.key_value(prefix, value, path, indent) - return - # Comments on the table itself go above its first value. - comments = self._comments(path) - for line in comments.get("before", []): - self.lines.append(f"{indent}# {line}".rstrip()) - if "trailing" in comments: - self.lines.append(f"{indent}# {comments['trailing']}".rstrip()) - for key, child in value.items(): - self.dotted_values(f"{prefix}.{toml_key(key)}", child, (*path, key), indent) - - def nav(self, key, nav, path): - """Write a `nav` setting, as nested arrays of inline tables.""" - self._before(path) - self.lines.append(f"{key} = [{self._trailing(path)}") - self._nav_items(nav, _INDENT, ()) - self.lines.append("]") - - def _nav_items(self, items, indent, path): - for index, item in enumerate(items): - for comment in self.nav_comments.get((*path, index), []): - for line in comment.splitlines(): - self.lines.append(f"{indent}# {line.strip()}".rstrip()) - if isinstance(item, str): - self.lines.append(f"{indent}{toml_string(item)},") - continue - if not isinstance(item, dict) or len(item) != 1: - raise ConversionError(f"Unexpected navigation entry: {item!r}") - [(title, value)] = item.items() - # Titles are always quoted, for consistency. - key = f'"{_escape(title)}"' - if isinstance(value, list): - self.lines.append(f"{indent}{{ {key} = [") - self._nav_items(value, indent + _INDENT, (*path, index)) - self.lines.append(f"{indent}] }},") - else: - self.lines.append(f"{indent}{{ {key} = {toml_inline(value)} }},") - - # Tables - - def table(self, path, table, header_style=None): - """Write a table, and all of its subtables. - - :param path: The key path of the table. - :param table: The table's content. - :param header_style: Optional function that takes a key path and returns - the way to write that table: "dotted" (as dotted keys in the parent - table), "nav", or None (as a table with a header). - """ - header_style = header_style or (lambda path: None) - if not isinstance(table, dict): - raise ConversionError(f"{'.'.join(path)} must be a table") - simple = [] - subtables = [] - for key, value in table.items(): - child = (*path, key) - style = header_style(child) - if style in {"dotted", "nav"} or ( - style != "table" - and not (_is_table(value) or _is_array_of_tables(value)) - ): - simple.append((key, value, style)) - else: - subtables.append((key, value)) - - header = ".".join(toml_key(key) for key in path) - if path and (simple or not subtables or self._comments(path)): - self.blank() - self._before(path) - self.lines.append(f"[{header}]{self._trailing(path)}") - - for key, value, style in simple: - child = (*path, key) - if style == "nav": - self.nav(toml_key(key), value, child) - elif style == "dotted": - key_text = ( - _extension_key(key) - if path[-1:] == ("markdown_extensions",) - else toml_key(key) - ) - self.dotted_values(key_text, value, child) - else: - self.key_value(toml_key(key), value, child) - - for key, value in subtables: - child = (*path, key) - if isinstance(value, dict): - self.table(child, value, header_style) - else: - self.array_of_tables(child, value) - - def array_of_tables(self, path, items): - header = ".".join(toml_key(key) for key in path) - self._before(path) - for index, item in enumerate(items): - item_path = (*path, index) - self.blank() - self._before(item_path) - self.lines.append(f"[[{header}]]{self._trailing(item_path)}") - for key, value in item.items(): - self.dotted_values(toml_key(key), value, (*item_path, key)) - - -def _extension_key(name): - """The TOML key for a Markdown extension. - - Zensical reads ``pymdownx.<name>`` and ``pymdownx.blocks.<name>`` (and the - same for ``zensical``) as dotted keys. Any other name containing a dot must - be quoted. - """ - parts = name.split(".") - if len(parts) == 1: - return toml_key(name) - if ( - parts[0] in {"pymdownx", "zensical"} - and (len(parts) == 2 or (len(parts) == 3 and parts[1] == "blocks")) - and all(_BARE_KEY.match(part) for part in parts) - ): - return name - return toml_string(name) - - -def _extension_order(name): - """The order Zensical reads dotted extension keys in. - - Zensical moves the ``pymdownx`` extensions (and then the ``zensical`` - extensions) after all the others. - """ - key = _extension_key(name) - if key.startswith("pymdownx."): - return 1 - if key.startswith("zensical."): - return 2 - return 0 - - -def write_config_toml(project, comments, nav_key=False, nav_comments=None): - """Format a ``[project]`` table as TOML. - - :param project: The configuration. - :param comments: The comments from the YAML file. - :param nav_key: True if the `nav` setting should be written as a navigation - tree. - :param nav_comments: Comments for items in the `nav` setting. - :returns: A tuple of the TOML text, and the comments that weren't written. - """ - project = dict(project) - - def path_map(path): - # The TOML data is nested under "project"; the YAML isn't. - return path[1:] - - writer = TomlWriter(comments, path_map, nav_comments) - - def header_style(path): - if path == ("project", "nav") and nav_key: - return "nav" - if len(path) == 3 and path[1] == "markdown_extensions": - return "dotted" - # Each plugin is written as a table, even if it's empty. - if len(path) == 3 and path[1] == "plugins": - return "table" - return None - - # Write the Markdown extensions in the order Zensical will read them in. - extensions = project.get("markdown_extensions") - if extensions: - project["markdown_extensions"] = dict( - sorted(extensions.items(), key=lambda item: _extension_order(item[0])) - ) - - writer.table(("project",), project, header_style) - return writer.text(), writer.unused_comments() - - -########################################################################### -# Equivalence checks -########################################################################### - - -def _callable_name(value): - return f"{value.__module__}.{value.__qualname__}" - - -def _normalize(value): - """Normalize a loaded configuration value for comparison. - - Python objects (from ``!!python/name:`` tags) are represented by their - dotted name, and null values (which can't be expressed in TOML, and which - Zensical treats the same as a missing value) are removed. - """ - if isinstance(value, dict): - return {k: _normalize(v) for k, v in value.items() if v is not None} - if isinstance(value, list): - return [_normalize(v) for v in value] - if callable(value): - return _callable_name(value) - return value - - -def _resolve_names(value, names): - """Resolve the strings that were converted from Python names to objects.""" - from zensical.config import _resolve - - if isinstance(value, dict): - return {k: _resolve_names(v, names) for k, v in value.items()} - if isinstance(value, list): - return [_resolve_names(v, names) for v in value] - if isinstance(value, str) and value in names: - return _callable_name(_resolve(value)) - return value - - -def _differences(old, new, path=()): - """List the differences between two normalized configuration values.""" - name = ".".join(str(p) for p in path) or "(root)" - if isinstance(old, dict) and isinstance(new, dict): - diffs = [] - for key in old.keys() | new.keys(): - if key not in new: - diffs.append(f"{name}.{key}: missing from the converted configuration") - elif key not in old: - diffs.append(f"{name}.{key}: added by the conversion") - else: - diffs.extend(_differences(old[key], new[key], (*path, key))) - return diffs - if old != new: - return [f"{name}: {old!r} became {new!r}"] - return [] - - -def _markdown_extensions(config): - from zensical.config import _convert_markdown_extensions - - names, configs = _convert_markdown_extensions( - config.pop("markdown_extensions", None) - ) - return names, configs - - -def compare_configs(old, new, python_names, allowed): - """Compare the configuration Zensical read from YAML with the converted one. - - The intended differences are: - - * `nav` is generated from the literate-nav navigation file (the - literate-nav plugin and its navigation file are removed); - * `site_url` is set from the environment, rather than with ``!ENV``; - * Python names are strings, rather than ``!!python/name:`` tags; and - * the Markdown extensions with dotted keys (``pymdownx.*``) are read after - the others. - - :param old: The configuration from ``zensical.config._yaml_load()``. - :param new: The merged TOML configuration. - :param python_names: The strings that were converted from Python names. - :param allowed: The intended differences that apply: a set containing any - of "nav" and "site_url". - :returns: A tuple of the list of unexpected differences, and a list of - notes about intended differences. - """ - # Named items with no configuration (`search:` or `- search`) are the same - # as an empty configuration; resolve that before null values are removed. - old = dict(old) - for setting in ("plugins", "markdown_extensions"): - value = old.get(setting) - if isinstance(value, list): - old[setting] = { - (item if isinstance(item, str) else next(iter(item))): ( - {} if isinstance(item, str) else next(iter(item.values())) - ) - for item in value - } - if isinstance(old.get(setting), dict): - old[setting] = {k: {} if v is None else v for k, v in old[setting].items()} - - old = _normalize(old) - new = _normalize(_resolve_names(new, python_names)) - notes = [] - - if "site_url" in allowed: - old.pop("site_url", None) - new.pop("site_url", None) - - old_plugins = old.get("plugins") or {} - if "nav" in allowed: - old_plugins.pop("literate-nav", None) - old.pop("nav", None) - new.pop("nav", None) - old["plugins"] = old_plugins - new.setdefault("plugins", {}) - if list(old_plugins) != list(new["plugins"]): - message = ( - f"plugins: order or names changed from {list(old_plugins)} to " - f"{list(new['plugins'])}" - ) - return [message], notes - - old_names, old_configs = _markdown_extensions(old) - new_names, new_configs = _markdown_extensions(new) - diffs = [] - if old_names != new_names: - if sorted(old_names) == sorted(new_names): - notes.append( - "Markdown extension order: " - + ", ".join(new_names) - + " (was " - + ", ".join(old_names) - + ")" - ) - else: - diffs.append(f"markdown_extensions: {old_names} became {new_names}") - diffs.extend( - _differences( - _normalize(old_configs), _normalize(new_configs), ("markdown_extensions",) - ) - ) - diffs.extend(_differences(old, new)) - return diffs, notes - - -########################################################################### -# Translations -########################################################################### - - -def migrate_nav_translations(po_path, nav_sources, titles, titles_occurrence): - """Migrate the navigation title translations in a PO file. - - Each title in the new `nav` setting gets an entry with the navigation - context (see `nav_translations`), carrying over the translation the - navigation previously displayed: the link text translation from the - literate-nav navigation file (``[Title]{1}``), or, for a section title, the - translation of the same text. The fuzzy flag is kept as it was. The - navigation file's references are then removed, along with any entries only - the navigation file used. - - :param po_path: The PO file to update. - :param nav_sources: The source references (as used in the PO file) of the - navigation files. - :param titles: The titles in the new `nav` setting. - :param titles_occurrence: The source reference to use for title entries. - :returns: A dictionary of counts and messages describing the migration. - """ - po = polib.pofile(str(po_path), wrapwidth=100000) - previous = polib.pofile(str(po_path), wrapwidth=100000) - report = {"migrated": 0, "untranslated": 0, "removed": 0, "unmapped": []} - - # A translated link that has lost its link markup can't be mapped. - for entry in previous: - if entry.obsolete or entry.msgctxt or not entry.msgstr: - continue - if not any(source in nav_sources for source, _ in entry.occurrences): - continue - link = LINK_RE.match(entry.msgid) - if link and link.group("title") in titles and not LINK_RE.match(entry.msgstr): - report["unmapped"].append(f"{entry.msgid!r} -> {entry.msgstr!r}") - - for title in dict.fromkeys(titles): - nav_entry = po.find(title, msgctxt=NAV_CONTEXT) - if nav_entry is None: - nav_entry = polib.POEntry( - msgid=title, - msgctxt=NAV_CONTEXT, - msgstr="", - occurrences=[(titles_occurrence, "")], - ) - po.append(nav_entry) - if nav_entry.msgstr: - continue - if found := previous_translation(previous, title): - nav_entry.msgstr, nav_entry.flags = found - report["migrated"] += 1 - else: - report["untranslated"] += 1 - - for entry in list(po): - if entry.obsolete or entry.msgctxt: - continue - others = [o for o in entry.occurrences if o[0] not in nav_sources] - if len(others) == len(entry.occurrences): - continue - if others: - entry.occurrences = others - else: - po.remove(entry) - report["removed"] += 1 - - po.save(str(po_path)) - return report - - -########################################################################### -# Conversion -########################################################################### - - -def convert(docs, write=True, keep_old=False, out=print): - """Convert the MkDocs configuration in a ``docs`` directory. - - :param docs: The ``docs`` directory. - :param write: If False, check the conversion, but don't change any files. - :param keep_old: If True, don't delete the original files. - :param out: A function used to report progress. - :returns: True if the conversion succeeded. - """ - docs = Path(docs) - base_file = docs / "config.yml" - if not base_file.is_file(): - raise ConversionError(f"{base_file} doesn't exist") - language_files = sorted(docs.glob("mkdocs.*.yml")) - if not language_files: - raise ConversionError(f"No mkdocs.<lang>.yml files in {docs}") - languages = [path.name[len("mkdocs.") : -len(".yml")] for path in language_files] - - notes = [] - allowed = set() - python_names = set() - - # Load the base configuration. - base, base_comments, unplaced = load_yaml(base_file) - for comment in unplaced: - notes.append(f"{base_file.name}: comment not carried over: {comment!r}") - if "INHERIT" in base: - raise ConversionError(f"{base_file.name} uses INHERIT, which isn't supported") - - if isinstance(base.get("site_url"), EnvTag): - del base["site_url"] - allowed.add("site_url") - notes.append( - f"{base_file.name}: site_url (!ENV) removed; it's set from " - "READTHEDOCS_CANONICAL_URL at build time" - ) - - for setting in ("markdown_extensions", "plugins"): - if setting in base: - base[setting] = normalize_named_items( - base[setting], (setting,), base_comments - ) - - # Load the language configurations. - language_configs = {} - for language, path in zip(languages, language_files, strict=True): - config, comments, unplaced = load_yaml(path) - for comment in unplaced: - notes.append(f"{path.name}: comment not carried over: {comment!r}") - inherit = config.pop("INHERIT", None) - if inherit != "config.yml": - raise ConversionError( - f"{path.name} must have `INHERIT: config.yml` (found {inherit!r})" - ) - if isinstance(config.get("site_url"), EnvTag): - del config["site_url"] - allowed.add("site_url") - for setting in ("markdown_extensions", "plugins"): - if setting in config: - raise ConversionError( - f"{path.name} sets {setting}, which isn't supported in a " - "language file" - ) - language_configs[language] = (config, comments) - - # A literal `site_url` is kept. If every language file sets the same one, - # it's moved into the base configuration. - site_urls = { - str(config.get("site_url")) - for config, _ in language_configs.values() - if "site_url" in config - } - if ( - len(site_urls) == 1 - and all("site_url" in config for config, _ in language_configs.values()) - and base.get("site_url", next(iter(site_urls))) == next(iter(site_urls)) - ): - base["site_url"] = next(iter(site_urls)) - for config, comments in language_configs.values(): - del config["site_url"] - _rename_comments(comments, ("site_url",), ("removed",)) - notes.append( - f"site_url: the same value ({base['site_url']!r}) was set for every " - f"language, so it was moved into {BASE_CONFIG}" - ) - - # Note any plugins that Zensical doesn't support (and will ignore). - from zensical.config import _PLUGIN_UNSUPPORTED_OPTIONS - - for name in base.get("plugins", {}): - canonical = name.removeprefix("material/").split("/", 1)[0] - if canonical not in _PLUGIN_UNSUPPORTED_OPTIONS: - notes.append( - f"plugins.{name}: Zensical doesn't support this plugin, and will " - "ignore it" - ) - - # Convert the literate-nav navigation file into a `nav` setting. - nav_files = [] - nav_comments = {} - plugins = base.get("plugins", {}) - if "literate-nav" in plugins: - en_config = language_configs.get("en", ({}, {}))[0] - docs_dir = docs / en_config.get("docs_dir", base.get("docs_dir", "docs")) - exclude_globs = (plugins.get("exclude") or {}).get("glob", []) - nav, nav_files, nav_comments = resolve_literate_nav( - docs_dir, - plugins.pop("literate-nav") or {}, - base.get("nav"), - exclude_globs=exclude_globs, - ) - nav_files = [docs_dir / path for path in nav_files] - _rename_comments(base_comments, ("plugins", "literate-nav"), ("removed",)) - base["nav"] = nav - allowed.add("nav") - notes.append( - "nav: generated from " - + ", ".join(str(path.relative_to(docs.parent)) for path in nav_files) - + "; the literate-nav plugin was removed" - ) - - # Convert the values to TOML-compatible data. - def convert_values(config, label): - conversion_notes = [] - data = to_toml_data(config, (), conversion_notes, python_names) - for note in conversion_notes: - notes.append(f"{label}: {note}") - return data - - base = convert_values(base, base_file.name) - language_data = { - language: (convert_values(config, f"mkdocs.{language}.yml"), comments) - for language, (config, comments) in language_configs.items() - } - - # Write the TOML files. - outputs = {} - text, unused = write_config_toml( - base, base_comments, nav_key=True, nav_comments=nav_comments - ) - outputs[BASE_CONFIG] = text - for path, comment in unused.items(): - if path and path[0] == "removed": - continue - notes.append( - f"{base_file.name}: comment not carried over ({'.'.join(map(str, path))}): " - f"{comment}" - ) - for language, (config, comments) in language_data.items(): - text, unused = write_config_toml(config, comments) - outputs[language_config_name(language)] = text - for path, comment in unused.items(): - if path and path[0] == "removed": - continue - notes.append( - f"mkdocs.{language}.yml: comment not carried over " - f"({'.'.join(map(str, path))}): {comment}" - ) - - # Check the converted configuration against what Zensical reads from YAML. - from zensical.config import _yaml_load - - failed = False - with tempfile.TemporaryDirectory() as temp: - temp_path = Path(temp) - for name, text in outputs.items(): - (temp_path / name).write_text(text, encoding="utf-8") - try: - tomllib.loads(text) - except tomllib.TOMLDecodeError as e: - raise ConversionError(f"Generated invalid TOML for {name}: {e}") from e - - new_base = read_toml(temp_path / BASE_CONFIG) - reported_notes = set() - for language, path in zip(languages, language_files, strict=True): - with path.open(encoding="utf-8") as f: - old = _yaml_load(f) - language_config = read_toml(temp_path / language_config_name(language)) - for key in unexpected_language_keys(language_config): - notes.append( - f"{language_config_name(language)}: {key!r} isn't a per-language " - "setting; it will produce a warning at build time" - ) - new = merge_config(new_base, language_config) - diffs, check_notes = compare_configs(old, new, python_names, allowed) - for note in check_notes: - if note not in reported_notes: - reported_notes.add(note) - notes.append(note) - if diffs: - failed = True - out(f"{language}: the converted configuration differs:") - for diff in diffs: - out(f" {diff}") - else: - out(f"{language}: the converted configuration is equivalent") - - for note in notes: - out(f"Note: {note}") - - if failed: - out("Conversion failed; no files were changed.") - return False - - if not write: - out("Check complete; no files were changed (--check).") - return True - - for name, text in outputs.items(): - (docs / name).write_text(text, encoding="utf-8") - out(f"Wrote {docs / name}") - - # Migrate the translations of the navigation titles. - if nav_files: - titles = nav_titles(base["nav"]) - project_root = docs.parent - nav_sources = {path.relative_to(project_root).as_posix() for path in nav_files} - titles_occurrence = (docs / TITLES_FILE).relative_to(project_root).as_posix() - for po_path in sorted(docs.glob("locales/*/translations.po")): - report = migrate_nav_translations( - po_path, nav_sources, titles, titles_occurrence - ) - out( - f"{po_path}: {report['migrated']} navigation titles migrated, " - f"{report['untranslated']} untranslated, " - f"{len(report['unmapped'])} couldn't be mapped; " - f"{report['removed']} navigation-only entries removed" - ) - for unmapped in report["unmapped"]: - out(f" Couldn't map: {unmapped}") - - if not keep_old: - for path in [base_file, *language_files, *nav_files]: - path.unlink() - out(f"Removed {path}") - - return True - - -def main(): - parser = ArgumentParser( - description=( - "Convert docs/config.yml, docs/mkdocs.<lang>.yml and the literate-nav " - "navigation file into docs/zensical.toml and docs/zensical.<lang>.toml." - ) - ) - parser.add_argument( - "-d", - "--docs-directory", - type=Path, - default=Path("docs"), - help="The documentation directory. Default: docs", - ) - parser.add_argument( - "--check", - action="store_true", - help="Check the conversion, but don't change any files.", - ) - parser.add_argument( - "--keep-old", - action="store_true", - help="Don't delete the original YAML and navigation files.", - ) - args = parser.parse_args() - - try: - success = convert( - args.docs_directory, write=not args.check, keep_old=args.keep_old - ) - except ConversionError as e: - print(f"Error: {e}", file=sys.stderr) - sys.exit(1) - sys.exit(0 if success else 1) - - -if __name__ == "__main__": - main() diff --git a/tests/test_convert_mkdocs_config.py b/tests/test_convert_mkdocs_config.py deleted file mode 100644 index cbae28d8..00000000 --- a/tests/test_convert_mkdocs_config.py +++ /dev/null @@ -1,319 +0,0 @@ -import tomllib - -import polib -import pytest - -from beeware_docs_tools.build_config import load_config -from beeware_docs_tools.convert_mkdocs_config import ( - ConversionError, - compare_configs, - convert, - extract_comments, - toml_key, - toml_string, -) -from beeware_docs_tools.nav_translations import NAV_CONTEXT - -CONFIG_YML = """\ -# yaml-language-server: $schema=https://squidfunk.github.io/mkdocs-material/schema.json -copyright: Someone - -not_in_nav: | - /index.md - -extra: - project_name: example # The name of the project - alternate: - - name: English - link: /en/ - lang: en - -theme: - name: material - features: - - navigation.tabs - palette: - # Light mode - - media: "(prefers-color-scheme: light)" - scheme: default - toggle: - icon: material/brightness-7 - name: Switch to dark mode - -markdown_extensions: - - attr_list - - toc: - permalink: true - - pymdownx.highlight: {} # Highlights code - - pymdownx.emoji: - emoji_index: !!python/name:material.extensions.emoji.twemoji - - pymdownx.blocks.admonition: - types: - - note - - markdown.extensions.smarty: - smart_quotes: false - -plugins: - - search - - literate-nav: - nav_file: SUMMARY.md - - macros: - on_error_fail: true -""" - -MKDOCS_EN_YML = """\ -INHERIT: config.yml -site_name: Example -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: en - -theme: - language: en -""" - -MKDOCS_FR_YML = """\ -INHERIT: config.yml -site_name: Exemple -site_url: !ENV READTHEDOCS_CANONICAL_URL -docs_dir: fr - -theme: - language: fr - -extra: - language_url: fr/ -""" - -SUMMARY_MD = """\ -- [Home](index.md) -- Guide - - [Guide](guide/index.md) - - ./guide/* -- Reference - <!-- A comment about the reference --> - - [Reference](reference/index.md) - - [API](reference/api.md) -""" - - -@pytest.fixture -def project(tmp_path, monkeypatch): - monkeypatch.delenv("READTHEDOCS_CANONICAL_URL", raising=False) - monkeypatch.delenv("READTHEDOCS", raising=False) - docs = tmp_path / "docs" - (docs / "en/guide").mkdir(parents=True) - (docs / "en/reference").mkdir(parents=True) - (docs / "config.yml").write_text(CONFIG_YML, encoding="utf-8") - (docs / "mkdocs.en.yml").write_text(MKDOCS_EN_YML, encoding="utf-8") - (docs / "mkdocs.fr.yml").write_text(MKDOCS_FR_YML, encoding="utf-8") - (docs / "en/SUMMARY.md").write_text(SUMMARY_MD, encoding="utf-8") - for page in [ - "index.md", - "guide/index.md", - "guide/b.md", - "guide/a.md", - "reference/index.md", - "reference/api.md", - ]: - (docs / "en" / page).write_text(f"# {page}\n", encoding="utf-8") - - po = polib.POFile(wrapwidth=100000) - po.metadata = {"Content-Type": "text/plain; charset=UTF-8"} - for msgid, msgstr, flags in [ - ("[Home]{1}", "[Accueil]{1}", ["fuzzy"]), - ("Guide", "Guide FR", []), - ("[Guide]{1}", "[Le guide]{1}", []), - ("./guide/*", "./guide/*", []), - ("[Reference]{1}", "[Référence]{1}", []), - ("[API]{1}", "", []), - ]: - po.append( - polib.POEntry( - msgid=msgid, - msgstr=msgstr, - flags=flags, - occurrences=[("docs/en/SUMMARY.md", "1")], - ) - ) - po.append( - polib.POEntry( - msgid="Reference", - msgstr="", - occurrences=[("docs/en/reference/index.md", "1")], - ) - ) - (docs / "locales/fr").mkdir(parents=True) - po.save(str(docs / "locales/fr/translations.po")) - - monkeypatch.chdir(tmp_path) - return tmp_path - - -def test_convert(project): - """A project is converted, and the converted configuration is equivalent.""" - messages = [] - assert convert(project / "docs", out=messages.append) - docs = project / "docs" - - output = "\n".join(messages) - assert "en: the converted configuration is equivalent" in output - assert "fr: the converted configuration is equivalent" in output - - # The original files have been removed. - assert not (docs / "config.yml").exists() - assert not (docs / "mkdocs.en.yml").exists() - assert not (docs / "en/SUMMARY.md").exists() - - text = (docs / "zensical.toml").read_text(encoding="utf-8") - base = tomllib.loads(text)["project"] - - # The navigation is resolved, including wildcards; HTML comments are - # removed from titles, and kept as TOML comments. - assert base["nav"] == [ - {"Home": "index.md"}, - {"Guide": [{"Guide": "guide/index.md"}, "guide/a.md", "guide/b.md"]}, - { - "Reference": [ - {"Reference": "reference/index.md"}, - {"API": "reference/api.md"}, - ] - }, - ] - assert "# A comment about the reference" in text - assert "literate-nav" not in base["plugins"] - assert list(base["plugins"]) == ["search", "macros"] - assert "[project.plugins.search]" in text - - # Markdown extensions use dotted keys, with Python names as strings. - assert "pymdownx.highlight = {} # Highlights code" in text - assert 'pymdownx.emoji.emoji_index = "zensical.extensions.emoji.twemoji"' in text - assert '"markdown.extensions.smarty".smart_quotes = false' in text - assert "toc.permalink = true" in text - - # Comments are carried over, except YAML editor directives. - assert "yaml-language-server" not in text - assert 'project_name = "example" # The name of the project' in text - assert "# Light mode\n[[project.theme.palette]]" in text - assert 'toggle.icon = "material/brightness-7"' in text - - # The language files only contain the language settings. - fr = tomllib.loads((docs / "zensical.fr.toml").read_text(encoding="utf-8")) - assert fr == { - "project": { - "site_name": "Exemple", - "docs_dir": "fr", - "theme": {"language": "fr"}, - "extra": {"language_url": "fr/"}, - } - } - - # The result can be loaded. - config = load_config(project, "fr", env={}) - assert config["site_name"] == "Exemple" - assert config["theme"]["features"] == ["navigation.tabs"] - - -def test_convert_translations(project): - """Navigation title translations are migrated to navigation entries.""" - messages = [] - assert convert(project / "docs", out=messages.append) - - po = polib.pofile(str(project / "docs/locales/fr/translations.po")) - nav = {e.msgid: e for e in po if not e.obsolete and e.msgctxt == NAV_CONTEXT} - plain = {e.msgid: e for e in po if not e.obsolete and not e.msgctxt} - - # Link titles become navigation entries, keeping their flags. - assert nav["Home"].msgstr == "Accueil" - assert nav["Home"].fuzzy - assert nav["Home"].occurrences == [("docs/en/titles.md", "")] - # The link text translation is used, as that's what the navigation showed. - assert nav["Guide"].msgstr == "Le guide" - assert not nav["Guide"].fuzzy - # A navigation title gets the link text translation, even though the page - # heading with the same text is untranslated; the heading is unchanged. - assert nav["Reference"].msgstr == "Référence" - assert plain["Reference"].msgstr == "" - assert plain["Reference"].occurrences == [("docs/en/reference/index.md", "1")] - # An untranslated link title becomes an untranslated navigation entry. - assert nav["API"].msgstr == "" - # Entries that were only used by the navigation file are removed. - assert not any("{1}" in msgid for msgid in plain) - assert "./guide/*" not in plain - assert "Guide" not in plain - - output = "\n".join(messages) - assert "3 navigation titles migrated, 1 untranslated" in output - - -def test_check_doesnt_write(project): - """In check mode, nothing is changed.""" - messages = [] - assert convert(project / "docs", write=False, out=messages.append) - assert (project / "docs/config.yml").exists() - assert not (project / "docs/zensical.toml").exists() - - -def test_keep_old(project): - """The original files can be kept.""" - assert convert(project / "docs", keep_old=True, out=lambda msg: None) - assert (project / "docs/config.yml").exists() - assert (project / "docs/en/SUMMARY.md").exists() - assert (project / "docs/zensical.toml").exists() - - -def test_unsupported_env(project): - """!ENV can only be used for site_url.""" - config = project / "docs/config.yml" - config.write_text( - config.read_text(encoding="utf-8") + "repo_url: !ENV REPO_URL\n", - encoding="utf-8", - ) - with pytest.raises(ConversionError, match="repo_url uses !ENV"): - convert(project / "docs", out=lambda msg: None) - - -def test_compare_configs_detects_differences(): - """Unintended differences are reported.""" - old = { - "site_name": "A", - "plugins": {"search": None}, - "markdown_extensions": ["toc"], - "theme": {"features": ["a", "b"]}, - } - new = { - "site_name": "A", - "plugins": {"search": {}}, - "markdown_extensions": {"toc": {}}, - "theme": {"features": ["a"]}, - } - diffs, _ = compare_configs(old, new, set(), set()) - assert diffs == ["theme.features: ['a', 'b'] became ['a']"] - - -def test_extract_comments(): - """Comments are attached to the setting they describe.""" - comments, unplaced = extract_comments( - "# Before a\na: 1 # After a\nb:\n # Before c\n - c # After c\n# Dangling\n" - ) - assert comments[("a",)] == {"before": ["Before a"], "trailing": "After a"} - assert comments[("b", 0)] == {"before": ["Before c"], "trailing": "After c"} - assert unplaced == ["Dangling"] - - -@pytest.mark.parametrize( - "value, expected", - [ - ("simple", '"simple"'), - ('quote " and \\ backslash', '"quote \\" and \\\\ backslash"'), - ("line\nbreak\n", '"""\nline\nbreak\n"""'), - ], -) -def test_toml_string(value, expected): - assert toml_string(value) == expected - assert tomllib.loads(f"x = {expected}")["x"] == value - - -def test_toml_key(): - assert toml_key("bare_key-1") == "bare_key-1" - assert toml_key("needs quotes") == '"needs quotes"' - assert toml_key("multi\nline") == '"multi\\nline"' diff --git a/tox.ini b/tox.ini index c681d9fe..6ef8bfa9 100644 --- a/tox.ini +++ b/tox.ini @@ -12,7 +12,6 @@ commands = pre-commit run --all-files --show-diff-on-failure --color=always package = wheel wheel_build_env = .pkg depends: pre-commit -extras = convert dependency_groups = test commands = python -X warn_default_encoding -m pytest {posargs:-vv --color yes} From b3a1e0323ca640469251eb3e61af5a73c407e4c7 Mon Sep 17 00:00:00 2001 From: Kattni <kattni@kattni.com> Date: Thu, 5 Nov 2026 23:33:54 -0500 Subject: [PATCH 5/5] Mark the current page in the sidebar using Zensical's active flags. The nav-item override compared navigation items with the page object, which never matches under Zensical, so the current page's table of contents wasn't shown under its link in the sidebar, and the active link was only highlighted by JavaScript. Use .active, as Zensical's own template does, and import the language helpers into the TOC partial, which is now rendered there. --- src/beeware_docs_tools/overrides/partials/nav-item.html | 4 ++-- src/beeware_docs_tools/overrides/partials/toc.html | 1 + 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/src/beeware_docs_tools/overrides/partials/nav-item.html b/src/beeware_docs_tools/overrides/partials/nav-item.html index f652b6ad..6e0914a5 100644 --- a/src/beeware_docs_tools/overrides/partials/nav-item.html +++ b/src/beeware_docs_tools/overrides/partials/nav-item.html @@ -191,7 +191,7 @@ <!-- Toggle to expand nested items with link to index page --> {% else %} - {% set class = "md-nav__link--active" if index == page %} + {% set class = "md-nav__link--active" if index.active %} <div class="md-nav__link md-nav__container"> <a href="{{ index.url | url }}" @@ -249,7 +249,7 @@ </li> <!-- Currently active page --> - {% elif nav_item == page %} + {% elif nav_item.active %} <li class="{{ class }}"> {% set toc = page.toc %} diff --git a/src/beeware_docs_tools/overrides/partials/toc.html b/src/beeware_docs_tools/overrides/partials/toc.html index 40d2619a..fa5c3b86 100644 --- a/src/beeware_docs_tools/overrides/partials/toc.html +++ b/src/beeware_docs_tools/overrides/partials/toc.html @@ -21,6 +21,7 @@ --> <!-- Determine title --> +{% import "partials/language.html" as lang with context %} {% set title = lang.t("toc") %} {% if config.mdx_configs.toc and config.mdx_configs.toc.title %} {% set title = config.mdx_configs.toc.title %}