【Linux工具】GIT+Gollum在Ubuntu下搭建本地WIKI编辑系统

╰+哭是因爲堅強的太久メ 2022-01-10 05:23 297阅读 0赞

# 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][http_127.0.0.1_4567] ；

# 5 功能展示 #

## 创建页面 ##

![247263-20160318005610459-483179602.png][]

## 预览页面 ##

![247263-20160318005622006-1913954420.png][]

【重要事情说三遍】

**不要在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上陆陆续续折腾好几天啊。╮(╯▽╰)╭

转载于:https://www.cnblogs.com/QuLory/p/5290184.html

[http_127.0.0.1_4567]: http://127.0.0.1:4567
[247263-20160318005610459-483179602.png]: /images/20220109/180d0632f8484386a2088d692de1accb.png
[247263-20160318005622006-1913954420.png]: /images/20220109/55e0c5398c65485b9c9c5ffd9d2e3ad5.png