-
-
Notifications
You must be signed in to change notification settings - Fork 1.1k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
a146f21
commit 23bcf87
Showing
3 changed files
with
168 additions
and
168 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -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 <[email protected]>\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 "" | ||
Oops, something went wrong.