Redmine 用戶手冊


目錄

1   說明

關於手冊中方框標記部分的說明

  • Note 是需要注意的部分。
  • Hint 是群英匯為Redmine擴展的部分。

2   用戶賬號

2.1   我的賬號

images/my_account.png

我的賬號截圖

  • 信息

    該區域用於修改用戶的姓名、郵件地址和語言設置。

  • 郵件通知

    郵件通知的下拉框選項有:

    • 只收取我跟蹤或參與的項目的通知
    • 收取我的項目的所有通知

    你可以根據自己的需要選擇不同的郵件通知策略

    同時,你也可以選種下拉框下面的那個復選框(不要發送對我自己提交的修改的通知),這樣就可以避免接收到你自己活動的郵件通知。

  • 首選項

    • 隱藏我的郵件地址

      如果選中,那么在顯示你個人信息的頁面將不會顯示你的郵件地址。

    • 時區

      用於設置你所在的時區,以便更好顯示你的活動時間。

    • 顯示注釋

      用於設置注釋顯示的順序。

      • 按時間順序

        此時問題(issues)的歷史記錄按照時間順序顯示,即先提交的comments顯示在前面,具體可參見下面的截圖。

      • 按時間順序(倒序)

        此時問題(issues)的歷史記錄按照時間順序倒序顯示,即先提交的comments顯示在后面,具體可參見下面的截圖。

      images/chronological_order.png

      按時間順序

      images/reverse_chronological_order.png

      按時間順序(倒序)

2.2   忘記密碼

如果你忘記了密碼,可用點擊登錄界面上的"忘記密碼"鏈接, 然后填入你的郵箱地址, 點擊提交。 隨后你將收到一封郵件, 點擊該郵件里的那個超鏈接, 你將跳到一個修改用戶密碼的界面, 輸入新密碼以及確認密碼。 這樣, 你就可以用剛才新建的密碼登錄系統了。

Note

  • 管理員可以禁用該功能
  • 如果你的賬號使用了外部認證(如LDAP),同樣不能使用該功能。 因為外部認證的密碼存儲在LDAP中, Redmine不能修改LDAP里的信息。

2.3   注冊

點擊主頁右上角的"注冊"鏈接, 用戶可以自己注冊。 填寫好表單提交后你將收到一封激活賬號的郵件, 通過郵件里的鏈接, 可以激活你剛注冊的賬號。

Note

  • 該功能需要管理員開啟"允許自注冊"功能, 並選擇通過郵件激活賬號

2.4   我的工作台

點擊主頁左上角的"我的工作台"鏈接,頁面將跳轉的當前用戶的工作台。

images/my_page_default.png

我的工作台截圖

該頁面用於顯示你所參與的項目的各種信息塊。 默認情況下只有下面兩個模塊啟用:

  • 指派給我的問題

    提供一個跨項目的指派給當前用戶的問題列表,顯示問題的ID,項目,跟蹤標簽類型和主題。

  • 已報告的問題

    提供一個跨項目的由當前用戶報告的問題列表,顯示問題的ID,項目,跟蹤標簽類型和主題。

Hint

群英匯為我的工作台添加了 任務日程安排 模塊,同時修改了默認的布局:

  • 上面:任務日程安排
  • 左邊:跟蹤的問題
  • 右邊:已報告的問題
images/ossxp_default_layout.png

當指派給你的問題太多時, 指派給我的問題 區域中的問題顯得雜亂無章,從而令你不知從哪一個問題先下手。此時的你或許會想起了Mylyn(主要用於管理你的任務,設置日程安排):如果Redmine有Mylyn的功能,那么我的工作就井井有條了。

群英匯為Redmine添加的Mylyn日程安排功能,正是在這種呼聲中誕生的。該功能主要借鑒於Mylyn,因此如果你使用過Mylyn,那么你將會很熟悉該功能。

功能介紹:

  • 該模塊會顯示從當前日期開始一周的每一天以及本周(從本周一到本周日)、下周(從下周一到下周日)、下下周(從下下周一到下下周日)、未來(下下周以后)和None(沒有設置計划日期的任務將顯示在該組)這些組。
  • 如果該組沒有安排任務,則不會顯示。
  • 當前日期(今天)那一組不僅僅只顯示規划到今天的任務,而且還會顯示那些已經超過完成日期而未完成的任務(並用紅色圓圈嘆號圖標標識), 以及那些已經超過計划日期而未完成任務(並用黃色三角嘆號圖標標識)
  • 同時對於那些計划日期設置在完成日期之后的任務,在分組時以完成日期為標准。

操作說明:

