gollum(git+markdown)wiki系统搭建

u=4018013451,3373016715&fm=21&gp=0
不要被可爱的咕噜吓到[偷笑]
为什么想搭建一个wiki系统呢?主要是平时工作中总会有一些细小的知识点想要记录下来,但是觉得这么细小的知识点又没什么必要开一篇博客。而现有的做法是出现一个知识点我就新建一个markdown文件放在桌面上,导致我的桌面上的文件超级多[汗]。所以就想搞一个wiki系统,用于记录这些琐碎的知识。
开源的wiki系统那么多,为什么就选择gollum呢?主要是这名字挺逗的,一下子想到魔戒的咕噜有木有?当然这个理由只是开个玩笑,网上多数推荐的是dokuwiki,而且PHP官方网站某些地方就使用了dokuwiki,比如phpng我个人也尝试了下,但还是因为某种原因没有吸引住我。所以最终就定了gollum。

动手搞起!
然而,然而,然而gollum没有那么好搞定,原因它是基于ruby的。so,想搞定gollum首先要搞定ruby那套环境。而由于gollum需要ruby的版本要在1.9.2以上,那么我们需要做如下工作:

  • 升级或安装ruby(1.9.2以上)(如果你的ruby版本已符合需求,那么忽略这一步)
  • 更新gem(ruby的包管理器)
  • 安装bundler(ruby的应用依赖管理器)
  • 使用gem安装gollum
  • 在github下载gollum
  • 使用bundler执行最后的安装

升级或安装ruby(1.9.2以上)
1.检查下是否已经安装了ruby以及当前ruby的版本,如果你的ruby版本已符合需求,那么忽略这一步

ruby -v

如果不符合要求,那么删除掉现有的ruby

yum remove ruby ruby-devel

2.安装高版本的ruby(我这里安装的是2.1.2)

yum groupinstall "Development Tools"
yum install openssl-devel
#下载ruby 2.1.2版本
wget http://cache.ruby-lang.org/pub/ruby/2.1/ruby-2.1.2.tar.gz
#解压缩
tar zxvf ruby-2.1.2.tar.gz
cd ruby-2.1.2
#执行编译和链接工作,过程可能会有点长
./configure && make && make install

#安装完成后,检查现在的ruby版本,如果是2.1.2那就OK了。
ruby -v

更新gem(ruby的包管理器)
如果你是重装了ruby,那么更新下gem源

gem update --system

Note:如果在这里你遇到了SSL错误的话,那么需要更改下gem的源网址,原因在于该网址被墙了[汗],点击解决国内gem不能用的问题解决问题,解决好之后,继续执行更新命令。

安装bundler(ruby的应用依赖管理器)

gem install bundler

使用gem安装gollum

gem install gollum

在github下载gollum
切换到server root目录下,执行以下命令

git clone https://github.com/gollum/gollum
cd gollum

使用bundler执行最后的安装

bundle install

如果你在安装时遇到了这样的问题:

Don't run Bundler as root. Bundler can ask for sudo if it is needed, and installing your bundle as
root will break this application for all non-root users on this machine.
Fetching gem metadata from https://rubygems.org/..........
Fetching version metadata from https://rubygems.org/..
Resolving dependencies.............
Using rake 10.5.0

Gem::RemoteFetcher::FetchError: SSL_connect SYSCALL returned=5 errno=0 state=SSLv2/v3 read server hello A (https://rubygems.global.ssl.fastly.net/gems/i18n-0.7.0.gem)
Using minitest 4.7.5

Gem::RemoteFetcher::FetchError: SSL_connect SYSCALL returned=5 errno=0 state=SSLv2/v3 read server hello A (https://rubygems.global.ssl.fastly.net/gems/multi_json-1.11.2.gem)

Gem::RemoteFetcher::FetchError: SSL_connect SYSCALL returned=5 errno=0 state=SSLv2/v3 read server hello A (https://rubygems.global.ssl.fastly.net/gems/thread_safe-0.3.5.gem)
...

也不要惊慌,其实还是被墙的原因,无耻而强大的墙啊!这时,解决方案是临时性的更改bundle源,执行如下命令

bundle config mirror.https://rubygems.org https://ruby.taobao.org

更改完成后,再次安装,等待安装结果吧~比如我的安装结果
5FDF8ED1-F612-4D63-A2BC-378E05F55FED

好,到这里也就完成了gollum的安装~

启动gollum服务器以及设定配置

gollum --css --allow-uploads --mathjax --h1-title

现在打开浏览器,输入http://localhost:4567/,比如我的是 http://192.168.33.10:4567/
D2F04F6F-C1CA-4165-B434-336C4A17D22B

参考网址:
How to upgrade Ruby on CentOS
gollum:轻量级的wiki系统
解决国内gem不能用的问题

gollum(git+markdown)wiki系统搭建
Tags:

One thought on “gollum(git+markdown)wiki系统搭建

  • 12/29/2016 at 上午11:04
    Permalink

    大神, 我也在用 gollum. 但是我觉得很慢, 部署在本地, 打开主页都要4-5秒. 我想知道你有这个问题吗?

    Reply

发表评论

电子邮件地址不会被公开。 必填项已用*标注