Translate all text to choosed language?

thanhnt

Hi guys, How can i change all text ( at builder display, user display ....) to jp?

gabriel

Welcome to the forum 🙂
Builder and other UI elements are currently provided in 5 languages - unfortunately, there is no Japanese translation available at the moment.

If you want to create one, let me know and I´ll show you how.

thanhnt

gabriel Tks for replied.
With Builder: I think I can translate to japanese by create a file in r3/www/langs and re-build

But with UI Elements: I want to know How to translate all text with one file like builder instead fill out each text/ title for now.

lsw-fabian

Currently you can only translate the R3 UI within a single file. Applications within R3 do not have this feature yet, but we have already worked out a concept for it and will release it in a later version. To translate applications, like 'Tasks' or 'Shift', in the current version you have to translate all components like attributes and forms manually in the builder.

If you want to translate the R3 UI, we would be very happy if you could send us the translation file so that we can include it in the next release and make it available to the whole community.

thanhnt

lsw-fabian Thank you so much for your answer

Luiz

I didn’t quite understand how to handle these translations. Does REI3 already provide a file for the 5 supported languages? I’d like to import a translation for Brazilian Portuguese. Can you help me with this?

gabriel

Luiz
Hello Luiz and welcome to the forum 🙂

To your question: It depends on the context. There are the translation files (available on Github), which provide the core translation for the r3 platform. You can follow this link, download an existing file, translate it to Brazilian Portuguese and either submit a pull request or send it to us to include in a future release. You can build r3 yourself to get the translation immediately, but it takes some effort to do. If you provide the file to us, we can include it in a patch.

Besides the platform translation, there are translations for r3 applications. These can be transalted by you in the admin panel under Translations to a language of your choice.

rfernandez

gabriel
Hi Gabriel,
I hope you are doing great!
I'm brand new to REI3, but I already find it great! Congratulations!!

I'm creating my first application and I would like to translate default elements like button captions, messages, etc., to Spanish.
I tried changing the user default language to es_es (which apparently is a community translation) in the admin panel, and it translates everything to Spanish but only in the admin panel itself, and what I want to change is inside my Application.
For example I'm using a list element to read data from the database, and I need to change the caption of the "New" button to the same, but in Spanish.

If I go to Translations option in the admin panel, everything is grayed out except for the Relations,for which I have defined captions when creating the relation.
If I go to Application Builder, the language selection to es_es does not work for the platform texts. (it does not translate the REI3 texts as it does in the Admin section)
Also if I go to the Captions option inside my application I only see the Relations section enabled (same as in the admin panel)

I've searched the documentation but I couldn't find anything that I could use to solve this situation.
Would you be so kind to guide me in solving it?

Thank you very much!
Warm regards
Ricardo

P.S. I attach a link to the image of the Translations/Captions screen.

Luiz

Thank you for the quick response. I appreciate your help.

gabriel

rfernandez

Hello and welcome to the forum 🙂

It´s a bit complicated, because there a different kinds of translations. What you show in the screenshot is the caption map, it is a global overview and direct access to all labels/titels which can be defined and translated inside an application. In this case your app "Address Book" appears to only have 1 relation and no defined forms or menus - that is why everything else is greyed out.

To translate platform labels, like help messages, or standardized buttons (like the 'New' button on a list field), you would need to update this file:
https://github.com/r3-team/r3/blob/main/www/langs/es_es
This is the es_es community translation, which contains all platform texts. If you are willing to put in the time to update it, we can include your changes in the next patch release of r3. This is how our community translations are kept up to date.

rfernandez

gabriel
Hi,
Thank you very much for the welcome and for your fast response!

Well in fact my app has a menu and a form:

No idea why they don't show in this screen; do you?

Meanwhile I'll take a look at that file you mentioned and see what I can do.
And I'll be coming back with my findings on the file and probably for some extra advice.

Thank you very much!!
Warm regards
Ricardo

gabriel

Hello Ricardo,

In your application settings, is es_es registered as supported language?

For values to appear in the caption map, the language must be available in your application and you need to have some captions assigned to elements (eg. a es_es form title for example).

rfernandez

Hello Gabriel,
Thanks again for taking the time to answer my question.

I've corrected the following:

Application language set only to es_es
Translations for App Title and List Title to es_es

My findings:
I set the app language to es_es, I run the application and ... still was displaying in English, until I found that you also need to assign the user a language. I did that to es_es and then it started displaying in Spanish.
However the user can only have one language assigned.
I also learned that the application has no option for changing language while running, like a "Select your language" list.
It is going to run in the language currently assigned for the user, if the application supports that same language. What makes sense since the user can only be assigned one language at a time.
Also that only certain elements support assigning a language in the Builder, so the rest must be done through the translation file, as you previously said.
Now, these translated elements started appearing in the screenshot I sent before, in which they were originally grayed out.

Please correct me if any of my findings is incorrect.

I will now try to find and translate other elements in the es_es file and I'll be sending it to you, for including it in the next version you release.
How do you prefer that I send you the file? (as an upload here? or somewhere else?)

Thank you very much!!
Warm regards
Ricardo

gabriel

Multi-language software is always somewhat complex due to the amount of variables, especially for a low-code platform such as we are. We have the language an app is built in (what is defined in the builder), languages supported by the platform (in the language files), the language a user wants to use the app in (yes, only one at a time 😉 ), language overwrites on a customer level (what you can do in the admin panel) and last, but not least, multi-language data (eg. data inside your app).

And in most cases, most users can "just" start using it without worrying about it. A lot of engineering for being as invisible as possible 🙂

Regarding work on language files: Thank you for taking the time and making the effort 🙂
You can either submit changes directly via Github (if you are comfortable with it), or you can paste it here as a link. I can also provide an email contact, if that is your preference 🙂

rfernandez

Hi Gabriel,
How are you?
Yes, it is indeed a multi-level language construction 🙂

Probably next week I'll be sending a new es_es file with some other sections translated for you to validate, and in case you find it OK, for including it in your next release.
I'll probably do it here as a as an upload or link. The email contact would also be fine.
I'm not much of a Github person 🙂. Unless it becomes the only means.

Thank you!!
Warm regards
Ricardo

gabriel

rfernandez
Thank you for your effort 🙂

A link works just fine. Github is convenient, but really not necessary, as long as the file content is correct.

rfernandez

Hi Gabriel,
I hope you are doing great!

I have the es_es translation file with my contribution.
It's a google drive link, but I prefer to share it only with you.
How would you suggest to do it. (I tried to upload it here but it didn't allow me)

Thank you!
Warm regards
Ricardo

gabriel

rfernandez
Hello Ricardo,

You can reach me via my mail, which you find here: https://rei3.de/en/contact 🙂

rfernandez

Hi Gabriel,
I've sent you the email with the es_es file for you to approve.

Warm regards!
Ricardo