在 None 組中選擇某一問題或者多個問題(注意多個問題要在同一個項目,否則將會操作失敗。因為Redmine目前還不支持跨項目批量修改問題),點擊鼠標右鍵,在彈出菜單中選擇 計划日期 選項,進而在二級菜單中設置計划日期。

images/setting_schedule_date.png

如果設置成功,系統提示 更新成功 ,而且點擊所設置的計划日期組,會發現該組多了一個任務,如下圖紅色方框圈中的內容。

images/setting_schedule_date1.png

同時,在項目的問題列表頁面,如果該問題指派給你,那么當你點擊鼠標右鍵時,在彈出菜單中會多出設置 計划日期 的選項。否則不會顯示該選項。

每一個用戶可以通過點擊"個性化定制本頁"的鏈接,進入我的工作台設置界面。在 我的工作台模塊 下拉框中選擇想要添加的模塊,然后點擊右側的 新增 鏈接,完成模塊添加。同時在該頁面可以通過拖拽,改變各個模塊的布局。最后別忘了點擊右側的 返回 鏈接退出自定義模式,Redmine將自動保存當前的布局。

下拉框中可選的模塊有:

  • 日歷

    提供一個跨項目的每周日歷概述

  • 文檔

    提供一個跨項目的最近文檔概述

  • 最近的新聞

    提供一個跨項目的最近新聞概述

  • 耗時

    提供一個跨項目的關於當前用戶最近7天工時的概述

  • 跟蹤的問題

    提供一個跨項目的由當前用戶跟蹤的問題列表

3   登錄

點擊主頁右上角的"登錄"鏈接

images/header_before_login.png

可跳到登錄頁面

images/login.png

輸入登錄名和密碼, 點擊登錄按鈕, 即可進入系統。

Hint

單點登錄功能

群英匯給Redmine添加了單點登錄的功能:

  • 該功能主要是省去了多個應用重復輸入登錄信息的麻煩, 免去了員工記憶多個賬號的煩惱。
  • 加上單點登錄功能之后, 在一個應用中登錄之后, 不用再次輸入登錄名和密碼就可以訪問其他應用程序了 (前提是你的所有應用都支持單點登錄)。這樣在一定程度上減少了密碼的暴露幾率, 提高了賬號的安全性。

4   注冊

Hint

群英匯集中管理平台,使用統一的用戶注冊平台

群英匯的集中管理平台,包含用戶注冊和帳號管理功能,和集中管理平台整合的應用需關閉用戶注冊功能。

即群英匯部署的 Redmine,用戶注冊將跳轉到集中管理平台。如果管理員開啟用戶自注冊, 則允許用戶在集中管理平台進行自注冊,否則需要由管理員統一創建用戶帳號。

下面是 Redmine 內置的用戶注冊界面,該操作需要管理員開啟"允許用戶注冊"的功能。

images/register.png

注冊截圖

注冊用戶需要填寫的字段包括: 登錄名, 密碼, 名字, 姓氏和郵箱, 以及可選的用戶語言字段。

注冊流程

根據管理員的設置, 用戶的賬號由以下幾種激活方式:

  • 通過郵件認證激活賬號

    用戶注冊后, 將收到一封激活賬號的郵件, 通過點擊郵件里的鏈接, 就可以激活剛注冊的郵件。

  • 手動激活賬號

    用戶注冊后, 需要等待管理員手動激活剛注冊的賬號。

  • 自動激活賬號

    用戶注冊后, 直接可以用剛才注冊的賬號登錄系統。

5   項目概述

images/overview.png

項目概述截圖

該頁面提供一個關於該項目的總體概述

  • 左上角的問題跟蹤區域列出了目前項中每一種問題跟蹤標簽的打開數量以及總共數量
  • 在成員區域列出該項目組的所有成員
  • 在最新新聞區域列出了項目的最新新聞

6   項目活動

images/activities.png

項目活動截圖

該頁面列出了該項目所有活動的歷史記錄, 這些活動包括:

  • 問題
  • 變更
  • 新聞
  • 文檔
  • 文件
  • Wiki編輯記錄
  • 帖子
  • 耗時

該頁面的右邊欄允許你選擇具體顯示哪類活動

如果你想要同時顯示子項目的活動, 那么你需要選種"子項目"復選框。

Hint

修改查看項目活動的基准時間

Redmine 將當天的日期作為顯示項目活動的基准時間, 當你點擊"活動"選項卡時, 它會顯示前30天到當天的活動。

這樣會出現一個問題: 當項目連續30天沒有活動時, 項目活動首頁會出現空白頁。

群英匯的修改: 將最后一次活動時間作為基准時間, 這樣就避免了上述問題的發生。

7   問題跟蹤

