如何在CentOS 7上使用Gollum设置Github风格的Wiki

・3 分钟阅读

Gollum是基于git的Wiki软件,用作GitHub Wiki的后端,部署Gollum将允许你在服务器上托管GitHub-like Wiki系统。

前提条件

  • CentOS 7x64服务器实例,
  • 一个sudo用户
  • EPEL yum 软件仓库。

步骤1:更新系统

使用sudo用户登录到你的服务器以安装EPEL,更新系统,然后重新启动以应用更新。


sudo yum install epel-release -y
sudo yum update -y && sudo shutdown -r now

步骤2:使用gem安装Gollum

在Centos 7上安装Gollum最简单的方法是使用RubyGems


sudo yum group install"Development Tools" -y
sudo yum install ruby ruby-devel libicu libicu-devel zlib zlib-devel git -y
sudo gem install gollum

注:上面的gem install命令可能需要一段时间才能完成,如果你要快速进行,你可以通过跳过文件来加速安装,如下所示。 你也可以在screen会话中运行它


sudo gem install --no-rdoc --no-ri gollum

Gollum二进制文件将在/usr/local/bin/gollum中安装到你的系统中,你可以通过运行以下简单命令来确认安装是否成功:

 
gollum --v

 

步骤3:设置一个Gollum wiki

设置Gollum Wiki所需要做的就是创建一个git存储库,并且在其中运行gollum命令:


cd
mkdir my-wiki
cd my-wiki
git init
gollum

注:必要时,你可以使用Ctrl+C退出Gollum 。

步骤4:允许网络访问

在用浏览器中访问你的Gollum wiki站点之前,需要修改防火墙规则,如下所示:


sudo firewall-cmd --zone=public --permanent --add-port=4567/tcp
sudo firewall-cmd --reload

步骤5:访问来自web的Gollum

在Gollum运行时,将你的网页浏览器指向http://203.0.113.1:4567,开始创建第一个Gollum wiki页面,在这里创建wiki页面,你创建的页面都将保存在当前git repo目录中的.md文件。

步骤6:从CLI创建或编辑Gollum维基页面

除了从Web浏览器创建或修改页面外,你还可以从CLI创建或编辑页面。只需根据Markdown语法创建.md文件,然后将它们提交到git repo :


cd ~/my-wiki
vi page1.md
git config --global user.email"admin@example.com"
git config --global user.name"admin"
git add page1.md
git commit -m"create page1"

就是这样了,要了解更多关于Gollum的信息,请键入gollum --help查看帮助,或访问官方Gollum网站 。

Anne655 profile image