home-assistant.io/source/developers/frontend_translation.markdown
2017-11-06 23:04:28 +01:00

2.6 KiB

layout, title, description, date, sidebar, comments, sharing, footer, ha_release
layout title description date sidebar comments sharing footer ha_release
page Frontend Translation How to translate the frontend for Home Assistant. 2017-10-27 13:00 true false true true 0.57

{% linkable_title How to start %}

Join the translation team and choose your language. Even if your language is completely translated, extra proofreading is a big help! Please feel free to review the existing translations, and vote for alternatives that might be more appropriate.

First time users may find it helpful to switch between multilanguage and single language view using the Multilanguage view button. For more information about the translation workflow, please see the Lokalise translation workflow documents.

The translation of the Home Assistant frontend is still a work in progress. More phrases will be available for translation soon.

{% linkable_title Rules %}

  1. Only native speakers should submit translations.
  2. Stick to Material Desing guidelines.
  3. Don't translate or change proper nouns like Home Assistant, Hass.io or Hue.

{% linkable_title Adding a new language %}

If your language is not listed you can request it at GitHub. Please provide both the English name and the native name for your language. For example:

English Name: German
Native Name: Deutsch

Note: Languages that differ from the language of the country of origin need a translation for the latter first. Example: `French as used in Canada` requires a generic `French` translation.

{% linkable_title Maintainer steps to add a new language %}

  1. Language tags have to follow BCP 47. A list of most language tags can be found here: IANA sutbtag registry. Examples: fr, fr-CA, zh-Hans. Only include the country code if country specific overrides are being included, and the base language is already translated.
  2. Add the language tag and native name in src/translations/translationMetadata.json. Examples: "Français", "Français (CA)"
  3. Add the new language in Lokalize. Note: Sometimes you have to change the tag in Lokalise (Language -> Language settings -> custom ISO code).