Language and Translations: Difference between revisions

From IMSMA Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(23 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__FORCETOC__
{{TOC right}}
{{TOC right}}
{{Note | The Data Entry Templates and the Summary Templates will not automatically be translated. }}
The language used by {{IMSMANG}} is of two types:
# the language that the data is entered in (blue arrow)
# the language that the application use (red arrows).
{| class="wikitable"
|-
| width="300pt" | [[Image:Language.png|300px]]
| width="300pt" | [[Image:VGA card.png|175px]] [[Image:VGA card2.png|175px]]
|-
| width="500pt" | When the users see ''squares'' instead of expected characters even if the font is installed on the computer e.g. in the Country structure then you need to
# create a new folder called ''fallback'' in ''C:\IMSMAng\java\lib\fonts'' and
# copy the fonts for the data language there.
| width="500pt" | Other font issues may be caused by high resolution VGA card. If this is the case then you need to:
# go to C:\IMSMAng\trayLauncher folder
# right-click on IMSMA.exe and choose Properties
# on the Compatibility tab check ''Disable display scaling on high DPI settings''
# choose ''System'' in the drop-down list.
|}
==Application language a.k.a. localisation or translation==__NOEDITSECTION____FORCETOC__
{{HowTo's
{{HowTo's
|[[Change the Language|How does IMSMA know which language to use?]]
|[[Change the Language|How does IMSMA know which language to use?]]
|[[Update the Localisation Files|Update the Localisation Files]]
|[[Update the Localisation Files|Update the Localisation Files]]
|[[Export the Translations]]
|[[Import the Translations]]
}}
}}
{{Note| To modify the localisation files, you '''should''' use Rosetta-J. For information on using Rosetta-J, contact your [[Information Management Team | GICHD IM advisor]].}}


In order to use other languages than English, three files are used for localization of the messages and terms used in {{IMSMANG}}. If you would like to run {{IMSMANG}} in a language other than English, you will need to enter translations into the following properties files:
If you would like to run {{IMSMANG}} in a language other than English or '''make changes to the English''' terms and messages, you will need to create three properties files for that language:
* IMessages.properties;
* IMessagesXX.properties;
* ITerms.properties.
* ITermsXX.properties;
 
* trans_XX.properties.  
These two files are stored as files and are not imported into the database nor included in the database backup. Please, refer to [[Considerations for Backup and Restore]].
 
The third file is created by the [[Export and Translate the Terms|Export Translations]] in the File menu and should be [[Import the Translated Terms|imported]] back into the database after the translation is done.


{{note| To modify the localisation files, you '''should''' use Rosetta-J. For information on using Rosetta-J, contact your GICHD IM advisor.}}
IMessages and ITerms are not imported into the database nor included in the database backup. '''[[Backup and Restore]]''' explains on how to backup the language files which are in the ''C:\IMSMAng\client\resources\com\fgm\imsma\lexicon'' folder. The third file is imported into the database and therefore included in the database backup.


{{NavBox Getting started with IMSMA}}
When the users see ''squares'' instead of expected characters e.g. in menus and labels then something is wrong with the translation files IMessages and ITerms for the language specified in the Regional settings on the user's computer.
{{NavBox IMSMA NG Administration}}


[[Category:NAA]]
[[Category:NAA]]

Latest revision as of 19:04, 18 August 2021

The Data Entry Templates and the Summary Templates will not automatically be translated.

The language used by IMSMANG is of two types:

  1. the language that the data is entered in (blue arrow)
  2. the language that the application use (red arrows).
When the users see squares instead of expected characters even if the font is installed on the computer e.g. in the Country structure then you need to
  1. create a new folder called fallback in C:\IMSMAng\java\lib\fonts and
  2. copy the fonts for the data language there.



Other font issues may be caused by high resolution VGA card. If this is the case then you need to:
  1. go to C:\IMSMAng\trayLauncher folder
  2. right-click on IMSMA.exe and choose Properties
  3. on the Compatibility tab check Disable display scaling on high DPI settings
  4. choose System in the drop-down list.

Application language a.k.a. localisation or translation

To modify the localisation files, you should use Rosetta-J. For information on using Rosetta-J, contact your GICHD IM advisor.

If you would like to run IMSMANG in a language other than English or make changes to the English terms and messages, you will need to create three properties files for that language:

  • IMessagesXX.properties;
  • ITermsXX.properties;
  • trans_XX.properties.

IMessages and ITerms are not imported into the database nor included in the database backup. Backup and Restore explains on how to backup the language files which are in the C:\IMSMAng\client\resources\com\fgm\imsma\lexicon folder. The third file is imported into the database and therefore included in the database backup.

When the users see squares instead of expected characters e.g. in menus and labels then something is wrong with the translation files IMessages and ITerms for the language specified in the Regional settings on the user's computer.

{{#switch:|subgroup|child=|none=|#default=

{{#if:|<th scope="col" style="border-left:2px solid #fdfdfd;width:100%;|}}{{#if:|{{#if:IMSMANG Administration|}}}}{{#if:{{#switch:{{#if:|{{{border}}}|child}}|subgroup|child=|none=|#default=

}}{{#ifeq:|Template|{{#ifeq:{{#if:|{{{border}}}|child}}|child||{{#ifeq:{{#if:|{{{border}}}|child}}|subgroup||{{#switch:language and translations

|doc
|sandbox
|testcases =
|#default = {{#switch:
 |plainlist
 |hlist
 |hlist hnum
 |hlist vcard
 |vcard hlist = 
 |#default = 
 }}
}}

}}}}}}|{{#if:IMSMANG Administration|}}{{#if:|

{{{imageleft}}}

}}{{#if:Installing IMSMANG|Installing IMSMANG<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{#switch:{{#if:|{{{border}}}|child}}|subgroup|child=

|none=|#default=

}}{{#ifeq:|Template|{{#ifeq:{{#if:|{{{border}}}|child}}|child||{{#ifeq:{{#if:|{{{border}}}|child}}|subgroup||{{#switch:language and translations

|doc
|sandbox
|testcases =
|#default = {{#switch:
 |plainlist
 |hlist
 |hlist hnum
 |hlist vcard
 |vcard hlist = 
 |#default = 
 }}
}}

}}}}}}{{#if:|

{{{image}}}

}}}}{{#if:|{{#if:IMSMANG Administration{{#switch:{{#if:|{{{border}}}|child}}|subgroup|child=|none=|#default=

}}{{#ifeq:|Template|{{#ifeq:{{#if:|{{{border}}}|child}}|child||{{#ifeq:{{#if:|{{{border}}}|child}}|subgroup||{{#switch:language and translations

|doc
|sandbox
|testcases =
|#default = {{#switch:
 |plainlist
 |hlist
 |hlist hnum
 |hlist vcard
 |vcard hlist = 
 |#default = 
 }}
}}

}}}}}}|}}{{#if:|{{{group2}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list2}}}

}}{{#if:|{{#if:IMSMANG Administration{{#switch:{{#if:|{{{border}}}|child}}|subgroup|child=|none=|#default=

}}{{#ifeq:|Template|{{#ifeq:{{#if:|{{{border}}}|child}}|child||{{#ifeq:{{#if:|{{{border}}}|child}}|subgroup||{{#switch:language and translations

|doc
|sandbox
|testcases =
|#default = {{#switch:
 |plainlist
 |hlist
 |hlist hnum
 |hlist vcard
 |vcard hlist = 
 |#default = 
 }}
}}

}}}}}}|}}{{#if:|{{{group3}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list3}}}

}}{{#if:|{{#if:|{{{group4}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list4}}}

}}{{#if:Documenting Customisations · Defining Roles, Permissions and Users · Language and Translations · Data Inventory Manager · Standardising Auxiliary Data · Design Data Entry Forms · Configuring the Items ID Generator · Designing Summary Templates · Standardising Data Analysis and Information Reporting · Designing iReport templates · Building Searches · Setting-up Maps and Coordinate Systems|{{#if:Customising IMSMANG|Customising IMSMANG<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

Documenting Customisations · Defining Roles, Permissions and Users · Language and Translations · Data Inventory Manager · Standardising Auxiliary Data · Design Data Entry Forms · Configuring the Items ID Generator · Designing Summary Templates · Standardising Data Analysis and Information Reporting · Designing iReport templates · Building Searches · Setting-up Maps and Coordinate Systems

}}{{#if:Information Exchange · Backup and Restore · Importing and Exporting|{{#if:Manage Information|Manage Information<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

Information Exchange · Backup and Restore · Importing and Exporting

}}{{#if:|{{#if:|{{{group7}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list7}}}

}}{{#if:|{{#if:|{{{group8}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list8}}}

}}{{#if:|{{#if:|{{{group9}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list9}}}

}}{{#if:|{{#if:|{{{group10}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list10}}}

}}{{#if:|{{#if:|{{{group11}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list11}}}

}}{{#if:|{{#if:|{{{group12}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list12}}}

}}{{#if:|{{#if:|{{{group13}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list13}}}

}}{{#if:|{{#if:|{{{group14}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list14}}}

}}{{#if:|{{#if:|{{{group15}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list15}}}

}}{{#if:|{{#if:|{{{group16}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list16}}}

}}{{#if:|{{#if:|{{{group17}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list17}}}

}}{{#if:|{{#if:|{{{group18}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list18}}}

}}{{#if:|{{#if:|{{{group19}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list19}}}

}}{{#if:|{{#if:|{{{group20}}}<td style="text-align:left;border-left-width:2px;border-left-style:solid;|

{{{list20}}}

}}{{#if:|{{#if:IMSMANG Administration{{#switch:{{#if:|{{{border}}}|child}}|subgroup|child=|none=|#default=

}}{{#ifeq:|Template|{{#ifeq:{{#if:|{{{border}}}|child}}|child||{{#ifeq:{{#if:|{{{border}}}|child}}|subgroup||{{#switch:language and translations

|doc
|sandbox
|testcases =
|#default = {{#switch:
 |plainlist
 |hlist
 |hlist hnum
 |hlist vcard
 |vcard hlist = 
 |#default = 
 }}
}}

}}}}}}|}}

{{{below}}}

}}{{#switch:|subgroup|child=

|none=|#default=}}{{#ifeq:|Template|{{#ifeq:|child||{{#ifeq:|subgroup||{{#switch:language and translations
|doc
|sandbox
|testcases =
|#default = {{#switch:hlist
 |plainlist
 |hlist
 |hlist hnum
 |hlist vcard
 |vcard hlist = 
 |#default = 
 }}
}}

}}}}}}