Extending the default factory-shipped translations

About this task

The default factory-shipped translations can be extended to create custom translations for the localization literals.

To modify the default factory-shipped translations with custom localization literals:

Procedure

  1. Create a new extn folder in the <INSTALL_DIR>/repository/factorysetup/complete_installation/XMLS/<language>_<country> directory.
    Note: For example, if fr_FR is the factory-shipped translated locale, the extn folder should be created in the <INSTALL_DIR>/repository/factorysetup/complete_installation/XMLS/fr_FR directory.
  2. Copy the <baselanguage>_<basecountry>_ycplocalizedstrings_<language>_<country>.properties file from the <INSTALL_DIR>/repository/factorysetup/complete_installation/XMLS/<language>_<country> directory to the newly created extn folder.
  3. Edit the translations in the properties file in the extn folder:
    • Modify the translations for existing localization literals with the new translations.
    • Add new localization literals and their translations, if required.
    • Remove any obsolete or unwanted translations that are not overridden for localization literals.
  4. Run the LocalizedStringReconciler tool from <INSTALL_DIR>/bin in IMPORT mode as follows:

    For UNIX:

    sci_ant.sh -f localizedstringreconciler.xml import 
    -Dsrc=<INSTALL_DIR>/repository/factorysetup/complete_installation/XMLS
       

    For Windows:

    sci_ant.cmd -f localizedstringreconciler.xml import 
    -Dsrc=<INSTALL_DIR>\repository\factorysetup\complete_installation\XMLS

    This tool first inserts the values specified in the properties file present in the <INSTALL_DIR>/repository/factorysetup/complete_installation/XMLS/<language>_<country> directory into the database.

    This entry is then replaced with the values specified in the properties file in the <INSTALL_DIR>/repository/factorysetup/complete_installation/XMLS/<language>_<country>/extn directory.