Theming and Branding - GeoscienceAustralia/earthsci GitHub Wiki

This page describes how to customise the theming and branding of applications developed on the EarthSci platform.

Contents:

1. Introduction
2. Replacing the default theme

## Introduction ## One of the main goals of the EarthSci project is to provide a comprehensive platform to build earth science visualisation applications. A key component of this is to allow for the customisation of the look-and-feel to match corporate branding requirements etc.

The platform has been designed to leverage the built-in Eclipse theming mechanism, and allow theming and branding to be controlled via a single plugin.

Currently, the platform supports the following customisations:

1. Default theme
2. Icon overrides

See the au.gov.ga.earthsci.theme.ga plugin for examples on customisation.

## Replacing the default theme ## Plugins can override the default theme by providing a replacement CSS file and registering it with the Eclipse theme engine. This theme can then be referenced by the `au.gov.ga.earthsci.application.defaultTheme` extension to set it as the default theme on startup.

1. Create a CSS theme (see http://www.vogella.com/articles/Eclipse4CSS/article.html for a good introduction)
2. Register the theme with the Eclipse theme engine using the org.eclipse.e4.ui.css.swt.theme extension point
3. Reference the theme with the au.gov.ga.earthsci.application.defaultTheme extension
4. Add your theme plugin to the product run configuration of your product

Plugins can replace individual element icons by using