問題是Redmine的核心業務。 一個問題綁定到一個項目, 由某一用戶創建, 可以關聯到某一版本, 等等。

  • 查看某一問題

    在問題列表頁面點擊某一問題的鏈接, 可以查看該問題的具體描述。

  • 子任務

    該功能在1.0版本引入。可以將一個問題拆分為若干個子問題。

    在使用redmine的過程中,可能有的用戶會抱怨,只能將問題指派給一個項目成員,而不能指派給多個項目成員共同完成。出現這種問題,從某種程度上來說,應該是你划分問題/任務過於粗糙(粒度過大),因此子任務功能就是為用戶提供拆分問題/任務的操作,從另一方面解決了將一個問題/任務指派給多人。

    首先需要在 角色和權限 設置中為某些角色開啟 管理子任務 功能,這樣該角色的用戶才有創建子任務的權力。

    操作步驟:

    • 點擊某一問題,進入問題查看頁面。然后點擊子任務區域的 新增 鏈接,進入新建子任務頁面。

      images/subtask1.png
    • 父任務字段的值系統自動獲得,其他字段像創建問題一樣輸入,最后點擊保存。

      images/subtask2.png

      輸入問題的描述信息

      images/subtask2.png

      成功創建子任務

  • 相關的問題

    允許開發者將某一問題與其他問題建立關聯, 從而起到了刪除重復問題, 簡化工作流的作用。 當前版本允許建立的關聯類型有:

    • 關聯到

    • 重復

      如果問題B重復於A,那么關閉A將自動關閉B。

    • 阻擋

      如果問題B阻擋A,A無法關閉,除非B已經關閉。

    • 優先於

      如果A優先於B,那么將B的起始日期自動設置為A的截至日期+延遲天數+1。

    • 跟隨於

      問題B跟隨於A(例如A截至於21/04,B開始於22/04),這時如果將A的截至日期延遲2天,那么B的起始和截至日期將自動推遲2天。

    點擊問題顯示頁面相關問題區域的"新增"鏈接, 可根據具體的情況建立不同類型的問題關聯。

    images/relative_issue.png

    管理員可以定義添加和修改問題關聯的權限

  • 跟蹤者

    點擊問題顯示頁面跟蹤者區域的"新增"鏈接, 在下拉列表里選擇跟蹤者

    images/watcher.png

    管理員可以定義添加和刪除跟蹤者的權限

  • 相關修訂

    當提交代碼時在提交注釋中引用某一問題, 那么稍后將會在該問題的顯示頁面中出現對於該次提交的描述信息。

    images/associated_revision.png

    相關修訂截圖

    具體那些使用那些關鍵字, 可以咨詢你們的管理員, 看他是如何配置的。

  • 新建問題

    要創建新的問題, 你需要有新建問題的權限

    創建問題時, 最重要的字段是跟蹤標簽字段, 它決定了問題的類型。

    默認情況下, Redmine有三種跟蹤標簽:

    • 缺陷
    • 功能
    • 支持
  • 更新已經存在的問題

    要更新問題的屬性, 你需要有編輯問題的權限。

7.1   問題列表

  • 概述

    點擊"問題"選項卡, 默認你將看到該項目中所有處於打開狀態的問題。

    images/issues_list.png
  • 過濾器的應用

    默認情況下, 問題列表顯示了所有處於打開狀態的問題。 你可以添加過濾器, 點擊"應用"鏈接刷新問題列表, 點擊"清除"鏈接刪除設置的濾器。

    你可以通過點擊那個小"+"號按鈕, 為過濾器字段選擇多個值。 這時會出現一個選擇列表, 按住"ctrl"后, 可選擇多個值。

  • 自定義查詢

    當刷新頁面后, 剛設置的過濾器就會消失, 你可以通過點擊"保存"鏈接保存你設置的過濾器, 從而建立自定義查詢。

    在新建自定義查詢的界面輸入自定義查詢的名稱, 以及過濾器和其他屬性的設置。

    點擊保存之后, 新建的自定義查詢將會出現在問題列表界面的右邊欄中。

  • 快捷菜單

    在問題列表的某一個問題上, 點擊鼠標右鍵, 將彈出一個快捷菜單, 用於便捷編輯問題。

    快捷菜單包含的選項有:

    • 編輯
    • 狀態
    • 跟蹤標簽
    • 優先級
    • 目標版本
    • 指派給
    • 完成度
    • 登記工時
    • 跟蹤者
    • 副本
    • 復制
    • 移動
    • 刪除
  • 批量編輯問題

    在問題列表界面, 你可以通過選擇多個復選框, 也可以按住"ctrl"鍵的同時選擇多個問題, 然后點擊右鍵, 同樣會彈出一個快捷菜單, 可以對選中的多個問題同時編輯。 你也可以點擊復選框上面的那個"對號"圖標, 全選問題或則撤銷全選。

  • 邊欄

    問題列表的右側邊欄提供了幾種不同的功能鏈接:

    • 問題區域

      • 查看所有問題

        該鏈接用於從自定義查詢頁面跳回問題列表頁面

      • 摘要

        從項目級別上查看問題的概述

      • 日歷

        日歷上顯示問題以及目標版本, 用於把握項目的進度。

      • 甘特圖

        顯示問題與時間的的二維圖表, 從而清晰地展現了項目的進度與當前的主要任務。

    • 自定義查詢區域 (如果你建立了自定義查詢)

      該區域列出了所有自定義查詢的鏈接

