Themes allow you to define a particular 'look and feel' which can be applied across Confluence or to an individual space. Use themes if you want to add a new functionality or to significantly alter the appearance of Confluence.
To create a new theme,
1. Create the decorator files that define how the different content screens are laid out.
2. Create the colour scheme for the theme (optional).
Optionally, use a stylesheet which will override the styles defined in the decorator files.
3. Create the theme plugin module.
4. Install the theme plugin.
You can configure a colour scheme for your theme dynamically throgh the 'Space Admin' tab of the space.
To incorporate a colour scheme within a theme, it needs to be expressed in an XML document.
Here ia an example:
<colour-scheme key="earth-colours" name="Brown and Red Earth Colours"
class="com.atlassian.confluence.themes.BaseColourScheme">
<colour key="topbar" value="#440000"/>
<colour key="spacename" value="#999999"/>
<colour key="headingtext" value="#663300"/>
<colour key="link" value="#663300"/>
<colour key="border" value="#440000"/>
<colour key="navbg" value="#663300"/>
<colour key="navtext" value="#ffffff"/>
<colour key="navselectedbg" value="#440000"/>
<colour key="navselectedtext" value="#ffffff"/>
</colour-scheme>
|
As above, the class of a colour scheme must implement com.atlassian.confluence.themes.ColourScheme. The com.atlassian.confluence.themes.BaseColourScheme class provided with Confluence sets the colours based on the module's configuration.
The available colours correspond to those that you would configure in the online colour-scheme editing, and are:
Key |
Description |
|---|---|
topbar |
The strip across the top of the page |
spacename |
The text of the current space name, or Confluence in the top left |
headingtext |
All heading tags throughout the site |
link |
All links throughout the site |
border |
Table borders and dividing lines |
navbg |
Background of top navigational buttons |
navtext |
Text of top navigational buttons |
navselectedbg |
Background of navigational buttons when selected or hovered |
navselectedtext |
Text of navigational buttons when selected or hovered |