Difference between revisions of "SHIP:Language and Translation Management (Version 5)"

From Serious Documentation
Jump to: navigation, search
(→‎The Language Manager)
(→‎The Language Manager)
Line 5: Line 5:
 
* Language list management
 
* Language list management
  
−
== The Language Manager ==
+
== SHIPTide Language Elements ==
 
In SHIPTide, the various language elements are:
 
In SHIPTide, the various language elements are:
 
{| class="wikitable" style="margin: 1em auto 1em auto;"  
 
{| class="wikitable" style="margin: 1em auto 1em auto;"  
Line 14: Line 14:
 
# individual {{Node|text}} and/or {{Node|string}} resources
 
# individual {{Node|text}} and/or {{Node|string}} resources
 
# selects the currently displayed language
 
# selects the currently displayed language
−
# launches the language manager
+
# launches the Language and Translations manager
 +
 
 +
== The Language and Translations Manager ==
 +
Pressing the language manager button launches a pop-up dialog language and translations manager something like this:
 +
{| class="wikitable" style="margin: 1em auto 1em auto;"
 +
|[[Image:SHIPTideLanguageManager.png|600px|center|The Language and Translations Manager]]
 +
|}
 +
The manager has two areas: the upper area (1) is the list of available languages, and the bottom area (2) shows all the translatable resources and enables Microsoft Excel import/export.
 +
=== The Language List ===
 +
The upper area (1) shows the list of languages you want to accommodate in your GUI. Here you can add, remove, and set the default language. The default language means that if a translation does not exist for a given string resources the default language translation will be used. 
 +
 
 +
Pressing the "add" button allows you to add a new 4-letter language code and to (optionally) give this language a more readable name:
 +
{| class="wikitable" style="margin: 1em auto 1em auto;"
 +
|[[Image:SHIPTideAddLanguage.png|600px|center|Adding a Language]]
 +
|}
 +
In the example above, we're adding Portuguese (pt) as used in Brazil (BR), and giving it the more readable name of "PortugueseSA" to remind us it is Portuguese as used in South America.  Pressing OK yields a new language list in the language manager:
 +
{| class="wikitable" style="margin: 1em auto 1em auto;"
 +
|[[Image:SHIPTideAddLanguage2.png|600px|center|After adding ptBR]]
 +
|}
 +
Highlighting this new language and pressing "Remove" will remove that language, '''including all translations for all resources in that language'''.
 +
{| class="wikitable" style="margin: 1em auto 1em auto;"
 +
|[[Image:SHIPTideRemLanguage.png|600px|center|Removing ptBR]]
 +
|}
 +
Selecting any language in the list and pressing "Set Default" will make that language the default GUI language.
 +
=== Import/Export ===
 +
The lower area (2) lists in a table format all the various {{Node|text}}/{{Node|string}} resources in your project, including their various translations.  Depending on the version of SHIPTide, you may or may not be able to edit this table directly.  This lower area allows you to export all these resources to a Microsoft Excel file (.xls) and re-import that file post-translation back into your project.

Revision as of 11:59, 20 May 2014

SHIPTide V5 includes significant new management capabilities for multi-language resources, including:

  • Import/Export of all your resources from/to Microsoft Excel
  • Table-style editing
  • Default language management
  • Language list management

SHIPTide Language Elements

In SHIPTide, the various language elements are:

Where to find Language Elements
  1. the Resources area
  2. the set of Text resources
  3. individual text and/or string resources
  4. selects the currently displayed language
  5. launches the Language and Translations manager

The Language and Translations Manager

Pressing the language manager button launches a pop-up dialog language and translations manager something like this:

The Language and Translations Manager

The manager has two areas: the upper area (1) is the list of available languages, and the bottom area (2) shows all the translatable resources and enables Microsoft Excel import/export.

The Language List

The upper area (1) shows the list of languages you want to accommodate in your GUI. Here you can add, remove, and set the default language. The default language means that if a translation does not exist for a given string resources the default language translation will be used.

Pressing the "add" button allows you to add a new 4-letter language code and to (optionally) give this language a more readable name:

Adding a Language

In the example above, we're adding Portuguese (pt) as used in Brazil (BR), and giving it the more readable name of "PortugueseSA" to remind us it is Portuguese as used in South America. Pressing OK yields a new language list in the language manager:

After adding ptBR

Highlighting this new language and pressing "Remove" will remove that language, including all translations for all resources in that language.

Removing ptBR

Selecting any language in the list and pressing "Set Default" will make that language the default GUI language.

Import/Export

The lower area (2) lists in a table format all the various text/string resources in your project, including their various translations. Depending on the version of SHIPTide, you may or may not be able to edit this table directly. This lower area allows you to export all these resources to a Microsoft Excel file (.xls) and re-import that file post-translation back into your project.

Retrieved from "https://techref.myserious.com/index.php?title=SHIP:Language_and_Translation_Management_(Version_5)&oldid=3799"