Continuing this effort, I am very pleased to let you know HABPanel is now fully localizable and it will use the setting you configure in Paper UI (Configuration > System > Regional Settings) to display dates, numbers and even text in your language!
The only thing left is to actually translate it
That’s where you, the community, will be able to help!
If you’re a native speaker or even fluent in another language than English or French (you’re in luck, I already took care of that one ) and were looking to contribute something other than code to the project, you can now step up and join the crowdin project at:
Click on your language, and choose which part of the project you’d like to help translate by clicking on one of the 3 files:
main.pot contains common terms across the application, as well as the new device tutorial and text displayed on end-user, non-administration screens: dashboards, main menu.
It currently contains only 40 strings and is the bare minimum to start a new language. You’re invited to begin with this one!
admin.pot contains all the text in the administration screens minus the widgets settings: dashboard designer, general settings, widget gallery, custom widget list and designer, etc.
It contains 183 strings to translate.
widgets.pot contains all the text in the widgets’ settings dialog boxes. Some are common to several widgets (widget.common…) and others are for a specific widget (widget.button…).
It contains 228 strings to translate.
It’s not mandatory to have a language completely translated for it to be included, main.pot is enough (but the more, the better ). Parts not translated will simply remain in English. All translations can then be upvoted and downvoted by other members and will be eventually approved. Approved translations will then end up in HABPanel.
A few things to keep in mind when translating:
The “context” will be displayed in the crowdin interface, most will include a small description about where the string would be found in the interface. Some will even have screenshots as we make and upload them. Indeed, some text like error strings are not easily or rarely shown.
HABPanel is designed to be usable even on phones, where screen estate is limited, so when translating, if you can, please use the Chrome developer tools (right-click text and click Inspect), click on this small icon: then verify how it looks when you select for instance “iPhone 7” or “Nexus 6P” in the toolbar above the page! This is absolutely not mandatory but I’d appreciate it.
You can also double-click on the text in the code (or right-click and choose Edit text) and replace it with your translation.
Some terms like panel, dashboard, panel configuration will have their definition shown, to help translating them in a consistent way. Those definitions are taken from the docs here: https://docs.openhab.org/configuration/habpanel.html#concepts
If your language isn’t included in the initial list (reproduced below), please follow the description in the project’s home page to request it:
Looking forward to your help!
Also be sure to help translating other openHAB projects on crowdin!