Adding a Theme

By adding a theme, you can completely customize the look and layout of the Novell eGuide client. You can, for example, create a theme with no frames, a theme with a different layout (placement of display elements), or one that is customized to search on a specific category other than Find People.

HINT:  If you only need to change the color set, simply add a skin file. For details, see Adding a Skin .

IMPORTANT:  Customizing the theme requires advanced knowledge of XSLT, HTML, JavaScript*, CSS, and other HTML-related technologies. In addition, Novell cannot support problems related to customized themes (unless the problem is unrelated to the style sheet). Therefore, in order to maintain support you must create a new theme instead of modifying the existing Default theme. This gives you a way to go back to the Default theme if you experience problems with the one you created.

A theme consists of several files in a theme directory in two separate locations: \EGUIDE\WEB-INF\TEMPLATES\XSL and \EGUIDE\LOOK. Each path is relative to the directory where you installed eGuide.

To create a new theme:

  1. Copy and rename the DEFAULT directory in the XSL directory.

  2. Copy and rename the DEFAULT directory in the LOOK directory.

    IMPORTANT:  The new theme directories must have exactly the same name in both the XSL and LOOK directories.

    After creating the new directories, the directory name appears in the Current Theme drop-down list in the Administration Utility. For details on selecting a theme, see Changing General Customization Settings .

    WARNING:  Never directly modify the contents of the DEFAULT or ADMINUTIL theme directories.

  3. Modify the template files in the new theme directory in the XSL directory as desired.

    HINT:  While modifying the templates, it is often necessary to view the XML output of the eGuide server. You can turn on XSL Debug to view the XML output in both the eGuide server console and in a log file in the \EGUIDE\WEB-INF\LOGS folder. For details, see Debug Reports .

  4. Modify the image, HTML, CSS, and JavaScript files in the new theme directory in the LOOK directory as desired.