Redmine 也有提供一些幫助團隊協作的工具,其中 Wiki 與 文件是 Redmine 裡面相對靜態的團隊協作功能,今天的文章中將會先針對 Wiki 來進行說明,分別會講到以下 4 個部分:
Wiki 你可以很直覺的跟我們很常用的維基百科有所聯想,總歸就是一個協作式的知識管理工具,可以讓團隊共同編輯、創建和分享文件,撰寫相關知識基礎或內部說明文件。
在Wiki頁面上可以使用工程師最喜歡的 Markdown 格式來編寫內容,當然內容也支持超連結、圖像、表格等。然後重點是 Wiki 還可以通過歷史版本追蹤看到文件完整的變更歷史,當然就也可進行 Rollback 。
在使用 wiki 功能前,記得先確認指定的角色權限中,對於 wiki 的設定,不然就算後續有開啟專案裡面的 wiki 功能,也會不能進行操作。
Redmine 預設會是Textitle 的選項,可以調整成為大家比較熟悉的 Markdown,這個設定通用在所有任何詳細文本編輯區塊,比如議題裡面的概述。
如果你有需要使用到 wiki 功能,那麼你就必須要在專案的設定裡面,開啟 wiki 模組。
這是一開始最讓我困惑的地方,因為他並不是非常貼近人性的操作在最一開始的時候你會看到像是這樣的頁面:
這時候你要毫不猶豫的按下儲存,因為這是 Wiki 的初始化頁面,如果這時候你按下取消離開,就會進入鬼打牆循環。
當你創立好第一個初始化頁面以後,就會看到完整的 wiki 功能。
總共有兩種做法可以去建立新的 Wiki 頁面,第一種方法是直接於介面上操作
另一種方法是編輯過程去建置,使用 [[]]
可以創造一個超連結,然後再點進去進行儲存後就完成新頁面建置。
在這邊如果你是使用方法一,可能會有一個困惑點:
我已經在A Wiki頁面裡,在介面上操作新增另一個 A-1 Wiki 頁面,但是為什麼沒有在 A Wiki 內容中出現 A-1 Wiki?
這個地方需要建立一個概念:「建置不代表引用」。
這個概念會有點違反我們平常對於在文件中插入檔案的印象,Redmine 會幫你建立檔案,並且也有依照階層去幫你,但是它認為你不一定要真的把 A-1 這個頁面放在 A 的 Wiki 裡面,所以你會必須要自己使用 [[]]
引用在 A Wiki 中,才會出現。
對於工程師來說這樣的功能應該非常的熟悉,而在 Redmine 裡面的 Wiki 就也提供了這樣的功能。當文件落落長的時候,根本不可能一個字一個字自己做核對,這時候就可以使用差異比較,去找出修改歷程的變動狀況。
透過版本上的比較,或是你有明確知道要還原的版本後,可以直接進入到該版本,進行版本還原。而這個還原並不是就把過去的所有紀錄都覆蓋掉,就是等於它幫你把當時的內容幫你載入,讓你再做一次存檔這樣,所以你就會往後追加一個版本紀錄,可以放心的還原,不用擔心中間過程全部也被刪除。
對於專案、產品來說,如果要長期發展,那麼「知識體系」就有相對的重要性,這就是 Wiki 存在的目的。再來會換介紹另一個較為靜態的協作功能「文件」,那麼就明天見囉!