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

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM