gollum 是什么？

gollum的readme上有句最簡單的描述很直白：A git-based Wiki。

個人認為github，jekyll，gollum可以并稱為碼農的三大神器，github用來敲代碼，jekyll用來寫技術博客，gollum用來搭建自己的知識管理wiki系統。很巧合的是部門用gollum也有兩年時間了，不過以前都是直接用，沒有仔細看過手冊，趁十一期間有時間簡單搭了一套玩玩。

簡單來講gollum有以下四個優點：

• 輕量級，但結構和功能完整
• 使用Markdown語法
• 可提供網頁服務
• 使用git進行內容控制
</ul>

尤其是第四點，完全沒有抵抗力啊~

gollum 的安裝

gollum的安裝很簡單，尤其是在ubuntu 14.04上：

sudo apt-get install ruby1.9.1 ruby1.9.1-dev make zlib1g-dev libicu-dev build-essential git
sudo gem install gollum

或者選擇源代碼安裝：

git clone https://github.com/gollum/gollum
cd gollum
bundle install

而后初始化git目錄，在git的目錄執行

gollum --css --allow-uploads --mathjax --h1-title

以上使用了一些參數，分別是使用自定義 custom.css 文件（在git初始化目錄），增加上傳功能，支持 LaTeX 公式，markdown的一級標題為全文標題。

在瀏覽器中訪問以下地址來創建wiki內容：

http://localhost:4567

我簡單編輯了home頁面，大概長得是這個樣子：



這個頁面其實是markdown的文件

# xxx部門的wiki

[[推薦系統|/RecHome]]
Gollum is a simple wiki system built on top of Git. A Gollum Wiki is simply a git repository (either bare or regular) of a specific nature:

A Gollum repository's contents are human-editable, unless the repository is bare. 
Pages are unique text files which may be organized into directories any way you choose. 
Other content can also be included, for example images, PDFs and headers/footers for your pages.

This is second</pre> 
如圖片所示，一般的功能諸如home，新建，重命名，編輯，歷史，最近的改變等均有。 
gollum有完整的wiki語法結構，可以直接參考gollum的wiki，這里就不做贅述，簡言之：非常完備值得擁有。 

最后在這里可以拿到自定義的 css文件 

gollum的一些注意點 


gollum命令必須在git目錄下使用 

使用git來提交內容時一定要commit之后才會生效 

git必須在master分支提交 

wiki的目錄結構最好事先設計好，否則文件會非常亂 
</ol>
來自： http://www.bjt.name/2015/10/gollum/