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

2019-07-06 12:41:05 阅读：289 来源： 互联网

标签：WIKI GIT Gollum icu https org ruby gollum gem

原文链接：http://www.cnblogs.com/QuLory/p/5290184.html

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要命还无法成功；以下简要说明以下痛苦经历：

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

标签：WIKI,GIT,Gollum,icu,https,org,ruby,gollum,gem
来源： https://blog.csdn.net/weixin_30221425/article/details/94843144

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

ICode9