Sync translation locales

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 <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\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)"
+#: ../../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
-msgid "[.gitignore](.gitignore): a list of files and directories to ignore in the `i18n` directory. We intentionaly ignore translated results (`translated/<language>` 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."
+#: ../../README.md:23
+msgid "[.gitignore](.gitignore): a list of files and directories to ignore in the `i18n` directory. We intentionaly ignore translated results (`translations/<language>` 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
-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: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/<language>` 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 `<language>` 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 <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/<language>` directory"
 msgstr ""
 
-#: ../../README.md:49
+#: ../../README.md:56
 msgid "Build translated documents: `just build-for-language <language>`"
 msgstr ""
 
-#: ../../README.md:51 ../../README.md:84
-msgid "Preview the result in the `translated/<language>` directory"
+#: ../../README.md:58 ../../README.md:91
+msgid "Preview the result in the `translations/<language>` directory"
 msgstr ""
 
-#: ../../README.md:53 ../../README.md:86
+#: ../../README.md:60 ../../README.md:93
 msgid "Commit your changes done to the `locales/<language>` 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 <language>`"
 msgstr ""
 
-#: ../../README.md:82
+#: ../../README.md:89
 msgid "Build translated documents: `./bin/build-translated-result.sh <language>`"
 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/<language>` directory:"
+#: ../../README.md:99
+msgid "To publish prebuilt documents translated in a new language to the `translations/<language>` 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/<language>` directory by adding a `!translated/<language>` rule to the [.gitignore](.gitignore) file"
+#: ../../README.md:102
+msgid "whitelist its `translations/<language>` directory by adding a `!translations/<language>` 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 ""

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 <EMAIL@ADDRESS>\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)"
+#: ../../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
-msgid "[.gitignore](.gitignore): a list of files and directories to ignore in the `i18n` directory. We intentionaly ignore translated results (`translated/<language>` 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."
+#: ../../README.md:23
+msgid "[.gitignore](.gitignore): a list of files and directories to ignore in the `i18n` directory. We intentionaly ignore translated results (`translations/<language>` 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
-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: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/<language>` 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 `<language>` 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 <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/<language>` directory"
 msgstr ""
 
-#: ../../README.md:49
+#: ../../README.md:56
 msgid "Build translated documents: `just build-for-language <language>`"
 msgstr ""
 
-#: ../../README.md:51 ../../README.md:84
-msgid "Preview the result in the `translated/<language>` directory"
+#: ../../README.md:58 ../../README.md:91
+msgid "Preview the result in the `translations/<language>` directory"
 msgstr ""
 
-#: ../../README.md:53 ../../README.md:86
+#: ../../README.md:60 ../../README.md:93
 msgid "Commit your changes done to the `locales/<language>` 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 <language>`"
 msgstr ""
 
-#: ../../README.md:82
+#: ../../README.md:89
 msgid "Build translated documents: `./bin/build-translated-result.sh <language>`"
 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/<language>` directory:"
+#: ../../README.md:99
+msgid "To publish prebuilt documents translated in a new language to the `translations/<language>` 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/<language>` directory by adding a `!translated/<language>` rule to the [.gitignore](.gitignore) file"
+#: ../../README.md:102
+msgid "whitelist its `translations/<language>` directory by adding a `!translations/<language>` 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 ""

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 <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\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/<language>` 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/<language>` 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 `<language>` 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 <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/<language>` directory"
 msgstr ""
 
-#: ../../README.md:49
+#: ../../README.md:56
 msgid "Build translated documents: `just build-for-language <language>`"
 msgstr ""
 
-#: ../../README.md:51
-#: ../../README.md:84
+#: ../../README.md:58
+#: ../../README.md:91
 msgid "Preview the result in the `translations/<language>` directory"
 msgstr ""
 
-#: ../../README.md:53
-#: ../../README.md:86
+#: ../../README.md:60
+#: ../../README.md:93
 msgid "Commit your changes done to the `locales/<language>` 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 <language>`"
 msgstr ""
 
-#: ../../README.md:82
+#: ../../README.md:89
 msgid "Build translated documents: `./bin/build-translated-result.sh <language>`"
 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/<language>` 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/<language>` directory by adding a `!translations/<language>` 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 ""