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上陸陸續續折騰好幾天啊。╮(╯▽╰)╭