Skip to content

1Panel-dev/MaxKB-docs

Repository files navigation

本仓库保存了 MaxKB 项目官方文档,该文档使用 MkDocs 文档框架下的 Material for MkDocs 主题进行构建。

本地开发

克隆本仓库

git clone [email protected]:1Panel-dev/MaxKB-docs.git

安装依赖

cd docs
pip install -r requirements/requirements.txt

修改文档内容

本文档的文档结构定义在 mkdocs.yml 文件中,文档的具体内容均在 docs 目录中。 文档内容使用 markdown 语法编写,若要添加新的文档,需要先在 mkdocs.yml 文件中的 nav 部分增加对应章节导航。

本地调试文档

mkdocs serve

执行上述命令后,可通过 http://127.0.0.1:8000 地址查看生成的文档内容,当修改文档后,页面内容会自动更新。

构建文档

mkdocs build

执行上述命令后,会在 site 目录下生成文档站点的静态文件,将目录中的内容复制到任意 HTTP 服务器上即可完成文档的部署。

帮助完善文档

Fork 文档仓库

点击仓库右上角的 fork 按钮,复制本仓库到自己的 github 账号。

克隆 fork 后的仓库

git clone https://github.com/your-github-account/docs.git

本地修改并调试

Push 修改内容到 GitHub 仓库

提交 Pull Request 到本仓库