Adding a Theme

A theme is the static portion of eGuide, which often displays a company or organizational logo.

By adding a theme, you can completely customize the look and layout of the 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.

If you need to only change the color set, add a skin file. For instructions, 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 lets you return 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 add a 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 you create 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.

    When you modify 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 instructions, see Setting Up Debug Reports

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