Creating a custom Mobile theme

You can create a custom Mobile theme to replace the default theme that is supplied with IBM® Cognos® Mobile.

Before you begin

Plan the design of your custom theme and prepare the required resources, such as image files.

About this task

When Cognos Mobile is installed, the installation directory c10_location/templates/mobile contains the defaultTheme.zip file. This is the default theme template. You can use this template as a starting point when creating your own custom theme.

The defaultTheme.zip file contains different directories and files. The main_panel\index.html file is the only file that is required for your custom theme. In this file you define all resources, such as images, that you want to use in your custom theme, and modify the color scheme and font styles.

The nls directory in the default theme template contains a directory structure for language-specific themes. You can emulate this structure or implement your own mechanism for creating language-specific themes.

You can use the following procedure as a guidance when creating a custom mobile theme based on the default theme.

Procedure

  1. Go to the c10_location/templates/mobile directory, make a copy of the defaultTheme.zip file, and save it under a different name.
  2. Extract the files from the .zip file that you created in the previous step.
  3. Edit the main_panel\index.html file as required. This file must contain references to all resources that are included with the theme.
  4. Compress all of your theme resources in one .zip file. At minimum, the .zip file must contain the modified main_panel\index.html file.
  5. Save your theme .zip file to a directory of your choice.

    Now, you can configure IBM Cognos Mobile to use the custom theme. For more information, see Configuring a Mobile theme.

Parent topic: Configuring a Mobile theme