markdown + git 最適合程序員的wiki系統：gollum

gollum 是github的使用的一個基于markdown的 wiki系統。 最重要的是gollum直接和git集成不需要數據庫，你可以選擇在Web頁面撰寫文檔，也可以用你喜歡的markdown工具編輯文檔在命令行進行提 交。 “markdown+git = wiki” 這對程序員來講絕對是最棒的選擇。

Gollum wiki 的截圖如下

Mac下安裝的適合遇到了一些小問題，所以在這里記錄一下安裝過程 。

基本的環境

在安裝之前，假定我們已經擁有了mac 下的包管理工具 homebrew 及 ruby 運行環境。我當前的工作環境如下:

1. Mac 10.9
2. homebrew 0.9
3. ruby 2.0

安裝 Gollum

我們可以選擇通過二進制或者源碼的方式進行安裝。

二進制安裝

在安裝的時候會出現找不到libiconv所以需要安裝下面的依賴庫

brew install libxml2 libxslt
brew link libxml2 libxslt --force
wget http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.13.1.tar.gz
tar xvfz libiconv-1.13.1.tar.gz
cd libiconv-1.13.1
./configure --prefix=/usr/local/Cellar/libiconv/1.13.1
make
sudo make install

通過Gem安裝 gollum

[sudo] gem install gollum

源碼安裝

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

安裝成功后嘗試著在終端輸入下面的命令，如果能夠正常顯示版本號則說明安裝成功.

gollum --v

創建自己的wiki系統

接下來我們就可以建立自己的wiki系統了，建立一個名字為”wiki”的目錄使用git進行管理。進入到wiki目錄，在wiki目錄下啟動gollum

mkdir wiki
cd wiki
git init
gollum

顯示如下：

[2015-01-21 14:03:45] INFO  WEBrick 1.3.1
[2015-01-21 14:03:45] INFO  ruby 2.0.0 (2013-05-14) [x86_64-darwin12.4.1]
== Sinatra/1.4.5 has taken the stage on 4567 for development with backup from WEBrick
[2015-01-21 14:03:45] INFO  WEBrick::HTTPServer#start: pid=17699 port=4567

接下就可以在瀏覽器中訪問了 http://localhost:4567/

創建wiki文檔可以選擇在全部Web界面進行操作，也可以選擇在終端命令行進行提交管理markdown文件，在瀏覽器中進行查看。

來自：http://examplecode.github.io/tools/2014/09/26/install-gollum-in-mac-109/