This project is in a trial period, be cautious while contributing. Setup can still change before being approved as a libre project.

Overview

Project website docs.beeware.org
Instructions for translators

Navigate to a component that is showing an incomplete translation; click on Translate, and update strings as required. Any string marked as "Needs editing" needs to be reviewed. Anything marked with green sidebar has been translated previously - but any string can be modified if you think a translation can be improved.

Pay close attention to markup. We use Restructured Text and Sphinx markup; at present, Weblate won't identify or correct markup errors.

Try to keep the tone consistent. The BeeWare tutorial is deliberately written in a casual, friendly tone; try to preserve that tone in translations.

We also avoid phrasing that the could leave the reader feeling "stupid". We avoid saying that things are "simple", or that you "just" need to do X; if a user has a problem doing a "simple" thing, or can't "just" do the thing you ask, they might conclude that the problem is with them. Avoid comparable phrasing in translations.

Once you've modified a translation, click on "Save and continue" to move to the next string. There's nothing else you need to do to make translations go live. Weblate will wait a few hours to make sure changes are combined together, and then commit changes to the upstream repository. When the commit happens, you’ll see a new commit in the Github repository that you're translating; a few minutes after that, a build should start on ReadTheDocs. Each language project has its own ReadTheDocs project, formed by adding the language suffix to the end of the base BeeWare ReadTheDocs URL.

For example, the BeeWare tutorial will show additional commits in the Github repository, and each language has it's own ReadTheDocs page (e.g., French, Chinese etc)

As soon as the ReadTheDocs build completes, the changes will be made live. If the ReadTheDocs build fails (usually due to a markup error) no changes will be published until the error is corrected. The build log will show the line in the source document that is causing a problem (e.g., "tutorial-1:16" is line 16 of the Tutorial 1 translation). The translations are sorted by line number in the Weblate interface; the right hand side bar shows the source string location for each translated string.

Project maintainers User avatar freakboy3742 User avatar glasnt
Translation license BSD-3-Clause index Tutorial 0 Tutorial 1 Tutorial 10 Tutorial 11 Tutorial 2 Tutorial 3 Tutorial 4 Tutorial 6 Tutorial 7 Tutorial 8 Tutorial 9
5 hours ago

String statistics

Strings percent Hosted strings Words percent Hosted words Characters percent Hosted characters
Total 3,777 89,066 547,303
Source 487 11,583 71,401
Approved 0% 0 0% 0 0% 0
Waiting for review 27% 1,048 18% 16,748 18% 103,618
Translated 40% 1,535 31% 28,331 31% 175,019
Needs editing 54% 2,051 61% 54,929 61% 336,145
Read-only 12% 487 13% 11,583 13% 71,401
Failing checks 9% 374 3% 3,326 3% 21,289
Strings with suggestions 0% 0 0% 0 0% 0
Untranslated strings 5% 191 6% 5,806 6% 36,139

Quick numbers

0
Hosted words
0
Hosted strings
0%
Translated
and previous 30 days

Trends of last 30 days

Hosted words
Hosted strings
Translated
Contributors
User avatar None

Resource updated

The “docs/locales/zh_TW/LC_MESSAGES/tutorial/tutorial-2.po” file was changed. 4 days ago
User avatar None

String added in the repository

4 days ago
User avatar None

String added in the repository

4 days ago
User avatar None

String added in the repository

4 days ago
User avatar None

Resource updated

The “docs/locales/zh_CN/LC_MESSAGES/tutorial/tutorial-2.po” file was changed. 4 days ago
User avatar None

String added in the repository

4 days ago
User avatar None

String added in the repository

4 days ago
User avatar None

String added in the repository

4 days ago
User avatar None

Resource updated

The “docs/locales/pt/LC_MESSAGES/tutorial/tutorial-2.po” file was changed. 4 days ago
User avatar None

String added in the repository

4 days ago
Browse all project changes