gollum:轻量级的wiki系统

标签: gollum 轻量级 wiki | 发表时间:2015-10-07 08:58 | 作者:
出处:http://www.bjt.name

gollum 是什么?

gollum的readme上有句最简单的描述很直白:A git-based Wiki。

个人认为github,jekyll, gollum可以并称为码农的三大神器,github用来敲代码,jekyll用来写技术博客,gollum用来搭建自己的知识管理wiki系统。很巧合的是部门用gollum也有两年时间了,不过以前都是直接用,没有仔细看过手册,趁十一期间有时间简单搭了一套玩玩。

简单来讲gollum有以下四个优点:

  • 轻量级,但结构和功能完整
  • 使用Markdown语法
  • 可提供网页服务
  • 使用git进行内容控制

尤其是第四点,完全没有抵抗力啊~

gollum 的安装

gollum的安装很简单,尤其是在ubuntu 14.04上:

  sudo apt-get install ruby1.9.1 ruby1.9.1-dev make zlib1g-dev libicu-dev build-essential git
sudo gem install gollum

或者选择源代码安装:

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

而后初始化git目录,在git的目录执行

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

以上使用了一些参数,分别是使用自定义 custom.css 文件(在git初始化目录),增加上传功能,支持 LaTeX 公式,markdown的一级标题为全文标题。

在浏览器中访问以下地址来创建wiki内容:

  http://localhost:4567

我简单编辑了home页面,大概长得是这个样子:

这个页面其实是markdown的文件

  # xxx部门的wiki

## [[推荐系统|/RecHome]]

Gollum is a simple wiki system built on top of Git. A Gollum Wiki is simply a git repository (either bare or regular) of a specific nature:

1. A Gollum repository's contents are human-editable, unless the repository is bare. 
2. Pages are unique text files which may be organized into directories any way you choose. 
3. Other content can also be included, for example images, PDFs and headers/footers for your pages.

## This is second

如图片所示,一般的功能诸如home,新建,重命名,编辑,历史,最近的改变等均有。

gollum有完整的wiki语法结构,可以直接参考gollum的wiki,这里就不做赘述,简言之:非常完备值得拥有。

最后在这里可以拿到自定义的 css文件

gollum的一些注意点

  1. gollum命令必须在git目录下使用
  2. 使用git来提交内容时一定要commit之后才会生效
  3. git必须在master分支提交
  4. wiki的目录结构最好事先设计好,否则文件会非常乱

相关 [gollum 轻量级 wiki] 推荐:

gollum:轻量级的wiki系统

- - 刘思喆@贝吉塔行星
gollum的readme上有句最简单的描述很直白:A git-based Wiki. 个人认为github,jekyll, gollum可以并称为码农的三大神器,github用来敲代码,jekyll用来写技术博客,gollum用来搭建自己的知识管理wiki系统. 很巧合的是部门用gollum也有两年时间了,不过以前都是直接用,没有仔细看过手册,趁十一期间有时间简单搭了一套玩玩.

Home · JohnLangford/vowpal_wabbit Wiki · GitHub

- -
There are two ways to have a fast learning algorithm: (a) start with a slow algorithm and speed it up, or (b) build an intrinsically fast learning algorithm.

MediaWiki 1.23.0 发布,开源 Wiki 程序

- - 开源中国社区最新新闻
MediaWiki 1.23.0 发布了,这是一个大的更新版本,包含很多新特性和 bug 修复,详细介绍请看 这里. MediaWiki全球最著名的开源wiki程序,运行于PHP+MySQL环境. MediaWiki从2002年2月25日被作为维基百科全书的系统软件,并有大量其他应用实例. 目前MediaWiki的开发得到维基媒体基金会的支持.

Loading Data into Hive - Pentaho Big Data - Pentaho Wiki

- -
Using the external option, you could define a Hive table that simply uses the HDFS directory that contains the parsed file. For this how-to, we chose not to use the external option so that you can see the ease with which files can be added to non-external Hive tables..

SSL Troubleshooting and Reference Guide - CAS User Manual - Apereo Wiki

- -
This section contains the most often-cited SSL errors reported by the CAS server and CAS clients in typical CAS integration scenarios.. If the certificate is issued by your own PKI, it is better to import the root certificate of your PKI into the CAS client truststore.

Databus for MySQL 同步 · linkedin/databus Wiki · GitHub

- -
A frequently asked question on the Databus open source mailing list is about the possibility of capturing changes in MySQL through Databus. $ (cd bin && ./create_person.sh): The script assumes that MySQL is started on port 33066; please change it appropriately for your setup.

CBoard 分析工具选型 · yzhang921/CBoard Wiki · GitHub

- -
数据可视化是BI生命周期里面非常重要的一个环节,当前数据可视化的几种常见模式如下:. 商业BI套件 能够提供BI生命周期全套的解决方案,业界比较知名BI套件老牌的有IBM的Cognos、SAP的BO、Oracle的BIEE,以及新生军Tableau、QlikView等等,这些产品前端可视化都做得非常强大,报表设计、Dashboard设计、Report邮件发送、OLAP分析都不在话下.

写了一个小 wiki 玩具 in web.py,无数据库,默认支持 markdown 标记

- wang - python.cn(jobs, news)
我用写了一个轻量 wiki 玩具名为 ZWiki (大小写敏感), 仅仅是因为妹子回家无聊,它不会像 mediawiki 那么庞大、强大和臃肿. - 基于 web.py 写,部分脏活粗暴直接调用 find grep 来干. - 支持 markdown 标记. - 不用数据库,粗暴直接读写文本文件,你可以用 Firefox + It's all text + 任意编辑器更新 wiki ,或者直接 修改对应的文本文件.

用 toto 快速建轻量级博客

- zhai - 博客园-首页原创精华区
对于程序员或创业团队来说,还是有必要拥有一个属于自己的博客. Wordpress 曾经让个人或企业搭建博客变得非常容易. 但是我们觉得 Wordpress 还是有些重量级,所以选择了一个非常轻便的工具 toto,一段只有200多行代码的Ruby应用程序. toto之所以简单,是因为它利用一些很好的工具和服务.

CintaNotes:轻量级笔记软件

- - 软件志
一、CintaNotes简介: 这是一款非常轻巧实用的笔记软件,体积仅1MB,可以很方便用快捷键从任意程序收集文本,或手工添加内容;收集的内容会保留来源url. 所有文本线性排列,并可添加标签(tag);搜索框中键入内容即可实时显示命中结果,非常方便——重要的是它支持UniCode,因此不存在中文搜索问题.