## **0. 前置说明** ### 0.1 创建项目 在进行后续的开发之前,请确保已经创建了一个CabloyJS项目,在这里我们仍然假定创建的项目名称为:`cabloy-demo` > 如何创建项目:[快速开始](https://cabloy.com/zh-cn/articles/guide-quick-start.html) ### 0.2 安装业务模块 安装业务模块`cms-sitedocumentation` ``` bash $ npm run cli :store:sync cms-sitedocumentation ``` 为了让业务模块中的测试数据生效,需要执行如下指令:(如果后端服务在运行当中,则需要先停止后端服务) ``` bash $ npm run db:reset ``` 由于安装了新的业务模块,需要重新启动开发服务 ``` bash # 启动后端开发服务 $ npm run dev:backend # 启动前端开发服务 $ npm run dev:front ``` ## **1. CMS管理页面** 通过菜单`工具/设置/CMS`打开`CMS静态渲染引擎`的管理页面 ![1](https://portal.cabloy.com/api/a/file/file/download/03e2e7e8e43e4b699c7beb2a87db6ae6.png) ## **2. 站点配置** 点击`CMS:文档`,进入配置页面,然后点击`配置`按钮,在编辑器中输入如下JSON配置: ![2](https://portal.cabloy.com/api/a/file/file/download/8b1023916fba4ae0a2ca094c2aac668e.png) ``` javascript { host: { url: 'http://docs.example.com', rootPath: '', }, language: { default: 'en-us', items: 'en-us,zh-cn', }, themes: { 'en-us': 'cms-themedocs', 'zh-cn': 'cms-themedocs', }, plugins: { 'cms-plugintrack': { track: { google: '', baidu: '', qq: '', }, }, }, } ``` 当然,我们一开始并不知道站点配置的规则。没关系,点击右侧的图标`!`,查看`缺省配置`,然后把缺省配置拷贝过来修改即可 ![1](https://portal.cabloy.com/api/a/file/file/download/824a9c66ed4544e18af6bfeb5c564bfc.png) ## **3. 参数说明** 各参数的说明,请参见:[博客:参数说明](https://cabloy.com/zh-cn/articles/13f6734ea4ff4ccc98eeee882f0027f9.html#3__63) 在这里,我们同样支持`en-us`和`zh-cn`两种语言。两种语言均使用相同的主题`cms-themedocs`。由于这个主题模块也是CabloyJS内置的,因此也可以直接使用。如果是使用第三方主题,请先安装相应的主题模块 ## 4. 语言配置 不同的语言也可以配置不同的参数,配置规则与`站点配置`一致,在这里我们都使用默认值即可 ## **下一步** 接下来,我们再调整一下静态站点的目录结构