[SAMPLE APP][INTERNATIONALIZATION] Localization tool section added
authorMichal Pawluk <m.pawluk@samsung.com>
Fri, 18 Sep 2015 12:56:08 +0000 (14:56 +0200)
committerMichal Pawluk <m.pawluk@samsung.com>
Tue, 29 Sep 2015 06:02:37 +0000 (08:02 +0200)
Change-Id: I96784ee77d35483073d16ff957cf9d5665b46267
Signed-off-by: Michal Pawluk <m.pawluk@samsung.com>
org.tizen.sampledescriptions/html/images/internationalization_add_lang_button_sd_mn.png [new file with mode: 0644]
org.tizen.sampledescriptions/html/images/internationalization_add_languages_view_sd_mn.png [new file with mode: 0644]
org.tizen.sampledescriptions/html/images/internationalization_add_string_button_sd_mn.png [new file with mode: 0644]
org.tizen.sampledescriptions/html/images/internationalization_localization_tool_view_sd_mn.png [new file with mode: 0644]
org.tizen.sampledescriptions/html/mobile_n/internationalization_sd_mn.htm

diff --git a/org.tizen.sampledescriptions/html/images/internationalization_add_lang_button_sd_mn.png b/org.tizen.sampledescriptions/html/images/internationalization_add_lang_button_sd_mn.png
new file mode 100644 (file)
index 0000000..84e9505
Binary files /dev/null and b/org.tizen.sampledescriptions/html/images/internationalization_add_lang_button_sd_mn.png differ
diff --git a/org.tizen.sampledescriptions/html/images/internationalization_add_languages_view_sd_mn.png b/org.tizen.sampledescriptions/html/images/internationalization_add_languages_view_sd_mn.png
new file mode 100644 (file)
index 0000000..f46584e
Binary files /dev/null and b/org.tizen.sampledescriptions/html/images/internationalization_add_languages_view_sd_mn.png differ
diff --git a/org.tizen.sampledescriptions/html/images/internationalization_add_string_button_sd_mn.png b/org.tizen.sampledescriptions/html/images/internationalization_add_string_button_sd_mn.png
new file mode 100644 (file)
index 0000000..ca88283
Binary files /dev/null and b/org.tizen.sampledescriptions/html/images/internationalization_add_string_button_sd_mn.png differ
diff --git a/org.tizen.sampledescriptions/html/images/internationalization_localization_tool_view_sd_mn.png b/org.tizen.sampledescriptions/html/images/internationalization_localization_tool_view_sd_mn.png
new file mode 100644 (file)
index 0000000..896736f
Binary files /dev/null and b/org.tizen.sampledescriptions/html/images/internationalization_localization_tool_view_sd_mn.png differ
index 62e77af..bffbc5d 100644 (file)
   <h3>Prerequisites</h3>
   <p>
     <ul>
-      <li>To ensure proper application execution, the strings translation files must be created using Language Explorer tool.</li>
+      <li>To ensure proper application execution, the strings translation files must be created using Localization tool.</li>
       <li>No privilages are required.</li>
        </ul>
   </p>
 
-<h2 id="lang-exp">Language Explorer</h2>
+<h2 id="lang-exp">Localization tool</h2>
+
+  <p>
+  To provide multilanguage support to the application, the Localization tool must be used. In order to invoke the Localization tool, one has to select "String Localize ..." option from project's
+  context menu. The image below depicts Localization tool view for this project.
+  </p>
+
+  <p class="figure">Figure: Localization tool view.</p>
+  <p style="text-align:center;">
+    <img alt="Localization tool view" height="450" src="../images/internationalization_localization_tool_view_sd_mn.png" />
+  </p>
+
+  <p>
+  New language is added by invoking "Add languages" tool (the screenshot is shown below) with <img src="../images/internationalization_add_lang_button_sd_mn.png" /> button.
+  </p>
+
+  <p class="figure">Figure: Add languages tool view.</p>
+  <p style="text-align:center;">
+    <img alt="Add languages tool view" height="450" src="../images/internationalization_add_languages_view_sd_mn.png" />
+  </p>
+
+  <p>
+  Once all the required languages are selected, they will appear in the Localization tool (see the Localization tool view image). Using the "Add string key" button
+  (<img src="../images/internationalization_add_string_button_sd_mn.png" />), a new text translation identification key is created. In case of this application, the following keys were created:
+  <ul>
+    <li><span style="font-family: Courier New,Courier,monospace">IDS_BODY_EXAMPLE_TEXT</span></li>
+       <li><span style="font-family: Courier New,Courier,monospace">IDS_BODY_HELLO_WORLD</span></li>
+  </ul>
+  For the keys above one can provide text translations for all selected languages.
+  </p>
+
+  <p>
+  From now on, within the application's source code, the translation keys must be used instead of the plain texts (see the <a href="#text-trans">Text translation</a> section for more details).
+  </p>
 
 <h2>Implementation</h2>
 
@@ -223,7 +256,7 @@ static bool __get_available_locale_cb(const char *locale, void *data)
   The view related source code is not listed here, as it is not a subject of this document.
   </p>
 
-<h3>Text translation</h3>
+<h3 id="text-trans">Text translation</h3>
 
   <p>
   The application demonstrates two different approaches to the text strings translation:
@@ -239,7 +272,7 @@ static bool __get_available_locale_cb(const char *locale, void *data)
          it affects only this application and does not influence any other component on the mobile platform.
          </li>
     </ul>
-  Both methods require that the strings translation files are available (see the <a href="#lang-exp">Language Explorer</a> section for more details).
+  Both methods require that the strings translation files are available (see the <a href="#lang-exp">Localization tool</a> section for more details).
   </p>
 
 <h4 id="global-lang-ch">Hangling global language change</h4>