mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2025-01-03 23:07:14 +01:00
| .. | ||
| README.po | ||
# Translations template for PROJECT. # Copyright (C) 2024 ORGANIZATION # This file is distributed under the same license as the PROJECT project. # FIRST AUTHOR <EMAIL@ADDRESS>, 2024. # #, fuzzy 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" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.16.0\n" #: ../../README.md:1 msgid "Internationalization" msgstr "" #: ../../README.md:3 msgid "Translated documentation files are published and maintained in [`translated/`](translated/) directory." msgstr "" #: ../../README.md:5 msgid "Currently, we support translation of:" msgstr "" #: ../../README.md:7 msgid "Markdown files found at the top level project directory" msgstr "" #: ../../README.md:8 msgid "Markdown files found in the [`docs`](../docs/) directory (this is where the bulk of the documentation is)" msgstr "" #: ../../README.md:9 msgid "this current document in the `i18n` directory" msgstr "" #: ../../README.md:11 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 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/<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 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))" msgstr "" #: ../../README.md:23 msgid "Guide for translators" msgstr "" #: ../../README.md:25 msgid "This project uses [Sphinx](https://www.sphinx-doc.org/) to generate translated documents." msgstr "" #: ../../README.md:27 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 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 msgid "(Recommended) Using the uv package manager and just command runner" msgstr "" #: ../../README.md:33 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 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 msgid "Preparation" msgstr "" #: ../../README.md:39 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 msgid "Translation" msgstr "" #: ../../README.md:43 ../../README.md:74 msgid "Recommended flow when working on a new language (replace `<language>` with the language code, e.g. `bg`):" msgstr "" #: ../../README.md:45 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 msgid "Use an editor to translate the files in the `locales/<language>` directory" msgstr "" #: ../../README.md:49 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" msgstr "" #: ../../README.md:53 ../../README.md:86 msgid "Commit your changes done to the `locales/<language>` directory" msgstr "" #: ../../README.md:55 ../../README.md:88 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 msgid "Using any other package manager and manual scripts" msgstr "" #: ../../README.md:59 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 msgid "manage Python packages in another way ([pip](https://pip.pypa.io/en/stable/), [Poetry](https://python-poetry.org/), etc.)" msgstr "" #: ../../README.md:62 msgid "manage translation strings and build translated documents manually by invoking scripts from the [bin](bin/) directory" msgstr "" #: ../../README.md:66 msgid "virtualenv and pip" msgstr "" #: ../../README.md:68 msgid "Create a Python virtual environment in the `.venv` directory: `virtualenv .venv`" msgstr "" #: ../../README.md:69 msgid "Activate the virtual environment: `source .venv/bin/activate`" msgstr "" #: ../../README.md:70 msgid "Install the required Python packages using [pip](https://pip.pypa.io/en/stable/): `pip install -r requirements.txt`" msgstr "" #: ../../README.md:76 msgid "Ensure the English translation templates ([translation-templates/](translation-templates/)) are extracted: `./bin/extract-translation-templates.sh`" msgstr "" #: ../../README.md:78 msgid "Update the locale files for your language: `./bin/sync-translation-templates-to-locales.sh <language>`" msgstr "" #: ../../README.md:82 msgid "Build translated documents: `./bin/build-translated-result.sh <language>`" msgstr "" #: ../../README.md:90 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:" msgstr "" #: ../../README.md:94 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" msgstr "" #: ../../README.md:97 msgid "💡 Leave a trailing new line at the end of the [PUBLISHED_LANGUAGES](PUBLISHED_LANGUAGES) file." msgstr ""