【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 安装必要的库

[email protected]: /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的,配置杠杠的跑起来飞快,几分钟就安装好啦;

[email protected]: /workspace/neo
$ sudo gem install gollum -V

在这里添加-V主要是为了观察以下安装过程,也可以忽略之,更多的命令行参数的话,就直接gem --help查看吧;

4 享受本地wiki之旅

[email protected]: /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上陆陆续续折腾好几天啊。╮(╯▽╰)╭

时间: 2024-11-19 05:51:09

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

Linux之旅-ubuntu下搭建nodejs环境

.NET Core也开源了,并且可移植到Linux下,而ubuntu作为linux发行版的翘楚,极大的方便了初学者的入门,搭建完ASP.NET Core运行环境后,作为半前半后的开发人员,就继续着搭建了下nodejs的开发环境! ubuntu下搭建nodejs最简单的方式就是用ubuntu的包管理工具 ,nodejs需要python环境,而一般ubuntu发行版本中是包含有python开发环境的,因此只需要注册nodejs的软件源然后执行安装即可 apt-get update apt-get i

Ubuntu下搭建NodeJS+Express WEB开发框架

Ubuntu下搭建NodeJS+Express WEB开发框架 2012-12-27 15:06 作者: NodeJSNet 来源: 本站 浏览: 2,966 次阅读 我要评论暂无评论 字号: 大 中 小 摘要: 本文主要对前人所写文章的总结,包括自己在安装node.js 和express过程中遇到的问题.以备后用,同时能让正在学习node.js 的人少走一些弯路. 1.安装环境,由于对linux是菜鸟级别,所以在虚拟机上安装的一个ubuntu11.10 随便玩玩,虚拟... 本文主要对前人所写

Ubuntu 下搭建 Android 开发环境

网上的N多教程全是Windows平台的,而Google官网是推荐用Ubuntu开发Android,很多朋友也是用Linux的系统开发的,下面我介绍下在Linux下Android开发环镜的搭建. 一.Linux 下安装配置 JDK 自从Oracle收购Sun近三年来,已经有很多变化.早在8月,甲骨文将"Operating System Distributor License for Java"许可证终结,这意味着第三方将不可以依据这一许可分发他们的软件包.因此Ubuntu Linux已经

ubuntu下搭建svn环境及其使用

ubuntu下搭建svn环境 软件下载安装: 我选用的是apt-get install subversion   操作系统自带的包管理工具安装,采用此法安装的软件方便管理,可以用dpkg -L subversion命令查看其所在安装目录. 注:ubuntu也有像archlinux相似的软件包搜索功能 , 搜索subversion 可以这么写apt-cache search subversion,就会列出所有匹配到的可选软件. 软件配置使用: 本环节其实就是在安装好subversion的操作系统中

cocos2d-x-2.2.3在Windows7和Ubuntu下搭建桌面开发环境(非Android环境)

要cocos2d-x-2.2.3搭建环境需要有以下的几个基本要求:(在我的小本本上) 1.一个操作系统(Win7或Ubuntu[只在这两个系统下测试过]): 2.在Win7下需要的是VS2010以上的版本(我用的是VS2012,虽然我不想用VS,但是现在我还没有办法不用IDE就编译代码),在Ubuntu下不需要,然后安装好VS2012,我没有安装那个VS2012.4的更新照样没事: 3.Python开发环境:(这个跟正常配置一样,一路Next再把Python安装目录(我用的2.7.x,因此是C:

ubuntu下搭建android开发环境(四)核心篇安装AndroidStudio、sdk、jdk(by 星空武哥)

转载请标注原创地址:http://blog.csdn.net/lsyz0021/article/details/52215996 所有的软件均在ubuntu 14.04 LTS下测试 ubuntu下搭建android开发环境(一)安装ubuntu系统 ubuntu下搭建android开发环境(二)设置ubuntu的root管理员密码 ubuntu下搭建android开发环境(三)ubuntu安装搜狗输入法 ubuntu下搭建android开发环境(四)核心篇安装AndroidStudio.sdk

ubuntu下搭建android开发环境(一)安装ubuntu系统(by 星空武哥)

    转载请标注原创地址:http://blog.csdn.net/lsyz0021/article/details/52187026 ubuntu下搭建android开发环境(一)安装ubuntu系统 ubuntu下搭建android开发环境(二)设置ubuntu的root管理员密码 ubuntu下搭建android开发环境(三)ubuntu安装搜狗输入法 虽说已经有很多ubuntu的安装教程了,但是今天我还是要写一篇这样的文章,因为这篇文章是为了在ubuntu下搭载android开发环境所

Ubuntu下搭建Tomcat服务器

安装JAVA环境 apt-get update apt-get install openjdk-7-jdk 配置JAVA环境变量 vi /etc/environment JAVA_HOME=JDK目录(一般在=/usr/lib/jvm/jdk1.7.0_04/) CLASSPATH=.:/usr/lib/jvm/jdk1.7.0_04/lib 获取Tomcat安装包 官方下载一个解压即可 #添加一个系统用户tomcat,并且设置为不可登录系统. useradd -d /tomcat解压目录 -s

Ubuntu下搭建Cocos2D-X 3.6开发环境

简单讲解在Ubuntu下搭建Cocos2D-X 3.6开发环境的过程,希望对大家有用. 1.解压下载的包,找到build目录: 在终端下先执行install-deps-linux.sh文件 结果类似: 时间可能比较长. 2.回到解压包的根目录下执行setup.py: 可以看出这个执行完成的是检测系统环境并在配置文件中加入需要的环境变量,会将原配置文件备份. 3.在解压包的目录运行 cmake . 注意后面代表当前目录的 . (不要在意sudo) 4.make 用cmake生成的Makefile就