Difference between revisions of "Update the Localisation Files"

From IMSMA Wiki
Jump to: navigation, search
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Note | To modify the localisation files, you '''should''' use Rosetta-J.}}
+
{{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.}}
 +
 
 +
{{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]'''.}}
  
 
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.
 
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.
  
:a. From the '''Customisation''' menu, select '''Data Inventory Manager'''.
+
# In the '''Customisation''' menu &rarr; '''Data Inventory Manager'''.
:b. Click on the Translate button in the Data Category pane of the Data Inventory Manager window.
+
# Click on the Translate button in the Data Category pane of the Data Inventory Manager window.
:c. Find the desired language in the Language list and note the code e.g. km for Khmer.
+
# Find the desired language in the Language list and note the code e.g. km for Khmer.
:d. Contact your [[Management Consulting Team | GICHD IM advisor]] for guidance on how to get started.
 
  
{{Note| If you are running {{IMSMANG}} in a client/server installation and modify the properties files, you will need to copy this file to the ''C:\IMSMAng\client\resources\com\fgm\imsma\lexicon'' folder of each client computer. }}
+
{{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. }}
  
 
==IMessages.properties==__NOEDITSECTION__
 
==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.
+
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.
 +
# 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.
  
 
==ITerms.properties==__NOEDITSECTION__
 
==ITerms.properties==__NOEDITSECTION__
 
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.
 
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.
 +
# 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.
 +
 
{{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''']].}}
 
{{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 third file==__NOEDITSECTION__
+
==trans.properties==__NOEDITSECTION__
The third files contains Data Inventory categories, enumeration values, Custom Defined Fields' labels, etc. The file is [[Export and Translate the Terms|exported]] from File menu → Export → Translations. When the translation to desired language is finished, the file is [[Import the Translated Terms|imported]] into the database.
+
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.  
  
 
{{NavBox HowTo Languages and Translations}}
 
{{NavBox HowTo Languages and Translations}}
  
 
[[Category:NAA]]
 
[[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.