文档贡献指南
在线编辑
在线编辑文档,点击在线文档左下角的 在线编辑此页,浏览器会跳转到仓库文件所在目录位置,此时点击右上角 编辑 按钮,修改后预览查看效果,确认无误后点击 提交修改 提交。
提交后会经过审查,通过后合并到主仓库。一般主仓库合并后,在线文档会自动更新,如果没有更新,请手动刷新页面,或者提交后等待几分钟再刷新。
本地编辑
文档可以直接向master分支提交PR,不必创建分支。
在提交代码之前请确保在本地完成了 Git 的全局配置
git config --global user.name 你的Git用户名
git config --global user.email 你的提交邮箱,必须和代码平台账户邮箱一致- Fork 项目:点击右上角 Fork 到自己的仓库
- 克隆仓库:
git clone https://gitcode.net/your_username/konado.git - 编辑文档:在
docs目录下找到需要修改的文件,使用 Markdown 语法进行编辑(参考 Markdown 语法) - 提交更改:
git commit -m "描述你的文档更改" - 推送分支:
git push origin master
提交后,在自己fork的仓库页面、点击Pull Request按钮,创建 PR。
预览本地文档
Konado的文档使用 VitePress 构建,可以本地预览文档后再提交。
安装依赖:
npm install启动服务:
npm run docs:dev访问文档:浏览器访问
http://localhost:5173/konado/,即可预览文档,具体的IP和端口可以在命令行输出中查看。shellvitepress v1.6.4 ➜ Local: http://localhost:5173/konado/ ➜ Network: use --host to expose ➜ press h to show help
修改后,浏览器会自动刷新,查看修改后的内容。