Difference between revisions of "Update the Localisation Files"

From IMSMA Wiki
Jump to: navigation, search
 
(36 intermediate revisions by 6 users not shown)
Line 1: Line 1:
In order to support IMSMA languages other than English, several files are provided to allow you to translate the messages and terms used in IMSMA. If you would like to run IMSMA in a language other than English, you will need to enter translations into the following .properties files:
+
{{Warning | The two original files IMessage.properties and ITerms.properties should '''not''' be edited. If you would like to '''change the English''' terms and messages then you have to create an '''English copy''' of the files. Be very careful with Search and Replace function while editing the files. The KEY names (value on the left of the '''<nowiki>=</nowiki>''' sign) should '''not''' be replaced.}}
::*IMessages.Properties
 
::*Iterms.Properties
 
::*UIStrings.Properties
 
  
 +
{{Note | To modify the localisation files, you '''should''' use Rosetta-J. Contact your [[Information Management Team | GICHD IM advisor]] who will provide guidance. You may download Rosetta-J from this '''[http://mwiki.gichd.org/mediawiki/images/0/00/Rosetta_J.zip link]'''.}}
  
A copy of the files above is available for each language supported by IMSMA. The files specific to a language are suffixed with an identifier specific to the language. For example, to translate the ITerms.Properties file for Spanish, you should modify the ITerm_Es.Properties file.
+
The three files that are used for localisation need to be created for each new language. Each language has a unique language code. IMSMA is using the Window's codes. See which code should be used in the Data Inventory Manager.
  
 +
# In the '''Customisation''' menu &rarr; '''Data Inventory Manager'''.
 +
# Click on the Translate button in the Data Category pane of the Data Inventory Manager window.
 +
# Find the desired language in the Language list and note the code e.g. km for Khmer.
  
[[File:Supported Languages.png|440px|''Table 55. Filename Suffixes for Supported Languages'']]
+
{{Note| If you are running {{IMSMANG}} in a client/server installation and modify the properties files, you will need to copy of IMessage and ITerms files to the ''C:\IMSMAng\client\resources\com\fgm\imsma\lexicon'' folder of each client computer. }}
  
{| class="wikitable"
+
==IMessages.properties==__NOEDITSECTION__
|-
+
The IMessage.properties file contains the error messages and warning messages used by {{IMSMANG}}. The file is located in the ''C:\IMSMAng\client\resources\com\fgm\imsma\lexicon'' folder.  
| [[File:LightBulb.png|20px|<span title=""></span>]]  To modify the localisation files, it is recommended that you use Rosetta-J. For information on using Rosetta-J, refer to the Rosetta-J User Manual.  
+
# Copy the existing IMessage.properties to e.g. IMessage_km.properties or IMessage_en.properties for English.
|}
+
# Edit the IMessage.properties copy with Rosetta-J.
  
==IMessages.Properties==
+
==ITerms.properties==__NOEDITSECTION__
The IMessage.Properties file contains the error messages, warning messages, and tooltips used by IMSMA. The file is located in the <IMSMA Installation Directory>\client\resources\com\fgm\imsma\lexicon directory.
+
The ITerms.Properties file contains terms used in menus, tooltips and field names in {{IMSMANG}}. The file is located in the ''C:\IMSMAng\client\resources\com\fgm\imsma\lexicon'' folder.
{{note| If you are running IMSMA in a networked environment and modify the IMessage.Properties file, you will need to copy this file to the <IMSMA Installation Directory>\client\resources\com\fgm\imsma\lexicon directory of each client computer
+
# Copy the existing ITerms.properties to e.g. ITerms_km.properties or ITerms_en.properties for English.
}}
+
# Edit the ITerms.properties copy with Rosetta-J.
  
==ITerms.Properties==
+
{{Warning | There are two terms that should '''not''' be translated and affects how dates are written in {{IMSMANG}}, see [[Two Terms Not to be Translated | '''more details here''']].}}
The ITerms.Properties file contains terms used by IMSMA field names. The file is located in the <IMSMA Installation Directory>\client\resources\com\fgm\imsma\lexicon directory.
 
{{note| If you are running IMSMA in a networked environment and modify the ITerms.Properties file, you will need to copy this file to the <IMSMA Installation Directory>\client\resources\com\fgm\imsma\lexicon directory of each client computer
 
}}
 
  
==UIStrings.Properties==
+
==trans.properties==__NOEDITSECTION__
The UIStrings.Properties file contains the additional terms used by the IMSMA user interface. The file is located in the Location <IMSMA Installation Directory>\client\resources\com\fgm\util directory.  
+
The third files contains Data Inventory categories, enumeration values, Custom Defined Fields' labels, etc. 
 +
# '''[[Export the Translations|export]]''' the English translations
 +
# rename the file (e.g. trans_km)
 +
# '''update''' the first row in the file to the new language code
 +
# create translations with Rosetta-J
 +
# '''[[Import the Translations|import]]''' the file into the database.  
  
{{note| If you are running IMSMA in a networked environment and modify the UIStrings.Properties file, you will need to copy this file to the <IMSMA Installation Directory>\client\resources\com\fgm\util directory of each client computer
+
{{NavBox HowTo Languages and Translations}}
}}
 
  
{{NavBox HowTo Languages and Translations}}
+
[[Category:NAA]]

Latest revision as of 19:07, 18 August 2021

Warning.jpg The two original files IMessage.properties and ITerms.properties should not be edited. If you would like to change the English terms and messages then you have to create an English copy of the files. Be very careful with Search and Replace function while editing the files. The KEY names (value on the left of the = sign) should not be replaced.
Note.jpg To modify the localisation files, you should use Rosetta-J. Contact your GICHD IM advisor who will provide guidance. You may download Rosetta-J from this link.

The three files that are used for localisation need to be created for each new language. Each language has a unique language code. IMSMA is using the Window's codes. See which code should be used in the Data Inventory Manager.

  1. In the Customisation menu → Data Inventory Manager.
  2. Click on the Translate button in the Data Category pane of the Data Inventory Manager window.
  3. Find the desired language in the Language list and note the code e.g. km for Khmer.
Note.jpg If you are running IMSMANG in a client/server installation and modify the properties files, you will need to copy of IMessage and ITerms files to the C:\IMSMAng\client\resources\com\fgm\imsma\lexicon folder of each client computer.

IMessages.properties

The IMessage.properties file contains the error messages and warning messages used by IMSMANG. The file is located in the C:\IMSMAng\client\resources\com\fgm\imsma\lexicon folder.

  1. Copy the existing IMessage.properties to e.g. IMessage_km.properties or IMessage_en.properties for English.
  2. Edit the IMessage.properties copy with Rosetta-J.

ITerms.properties

The ITerms.Properties file contains terms used in menus, tooltips and field names in IMSMANG. The file is located in the C:\IMSMAng\client\resources\com\fgm\imsma\lexicon folder.

  1. Copy the existing ITerms.properties to e.g. ITerms_km.properties or ITerms_en.properties for English.
  2. Edit the ITerms.properties copy with Rosetta-J.
Warning.jpg There are two terms that should not be translated and affects how dates are written in IMSMANG, see more details here.

trans.properties

The third files contains Data Inventory categories, enumeration values, Custom Defined Fields' labels, etc.

  1. export the English translations
  2. rename the file (e.g. trans_km)
  3. update the first row in the file to the new language code
  4. create translations with Rosetta-J
  5. import the file into the database.