基本概念

使用CabloyJS开发文档网站(比如CabloyJS的官方技术文档)也是非常方便。与一些静态建站工具(如hexo)相比,CabloyJS开发的文档网站天然具备一些丰富的特性,比如:

  1. 在线文档编辑

  2. 支持审批工作流

  3. 文档的历史版本管理

  4. 直接支持多语言

  5. 直接支持评论、附件

  6. 直接支持文档访问量统计、点赞、收藏

  7. 所见即所得的Markdown富文本编辑器

  8. RSS文章订阅

如何开发

教程:博客中,我们已经知道了如何开发一个博客网站。具体而言,就是CabloyJS内置了一个业务模块a-cms,该模块提供了一个通用的业务数据article,该业务数据支持CMS静态渲染引擎。其实,业务数据article之所以称之为通用,就是因为它不仅可以用来实现博客,也可以用来实现文档

但是,在这里,我们将使用另外一个业务模块cms-sitedocumentation来实现文档网站。这样做的好处就是,我们的项目可以同时开发博客文档了,而且二者互不干扰

目标

通过本教程,我们来体验一下在CabloyJS中是如何开发文档的:

  1. 站点参数配置

  2. 添加目录

  3. 整站构建

  4. 添加文档

  5. 定制首页

如果想了解CMS静态渲染引擎的更完整内容,请参见:Cabloy-CMS