Add Multi-Language Support

[StefanoBerlato]

As per title, I would start thinking about multi-language support, if you are ok I can take care of it.

[emavgl]

Assigned!

[StefanoBerlato]

I started following this official guide (https://flutter.dev/docs/development/accessibility-and-localization/internationalization).

[StefanoBerlato]

The official guide is ok but a bit messy and the code boilerplate, I would like to leverage a dedicated package flutter. There are two packages suitable for i18n (i.e., score > 90 and author verified), I chose the one with the highest number of likes (https://pub.dev/packages/i18n_extension).

[StefanoBerlato]

I18n is working, now we just have to keep track of the new strings we add to the app and translate them. As of now, the supported languages are:

• English (en_us)
• Italian (it_it)
• Spanish (es_es)
• French (fr_fr)
• German (de_de)

We can both take care of English and Italian. I will take care of Spanish and French, while you can take care of German (so you learn a bit 😛 )

[freacore]

What files exactly do I have to translate? Because there is no german or spanish available yet.

[emavgl]

Hi @freacore, that's right, just English and Italian are currently supported. You are of course welcome to contribute. We are using this library https://pub.dev/packages/i18n_extension - you basically have to look for files with the extensions .i18n. In those you can find the strings in the two available languages.

For example: https://github.com/emavgl/oinkoin/blob/master/lib/records/i18n/records-page.i18n.dart

Here you have for example:

      {
        "en_us": 'Add a new record',
        "it_it": "Aggiungi un nuovo movimento.",
      }

and if you want to provide a German translation, you just add

      {
        "en_us": 'Add a new record',
        "it_it": "Aggiungi un nuovo movimento.",
        "de": "HERE YOUR GERMAN TRANSLATION"
      }

Eventually, we will need to add German as supported Locale here https://github.com/emavgl/oinkoin/blob/master/lib/main.dart#L65

[nizarus]

Hi, Why not using a translation platform like https://weblate.org/ so the application can be translated by the community in multiple languages

[emavgl]

Thanks, I am not familiar with weblate and I will look at it, together with crowdin. The format used in this app is not a standard and it can be of difficult integration. So I was thinking to put all the strings in a single file like en.json, it.json, de.json and so on. Then those websites should be able to work with them.

[emavgl]

Hi there, I have recently added an integration with the platform Crowdin for the translation. It should facilitate the translations of new strings. You can find the link here https://github.com/emavgl/oinkoin#translation - let me know if there are any issue (login etc)

cc: @nizarus @freacore

[nizarus]

I can help in French and Arabic translation. Please activate them in Crowdin.

[emavgl]

@nizarus just added :) do you require any additional permissions?

[nizarus]

@emavgl done 👍

[emavgl]

Thank you so much @nizarus - I have released a new version and it got already approved in Google Play. You can find your translation in https://github.com/emavgl/oinkoin/releases/tag/1.0.31

[nizarus]

I detected a wrong French translation and I updated it on Crowdin. Also the format in 'Recurrent Records' pane should be updated to display the whole message. See :

[emavgl]

Thanks, merged with the PR https://github.com/emavgl/oinkoin/pull/38 They will be released, together with the 'Recurrent Records' pane in the next release :)

[emavgl]

I have created the following threads on Github discussions page: https://github.com/emavgl/oinkoin/discussions/categories/translations - so that we leave this issue closed, and we have always going discussions there.