Localizing themes

When localizing your Applications Manager user interface themes, you modify the theme-specific XML file. When localizing your Application Console user interface themes, you modify the theme-specific CSS file.

About this task

For example, the following files must be localized for themes:


<INSTALL_DIR>/repository/xapi/template/merged/resource/<theme>.xml and 
<INSTALL_DIR>/repository/eardata/platform/war/css/<theme>.css

These files are localized by appending the language and country or region codes in the file name. For example, if you are using the sapphire theme in a French locale, localize the following files:


<INSTALL_DIR>/repository/xapi/template/merged/resource/sapphire_fr_FR.xml 
<INSTALL_DIR>/repository/eardata/platform/war/css/sapphire_fr_FR.css

The following themes are distributed with Sterling™ Order Management System Software:

  • Earth
    • <INSTALL_DIR>/repository/xapi/template/merged/resource/earth.xml
    • <INSTALL_DIR>/repository/eardata/platform/war/css/earth.css
  • Jade
    • <INSTALL_DIR>/repository/xapi/template/merged/resource/jade.xml
    • <INSTALL_DIR>/repository/eardata/platform/war/css/jade.css
  • Sapphire
    • <INSTALL_DIR>/repository/xapi/template/merged/resource/sapphire.xml
    • <INSTALL_DIR>/repository/eardata/platform/war/css/sapphire.css
Note: For locale specific theme files, the CSS entry for detailpagetitle6 for button panel must be adjusted to fit the translation.

To localize a theme:

Procedure

  1. Copy the <INSTALL_DIR>/repository/xapi/template/merged/resource/<theme>.xml file and save it as <INSTALL_DIR>/repository/xapi/template/merged/resource/<theme>_<language>_<country>.xml.
  2. Copy the <INSTALL_DIR>/repository/eardata/platform/war/css/<theme>.css file and save it as <INSTALL_DIR>/repository/eardata/platform/war/css/<theme>_<language>_<country>.css.

    Edit the <INSTALL_DIR>/repository/eardata/platform/war/css/<theme>_<language>_<country>.css file to change the display font for the Application Console. In addition, the font name and size for the graph displayed in the Inventory Summary screen in the Inventory Console is configured in the <INSTALL_DIR>/repository/xapi/template/merged/resource/<theme>_<language>_<country>.xml file.

    For example, in the default sapphire.xml file, the graph font is configured as:

    <!-- Font for Inventory Graphs(Axis Titles & Labels) -->
    <Font Name="InvGraphFont" FontName="Tahoma" FontSize="12"/>
    <!-- Font for Inventory Graphs -->

    To localize double-byte languages such as Japanese, it is recommended that you edit the <INSTALL_DIR>/repository/xapi/template/merged/resource/<theme>_<language>_<country>.xml file to use either the MS UI Gothic or SimSun font as follows:

    
<!-- Font for Inventory Graphs(Axis Titles & Labels) -->
<Font Name="InvGraphFont" FontName="simsun" FontSize="12"/>
<!-- Font for Inventory Graphs -->
  3. Rebuild the resources.jar by running the following command from the <INSTALL_DIR>/bin directory: 
    
/deployer.sh -t resourcejar
  4. If you are using Oracle WebLogic or IBM WebSphere, rebuild the EAR.
    Note: If your application server is running on UNIX, the valid fonts that you can use are stored in the <JAVA_HOME>/jre/lib/font_properties.<file.encoding> file.