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

1 設置淘寶的gem鏡像

1.1 不用鏡像的痛苦

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

$ 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的，配置槓槓的跑起來飛快，幾分鐘就安裝好啦；

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 ；

5 功能展示

創建頁面

預覽頁面

 

 

 

【重要事情說三遍】

不要在windows上折騰gollum！！！

不要在windows上折騰gollum！！！

不要在windows上折騰gollum！！！

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

1、爲了能安裝gem，需要自己下載ruby的devkit，還好在rubyinstaller網站上有；

2、gollum依賴於很多庫，最難裝的那個依賴於icu， 所以要去icu官網下載源碼自己安裝；

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

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

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

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

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

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