7.2   路線圖

images/roadmap.png

路線圖提供了一個更高級別的基於項目版本的對於整個問題跟蹤系統的概述, 它可以幫助制定項目計划, 管理項目開發。

  • 概述

    點擊"路線圖"選項卡, 你就可以查看當前項目的進展狀態:

    • 版本名稱

    • 版本的完成日期

    • 進度條

      根據問題狀態所占的百分比(即問題的完成度), 統計出目標版本的完成度。

    • 目標版本相關連的問題列表

  • 管理路線圖

    如果你的權限合適, 你可以為版本添加一個wiki頁面(參考 項目版本), 用於描述當前版本的一些主要事件。

  • 邊欄

    路線圖頁面的右邊欄為你提供了以下功能:

    • 可以根據需要, 選擇路線圖上顯示哪些跟蹤標簽。
    • 可以根據需要, 選擇是否顯示已經完成的版本
    • 所有版本的鏈接

7.2.1   版本概述

images/version_overview.png

版本概述提供了一個詳細的關於當前版本的狀態描述。 包括:

  • 版本名稱

  • 版本完成時間

  • 版本的進度條

  • wiki(如果管理員配置了wiki頁面)

  • 相關的問題列表

  • 時間跟蹤區域

    • 預期時間
    • 耗時
  • 分組顯示區域

    可供分組顯示問題的選項有:

    • 類別
    • 跟蹤標簽
    • 優先級
    • 作者
    • 指派給

7.3   日歷

  • 概述

    在問題列表頁面, 點擊右邊欄的"日歷"鏈接, 即可進入日歷界面。

    images/calendar.png

    日歷提供了一個按月份顯示的項目預覽。 在這里你可以看到一個任務狀態的起止日期。

  • 過濾器

    像Redmine提供的其他視圖一樣, 你可以通過設置過濾器從而決定日歷圖上顯示的內容。過濾器的用法可以參見 過濾器

7.4   甘特圖

在問題列表頁面, 點擊右邊欄的"甘特圖"鏈接, 即可進入甘特圖界面。

甘特圖顯示問題的起止日期以及版本的截至日期

images/gant.png

甘特圖截圖

8   實時跟蹤

實時跟蹤允許你跟蹤解決某一具體問題所花費的時間。 通過填寫預期時間, 項目經理可以根據你的進度更好地制定項目計划。 同時實時跟蹤與項目成員建立了關聯, 從而有效的度量了每個成員的工作情況。

  • 給問題登記工時

    通過點擊問題瀏覽頁面上"登記工時"的鏈接, 可以給該問題登記工時。

    images/log_time.png

    預計耗時字段可填入的時間格式如下:

    • 整數格式的小時和分鍾: 1, 1h, 1hour, 2hours, 30m, 30min, 1h30, 1h30m, 1:30
    • 小數格式的小時: 1.5 1,5(等於1h30)

    你也可以在更新問題時填入工時

  • 項目級別的登記工時

    如果登記工時時問題字段為空, 那么該工時就屬於整個項目的工時。

9   新聞

在"新聞"選項卡下, 你可以發布關於項目的新聞條目, 甚至任何你喜歡的新聞條目。

images/news.png

新聞條目包含的字段有:

  • 標題

  • 概述

    概述將和標題一起被顯示在項目概述頁面的 最近新聞 部分, 而詳細信息只有點擊了該新聞條目時才能看到。

  • 詳細信息

如果你有創建新聞的權限, 那么你就可以添加/編輯/刪除新聞。

10   文檔

images/documents.png

在這里可以書寫不同類型的文檔, 默認有兩種文檔類型:

  • 用戶文檔
  • 技術文檔

管理員可以添加文檔類型

11   文件

images/files.png

在這里可以上傳項目需要用到的其他資源, 如圖片, 視頻等等。

12   討論區

images/forum.png

