Creating new themes

Before you create a new theme, familiarize yourself with the procedure listed in this section in order to help ensure a successful experience.

About this task

To create a new theme, use the following procedure:

Procedure

  1. Copy the INSTALL_DIR/repository/xapi/template/merged/resource/sapphire.xml theme file to INSTALL_DIR/extensions/global/template/resource/theme.xml.

    If the /extensions/global/template/resource/ directory structure does not exist, create the required directory structure.

  2. Edit your new XML file to define the values you want to use for colors and fonts for each Color Name and Font Name element you want to display within the Applications Manager and within any bar or pie charts.
    Note: The fonts defined in the new theme XML must exist on the system you are using.
  3. Copy the INSTALL_DIR/repository/eardata/platform/war/css/sapphire.css theme style sheet to INSTALL_DIR/repository/eardata/platform/war/css/theme.css.
  4. (Optional) Only if you have enabled skin, copy the INSTALL_DIR/repository/eardata/platform/war/skins/skin-name/css/skin-name_sapphire_mb.css theme style sheet to INSTALL_DIR/repository/eardata/platform/war/skins/skin-name/css/skin-name_theme_mb.css.
  5. Edit your new style file to specify the new colors and fonts added in the new theme file.
  6. Copy the INSTALL_DIR/repository/xapi/template/merged/resource/sapphire_exui.xml file to INSTALL_DIR/extensions/global/template/resource/theme_exui.xml.
  7. Modify your new XML file to define the values you want to use for the colors and fonts for each Color Name and Font Name elements that you want to display within the Applications Manager and on any bar or pie charts.
    Note: Be aware that modifying fonts may require you to make other changes such as the size of fields or other UI elements that use the font. For more information about modifying fonts, see "CSS Theme File Reference."
  8. From the Applications Manager menu, configure a theme.

    After creating a new theme, the user can select the appropriate theme from the drop-down list on the Application Console user interface.