git clone [email protected]:xxx/mixchat-docs.git
xxx 是你的 Github 账号
打开克隆到本地的文件夹,在目录 docs 下,可以看到网站上显示的文件。
编辑其中的 md 文件,每个 md 文件都已下面的内容开始,后面就是文档的正文部分,使用 markdown 语法即可。
下面的内容对应着文档在网站侧边栏显示的顺序,1
就是排在第一个显示,2
就是排在第二个显示,以此类推。
---
sidebar_position: 1
---
文件夹通过_category_.json
文件控制文件夹在侧边栏显示的顺序,比如en
是英文文档,其position
的值为2
,则排在侧边栏第 2 个显示。
文件夹内的每个文档同理,决定该文档在文件夹内的排序。
在本地的命令行中,mixchat-docs 目录下,执行下面的命令,会通过本地浏览器打开网站,预览合适后就可以提交至 Github 中。
yarn run start
git add .
git commit -m 'update'
git push