From 74feec1213281d593cf4f0a0e00353cdd23ae552 Mon Sep 17 00:00:00 2001 From: Adam Mills Date: Sun, 5 Nov 2017 22:04:03 -0500 Subject: [PATCH] Frontend translation guide cleanup --- .../asides/developers_navigation.html | 1 + .../developers/frontend_translation.markdown | 35 +++++++++++------- .../lokalise-multilanguage-view-button.png | Bin 0 -> 3843 bytes 3 files changed, 22 insertions(+), 14 deletions(-) create mode 100644 source/images/frontend/lokalise-multilanguage-view-button.png diff --git a/source/_includes/asides/developers_navigation.html b/source/_includes/asides/developers_navigation.html index 613ff5834b41..34f1de46476d 100644 --- a/source/_includes/asides/developers_navigation.html +++ b/source/_includes/asides/developers_navigation.html @@ -78,6 +78,7 @@

Development Guide

  • {% active_link /developers/frontend_add_more_info/ Add More Info Dialog %}
  • {% active_link /developers/frontend_creating_custom_panels/ Add Custom Panels %}
  • {% active_link /developers/frontend_creating_custom_ui/ Add Custom UI %}
    • +
  • {% active_link /developers/frontend_translation/ Translation %}
  • diff --git a/source/developers/frontend_translation.markdown b/source/developers/frontend_translation.markdown index 3d6e452da5a9..feb07d5a2085 100644 --- a/source/developers/frontend_translation.markdown +++ b/source/developers/frontend_translation.markdown @@ -1,6 +1,6 @@ --- layout: page -title: "Translate Home Assistant frontend" +title: "Frontend Translation" description: "How to translate the frontend for Home Assistant." date: 2017-10-27 13:00 sidebar: true @@ -10,25 +10,32 @@ footer: true ha_release: 0.57 --- -The translation of the Home Assistant frontend is still a work in progress. More phrases will be available soon. +## {% linkable_title How to start %} +[Join the translation team](https://lokalise.co/signup/3420425759f6d6d241f598.13594006/all/) 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. -#### {% linkable_title How to start %} -[Join the translation team](https://lokalise.co/signup/3420425759f6d6d241f598.13594006/all/) and choose your language. If your language is not listed you can request it at [GitHub](https://github.com/home-assistant/home-assistant-polymer/issues/new). Please provide both the English name and the native name for your language. Example: German / 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. - -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](https://docs.lokalise.co/category/iOzEuQPS53-for-team-leads-and-translators). -For more information about the translation workflow, please see the [Lokalise translation workflow documents](https://docs.lokalise.co/category/iOzEuQPS53-for-team-leads-and-translators). +

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

    -#### {% linkable_title Rules %} +## {% linkable_title Rules %} 1. Only native speakers should submit translations. -2. English is reference language. -3. Stick to [Material Desing guidelines](https://material.io/guidelines/style/writing.html). -4. Don't translate or change proper nouns like `Home Assistant`, `Hass.io` or `Hue`. +2. Stick to [Material Desing guidelines](https://material.io/guidelines/style/writing.html). +3. Don't translate or change proper nouns like `Home Assistant`, `Hass.io` or `Hue`. -Tip: Use `Multilanguage view` (eye-symbol) and hide those languages you don't need. +## {% linkable_title Adding a new language %} +If your language is not listed you can request it at [GitHub](https://github.com/home-assistant/home-assistant-polymer/issues/new). 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 For maintainers %} +### {% linkable_title Maintainer steps to add a new language %} 1. Language tags have to follow [BCP 47](https://tools.ietf.org/html/bcp47). A list of most language tags can be found here: [IANA sutbtag registry](http://www.iana.org/assignments/language-subtag-registry/language-subtag-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. diff --git a/source/images/frontend/lokalise-multilanguage-view-button.png b/source/images/frontend/lokalise-multilanguage-view-button.png new file mode 100644 index 0000000000000000000000000000000000000000..12370813300e8a81d7ffe9e89abc8f5a36d56b00 GIT binary patch literal 3843 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 M^-SRJVD|X`0JR9d_5c6? literal 0 HcmV?d00001