HowTo create a custom Redmine theme » History » Version 1

Jean-Philippe Lang, 2007-10-10 19:36

1 1 Jean-Philippe Lang
h1. HowTo create a custom Redmine theme
2 1 Jean-Philippe Lang
3 1 Jean-Philippe Lang
As of r818, Redmine offers basic support for themes.
4 1 Jean-Philippe Lang
Themes can override stylesheets only (application.css).
5 1 Jean-Philippe Lang
6 1 Jean-Philippe Lang
h2. Creating a new theme
7 1 Jean-Philippe Lang
8 1 Jean-Philippe Lang
Create a directory in public/themes. The directory name will be used as the theme name.
9 1 Jean-Philippe Lang
10 1 Jean-Philippe Lang
Example:
11 1 Jean-Philippe Lang
12 1 Jean-Philippe Lang
  public/themes/my_theme
13 1 Jean-Philippe Lang
14 1 Jean-Philippe Lang
Create your custom @application.css@ and put it in a subdirectory names @stylesheets@:
15 1 Jean-Philippe Lang
16 1 Jean-Philippe Lang
  public/themes/my_theme/stylesheets/application.css
17 1 Jean-Philippe Lang
18 1 Jean-Philippe Lang
Here is an example of a custom stylesheets that only override a few settings:
19 1 Jean-Philippe Lang
20 1 Jean-Philippe Lang
<pre><code>
21 1 Jean-Philippe Lang
22 1 Jean-Philippe Lang
</code></pre>
23 1 Jean-Philippe Lang
24 1 Jean-Philippe Lang
h2. Applying the theme
25 1 Jean-Philippe Lang
26 1 Jean-Philippe Lang
Go to "Administration -> Settings" and select your newly created theme in the "Theme" drop-down list. Save your settings.
27 1 Jean-Philippe Lang
28 1 Jean-Philippe Lang
Redmine should now be displayed using your custom theme.