如何創建自定義 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 目錄中。

**注意**：如果您已根據 瀏覽器快取 啟用了快取，請確保您在包含時附加 ?version 並在每次更新 Redmine 時更新它，以避免您的使用者瀏覽器在您升級 Redmine 時抓取舊的 application.css 檔案。 @import url(../../../stylesheets/application.css?4.3.2);

添加自定義 JavaScript¶

只需將您的 JavaScript 放在 javascripts/theme.js 中，它就會在每個頁面上自動載入（僅限 Redmine >= 1.1.0）。

設定網站圖示¶

將您的網站圖示放在 favicon 目錄中，它將在每個頁面上自動載入，而不是預設的網站圖示。網站圖示檔案的名稱可以是任何名稱。

套用主題¶

轉到「管理 -> 設定」，然後在「主題」下拉清單中選擇您新創建的主題。儲存您的設定。
Redmine 現在應該使用您的自定義主題顯示。

如果您使用的是 Redmine < 1.1.0，則可能需要重新啟動應用程式，以便它顯示在可用主題列表中。

主題的目錄結構¶

主題包含以下檔案

• 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