search

WebThingsIO / gateway

WebThings Gateway - a self-hosted web application for monitoring and controlling a building over the web
http://webthings.io/gateway
Mozilla Public License 2.0
2.62k stars 339 forks source link

Localisation (L10n) #1647

Closed benfrancis closed 5 years ago

benfrancis commented 5 years ago

As a user I would like to use the gateway in my native language so that I can use it without knowing English.

benfrancis commented 5 years ago

See also: Issue on localizing the website https://github.com/mozilla-iot/mozilla-iot.github.io/issues/18

Tools Suggestion: Fluent for your front-end library, and Pontoon for your community translation tool.

mrstegeman commented 5 years ago

We'll need to extend this to add-ons as well, for property titles, configuration descriptions, etc.

jaller94 commented 5 years ago

Is localization a consideration in the Web of Things API? The things come with labels and descriptions, as do properties, events and actions.

Besides vendors of things providing these, it would be cool to have an open data collection of translations for languages that the vendors didn’t support. I imagine this similar to TypeScript where one can create a repository of type definitions for frameworks that do not ship type definitions themselves.

benfrancis commented 5 years ago

@jaller94 wrote:

Is localization a consideration in the Web of Things API?

I've filed https://github.com/mozilla-iot/wot/issues/127 for this. My recommendation is to use HTTP Accept-Language headers.

kgiori commented 5 years ago

It would be nice to see some initial "scaffolding" implemented to support Fluent. With example Fluent framework added to the "Things" and "Rules" pages, that might be enough to enable the community to step in and help on remaining pages. Once we have even just a few of the structural elements in place, we can contact friends of Mozilla (language translators) who will likely be willing to help make this happen.

wtigga commented 5 years ago

Hi there. I would really love to contribute to WebThings i18n part. I have published three translations of Mozilla IoT-related articles in Russian (Gateway user guide, Gateway - Getting Started, Empowering User Privacy), and I see people are very curious about the project, but the lack of language support is a bummer for the majority of users.

Please let the community know once we can start the translation process. Cheers.

mrstegeman commented 5 years ago

Resources:

mrstegeman commented 5 years ago

This is doe, as of 0.10. At some point, add-ons will need localization as well, but that can be a separate issue.