Overview

Project website github.com/habitRPG/habitica
Instructions for translators

Habitica’s translations are done by our community of contributors from around the world!

Are you fluent in a language and want to contribute? Here are some instructions and common questions to introduce you to Habitica’s community translation process.


How is Habitica’s text translated?
As an open-source app, Habitica hosts our translations publicly here, at translate.habitica.com which is where contributors can submit, discuss, and review translations.

Translatable text is called a string. Source strings are provided in English, uploaded to translate.habitica.com, then translated into different languages for web, Android, and iOS by contributors. Approved translations will populate to the platforms they were submitted to after periodic updates by the Habitica team. This usually happens about once a month for the web version, or alongside mobile milestone releases for Android and iOS.


How do I contribute translations?

  1. Create an account on translate.habitica.com
  2. Choose a Project (web, Android, iOS), a language, and a Component (section of the app)
  3. To view strings that need translation, select one of the red string categories such as “Untranslated Strings”
  4. Navigate between strings with the arrow buttons to find a source string you want to translate
  5. Type your translation then save for someone to review. This may take some time as reviewers are contributors just like you

The translation platform we use, Weblate, also has more in depth guidance on how to use the platform in their documentation.


How do translations stay consistent?
We have a glossary of standard translations to reference. When you view a string, look to the right column to reference corresponding words from the language’s glossary.


How do I change a translation that’s already been reviewed?
When you have an idea for a better translation for a reviewed string, provide your translation then hit "Suggest".


What are the symbols I see in translatable text?
Words between <% %> symbols are variables used to insert information from the code. These variables shouldn’t be translated or edited in any way. You can translate everything around the variable and shift its position to fit your language’s grammar. When translating a string that has this, we recommend copy and pasting the code into your translation, as mistyping a letter or symbol can cause issues in the app.


How do I collaborate with other translators?
You can start discussions on the translation website from the “Comments” tab under each string. Alternatively, you can work with other translators through Habitica in Guilds, direct messages, and Party chat, or connect in unofficial spaces outside of Habitica.


Who do I contact if I’m having issues with the translation site?
Technical issues with translate.habitica.com can be reported to <admin@habitica.com>.


I don’t see my language listed for all platforms, or at all?
We do our best to support as many languages as we can, but since we are a very small team you may find a particular language isn’t offered. As of now, we aren’t planning to support additional languages. Languages that are partially translated now may become available within Habitica when it reaches a high percentage of strings translated.


What role does the Habitica team play in translation?
Our small team of seven aren’t experts on every language, but we do create the source English strings. We evaluate contributor tiers and appoint language reviewers based on past contributions. Source strings may change from time to time as we adjust the experience of an existing feature or add new features. While we don’t play an active role in each language’s translations, we can step in if necessary to help resolve disagreements.


How are contributor tiers awarded for translation?
After submitting translations for Habitica, you may get a contributor tier to acknowledge your help! Tiers change the color of your display name, add a badge after your name in messages, award you Gems, and display in the Hall of Heroes.

Tiers for help with translation are awarded:

  • After your first substantive contribution
  • After 1, 3, 6 months, and 1 year of contributions
  • Later tiers may be offered for 2+ years of contributions

If you meet these conditions, complete the Translation Badge Application form to let us know about your contribution. Tier requests are usually processed once every month and are awarded at the Habitica team’s discretion based on translation quality, complexity, and time spent.


How do I become a reviewer for my language?
In order to become a reviewer, you should:

  • Have 2+ translation tiers for the language you want to review
  • Know how to use our translation website’s functions efficiently
  • Work well with others and be open to discussion
  • Follow official guidance and respect language-specific best practices

If you meet these conditions, complete the Translation Reviewer Application form and reach out to us at <admin@habitica.com> to let us know you’d like to become a reviewer for a specific language. After reviewing, a member of our team will reach out to you with our decision.


Most important of all, have fun! These translations make Habitica accessible to a wider variety of people and we're extremely thankful for that. Habitica helps players improve their lives every day and we hope offering more languages will help even more people achieve their goals.


Project maintainers User avatar eilatan User avatar beffymaroo User avatar saraolson User avatar SabreCat
Translation process
  • Translations can be made directly.
  • Translation suggestions can be made.
  • Any authenticated user can contribute.
  • The translation uses monolingual files.
  • The translation base language can not be edited.
Translation license Proprietary
Source code repository git@github.com:HabitRPG/habitica.git
Repository branch develop
Last remote commit 5.31.1 31afc45744
Kalista Payne authored 19 hours ago
Last commit in Weblate Translated using Weblate (German) e455392b3a
Weblate authored 2 days ago
Weblate repository https://translate.habitica.com/git/habitica/settings/
File mask website/common/locales/*/content.json
Monolingual base language file website/common/locales/en/content.json
Translation file Download website/common/locales/ja/content.json
Last change Aug. 26, 2024, 9:41 a.m.
Last author TOMA Mitsuru

String statistics

Strings percent Hosted strings Words percent Hosted words Characters percent Hosted characters
Total 394 864 4,659
Approved 0% 0 0% 0 0% 0
Waiting for review 98% 390 99% 859 99% 4,630
Translated 98% 390 99% 859 99% 4,630
Needs editing 0% 0 0% 0 0% 0
Read-only 0% 0 0% 0 0% 0
Failing checks 0% 0 0% 0 0% 0
Strings with suggestions 0% 0 0% 0 0% 0
Untranslated strings 1% 4 1% 5 1% 29

Quick numbers

864
Hosted words
394
Hosted strings
98%
Translated
2
Contributors
and previous 30 days

Trends of last 30 days

+1%
Hosted words
+1%
+1%
Hosted strings
+1%
−1%
Translated
−1%
+50%
Contributors
−100%
User avatar None

New string to translate

Habitica / ContentJapanese

1 new string to translate appeared in the translation. 2 days ago
User avatar None

Resource update

Habitica / ContentJapanese

The "website/common/locales/en/content.json" file was changed. 2 days ago
User avatar None

String updated in the repository

Habitica / ContentJapanese

 
2 days ago
User avatar SabreCat

New string to translate

Habitica / ContentJapanese

1 new string to translate appeared in the translation. 4 weeks ago
User avatar SabreCat

Resource update

Habitica / ContentJapanese

The "website/common/locales/en/content.json" file was changed. 4 weeks ago
User avatar None

String updated in the repository

Habitica / ContentJapanese

 
4 weeks ago
User avatar None

Resource update

Habitica / ContentJapanese

The "website/common/locales/ja/content.json" file was changed. a month ago
User avatar None

New strings to translate

Habitica / ContentJapanese

3 new strings to translate appeared to the translation. 2 months ago
User avatar None

Resource update

Habitica / ContentJapanese

The "website/common/locales/en/content.json" file was changed. 2 months ago
User avatar None

String updated in the repository

Habitica / ContentJapanese

 
2 months ago
Browse all translation changes