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 freakboy3742User avatar glasnt
Translation license BSD 3-Clause "New" or "Revised" License
Translation process
  • Translations can be made directly.
  • Translation suggestions can be made.
  • Any authenticated user can contribute.
  • The translation uses bilingual files.
Source code repository https://github.com/beeware/beeware
Repository branch main
Last remote commit Merge pull request #455 from beeware/dependabot/pip/sphinx-intl-2.3.1 5b2f3ce
User avatar freakboy3742 authored 2 weeks ago
Last commit in Weblate Translated using Weblate (Italian) 8ed1229
User avatar pp authored 11 days ago
Weblate repository https://hosted.weblate.org/git/beeware/tutorial/index/
File mask docs/locales/*/LC_MESSAGES/tutorial/topics/custom-icons.po
Translation file Download docs/locales/fr/LC_MESSAGES/tutorial/topics/custom-icons.po
Last change Nov. 26, 2024, 3:33 a.m.
Last change made by None
Language French
Language code fr
Text direction Left to right
Number of speakers 295,510,923
Number of plurals 2
Plural type One/other
Plurals Singular 0, 1
Plural 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, …
Plural formula n > 1
3 weeks ago

String statistics

Strings percent Hosted strings Words percent Hosted words Characters percent Hosted characters
Total 23 725 4,406
Translated 0% 0 0% 0 0% 0
Needs editing 8% 2 4% 33 4% 181
Read-only 0% 0 0% 0 0% 0
Failing checks 26% 6 4% 35 4% 194
Strings with suggestions 0% 0 0% 0 0% 0
Untranslated strings 91% 21 95% 692 95% 4,225
Last 12 months Previous

Activity in last 12 months

0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 24 changes 0 changes 1 change 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 2 changes
DecJanFebMarAprMayJunJulAugSepOctNov

Quick numbers

725
Hosted words
23
Hosted strings
0%
Translated
0
Contributors
and previous 30 days

Trends of last 30 days

—
Hosted words
+100%
—
Hosted strings
+100%
—
Translated
—
—
Contributors
—
User avatar None

Resource updated
The “docs/locales/fr/LC_MESSAGES/tutorial/topics/custom-icons.po” file was changed. 3 weeks ago
User avatar None

String added in the repository
Let's provide some actual icons. Download :download:`this icons.zip bundle <../resources/icons.zip>`, and unzip it into the root of your project directory. After unzipping, your project directory should look something like::
 
3 weeks ago
User avatar None

Resource updated
The “docs/locales/fr/LC_MESSAGES/tutorial/topics/custom-icons.po” file was changed. 6 months ago
User avatar None

Resource updated
File “docs/locales/fr/LC_MESSAGES/tutorial/topics/custom-icons.po” was added. 6 months ago
User avatar None

String added in the repository
You'll need to re-create the app like this whenever you make a change to your ``pyproject.toml`` that doesn't relate to source code or dependencies. Any change to descriptions, version numbers, colors, or permissions will require a re-create step. Because of this, while you are developing your project, you shouldn't make any manual changes to the contents of the ``build`` folder, and you shouldn't add the ``build`` folder to your version control system. The ``build`` folder should be considered entirely ephemeral - an output of the build system that can be recreated as needed to reflect the current configuration of your project.
 
6 months ago
User avatar None

String added in the repository
You can then re-build and re-run the app using ``briefcase run``. You won't notice any changes to the desktop app; but the Android or iOS apps should now have a light blue splash screen background.
 
6 months ago
User avatar None

String added in the repository
Unfortunately, Briefcase isn't able to apply this change to an already generated project, as it requires making modifications to one of the files that was generated during the original call to ``briefcase create``. To apply this change, we have to re-create the app by re-running ``briefcase create``. When we do this, we'll be prompted to confirm that we want to overwrite the existing project:
 
6 months ago
User avatar None

String added in the repository
When you run the app on iOS or Android, in addition to the icon change, you should also notice that the splash screen incorporates the new icon. However, the light blue background of the icon looks a little out of place against the white background of the splash screen. We can fix this by customizing the background color of the splash screen. Add the following definition to your ``pyproject.toml``, just after the ``icon`` definition::
 
6 months ago
User avatar None

String added in the repository
If you're using a recent version of Android, you may notice that the app icon has been changed to a green snake, but the background of the icon is *white*, rather than light blue. We'll fix this in the next step.
 
6 months ago
User avatar None

String added in the repository
Now that we have icons, we can update the application again. However, ``briefcase update`` will only copy the updated resources into the build directory; we also want to rebuild the app to make sure the new icon is included, then start the app. We can shortcut this process by passing ``--update-resources`` to our call to ``run`` - this will update the app, update the app's resources, and then start the app:
 
6 months ago
Browse all translation changes