Internationalize and localize Hajk

[jacobwod]

Currently all text strings in Hajk are hard-coded in Swedish. To make this project attract more users and developers, it is essential that the software is engineered in a way that allows for easy localization.

Built-in localization that adapts Hajk's UI according to the user's language preferences is another convenient side effect of this feature.

For more info, see this wiki article.

Below are some articles with examples of different solutions that must be compared before we decide which way to go. The list is in no particular order.

• https://phrase.com/blog/posts/react-i18n-best-libraries/
• https://lingui.js.org/index.html
• https://medium.com/@shalkam/create-react-app-i18n-the-easy-way-b05536c594cb

[Hallbergs]

I've done some tests in this branch: https://github.com/hajkmap/Hajk/tree/feature/502-internationalization

First translation added ("core.drawerToggleButton.plugins", Kartverktyg in sv and Tools in en)

The solution uses i18next, react-i18next, and i18next-browser-languagedetector

[jacobwod]

C'est wonderful! 😃

[AndreasAtakan]

What's the status on this?

I just created a new issue asking about this: #942

[Hallbergs]

The current status is that the core functionality (switching language in the UI or in the map configuration) has been added, and a couple of components have been migrated to use I18n. Unfortunately, the migration has been put on hold due to other priorities.

However, i still think it is important that this gets done asap, so that organizations outside Sweden can use Hajk! My guess is that this will get done in q1-q2 2022.

[jacobwod]

I second @Hallbergs opinion: this is a priority that has been put on hold but we're working on sorting the out the blocking parts so the I18N work can continue. 👍

[matself]

Hi! I’d be happy to provide an english translation. But I am unable to find any language files. I have just done Geonetwork (on Transifex) and Mapstore (file-based) to swedish. And a revised Geoserver swedish UI is coming up, as soon as the Transifex integration has been sorted out. Hälsning / Regards Mats.E Skickat från min / Sent from my iPad, Ursäkta att jag är kortfattad / Excuse my brevity.

…

2 dec. 2021 kl. 08:16 skrev Jacob Wodzyński ***@***.***>:  I second @Hallbergs opinion, this is a priority that has been put on hold but we're working on sorting the out the blocking parts so the I18N work can continue. 👍 — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub, or unsubscribe.

[Hallbergs]

Translation files (eng and swe) exists on the feature branch for the i18n migration.

This branch is on-hold for the moment since we're currently migrating the application to MUI5, and want to avoid too many merge conflicts. The plan is to get the MUI5 migration done, then merge the the MUI5 migration into the I18n-feature-branch, and then continue the I18n migration.

[matself]

I see. I looked in master only and found no language files at all. Hälsning / Regards Mats.E Skickat från min / Sent from my iPad, Ursäkta att jag är kortfattad / Excuse my brevity.

…

2 dec. 2021 kl. 10:06 skrev Henrik Hallberg ***@***.***>:  Translation files (eng and swe) exists on the feature branch for the i18n migration. This branch is on-hold for the moment since we're currently migrating the application to MUI5, and want to avoid too many merge conflicts. The plan is to get the MUI5 migration done, then merge the the MUI5 migration into the I18n-feature-branch, and then continue the I18n migration. — You are receiving this because you commented. Reply to this email directly, view it on GitHub, or unsubscribe.

[bitmapbulgaria]

There is introduction translation in Bulgarian, for the future language localization:

https://drive.google.com/file/d/1nN-K4A3ATYo5ULUPlc3m-mj838-OulBw/view?usp=sharing
Please, add this to the branch, I'll delete the link after that.

[Hallbergs]

Woho! Nice job!

I just pushed it to the branch, so you can go ahead and delete the file.

[bitmapbulgaria]

Thanks! Will do some polishing, when #502 is complete, but for now is good enough.

[mkoskl]

Is this still relevant issue? Are you working on this?

[jacobwod]

The issue is relevant, but the current maintainers and organisations we represent have not had the resources to implement this ourselves.

Being an open source product, Hajk looks forward to any contributions, including (but not limited to) internationalization efforts. The Hajk maintainers will certainly pay attention to any PR addresses this.

[mkoskl]

Is there any documentation where I could at least look at it? What it requires etc.