討論區給項目成員之間提供一個交流的平台。 管理員根據需要可以創建不同類別的討論區。

  • 討論區列表頁面顯示的內容:

    • 話題的總數
    • 留言的總數
    • 最后留言的鏈接
  • 發起一個話題

    點擊右上角的"新貼"鏈接, 進入新建貼子的頁面, 輸入主題和內容, 點擊創建按鈕, 一個新的話題就發起了。

    話題有兩個可選選項:

    • 置頂(sticky): 如果選中, 表示該話題將會在討論區列表置頂, 並加粗顯示
    • 鎖定(locked): 如果選中, 表示該貼不允許用戶跟貼

13   Wikis

  • 創建一個新的Wiki頁面

    在任何一個wiki頁面,僅僅需要添加一個你想要創建的新頁面的鏈接。

    [[MyNewPage]]

    保存當前頁面,點擊剛添加的鏈接,恭喜:你已經成功創建了一個名為"MyNewWikiPage"的新頁面。

  • 保護wiki頁面

    如果你擁有保護wiki頁面的權限,你可以點擊"鎖定"鏈接保護該Wiki頁面。

    已經鎖定的wiki頁面只允許擁有保護wiki頁面權限的用戶編輯。

    擁有此權限的用戶同樣可以為該頁面解鎖。

  • Wiki頁面的歷史

    Redmine保存每一次wiki頁面的改動歷史。 通過點擊"歷史"鏈接你可以瀏覽這些變更。

    點擊變更的序列號可查看某一個具體版本的頁面信息。

    你可以通過點擊"回退到這個版本"的鏈接回退該頁面到先前的版本。

14   Redmine wiki的文本格式

Redmine默認使用Textile作為wiki的文本格式過濾器, 當然你也可以下載其他文本格式過濾器插件(Markdown, reST等)。 以下介紹的語法都是基於Textile 。

14.1   鏈接

14.1.1   Redmine鏈接

Redmine允許在任何wiki文本格式里引用問題,變更集和wiki頁面的超鏈接。

  • 鏈接到問題: #124 (顯示為#124, 如果此問題已經關閉則顯示刪除線)。
  • 鏈接到變更集: r758 (顯示為r758)。
  • 使用非數字的哈希值鏈接到變更集: commit:c6f4d0fd(顯示c6f4d0fd)。

