From 23bcf87596018d8e37d81705d1fbba912599086d Mon Sep 17 00:00:00 2001 From: Slavi Pantaleev Date: Fri, 20 Dec 2024 15:28:26 +0200 Subject: [PATCH] Sync translation locales --- i18n/locales/bg/LC_MESSAGES/i18n/README.po | 142 ++++++++++----------- i18n/locales/jp/LC_MESSAGES/i18n/README.po | 142 ++++++++++----------- i18n/translation-templates/i18n/README.pot | 112 ++++++++-------- 3 files changed, 198 insertions(+), 198 deletions(-) diff --git a/i18n/locales/bg/LC_MESSAGES/i18n/README.po b/i18n/locales/bg/LC_MESSAGES/i18n/README.po index 72a8111ae..c5e6d158e 100644 --- a/i18n/locales/bg/LC_MESSAGES/i18n/README.po +++ b/i18n/locales/bg/LC_MESSAGES/i18n/README.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2024-12-20 09:29+0200\n" +"POT-Creation-Date: 2024-12-20 15:27+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -17,194 +17,194 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.16.0\n" -#: ../../README.md:1 +#: ../../README.md:8 msgid "Internationalization" msgstr "" -#: ../../README.md:3 -msgid "Translated documentation files are published and maintained in [`translated/`](translated/) directory." +#: ../../README.md:10 +msgid "Translated documentation files are published and maintained in [`translations/`](translations/) directory." msgstr "" -#: ../../README.md:5 +#: ../../README.md:12 msgid "Currently, we support translation of:" msgstr "" -#: ../../README.md:7 +#: ../../README.md:14 msgid "Markdown files found at the top level project directory" msgstr "" -#: ../../README.md:8 +#: ../../README.md:15 msgid "Markdown files found in the [`docs`](../docs/) directory (this is where the bulk of the documentation is)" msgstr "" -#: ../../README.md:9 +#: ../../README.md:16 msgid "this current document in the `i18n` directory" msgstr "" -#: ../../README.md:11 +#: ../../README.md:18 msgid "💡 For readers' sake, we only [publish translations in a new language](#publish-translations-in-a-new-language) when the translation progresses beyond a certain threshold (requiring that at least the project README and core installation guides are translated)." msgstr "" -#: ../../README.md:13 +#: ../../README.md:20 msgid "Organization of this `i18n` directory is as follows:" msgstr "" -#: ../../README.md:15 -msgid "[PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES): a list of languages that we publish translations for (in the [translated/](translated/) directory)" -msgstr "" - -#: ../../README.md:16 -msgid "[.gitignore](.gitignore): a list of files and directories to ignore in the `i18n` directory. We intentionaly ignore translated results (`translated/` directories) for languages taht are still in progress. We only [publish translations in a new language](#publish-translations-in-a-new-language) when the translation progresses beyond a certain threshold." -msgstr "" - -#: ../../README.md:17 -msgid "[justfile](justfile): a list of recipes for [just](https://github.com/casey/just) command runner" -msgstr "" - -#: ../../README.md:18 -msgid "[requirements.txt](requirements.txt): a list of Python packages required to work with translations" -msgstr "" - -#: ../../README.md:19 -msgid "[translation-templates/](translation-templates/): a list of English translation templates - strings extracted from Markdown files" -msgstr "" - -#: ../../README.md:20 -msgid "[locales/](locales/): localization files for languages" -msgstr "" - -#: ../../README.md:21 -msgid "[translated/](translated/): translated documents for published languages (see [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) and [publish translations in a new language](#publish-translations-in-a-new-language))" +#: ../../README.md:22 +msgid "[PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES): a list of languages that we publish translations for (in the [translations/](translations/) directory)" msgstr "" #: ../../README.md:23 -msgid "Guide for translators" +msgid "[.gitignore](.gitignore): a list of files and directories to ignore in the `i18n` directory. We intentionaly ignore translated results (`translations/` directories) for languages taht are still in progress. We only [publish translations in a new language](#publish-translations-in-a-new-language) when the translation progresses beyond a certain threshold." +msgstr "" + +#: ../../README.md:24 +msgid "[justfile](justfile): a list of recipes for [just](https://github.com/casey/just) command runner" msgstr "" #: ../../README.md:25 -msgid "This project uses [Sphinx](https://www.sphinx-doc.org/) to generate translated documents." +msgid "[requirements.txt](requirements.txt): a list of Python packages required to work with translations" +msgstr "" + +#: ../../README.md:26 +msgid "[translation-templates/](translation-templates/): a list of English translation templates - strings extracted from Markdown files" msgstr "" #: ../../README.md:27 +msgid "[locales/](locales/): localization files for languages" +msgstr "" + +#: ../../README.md:28 +msgid "[translations/](translations/): translated documents for published languages (see [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) and [publish translations in a new language](#publish-translations-in-a-new-language))" +msgstr "" + +#: ../../README.md:30 +msgid "Guide for translators" +msgstr "" + +#: ../../README.md:32 +msgid "This project uses [Sphinx](https://www.sphinx-doc.org/) to generate translated documents." +msgstr "" + +#: ../../README.md:34 msgid "For details about using Sphinx for translation, refer [this official document](https://www.sphinx-doc.org/en/master/usage/advanced/intl.html) as well." msgstr "" -#: ../../README.md:29 +#: ../../README.md:36 msgid "For now, translations are handled manually by editing `.po` files in the `locales/` directory. In the future, we plan on integrating with [Weblate](https://weblate.org/) to allow for translating from a web interface." msgstr "" -#: ../../README.md:31 +#: ../../README.md:38 msgid "(Recommended) Using the uv package manager and just command runner" msgstr "" -#: ../../README.md:33 +#: ../../README.md:40 msgid "If you have the [uv](https://docs.astral.sh/uv/) package manager and [just](https://github.com/casey/just) command runner installed, you can use our [justfile](justfile) recipes to easily manage translation files and build translated documents." msgstr "" -#: ../../README.md:35 +#: ../../README.md:42 msgid "The recipes will use [uv](https://github.com/astral-sh/uv) to auto-create [a Python virtual environment](https://docs.astral.sh/uv/pip/environments/) in the `.venv` directory and install the required Python packages (as per [requirements.txt](requirements.txt)) to it." msgstr "" -#: ../../README.md:37 ../../README.md:64 +#: ../../README.md:44 ../../README.md:71 msgid "Preparation" msgstr "" -#: ../../README.md:39 +#: ../../README.md:46 msgid "Make sure you have the [uv](https://docs.astral.sh/uv/) package manager and [just](https://github.com/casey/just) command runner installed." msgstr "" -#: ../../README.md:41 ../../README.md:72 +#: ../../README.md:48 ../../README.md:79 msgid "Translation" msgstr "" -#: ../../README.md:43 ../../README.md:74 +#: ../../README.md:50 ../../README.md:81 msgid "Recommended flow when working on a new language (replace `` with the language code, e.g. `bg`):" msgstr "" -#: ../../README.md:45 +#: ../../README.md:52 msgid "Update the locale files for your language: `just sync-for-language ` (internally, this automatically runs `just extract-translation-templates` to make sure the translation templates are up-to-date)" msgstr "" -#: ../../README.md:47 ../../README.md:80 +#: ../../README.md:54 ../../README.md:87 msgid "Use an editor to translate the files in the `locales/` directory" msgstr "" -#: ../../README.md:49 +#: ../../README.md:56 msgid "Build translated documents: `just build-for-language `" msgstr "" -#: ../../README.md:51 ../../README.md:84 -msgid "Preview the result in the `translated/` directory" +#: ../../README.md:58 ../../README.md:91 +msgid "Preview the result in the `translations/` directory" msgstr "" -#: ../../README.md:53 ../../README.md:86 +#: ../../README.md:60 ../../README.md:93 msgid "Commit your changes done to the `locales/` directory" msgstr "" -#: ../../README.md:55 ../../README.md:88 +#: ../../README.md:62 ../../README.md:95 msgid "If you have progressed with the translation beyond a certain threshold, consider [Publishing translations in a new language](#publish-translations-in-a-new-language)" msgstr "" -#: ../../README.md:57 +#: ../../README.md:64 msgid "Using any other package manager and manual scripts" msgstr "" -#: ../../README.md:59 +#: ../../README.md:66 msgid "If you cannot use [uv](https://docs.astral.sh/uv/) and/or [just](https://github.com/casey/just), you can:" msgstr "" -#: ../../README.md:61 +#: ../../README.md:68 msgid "manage Python packages in another way ([pip](https://pip.pypa.io/en/stable/), [Poetry](https://python-poetry.org/), etc.)" msgstr "" -#: ../../README.md:62 +#: ../../README.md:69 msgid "manage translation strings and build translated documents manually by invoking scripts from the [bin](bin/) directory" msgstr "" -#: ../../README.md:66 +#: ../../README.md:73 msgid "virtualenv and pip" msgstr "" -#: ../../README.md:68 +#: ../../README.md:75 msgid "Create a Python virtual environment in the `.venv` directory: `virtualenv .venv`" msgstr "" -#: ../../README.md:69 +#: ../../README.md:76 msgid "Activate the virtual environment: `source .venv/bin/activate`" msgstr "" -#: ../../README.md:70 +#: ../../README.md:77 msgid "Install the required Python packages using [pip](https://pip.pypa.io/en/stable/): `pip install -r requirements.txt`" msgstr "" -#: ../../README.md:76 +#: ../../README.md:83 msgid "Ensure the English translation templates ([translation-templates/](translation-templates/)) are extracted: `./bin/extract-translation-templates.sh`" msgstr "" -#: ../../README.md:78 +#: ../../README.md:85 msgid "Update the locale files for your language: `./bin/sync-translation-templates-to-locales.sh `" msgstr "" -#: ../../README.md:82 +#: ../../README.md:89 msgid "Build translated documents: `./bin/build-translated-result.sh `" msgstr "" -#: ../../README.md:90 +#: ../../README.md:97 msgid "Publish translations in a new language" msgstr "" -#: ../../README.md:92 -msgid "To publish prebuilt documents translated in a new language to the `translated/` directory:" +#: ../../README.md:99 +msgid "To publish prebuilt documents translated in a new language to the `translations/` directory:" msgstr "" -#: ../../README.md:94 +#: ../../README.md:101 msgid "add its language code to the [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) file" msgstr "" -#: ../../README.md:95 -msgid "whitelist its `translated/` directory by adding a `!translated/` rule to the [.gitignore](.gitignore) file" +#: ../../README.md:102 +msgid "whitelist its `translations/` directory by adding a `!translations/` rule to the [.gitignore](.gitignore) file" msgstr "" -#: ../../README.md:97 +#: ../../README.md:104 msgid "💡 Leave a trailing new line at the end of the [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) file." msgstr "" diff --git a/i18n/locales/jp/LC_MESSAGES/i18n/README.po b/i18n/locales/jp/LC_MESSAGES/i18n/README.po index 1707d7168..f93ab6c11 100644 --- a/i18n/locales/jp/LC_MESSAGES/i18n/README.po +++ b/i18n/locales/jp/LC_MESSAGES/i18n/README.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:29+0200\n" +"POT-Creation-Date: 2024-12-20 15:27+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" @@ -20,194 +20,194 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.16.0\n" -#: ../../README.md:1 +#: ../../README.md:8 msgid "Internationalization" msgstr "" -#: ../../README.md:3 -msgid "Translated documentation files are published and maintained in [`translated/`](translated/) directory." +#: ../../README.md:10 +msgid "Translated documentation files are published and maintained in [`translations/`](translations/) directory." msgstr "" -#: ../../README.md:5 +#: ../../README.md:12 msgid "Currently, we support translation of:" msgstr "" -#: ../../README.md:7 +#: ../../README.md:14 msgid "Markdown files found at the top level project directory" msgstr "" -#: ../../README.md:8 +#: ../../README.md:15 msgid "Markdown files found in the [`docs`](../docs/) directory (this is where the bulk of the documentation is)" msgstr "" -#: ../../README.md:9 +#: ../../README.md:16 msgid "this current document in the `i18n` directory" msgstr "" -#: ../../README.md:11 +#: ../../README.md:18 msgid "💡 For readers' sake, we only [publish translations in a new language](#publish-translations-in-a-new-language) when the translation progresses beyond a certain threshold (requiring that at least the project README and core installation guides are translated)." msgstr "" -#: ../../README.md:13 +#: ../../README.md:20 msgid "Organization of this `i18n` directory is as follows:" msgstr "" -#: ../../README.md:15 -msgid "[PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES): a list of languages that we publish translations for (in the [translated/](translated/) directory)" -msgstr "" - -#: ../../README.md:16 -msgid "[.gitignore](.gitignore): a list of files and directories to ignore in the `i18n` directory. We intentionaly ignore translated results (`translated/` directories) for languages taht are still in progress. We only [publish translations in a new language](#publish-translations-in-a-new-language) when the translation progresses beyond a certain threshold." -msgstr "" - -#: ../../README.md:17 -msgid "[justfile](justfile): a list of recipes for [just](https://github.com/casey/just) command runner" -msgstr "" - -#: ../../README.md:18 -msgid "[requirements.txt](requirements.txt): a list of Python packages required to work with translations" -msgstr "" - -#: ../../README.md:19 -msgid "[translation-templates/](translation-templates/): a list of English translation templates - strings extracted from Markdown files" -msgstr "" - -#: ../../README.md:20 -msgid "[locales/](locales/): localization files for languages" -msgstr "" - -#: ../../README.md:21 -msgid "[translated/](translated/): translated documents for published languages (see [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) and [publish translations in a new language](#publish-translations-in-a-new-language))" +#: ../../README.md:22 +msgid "[PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES): a list of languages that we publish translations for (in the [translations/](translations/) directory)" msgstr "" #: ../../README.md:23 -msgid "Guide for translators" +msgid "[.gitignore](.gitignore): a list of files and directories to ignore in the `i18n` directory. We intentionaly ignore translated results (`translations/` directories) for languages taht are still in progress. We only [publish translations in a new language](#publish-translations-in-a-new-language) when the translation progresses beyond a certain threshold." +msgstr "" + +#: ../../README.md:24 +msgid "[justfile](justfile): a list of recipes for [just](https://github.com/casey/just) command runner" msgstr "" #: ../../README.md:25 -msgid "This project uses [Sphinx](https://www.sphinx-doc.org/) to generate translated documents." +msgid "[requirements.txt](requirements.txt): a list of Python packages required to work with translations" +msgstr "" + +#: ../../README.md:26 +msgid "[translation-templates/](translation-templates/): a list of English translation templates - strings extracted from Markdown files" msgstr "" #: ../../README.md:27 +msgid "[locales/](locales/): localization files for languages" +msgstr "" + +#: ../../README.md:28 +msgid "[translations/](translations/): translated documents for published languages (see [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) and [publish translations in a new language](#publish-translations-in-a-new-language))" +msgstr "" + +#: ../../README.md:30 +msgid "Guide for translators" +msgstr "" + +#: ../../README.md:32 +msgid "This project uses [Sphinx](https://www.sphinx-doc.org/) to generate translated documents." +msgstr "" + +#: ../../README.md:34 msgid "For details about using Sphinx for translation, refer [this official document](https://www.sphinx-doc.org/en/master/usage/advanced/intl.html) as well." msgstr "" -#: ../../README.md:29 +#: ../../README.md:36 msgid "For now, translations are handled manually by editing `.po` files in the `locales/` directory. In the future, we plan on integrating with [Weblate](https://weblate.org/) to allow for translating from a web interface." msgstr "" -#: ../../README.md:31 +#: ../../README.md:38 msgid "(Recommended) Using the uv package manager and just command runner" msgstr "" -#: ../../README.md:33 +#: ../../README.md:40 msgid "If you have the [uv](https://docs.astral.sh/uv/) package manager and [just](https://github.com/casey/just) command runner installed, you can use our [justfile](justfile) recipes to easily manage translation files and build translated documents." msgstr "" -#: ../../README.md:35 +#: ../../README.md:42 msgid "The recipes will use [uv](https://github.com/astral-sh/uv) to auto-create [a Python virtual environment](https://docs.astral.sh/uv/pip/environments/) in the `.venv` directory and install the required Python packages (as per [requirements.txt](requirements.txt)) to it." msgstr "" -#: ../../README.md:37 ../../README.md:64 +#: ../../README.md:44 ../../README.md:71 msgid "Preparation" msgstr "" -#: ../../README.md:39 +#: ../../README.md:46 msgid "Make sure you have the [uv](https://docs.astral.sh/uv/) package manager and [just](https://github.com/casey/just) command runner installed." msgstr "" -#: ../../README.md:41 ../../README.md:72 +#: ../../README.md:48 ../../README.md:79 msgid "Translation" msgstr "" -#: ../../README.md:43 ../../README.md:74 +#: ../../README.md:50 ../../README.md:81 msgid "Recommended flow when working on a new language (replace `` with the language code, e.g. `bg`):" msgstr "" -#: ../../README.md:45 +#: ../../README.md:52 msgid "Update the locale files for your language: `just sync-for-language ` (internally, this automatically runs `just extract-translation-templates` to make sure the translation templates are up-to-date)" msgstr "" -#: ../../README.md:47 ../../README.md:80 +#: ../../README.md:54 ../../README.md:87 msgid "Use an editor to translate the files in the `locales/` directory" msgstr "" -#: ../../README.md:49 +#: ../../README.md:56 msgid "Build translated documents: `just build-for-language `" msgstr "" -#: ../../README.md:51 ../../README.md:84 -msgid "Preview the result in the `translated/` directory" +#: ../../README.md:58 ../../README.md:91 +msgid "Preview the result in the `translations/` directory" msgstr "" -#: ../../README.md:53 ../../README.md:86 +#: ../../README.md:60 ../../README.md:93 msgid "Commit your changes done to the `locales/` directory" msgstr "" -#: ../../README.md:55 ../../README.md:88 +#: ../../README.md:62 ../../README.md:95 msgid "If you have progressed with the translation beyond a certain threshold, consider [Publishing translations in a new language](#publish-translations-in-a-new-language)" msgstr "" -#: ../../README.md:57 +#: ../../README.md:64 msgid "Using any other package manager and manual scripts" msgstr "" -#: ../../README.md:59 +#: ../../README.md:66 msgid "If you cannot use [uv](https://docs.astral.sh/uv/) and/or [just](https://github.com/casey/just), you can:" msgstr "" -#: ../../README.md:61 +#: ../../README.md:68 msgid "manage Python packages in another way ([pip](https://pip.pypa.io/en/stable/), [Poetry](https://python-poetry.org/), etc.)" msgstr "" -#: ../../README.md:62 +#: ../../README.md:69 msgid "manage translation strings and build translated documents manually by invoking scripts from the [bin](bin/) directory" msgstr "" -#: ../../README.md:66 +#: ../../README.md:73 msgid "virtualenv and pip" msgstr "" -#: ../../README.md:68 +#: ../../README.md:75 msgid "Create a Python virtual environment in the `.venv` directory: `virtualenv .venv`" msgstr "" -#: ../../README.md:69 +#: ../../README.md:76 msgid "Activate the virtual environment: `source .venv/bin/activate`" msgstr "" -#: ../../README.md:70 +#: ../../README.md:77 msgid "Install the required Python packages using [pip](https://pip.pypa.io/en/stable/): `pip install -r requirements.txt`" msgstr "" -#: ../../README.md:76 +#: ../../README.md:83 msgid "Ensure the English translation templates ([translation-templates/](translation-templates/)) are extracted: `./bin/extract-translation-templates.sh`" msgstr "" -#: ../../README.md:78 +#: ../../README.md:85 msgid "Update the locale files for your language: `./bin/sync-translation-templates-to-locales.sh `" msgstr "" -#: ../../README.md:82 +#: ../../README.md:89 msgid "Build translated documents: `./bin/build-translated-result.sh `" msgstr "" -#: ../../README.md:90 +#: ../../README.md:97 msgid "Publish translations in a new language" msgstr "" -#: ../../README.md:92 -msgid "To publish prebuilt documents translated in a new language to the `translated/` directory:" +#: ../../README.md:99 +msgid "To publish prebuilt documents translated in a new language to the `translations/` directory:" msgstr "" -#: ../../README.md:94 +#: ../../README.md:101 msgid "add its language code to the [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) file" msgstr "" -#: ../../README.md:95 -msgid "whitelist its `translated/` directory by adding a `!translated/` rule to the [.gitignore](.gitignore) file" +#: ../../README.md:102 +msgid "whitelist its `translations/` directory by adding a `!translations/` rule to the [.gitignore](.gitignore) file" msgstr "" -#: ../../README.md:97 +#: ../../README.md:104 msgid "💡 Leave a trailing new line at the end of the [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) file." msgstr "" diff --git a/i18n/translation-templates/i18n/README.pot b/i18n/translation-templates/i18n/README.pot index 880598c2f..4f94ba62b 100644 --- a/i18n/translation-templates/i18n/README.pot +++ b/i18n/translation-templates/i18n/README.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-12-20 09:29+0200\n" +"POT-Creation-Date: 2024-12-20 15:27+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -16,201 +16,201 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -#: ../../README.md:1 +#: ../../README.md:8 msgid "Internationalization" msgstr "" -#: ../../README.md:3 +#: ../../README.md:10 msgid "Translated documentation files are published and maintained in [`translations/`](translations/) directory." msgstr "" -#: ../../README.md:5 +#: ../../README.md:12 msgid "Currently, we support translation of:" msgstr "" -#: ../../README.md:7 +#: ../../README.md:14 msgid "Markdown files found at the top level project directory" msgstr "" -#: ../../README.md:8 +#: ../../README.md:15 msgid "Markdown files found in the [`docs`](../docs/) directory (this is where the bulk of the documentation is)" msgstr "" -#: ../../README.md:9 +#: ../../README.md:16 msgid "this current document in the `i18n` directory" msgstr "" -#: ../../README.md:11 +#: ../../README.md:18 msgid "💡 For readers' sake, we only [publish translations in a new language](#publish-translations-in-a-new-language) when the translation progresses beyond a certain threshold (requiring that at least the project README and core installation guides are translated)." msgstr "" -#: ../../README.md:13 +#: ../../README.md:20 msgid "Organization of this `i18n` directory is as follows:" msgstr "" -#: ../../README.md:15 +#: ../../README.md:22 msgid "[PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES): a list of languages that we publish translations for (in the [translations/](translations/) directory)" msgstr "" -#: ../../README.md:16 +#: ../../README.md:23 msgid "[.gitignore](.gitignore): a list of files and directories to ignore in the `i18n` directory. We intentionaly ignore translated results (`translations/` directories) for languages taht are still in progress. We only [publish translations in a new language](#publish-translations-in-a-new-language) when the translation progresses beyond a certain threshold." msgstr "" -#: ../../README.md:17 +#: ../../README.md:24 msgid "[justfile](justfile): a list of recipes for [just](https://github.com/casey/just) command runner" msgstr "" -#: ../../README.md:18 +#: ../../README.md:25 msgid "[requirements.txt](requirements.txt): a list of Python packages required to work with translations" msgstr "" -#: ../../README.md:19 +#: ../../README.md:26 msgid "[translation-templates/](translation-templates/): a list of English translation templates - strings extracted from Markdown files" msgstr "" -#: ../../README.md:20 +#: ../../README.md:27 msgid "[locales/](locales/): localization files for languages" msgstr "" -#: ../../README.md:21 +#: ../../README.md:28 msgid "[translations/](translations/): translated documents for published languages (see [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) and [publish translations in a new language](#publish-translations-in-a-new-language))" msgstr "" -#: ../../README.md:23 +#: ../../README.md:30 msgid "Guide for translators" msgstr "" -#: ../../README.md:25 +#: ../../README.md:32 msgid "This project uses [Sphinx](https://www.sphinx-doc.org/) to generate translated documents." msgstr "" -#: ../../README.md:27 +#: ../../README.md:34 msgid "For details about using Sphinx for translation, refer [this official document](https://www.sphinx-doc.org/en/master/usage/advanced/intl.html) as well." msgstr "" -#: ../../README.md:29 +#: ../../README.md:36 msgid "For now, translations are handled manually by editing `.po` files in the `locales/` directory. In the future, we plan on integrating with [Weblate](https://weblate.org/) to allow for translating from a web interface." msgstr "" -#: ../../README.md:31 +#: ../../README.md:38 msgid "(Recommended) Using the uv package manager and just command runner" msgstr "" -#: ../../README.md:33 +#: ../../README.md:40 msgid "If you have the [uv](https://docs.astral.sh/uv/) package manager and [just](https://github.com/casey/just) command runner installed, you can use our [justfile](justfile) recipes to easily manage translation files and build translated documents." msgstr "" -#: ../../README.md:35 +#: ../../README.md:42 msgid "The recipes will use [uv](https://github.com/astral-sh/uv) to auto-create [a Python virtual environment](https://docs.astral.sh/uv/pip/environments/) in the `.venv` directory and install the required Python packages (as per [requirements.txt](requirements.txt)) to it." msgstr "" -#: ../../README.md:37 -#: ../../README.md:64 +#: ../../README.md:44 +#: ../../README.md:71 msgid "Preparation" msgstr "" -#: ../../README.md:39 +#: ../../README.md:46 msgid "Make sure you have the [uv](https://docs.astral.sh/uv/) package manager and [just](https://github.com/casey/just) command runner installed." msgstr "" -#: ../../README.md:41 -#: ../../README.md:72 +#: ../../README.md:48 +#: ../../README.md:79 msgid "Translation" msgstr "" -#: ../../README.md:43 -#: ../../README.md:74 +#: ../../README.md:50 +#: ../../README.md:81 msgid "Recommended flow when working on a new language (replace `` with the language code, e.g. `bg`):" msgstr "" -#: ../../README.md:45 +#: ../../README.md:52 msgid "Update the locale files for your language: `just sync-for-language ` (internally, this automatically runs `just extract-translation-templates` to make sure the translation templates are up-to-date)" msgstr "" -#: ../../README.md:47 -#: ../../README.md:80 +#: ../../README.md:54 +#: ../../README.md:87 msgid "Use an editor to translate the files in the `locales/` directory" msgstr "" -#: ../../README.md:49 +#: ../../README.md:56 msgid "Build translated documents: `just build-for-language `" msgstr "" -#: ../../README.md:51 -#: ../../README.md:84 +#: ../../README.md:58 +#: ../../README.md:91 msgid "Preview the result in the `translations/` directory" msgstr "" -#: ../../README.md:53 -#: ../../README.md:86 +#: ../../README.md:60 +#: ../../README.md:93 msgid "Commit your changes done to the `locales/` directory" msgstr "" -#: ../../README.md:55 -#: ../../README.md:88 +#: ../../README.md:62 +#: ../../README.md:95 msgid "If you have progressed with the translation beyond a certain threshold, consider [Publishing translations in a new language](#publish-translations-in-a-new-language)" msgstr "" -#: ../../README.md:57 +#: ../../README.md:64 msgid "Using any other package manager and manual scripts" msgstr "" -#: ../../README.md:59 +#: ../../README.md:66 msgid "If you cannot use [uv](https://docs.astral.sh/uv/) and/or [just](https://github.com/casey/just), you can:" msgstr "" -#: ../../README.md:61 +#: ../../README.md:68 msgid "manage Python packages in another way ([pip](https://pip.pypa.io/en/stable/), [Poetry](https://python-poetry.org/), etc.)" msgstr "" -#: ../../README.md:62 +#: ../../README.md:69 msgid "manage translation strings and build translated documents manually by invoking scripts from the [bin](bin/) directory" msgstr "" -#: ../../README.md:66 +#: ../../README.md:73 msgid "virtualenv and pip" msgstr "" -#: ../../README.md:68 +#: ../../README.md:75 msgid "Create a Python virtual environment in the `.venv` directory: `virtualenv .venv`" msgstr "" -#: ../../README.md:69 +#: ../../README.md:76 msgid "Activate the virtual environment: `source .venv/bin/activate`" msgstr "" -#: ../../README.md:70 +#: ../../README.md:77 msgid "Install the required Python packages using [pip](https://pip.pypa.io/en/stable/): `pip install -r requirements.txt`" msgstr "" -#: ../../README.md:76 +#: ../../README.md:83 msgid "Ensure the English translation templates ([translation-templates/](translation-templates/)) are extracted: `./bin/extract-translation-templates.sh`" msgstr "" -#: ../../README.md:78 +#: ../../README.md:85 msgid "Update the locale files for your language: `./bin/sync-translation-templates-to-locales.sh `" msgstr "" -#: ../../README.md:82 +#: ../../README.md:89 msgid "Build translated documents: `./bin/build-translated-result.sh `" msgstr "" -#: ../../README.md:90 +#: ../../README.md:97 msgid "Publish translations in a new language" msgstr "" -#: ../../README.md:92 +#: ../../README.md:99 msgid "To publish prebuilt documents translated in a new language to the `translations/` directory:" msgstr "" -#: ../../README.md:94 +#: ../../README.md:101 msgid "add its language code to the [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) file" msgstr "" -#: ../../README.md:95 +#: ../../README.md:102 msgid "whitelist its `translations/` directory by adding a `!translations/` rule to the [.gitignore](.gitignore) file" msgstr "" -#: ../../README.md:97 +#: ../../README.md:104 msgid "💡 Leave a trailing new line at the end of the [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) file." msgstr ""