【Linux工具】GIT+Gollum在Ubuntu下搭建本地WIKI編輯系統

1 設置淘寶的gem鏡像

1.1 不用鏡像的痛苦

若是直接用官網的話，會有以下的錯誤信息，添加源、安裝gem都是同樣的錯誤，就算能連上也會很慢；linux

$ gem sources -a https://rubygems.org/
Error fetching https://rubygems.org/:
	Errno::ECONNRESET: Connection reset by peer - SSL_connect (https://api.rubygems.org/specs.4.8.gz)

1.2 添加淘寶gem鏡像地址

$ gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org/
$ gem sources -l
*** CURRENT SOURCES ***

https://ruby.taobao.org
# 請確保只有 ruby.taobao.org
$ gem install rails

2 安裝必要的庫

neo@dev-All-Series: /workspace/neo 
$ sudo apt-get install ruby2.1-dev libicu-dev

沒有安裝這些依賴關係時候遇到錯誤碼以下：

ERROR: Failed to build gem native extension. /usr/bin/ruby2.1 extconf.rb mkmf.rb can’t find header files for ruby at /usr/lib/ruby/include/ruby.h

3 安裝gollum

因爲家裏臺式機是8核16G的，配置槓槓的跑起來飛快，幾分鐘就安裝好啦；git

neo@dev-All-Series: /workspace/neo 
$ sudo gem install gollum -V

在這裏添加-V主要是爲了觀察如下安裝過程，也能夠忽略之，更多的命令行參數的話，就直接 gem --help查看吧；

4 享受本地wiki之旅

neo@dev-All-Series: /workspace/neo/gitlab/test.wiki 
$ gollum
[2016-03-17 23:37:56] INFO  WEBrick 1.3.1
[2016-03-17 23:37:56] INFO  ruby 2.1.2 (2014-05-08) [x86_64-linux-gnu]
== Sinatra (v1.4.7) has taken the stage on 4567 for development with backup from WEBrick
[2016-03-17 23:37:56] INFO  WEBrick::HTTPServer#start: pid=32446 port=4567
localhost - - [17/Mar/2016:23:38:22 CST] "GET / HTTP/1.1" 302 0
- -> /
localhost - - [17/Mar/2016:23:38:22 CST] "GET /Home HTTP/1.1" 302 0
- -> /Home
localhost - - [17/Mar/2016:23:38:22 CST] "GET /create/Home HTTP/1.1" 200 6600
- -> /create/Home

believe it or not， i'm now using gollum to finish this article； LOL

直接在瀏覽器中輸入本地127.0.0.1:4567開啓wiki之旅吧，實時預覽起來挺不錯的哦；若是你按照本教程剛剛安裝好，那麼就點擊準備好的地址吧 http://127.0.0.1:4567 ；windows

5 功能展現

建立頁面

預覽頁面

【重要事情說三遍】api

不要在windows上折騰gollum！！！瀏覽器

不要在windows上折騰gollum！！！ruby

不要在windows上折騰gollum！！！markdown

親身經歷告訴我，在windows上折騰gollum要命還沒法成功；如下簡要說明如下痛苦經歷：gitlab

一、爲了能安裝gem，須要本身下載ruby的devkit，還好在rubyinstaller網站上有；fetch

二、gollum依賴於不少庫，最難裝的那個依賴於icu，因此要去icu官網下載源碼本身安裝；網站

三、先安裝的那個鬼gem（名字很難記）編譯icu常常出現找不到icu的庫，須要手動設置 --with-icu-dir='/your/icu/installed/path/'

四、安裝好gollum後，啓動時報上面那個鬼gem的.so 加載失敗，爲啥呢？定位了好久，最後看經過手動irb中require該庫，而後看mkmf.log日誌中的編譯方法，

發現是找不到icu的庫，由於編譯代碼用的-L. ，因此機制的我只能切換到安裝icu的lib的目錄下去執行gollum，竟然就啓動成功了，由於對ruby不熟悉，不知道

怎麼設置各類gem依賴的動態庫的路徑，反正設置環境變量LD_LIBRARY_PATH貌似沒有效果；

五、不要高興地太早，就算啓動了gollum，去瀏覽器中打開地址一看，傻眼了，竟然ERROR ，，，看命令行日誌是，各類posix spawn在windows上失敗，這個是硬傷啊！！！

windows傷不起，晚上回來本身機器上Ubuntu環境下幾分鐘搞定的事情！！！windows上陸陸續續折騰好幾天啊。╮(╯▽╰)╭