14.1.2   wiki鏈接

  • [[Guide]] 顯示一個鏈接到"Guide"的鏈接: Guide
  • [[Guide|Use manual]] 顯示指向同一頁面的鏈接,鏈接顯示的文本是: Use manual
  • [[Guide#Use-guide|Use guide]] 顯示指向同一頁面頭的鏈接,鏈接顯示的文本是: Use guide

可以加入指向其它項目wiki頁面的鏈接

  • [[sandbox:some page]] 顯示一個指向Sandbox項目名稱為"Some page"的wiki頁面的鏈接。
  • [[sandbox:]] 顯示一個指向Sandbox項目Wiki主頁面的鏈接。

如果Wiki頁面不存在,則連接將顯示為紅色。

14.1.3   鏈接到其他資源

  • 文檔
    • document#17 (鏈接到ID為17的文檔)
    • document:Geetings (鏈接到標題為"Geetings"的文檔)
    • document:"Some document" (當文檔標題含有空格時需要使用雙引號)
  • 版本
    • vesion#3 (鏈接到ID為3的版本)
    • vesion:1.0.0 (鏈接到名稱為"1.0.0"的版本)
    • vesion:"1.0 beta 2" (當版本名稱含有空格時需要使用雙引號)
  • 附件
    • attachment:file.zip (鏈接到當前頁面名稱為 file.zip 的附件)
    • 到目前為止, 只能引用當前頁面的附件(如果您在編輯問題,則只能引用此問題的附件)
  • 版本庫
    • souce:some/file 鏈接到項目版本庫的 /some/file 文件
    • souce:some/file@52 鏈接到項目版本庫 /some/file 文件的第52版本
    • souce:some/file#L120 鏈接到項目版本庫 /some/file 文件的第120行
    • souce:some/file@52#L120 鏈接到項目版本庫 /some/file 文件的第52版本的第120行
    • souce:"some file@52#L120" 如果URL中有空格,需要使用雙引號來。鏈接到項目版本庫 some file 文件的第52版本的第120行
    • expot:some/file 強制顯示該文件的下載鏈接

14.1.4   轉意字符

如果您不希望Redmine將上述標記解釋為鏈接,可以在它們前面添加一個感嘆號:!

14.1.5   外部鏈接

HTTP URLs和郵件地址將自動轉換為可點擊的鏈接

如果你想指定鏈接顯示的文本,你可以使用標准的textile語法。

"群英匯":http://ossxp.com

14.2   文本格式

對於標題、粗體、表格、列表, Redmine支持Textile語法。參考 http://www.textism.com/tools/textile/ 上對使用這些特征的詳細信息。

下面列出一些例子:

14.2.1   字體樣式

*bold*                   加粗
_italic_                 斜體
*_bold italic_*          加粗並斜體
+underline+              下划線
-strike-through-         刪除線

14.2.2   內嵌圖片

  • !image_url! 顯示地址為image_url的圖片(textile語法)
  • !>image_url! 圖片右懸浮
  • !{width:300px}image_url! 設置圖片的顯示寬度

如果你的wiki頁面有圖片附件,你可以使用文件名:!attached_image.png!顯示它。

14.2.3   標題

  • h1. 一級標題
  • h2. 二級標題
  • h3. 三級標題

14.2.4   段落

  • p>. 右對齊
  • p=. 居中

14.2.5   塊引用

段落以 bq. 開始

14.2.6   無序列表

* Item 1
* Item 2
** Item 21
** Item 22
* Item 3

14.2.7   有序列表

# Item 1
# Item 2
# Item 3
## Item 3.1
## Item 3.2

14.2.8   表格

|_.UserID|_.Name|_.Group|
|\3=.IT|
|1|張三|/2.Users|
|2|李四|
|3|王五|Admin|

14.2.9   內容列表

{{toc}} => 內容列表左對齊
{{>toc}} => 內容列表右對齊

14.2.10   宏(Macros)

Note

此功能僅在Wiki頁面有效

Redmine有以下內置宏:

  • 子頁面

    顯示子頁面列表。 當沒有參數時,將顯示當前wiki頁面的子頁面。 例如:

    {{child_paegs}} 該功能只有在wiki頁面有效
    {{child_pages(Foo)}} 列出Foo頁面的子頁面
    {{child_paegs(Foo,parent=1)}} 和上面的功能一樣,只不過多了一個鏈到Foo頁面的鏈接
    
  • hello_world

    一個宏示例

  • include

    包含一個wiki頁面。例如:

    {{include(Foo)}}
    

    或者包含一個指定項目的wiki頁面:

    {{include(projectname:Foo)}}
    
  • macro_list

    顯示所有可用宏的列表,以及關於宏的描述。

  • 代碼高亮顯示

    代碼高亮顯示依賴 CodeRay http://coderay.rubychan.de/ ,它是一個完全用Ruby編寫的快速的語法高亮顯示庫。 目前支持的語言: c,html,javascript,rhtml,ruby,scheme,xml。

    你可以用下面的語法高亮顯示ruby代碼:

    <pre><code class='ruby'>
    加入你的代碼
    </code></pre>
    

15   版本庫

點擊"版本庫"選項卡, 你可以瀏覽項目的版本庫以及最近的提交。

images/repository_browser.png

你可以通過打開目錄前面的"+"按鈕, 展開目錄。

你也可以點擊目錄鏈接進入該目錄。

點擊某一修訂號你可以查看該次提交的詳細信息。

想要瀏覽已知提交號的某一次提交的具體信息, 你可以將該提交號直接輸入右上角的輸入框里, 按回車鍵即可查看。

15.1   版本庫統計

images/repository_statistic.png

Redmine生成兩種關於變更和修訂數量的版本庫圖片。 上面的一幅按月份顯示變更和修訂數量; 下面的一幅按提交者顯示變更和修訂數量。

名詞解釋

  • 修訂 是版本庫的提交次數, 顯示為橘紅色。
  • 變更 是對版本庫中文件的修改次數, 顯示為藍色。

16   項目配置

images/project_setting.png

該界面提供項目級別的配置, 可用的配置選項卡如下:

  • 信息

    在這里可以設置

    • 項目名稱

    • 上級項目

      指定該項目的父項目

      在Redmine 0.9 版本之前, 只允許2級嵌套; 0.9版本之后, 可以無限嵌套。

    • 項目描述

    • 標識

      由於Redmine支持多項目, 而且采用REST架構, 所以需要一個URL的唯一標識符。 這個值在創建項目時填寫, 且一旦創建成功就不能修改。

    • 主頁

      主頁鏈接會顯示在項目概述頁面中

    • 是否公開

      如果選中, 該項目將允許所有用戶瀏覽, 包括非項目成員的用戶。

      如果不選, 只有項目成員才有權限訪問。

    • 跟蹤標簽

      在這里可以設置開啟哪些跟蹤標簽, 默認可用的有三種: 錯誤, 功能和支持。

      管理員可以在管理界面添加跟蹤標簽的類型。

  • 模塊

    在這里可以設置該項目開啟的功能模塊

  • 成員

    在這里可以指定項目的成員, 以及他們的角色。

    Redmine 0.9之后可以以組為操作單元, 給組賦予角色, 添加到項目中。 這樣該組的所有成員都成為該項目的成員, 且屬於相同的角色, 擁有一樣的權限。

  • 版本

    項目版本可以對變更進行跟蹤和計划。 你可以給問題指定目標版本, 然后在路線圖中就能看到與改版本關聯的問題列表。

    版本包括的屬性:

    • 名稱

    • 描述

    • 狀態

      這個屬性是Redmine-0.9添加的, 這些狀態控制問題如何被指定目標版本。

      • 打開

        默認值, 沒有限制

      • 鎖定

        不能再給該版本指定新的問題

      • 關閉

        不能再給該版本指定新的問題, 而且不能重新打開已經指定目標版本的問題。

    • Wiki頁面

      可以將該版本的主要事件寫入Wiki里, 以供瀏覽該版本時顯示 可選屬性 。

    • 日期

      版本的完成日期 可選屬性

    • 共享

      這個屬性是Redmine-0.9添加的, 該屬性決定該版本是否能被其他項目共享, 從而使其他項目的問題也可以指定到該版本 可選屬性 。

      • 不共享

      • 與子項目共享

        所有子孫項目

      • 與項目繼承層次共享

        祖先以及子孫項目

      • 與項目樹共享

        根項目和所有子孫項目(與上面的等同)

      • 與所有項目共享

      私有項目與公開項目共享版本后, 私有項目的名稱將能夠別所有用戶看到。

      在版本列表頁面點擊"關閉已完成的版本"鏈接, 那些處於完成狀態的版本(到達截至日期並且沒有處於打開狀態的問題)將自動關閉。

    Hint

    指定默認目標版本

    在這里可以給項目指定默認目標版本, 這是群英匯為Redmine添加的功能。

    這樣可以省去在給項目創建問題時指定目標目標版本的繁瑣操作。

    群英匯的擴展靈活地與Redmine指定目標版本結合, 當你新建問題時, 如果感覺該問題不應該指定到默認的目標版本, 你也可以重新選擇其他的版本。

  • 問題類別

    問題類別功能可以有效組織管理項目的問題。

    問題類別的屬性:

    • 名字 必填字段

    • 指派給

      新建屬於該類別的問題將自動指派給該項目成員 可選字段 。

  • wiki

    每一個項目擁有它自己的wiki。

  • 版本庫

    每一個項目能跟一個版本庫(SCM)建立關聯。 一旦版本庫配置成功, 你就可以點擊"版本庫"選項卡, 瀏覽版本庫的變更集了。 版本庫的變更集也能在活動頁面瀏覽到。

  • 討論區

    每一個項目可以有一個或者多個討論區。 討論區的屬性有:

    • 名稱
    • 描述
  • 活動

    默認情況下, 活動階段有"開發"和"測試"兩種類型, 管理員可以根據需要創建新的活動階段。

    只有選中的活動階段才會出現在登記工時頁面的下拉框中。

17   Redmine與其他工具整合

17.2   Redmine與TortoiseSVN的整合

眾所周知,TortoiseSVN是一款靈活而且功能強大的SVN客戶端視圖工具。更錦上添花的是,它還提供了整合問題跟蹤系統的接口(通過與問題跟蹤系統的集成,在提交代碼時,可以點擊相應的按鈕,彈出缺陷跟蹤系統中的bug列表,選擇相應的bug作為提交日志,即減少了寫提交日志的苦惱,又使提交與 bug建立的關聯,一舉兩得)。不知Redmine是否也有相應的插件?

TortoiseSVNRedmineIssuesPlugin 解決了Redmine與TortoiseSVN的整合。

具體的安裝介紹可參考 http://blog.ossxp.com/2010/05/1221/

17.3   Redmine與Mylyn的整合

Eclipse是一款功能強大的IDE,尤其是其靈活的插件擴展機制更使它錦上添花。

對於開發人員來說,要處理的任務太多,那么有沒有一個工具可以讓開發人員自由規划自己的任務呢?

Mylyn的誕生給開發人員帶來了福音,從此開發人員的工作變得井然有序。

Mylyn 是一個Eclipse任務管理(task management)插件。它提出了任務倉庫和任務列表的概念。任務倉庫可以是本地的,也可以是互聯網上基於Web的任務管理或者缺陷管理系統的任務列表。任務列表則是從任務倉庫中取出的符合查詢條件的一組任務。同時它還提供了本地個人日程安排的功能。可以將任務列表的任務根據具體情況設置日程。

Redmine與Mylyn的整合共有兩種方案:

17.3.1   通用的Web倉庫鏈接器(Web Repository connector)

首先你需要安裝Web倉庫連接器插件incubator,更新站點http://download.eclipse.org/tools/mylyn/update/incubator

17.3.1.1   配置步驟

17.3.1.1.1   創建一個任務倉庫(Task Repository)
  • 在 Task Repositories 列表中點擊鼠標右鍵,選擇 Add Task Repository ... 選項

  • 選擇 Web Template (Advanced) 選項,點擊 Next 按鈕

  • 配置任務倉庫

    Server:                 http://www.redmine.org -- 用你的Redmine實例URL替換該值
    Task URL:               ${serverUrl}/issues/
    New task URL:           ${serverUrl}/projects/foo/issues/new -- 用新建問題所屬項目的項目標識符替換foo
    Query request URL:      ${serverUrl}/issues
    Query pattern:          <td class="subject">.*?<a href="/issues/(\d+)">(.+?)</a></td>
    Login request URL:      ${serverUrl}/login?username=${userId}&password=${password}&authenticity_token=${loginToken}[POST]
    Login Form URL:        ${serverUrl}/login
    Login Token Pattern:    <input name="authenticity_token" type="hidden" value="(.+?)" />
    

    示例截圖:

    images/web_repository_setting.png

    如果你僅想獲得指派給你的問題,那么可以使用下面的值填充查詢請求URL(Query request URL)字段:

    ${serverUrl}/issues?set_filter=1&assigned_to_id=me
    

    下面的查詢模式(Query pattern)將連同狀態、作者和跟蹤(Tracker)一塊讀取(Mylyn 3.2.1):

    <td class="tracker">({Type}.+?)</td.<td class="status">)({Status}.+?<td class="subject">\
    .*?<a href=".*?/issues/({Id})\d+)">({Description}.+?)</a></td><td class="assigned_to"><a href.+?>({Owner}.+?)</a></td>
    

    Eclipse里的有 未完成(uncomplete) 和 完成(complete) 兩種狀態。

17.3.1.1.2   創建一個查詢
  • 在任務列表點擊右鍵, 選擇 New -> Query...

  • 選擇你最新創建的倉庫(repository),給該查詢起個名稱,同時指定查詢的模式,點擊Finish。

    images/query.png

    查詢結果截圖

17.3.2   Redmine專用的 Redmine-Mylyn Connector

Redmine-Mylyn-Connector 是Redmine的Eclipse Mylyn 倉庫插件,為Redmine與Mylyn整合的提供了更好的解決方案。

17.3.2.1   插件的依賴關系:

  • 客戶端(即Eclipse端)
    • Java 5 (或者更高)
    • Eclipse 3.4 (或者更高)
    • Mylyn 3.2.0 (或者更高)
  • 服務器端(即Redmine端)
    • Redmine 0.8.6 (或者更高)

17.3.2.2   客戶端安裝

打開Eclipse,點擊 Help -> Install New Software -> Add

彈出窗口需要輸入的字段

點擊確認后,你將在下拉框中看見該插件包含的組件,選擇你想安裝的組件,最后點擊 Finish。 Eclipse將自動完成插件的下載和安裝。最后提示你重啟Eclipse。點擊確定,Eclipse將自動完成重啟,這時插件已成功安裝,並可以使用了。

17.3.2.3   服務器端安裝

下載 Redmine-Mylyn-Connector-server-plugin 服務器端插件

解壓到 Redmine 根目錄下vendor/plugins目錄下,重啟Redmine服務器。

17.3.2.4   配置步驟

17.3.2.4.1   在Eclipse中添加任務倉庫
  • 打開Eclipse,切換到Planning視圖,在任務倉庫列表中點擊鼠標右鍵,選擇 Add Task Repository 選項。然后在彈出的對話框中選擇Redmine,點擊 Next 。如下圖:

    images/add_redmine_task_repository.png
  • 設置Redmine倉庫的參數,如圖:

    images/setting_redmine_task_repository.png
  • 驗證參數是否正確填寫。(點擊 Validate Settings)按鈕,看上方驗證結果的提示信息。

    images/validate_redmine_task_repository.png
  • 最后點擊Finish按鈕,完成倉庫的添加。

17.3.2.4.2   為剛創建的任務倉庫添加查詢
  • 在上步點擊Finish按鈕后,會彈出提示你為該倉庫創建查詢的對話框,點擊Yes,將跳轉到 Add new query 界面。

    注意: 目前Redmine-Mylny-Connector插件僅支持自定義查詢(即你在redmine中創建的自定義查詢。創建自定義查詢的步驟可參考 添加自定義查詢 )

    images/add_query1.png
  • 根據具體需要,設置查詢條件,建立查詢。下面的查詢條件將查詢test項目中所有指派給我的任務。

    images/add_query2.png
  • 任務列表截圖

    images/task_list.png
  • 在Eclipse中瀏覽任務截圖

    images/view_task_in_eclipse.png


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM