用 Jekyll 搭建文档系统

技术输出型公司,一套优秀的文档管理、发布系统必不可少。文档系统是内容管理系统的一种,其对可访问性要求高、单文档更新频率低、发布频率高。笔者认为,以纯静态HTML对外发布文档是个不错的选择。但是,直接写HTML文档,费时费力、不好维护。能不能将我们常用的Markdown文档,转化为HTML对外发布呢?当然可以。本文主要介绍如何利用Jekyll搭建一套文档系统。

1. Jekyll

1.1 简介

  • 第一步:安装ruby和devkit。
1
2
ruby dk.rb init
ruby dk.rb install
  • 第三步:设置gem源。