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..a2b2eb7f 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,58 @@ 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`. + ## 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 +62,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 +76,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..7f42819e 100644 --- a/docs/en/section_one/page_two.md +++ b/docs/en/section_one/page_two.md @@ -10,10 +10,14 @@ 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 -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 69ab8b9a..4f2573d8 100644 --- a/docs/locales/ar/translations.po +++ b/docs/locales/ar/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, fuzzy -msgid "Shared content testbed" -msgstr "منصة اختبار المحتوى المشترك" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[منصة اختبار المحتوى المشترك]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "How-to guides" -msgstr "أدلة إرشادية" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, fuzzy -msgid "Policies" -msgstr "السياسات" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[سياسة الذكاء الاصطناعي]{1}" - -#: docs/en/SUMMARY.md:7 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}\"" @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "القسم الثاني" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "القسم الثالث" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "تنفيذ ميزة جديدة" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "كتابة الوثائق" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "تصنيف مشكلة" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "مراجعة طلب سحب" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "اقتراح ميزة جديدة" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "ترجمة المحتوى" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "استخدم الأدوات" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "إضافة ملاحظة تغيير" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "تقديم مراجعة" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "عملية الإصدار" + +#: 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 300816ce..880d3123 100644 --- a/docs/locales/cs/translations.po +++ b/docs/locales/cs/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, 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 -#, fuzzy -msgid "How-to guides" -msgstr "Návody" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}“" @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "Část druhá" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Část třetí" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "Implementovat novou funkci" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Napsat dokumentaci" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Třídění problému" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "Zkontrolujte žádost o stažení" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Navrhnout novou funkci" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "Přeložit obsah" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "Použijte nástroje" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Přidání poznámky o změně" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "Poskytnutí recenze" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Proces uvolnění" + +#: 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 5ae6fc3f..2f01b7b8 100644 --- a/docs/locales/da/translations.po +++ b/docs/locales/da/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, 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 -#, fuzzy -msgid "How-to guides" -msgstr "Vejledninger" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, fuzzy -msgid "Policies" -msgstr "Retningslinjer" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[AI-politik]{1}" - -#: docs/en/SUMMARY.md:7 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}\"" @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "Afsnit to" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Afsnit tre" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "Implementer en ny funktion" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Skriv dokumentation" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Prioriter et problem" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "Gennemgå en pull-anmodning" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Foreslå en ny funktion" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "Oversæt indhold" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "Brug værktøjerne" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Tilføjelse af en ændringsnote" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "Giver en anmeldelse" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Frigivelsesproces" + +#: 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 adcbbd08..2fc0a729 100644 --- a/docs/locales/de/translations.po +++ b/docs/locales/de/translations.po @@ -12,235 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, 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 -#, fuzzy -msgid "How-to guides" -msgstr "Anleitungen" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, fuzzy -msgid "Policies" -msgstr "Richtlinien" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[KI-Richtlinie]{1}" - -#: docs/en/SUMMARY.md:7 -#, 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" @@ -256,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\" %}" @@ -274,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\" %}" @@ -314,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\" %}" @@ -323,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\" %}" @@ -332,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\" %}" @@ -346,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\" %}" @@ -374,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\" %}" @@ -383,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\" %}" @@ -417,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\" %}" @@ -426,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\" %}" @@ -445,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\" %}" @@ -495,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\" %}" @@ -504,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\" %}" @@ -606,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 @@ -632,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 @@ -776,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 @@ -865,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 @@ -1014,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() }}\"" @@ -1077,3 +922,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "Abschnitt zwei" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Abschnitt drei" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "Implementierung einer neuen Funktion" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Dokumentation schreiben" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Triage eines Problems" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "Eine Pull-Anfrage überprüfen" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Vorschlag für ein neues Merkmal" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "Inhalt übersetzen" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "Benutze die Werkzeuge" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Hinzufügen einer Änderungsnotiz" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "Bereitstellung einer Rezension" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Freigabeprozess" + +#: 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 7c6cf84d..62e911d9 100644 --- a/docs/locales/es/translations.po +++ b/docs/locales/es/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, 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 -#, fuzzy -msgid "How-to guides" -msgstr "Guías prácticas" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}»." @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "Sección dos" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Sección tres" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "Implementar una nueva función" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Escribir documentación" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Clasificar un problema" + +#: 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:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Proponer una nueva función" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "Traducir contenido" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "Utilice las herramientas" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Añadir una nota de cambio" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "Proporcionar una reseña" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Proceso de liberación" + +#: 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 3a09399a..e8ea7fd8 100644 --- a/docs/locales/fa/translations.po +++ b/docs/locales/fa/translations.po @@ -12,233 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, fuzzy -msgid "Shared content testbed" -msgstr "محیط آزمایشی محتوای مشترک" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[محیط آزمایشی محتوای مشترک]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "How-to guides" -msgstr "راهنمای چگونگی انجام" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, fuzzy -msgid "Policies" -msgstr "سیاست‌ها" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[سیاست‌گذاری هوش مصنوعی]{1}" - -#: docs/en/SUMMARY.md:7 -#, 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" @@ -254,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\" %}" @@ -272,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\" %}" @@ -312,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\" %}" @@ -321,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\" %}" @@ -330,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\" %}" @@ -344,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\" %}" @@ -372,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\" %}" @@ -381,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\" %}" @@ -412,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\" %}" @@ -421,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\" %}" @@ -440,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\" %}" @@ -490,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\" %}" @@ -499,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\" %}" @@ -601,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 @@ -626,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 @@ -771,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 @@ -857,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 @@ -1006,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() }}»" @@ -1069,3 +915,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "بخش دوم" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "بخش سوم" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "پیاده‌سازی یک ویژگی جدید" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "مستندسازی بنویسید" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "اولویت‌بندی یک مسئله" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "بررسی یک درخواست کشش" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "پیشنهاد یک ویژگی جدید" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "محتوا را ترجمه کنید" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "ابزارها را استفاده کنید" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "افزودن یادداشت تغییر" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "ارائه یک نقد" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "فرآیند انتشار" + +#: 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 aaea08a2..21f0b8ce 100644 --- a/docs/locales/fr/translations.po +++ b/docs/locales/fr/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, 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 -#, fuzzy -msgid "How-to guides" -msgstr "Guides pratiques" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -316,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\" %}" @@ -325,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\" %}" @@ -334,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\" %}" @@ -348,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\" %}" @@ -376,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\" %}" @@ -385,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\" %}" @@ -419,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\" %}" @@ -428,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\" %}" @@ -447,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\" %}" @@ -497,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\" %}" @@ -506,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\" %}" @@ -608,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 @@ -634,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 @@ -778,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 @@ -867,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 @@ -1016,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() }}\"" @@ -1079,3 +925,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "Section deux" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Section trois" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "Mettre en œuvre une nouvelle fonctionnalité" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Write documentation" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Triage d'un problème" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "Examiner une demande d'extraction" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Proposer une nouvelle fonctionnalité" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "Traduire le contenu" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "Utiliser les outils" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Ajouter une note de modification" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "Fournir un avis" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Processus de libération" + +#: 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 660c734d..6f2f9a52 100644 --- a/docs/locales/it/translations.po +++ b/docs/locales/it/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, 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 -#, fuzzy -msgid "How-to guides" -msgstr "Guide pratiche" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}\"" @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "Sezione due" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Sezione tre" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "Implementare una nuova funzionalità" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Scrivere la documentazione" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Valutare un problema" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "Esamina una richiesta pull" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Proponi una nuova funzionalità" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "Traduci contenuto" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "Utilizza gli strumenti" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Aggiunta di una nota di modifica" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "Fornire una recensione" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Processo di rilascio" + +#: 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 755785e2..e1be8894 100644 --- a/docs/locales/ja/translations.po +++ b/docs/locales/ja/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, fuzzy -msgid "Shared content testbed" -msgstr "共有コンテンツ試験環境" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[共有コンテンツテストベッド]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "How-to guides" -msgstr "ハウツーガイド" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, fuzzy -msgid "Policies" -msgstr "方針" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[AIポリシー]{1}" - -#: docs/en/SUMMARY.md:7 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}」と言っている" @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "セクション2" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "セクション３" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "新機能の実装" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "ドキュメントを作成する" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "問題をトリアージする" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "プルリクエストをレビューする" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "新機能の提案" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "コンテンツを翻訳" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "ツールを使用する" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "変更メモの追加" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "レビューを提供すること" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "リリースプロセス" + +#: 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 d50f8bd5..a1bba74b 100644 --- a/docs/locales/ko/translations.po +++ b/docs/locales/ko/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, fuzzy -msgid "Shared content testbed" -msgstr "공유 콘텐츠 테스트베드" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[공유 콘텐츠 테스트베드]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "How-to guides" -msgstr "사용 방법 안내서" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, fuzzy -msgid "Policies" -msgstr "정책" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[AI 정책]{1}" - -#: docs/en/SUMMARY.md:7 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}\"라고 말한다." @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "제2절" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "제3절" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "새 기능 구현" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "문서 작성" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "문제를 분류하다" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "풀 리퀘스트 검토하기" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "새로운 기능 제안하기" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "번역 내용" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "도구를 사용하세요" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "변경 사항 추가" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "리뷰 제공" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "출시 절차" + +#: 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 395698c9..bfb742f1 100644 --- a/docs/locales/pl/translations.po +++ b/docs/locales/pl/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, 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 -#, fuzzy -msgid "How-to guides" -msgstr "Poradniki" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}”" @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "Sekcja druga" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Sekcja trzecia" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "Wdrożenie nowej funkcji" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Napisz dokumentację" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Klasyfikacja problemu" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "Sprawdź pull request" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Zaproponuj nową funkcję" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "Przetłumacz treść" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "Użyj narzędzi" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Dodanie uwagi dotyczącej zmiany" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "Przegląd" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Proces zwalniania" + +#: 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 26909bc3..c79b26d0 100644 --- a/docs/locales/pt/translations.po +++ b/docs/locales/pt/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, 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 -#, fuzzy -msgid "How-to guides" -msgstr "Guias práticos" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}”" @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "Seção dois" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Seção três" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "Implementar um novo recurso" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Escreva a documentação" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Classificar um problema" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "Revisar uma solicitação pull" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Proponha um novo recurso" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "Traduzir conteúdo" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "Use as ferramentas" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Adicionando uma nota de alteração" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "Fornecendo uma revisão" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Processo de liberação" + +#: 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 f10e7fa0..bad5bbde 100644 --- a/docs/locales/ru/translations.po +++ b/docs/locales/ru/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, fuzzy -msgid "Shared content testbed" -msgstr "Тестовая платформа для совместного использования контента" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Тестовая платформа для обмена контентом]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "How-to guides" -msgstr "Руководства по эксплуатации" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, fuzzy -msgid "Policies" -msgstr "Политики" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Политика в области искусственного интеллекта]{1}" - -#: docs/en/SUMMARY.md:7 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}»" @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "Раздел второй" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Раздел третий" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "Внедрить новую функцию" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Написать документацию" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Сортировка проблемы" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "Просмотреть запрос на вытягивание" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Предложить новую функцию" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "Перевести контент" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "Используйте инструменты" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Добавление примечания об изменении" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "Предоставление обзора" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Процесс выпуска" + +#: 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 ae3e877e..5e5ed916 100644 --- a/docs/locales/ta/translations.po +++ b/docs/locales/ta/translations.po @@ -12,233 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, fuzzy -msgid "Shared content testbed" -msgstr "பகிர்ந்த உள்ளடக்க சோதனைக்களம்" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[பகிர்ந்த உள்ளடக்க சோதனைக்களம்]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "How-to guides" -msgstr "செய்முறை வழிகாட்டிகள்" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, fuzzy -msgid "Policies" -msgstr "கொள்கைகள்" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[கலைப்புத்தி கொள்கை]{1}" - -#: docs/en/SUMMARY.md:7 -#, 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" @@ -254,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\" %}" @@ -272,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\" %}" @@ -312,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\" %}" @@ -321,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\" %}" @@ -330,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\" %}" @@ -344,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\" %}" @@ -372,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\" %}" @@ -381,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\" %}" @@ -412,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\" %}" @@ -421,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\" %}" @@ -440,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\" %}" @@ -490,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\" %}" @@ -499,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\" %}" @@ -601,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 @@ -626,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 @@ -771,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 @@ -857,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 @@ -1007,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() }}\"" @@ -1069,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "பிரிவு இரண்டு" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "பிரிவு மூன்று" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "ஒரு புதிய அம்சத்தைச் செயல்படுத்தவும்" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "தயாரிப்பு ஆவணங்களை எழுதுங்கள்" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "ஒரு சிக்கலை முன்னுரிமைப்படுத்துதல்" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "இழு கோரிக்கையை மதிப்பாய்வு செய்யவும்" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "புதிய அம்சத்தை முன்மொழியுங்கள்" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "உள்ளடக்கத்தை மொழிபெயர்க்கவும்" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "கருவிகளைப் பயன்படுத்துங்கள்" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "மாற்றக் குறிப்பைச் சேர்த்தல்" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "மதிப்பாய்வு வழங்குக" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "வெளியீட்டு செயல்முறை" + +#: 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 9f776f9c..87a8178c 100644 --- a/docs/locales/tr/translations.po +++ b/docs/locales/tr/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, 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 -#, fuzzy -msgid "How-to guides" -msgstr "Nasıl yapılır kılavuzları" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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." @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "İkinci bölüm" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Üçüncü bölüm" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "Yeni bir özellik ekleyin" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Belgeleri yazın" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Bir sorunu öncelik sırasına koymak" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "Çekme isteğini incele" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Yeni bir özellik önerin" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "İçeriği çevir" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "Araçları kullanın" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Değişiklik notu ekleme" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "İnceleme sunmak" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Serbest bırakma süreci" + +#: 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 b7185d40..9feaf379 100644 --- a/docs/locales/uk/translations.po +++ b/docs/locales/uk/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, fuzzy -msgid "Shared content testbed" -msgstr "Тестова платформа для спільного контенту" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[Тестова платформа для спільного контенту]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "How-to guides" -msgstr "Інструкції" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, fuzzy -msgid "Policies" -msgstr "Політики" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[Політика щодо штучного інтелекту]{1}" - -#: docs/en/SUMMARY.md:7 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -627,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 @@ -772,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 @@ -858,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 @@ -1008,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() }}»" @@ -1071,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "Розділ другий" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Розділ третій" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "Реалізувати нову функцію" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Створити документацію" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Оцінка проблеми" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "Переглянути запит на злиття" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Запропонувати нову функцію" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "Перекласти вміст" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "Скористайтеся інструментами" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Додавання примітки про зміну" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "Написання відгуку" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Процес випуску" + +#: 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 7f735c72..d2658263 100644 --- a/docs/locales/vi/translations.po +++ b/docs/locales/vi/translations.po @@ -12,235 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, 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 -#, fuzzy -msgid "How-to guides" -msgstr "Hướng dẫn thực hiện" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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 -#, 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" @@ -256,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\" %}" @@ -274,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\" %}" @@ -314,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\" %}" @@ -323,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\" %}" @@ -332,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\" %}" @@ -346,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\" %}" @@ -374,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\" %}" @@ -383,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\" %}" @@ -414,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\" %}" @@ -423,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\" %}" @@ -442,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\" %}" @@ -492,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\" %}" @@ -501,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\" %}" @@ -603,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 @@ -629,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 @@ -773,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 @@ -859,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 @@ -1009,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() }}\"" @@ -1072,3 +917,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "Phần hai" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "Phần ba" + +#: 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: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: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:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "Viết tài liệu" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "Phân loại vấn đề" + +#: 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:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "Đề xuất tính năng mới" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "Dịch nội dung" + +#: 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: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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "Thêm ghi chú thay đổi" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "Viết đánh giá" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "Quy trình phát hành" + +#: 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 951e701b..e406fd7e 100644 --- a/docs/locales/zh_CN/translations.po +++ b/docs/locales/zh_CN/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, fuzzy -msgid "Shared content testbed" -msgstr "共享内容测试平台" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[共享内容测试平台]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "How-to guides" -msgstr "操作指南" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, fuzzy -msgid "Policies" -msgstr "政策" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[人工智能政策]{1}" - -#: docs/en/SUMMARY.md:7 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}\"" @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "第二部分" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "第三部分" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "实现新功能" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "编写文档" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "对问题进行分级处理" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "审查拉取请求" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "提出新功能建议" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "翻译内容" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "使用工具" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "添加变更说明" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "提供评论" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "发布流程" + +#: 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 4bc96270..d2332b5e 100644 --- a/docs/locales/zh_TW/translations.po +++ b/docs/locales/zh_TW/translations.po @@ -12,234 +12,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Translate Toolkit 3.20.2\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 -#, 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 -#, fuzzy -msgid "Shared content testbed" -msgstr "共享內容測試平台" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[Shared content testbed]{1}" -msgstr "[共享內容測試平台]{1}" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "How-to guides" -msgstr "操作指南" - -#: docs/en/SUMMARY.md:7 -#, 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 -#, 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 -#, 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 -#, 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 -#, fuzzy -msgid "Policies" -msgstr "政策" - -#: docs/en/SUMMARY.md:7 -#, fuzzy -msgid "[AI Policy]{1}" -msgstr "[AI 政策]{1}" - -#: docs/en/SUMMARY.md:7 -#, 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" @@ -255,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\" %}" @@ -273,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\" %}" @@ -313,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\" %}" @@ -322,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\" %}" @@ -331,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\" %}" @@ -345,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\" %}" @@ -373,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\" %}" @@ -382,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\" %}" @@ -413,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\" %}" @@ -422,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\" %}" @@ -441,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\" %}" @@ -491,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\" %}" @@ -500,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\" %}" @@ -602,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 @@ -628,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 @@ -772,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 @@ -858,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 @@ -1007,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() }}」" @@ -1070,3 +916,165 @@ 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: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:9 +#, fuzzy +msgctxt "navigation" +msgid "Section two" +msgstr "第二節" + +#: docs/en/titles.md:11 +#, fuzzy +msgctxt "navigation" +msgid "Section three" +msgstr "第三節" + +#: 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: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:29 +#, fuzzy +msgctxt "navigation" +msgid "Implement a new feature" +msgstr "實作新功能" + +#: docs/en/titles.md:31 +#, fuzzy +msgctxt "navigation" +msgid "Write documentation" +msgstr "撰寫文件" + +#: docs/en/titles.md:33 +#, fuzzy +msgctxt "navigation" +msgid "Triage an issue" +msgstr "分級處理問題" + +#: docs/en/titles.md:35 +#, fuzzy +msgctxt "navigation" +msgid "Review a pull request" +msgstr "審閱拉取請求" + +#: docs/en/titles.md:37 +#, fuzzy +msgctxt "navigation" +msgid "Propose a new feature" +msgstr "提出新功能建議" + +#: docs/en/titles.md:39 +#, fuzzy +msgctxt "navigation" +msgid "Translate content" +msgstr "翻譯內容" + +#: docs/en/titles.md:41 +#, fuzzy +msgctxt "navigation" +msgid "Use the tools" +msgstr "使用工具" + +#: 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:59 +#, fuzzy +msgctxt "navigation" +msgid "Adding a change note" +msgstr "新增變更說明" + +#: docs/en/titles.md:63 +#, fuzzy +msgctxt "navigation" +msgid "Providing a review" +msgstr "提供評論" + +#: 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:75 +#, fuzzy +msgctxt "navigation" +msgid "Release process" +msgstr "釋放流程" + +#: 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/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/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/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 9b7325aa..07c4039d 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -27,12 +27,11 @@ 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-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 +40,9 @@ dependencies = [ "polib==1.2.0", "ruff==0.17.3", "setuptools_scm==10.3.4", + "tomli-w==1.2.0", "translate-toolkit==3.20.2", + "zensical==0.1.0", # Pre-1.0; pin exactly. ] [dependency-groups] @@ -126,7 +127,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/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 new file mode 100644 index 00000000..c71cd2d5 --- /dev/null +++ b/src/beeware_docs_tools/build_config.py @@ -0,0 +1,489 @@ +"""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 + +from .nav_translations import NAV_CONTEXT + +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 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. + + 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 + + # 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 + except (KeyError, PackageNotFoundError): + pass + + return config + + +def translate(po): + """Generate a translator function using the provided PO file.""" + + def _translate(entry): + # 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 + + +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..c4b373fb 100644 --- a/src/beeware_docs_tools/build_md_translations.py +++ b/src/beeware_docs_tools/build_md_translations.py @@ -1,11 +1,17 @@ -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 .api_directives import restore_api_blocks +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 +37,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 +81,200 @@ 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) + # 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 + 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_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 857f034f..e536589c 100644 --- a/src/beeware_docs_tools/build_pot_translations.py +++ b/src/beeware_docs_tools/build_pot_translations.py @@ -1,12 +1,14 @@ +import shutil import subprocess from argparse import ArgumentParser, Namespace from pathlib import Path from tempfile import TemporaryDirectory import polib -import yaml -from .md_tempdir import process_nav +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. @@ -33,10 +35,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 = [] @@ -45,14 +51,14 @@ 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) ) return title_file except FileNotFoundError: - # "No config.yml file + # No zensical.toml file pass except KeyError: # No navigation in config. @@ -106,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) @@ -122,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/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/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.*)\]\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/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 "" %}