如何创建自定义Redmine主题¶

Redmine提供了对主题的基本支持。主题可以覆盖样式表（application.css）并添加一些自定义JavaScript。

创建新主题¶

在public/themes中创建一个目录。目录名称将用作主题名称。

示例

public/themes/my_theme

创建您的自定义application.css并将其保存在名为stylesheets的子目录中

public/themes/my_theme/stylesheets/application.css

以下是一个自定义样式表的示例，它只覆盖了一些设置

/* load the default Redmine stylesheet */
@import url(../../../stylesheets/application.css);

/* add a logo in the header */
#header {
    background: #507AAA url(../images/logo.png) no-repeat 2px;
    padding-left: 86px;
}

/* move the project menu to the right */
#main-menu { 
    left: auto;
    right: 0px;
}

此示例假设您有一个位于my_theme/images/logo.png的图像。

您可以下载此示例主题作为您自己的主题的起点。将其解压到public/themes目录。

注意：如果您已根据浏览器缓存启用缓存，请确保将版本号追加到include，并在更新Redmine时更新它，以避免您的用户浏览器在升级Redmine时抓取旧的应用程序.css文件。@import url(../../../stylesheets/application.css?4.3.2);

添加自定义JavaScript¶

只需将您的JavaScript放入javascripts/theme.js，它将自动在每一页（Redmine >= 1.1.0）加载。

设置favicon¶

将您的favicon放入favicon目录，它将自动在每一页加载，而不是默认的favicon。favicon文件的名称可以是任何名称。

应用主题¶

转到“管理 -> 设置”并从“主题”下拉列表中选择您新建的主题。保存您的设置。
现在Redmine应使用您的自定义主题显示。

如果您正在使用Redmine < 1.1.0，您可能需要重新启动应用程序，以便它显示在可用主题列表中。

主题目录结构¶

一个主题由以下文件组成

• favicon/<favicon file>（可选）：主题的favicon
• javascripts/theme.js（可选）：主题的自定义JavaScript
• stylesheets/application.css（必需）：主题的CSS

public/
  +- themes/
       +- <theme name>/
            |
            +- favicon/
            |    +- <favicon file> (e.g. favicon.ico, favicon.png)
            |
            +- javascripts/
            |    +- theme.js
            |
            +- stylesheets/
                 +- application.css