今天中午花了点时间尝试构建了一个文档知识库小站点，作为一个知识库方案落地的备选。使用的是开源项目Raneto,全面支持markdown的格式。
有些同学可能对markdown的格式有些陌生，如果熟悉GitHub会发现里面大量的文件都是.md结尾的，比如readme.md文件。
markdown支持的格式还是很丰富的，而且语法相当简洁。相比于html的标签更加轻量级。GitHub上有个项目就做RADME,就是示例怎么去写markdown格式的文件。
这个过程可以边实现边改进，就跟我这几天和一个业内朋友讨论SQL审核时我说，功能优先，界面丑点没关系，我们能忍。这是一个0-1,1-90的问题，你得现有，然后再在这个基础上谈优化。
构建Raneto项目的步骤很简单，大概得花个十多分钟。
首先需要从GitHub上下载整个项目。
git clone https://github.com/gilbitron/Raneto
因为Raneto是基于NodeJS的项目，所以你得包装安装了NodeJS,可以参考链接：
https://nodejs.org/zh-cn/download/
比如我下载了一个略旧的版本，最新的是8.9.1
node-v7.6.0-linux-x64.tar
使用node -v来查看版本，如果没有问题，证明这个基础的安装就可以了。
接下来需要的就是npm了，这是管理JS包的工具。
有了node,就会自带。使用npm -v也可以查看npm的版本。
然后我们到Raneto的目录下，使用npm install来完成基本的安装，这个过程会持续一些时间，因为要下载一些相关的包，在根目录所在路径的目录.npm下，会下载大概50M左右的相关包。
这个部分完成之后，就可以使用npm start来启动了。
打开页面http://localhost:3000即可看到内容。整体看起来还不错。
当然这个是一个样例目录，我们需要在这个基础上来定制修改，完成自己的基本需求。
可以在Raneto目录下创建一个新的目录，可以理解是一个新的项目，比如jeanron100
可以把同级目录example下的*.js和*.json文件都拷贝过来复用
然后创建一个content目录，作为显示的内容主体，这个目录和web项目里面的webroot,webapp等差不多。然后我们可以创建一个测试文件index.md
输入一句话作为测试：
# cat index.md
this is a test
修改jeanron100目录下的config.default.js文件，添加文件的标题和语言（默认是英文）
site_title: 'DBA文档库',
locale: 'zh',
然后在Raneto的目录下修改入口的配置文件package.json
修改下面的这一句为项目jeanron100
"s": {
"start": "DEBUG=raneto node jeanron100/server.js",
重新启动，就可以看到新的页面了。
稍后比如我们继续补充，可以添加很多的目录，比如在content下面添加多个目录，一个根目录是a,然后下面有一系列的目录和文件。
刷新一下就能看到效果了。
