Git Product home page Git Product logo

docs's Introduction

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


一、开发环境准备

克隆本仓库

git clone https://github.com/hummerrisk/hummerrisk-docs.git

运行方式1. 使用 Docker 运行

本地运行环境

docker run --rm -it -p 8000:8000 -v ${PWD}:/docs registry.cn-beijing.aliyuncs.com/hummerrisk/mkdocs-material:8.4.2

本地构建

docker run --rm -it -v ${PWD}:/docs registry.cn-beijing.aliyuncs.com/hummerrisk/mkdocs-material:8.4.2 build

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


运行方式2. 本地手动模式

安装依赖

cd docs
pip3 install -r requirements/requirements.txt

运行调试

pip3 install mkdocs 
mkdocs --version
pip3 install mkdocs-material
mkdocs serve

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

构建文档

mkdocs build

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

二、修改文档内容

本文档的文档结构定义在 mkdocs.yml 文件中,文档的具体内容均在 docs 目录中。

nav:
  - 系统介绍:
      - 整体介绍: architecture.md
      - 快速安装: system/setup_by_fast.md
      - 升级文档: system/upgrade.md
  - 用户手册:
      - 使用流程: user/process.md
      - 系统设置: user/settings.md
      - 检测规则: user/rule.md
      - 云账号: user/account.md
      - 检测结果: user/resource.md
      - 首页: user/dashboard.md
  - 常见问题:
      - 开发文档: question/dev_manual.md
      - 等级保护: question/grade_protection.md
      - 开启企业微信通知: question/weixin_settings.md
      - 开启钉钉消息通知: question/dingtalk_settings.md
      - 解决云账号校验失败问题(Custodian): question/account.md
      - 如何自定义规则(Custodian): question/rule.md
      - 自定义阿里云监控规则示例(Custodian): question/example.md
      - 自定义漏洞检测规则(Nuclei): question/nuclei.md
      - 快速了解AWS检测规则(Prowler): question/prowler.md
  - 关于我们:
      - 资源下载: about/download.md
      - 更新说明: about/changelog.md
      - 联系我们: about/contact.md

文档内容使用 markdown 语法编写,若要添加新的文档,需要先在 mkdocs.yml 文件中的 nav 部分增加对应章节导航。

三、帮助完善文档

Fork 文档仓库

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

克隆 fork 后的仓库

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

本地修改并调试

Push 修改内容到 GitHub 仓库

提交 Pull Request 到本仓库

docs's People

Contributors

harris1943 avatar alvin5840 avatar colinn66 avatar wangjiankun233 avatar jackie066 avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.