diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml new file mode 100644 index 00000000..f9554157 --- /dev/null +++ b/.github/workflows/main.yml @@ -0,0 +1,33 @@ +name: Docs Build +on: + push: + branches: + - master + +jobs: + build: + name: Deploy docs + runs-on: ubuntu-latest + steps: + - name: Checkout master + uses: actions/checkout@v2 + + - name: Deploy docs to GitHub Pages + uses: mhausenblas/mkdocs-deploy-gh-pages@master + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + CUSTOM_DOMAIN: framework.zhamao.me + CONFIG_FILE: mkdocs.yml + EXTRA_PACKAGES: build-base + - name: Copy deployment to current folder + run: | + cp -r "${GITHUB_WORKSPACE}/site" "./deploy" + - name: Deploy to Zhamao Server + uses: easingthemes/ssh-deploy@main + env: + SSH_PRIVATE_KEY: ${{ secrets.ZHAMAO_XIN_PRIVATE_KEY }} + ARGS: "-rltgoDzvO --delete" + SOURCE: "deploy/" + REMOTE_HOST: ${{ secrets.ZHAMAO_XIN_HOST }} + REMOTE_USER: ${{ secrets.ZHAMAO_XIN_USER }} + TARGET: ${{ secrets.ZHAMAO_XIN_TARGET }} diff --git a/README.md b/README.md index d916c229..1f441880 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,7 @@ [![zhamao License](https://img.shields.io/hexpm/l/plug.svg?maxAge=2592000)](https://github.com/zhamao-robot/zhamao-framework/blob/master/LICENSE) [![Latest Stable Version](http://img.shields.io/packagist/v/zhamao/framework.svg)](https://packagist.org/packages/zhamao/framework) [![Banner](https://img.shields.io/badge/OneBot-v11-success)](https://github.com/howmanybots/onebot) +![Build Actions](https://github.com/zhamao-robot/zhamao-framework/actions/workflows/main.yml/badge.svg) [![注解数量](https://img.shields.io/github/search/zhamao-robot/zhamao-framework/AnnotationBase.svg)](https://github.com/zhamao-robot/zhamao-framework/search?q=AnnotationBase) [![TODO 数量](https://img.shields.io/github/search/zhamao-robot/zhamao-framework/TODO.svg)](https://github.com/zhamao-robot/zhamao-framework/search?q=TODO) @@ -52,9 +53,9 @@ vendor/bin/start server ``` ## 文档(v2 版本) -查看文档(国内自建): +查看文档(国内自建): -备用链接(国外托管): +备用链接(国外托管): 自行构建文档:`mkdocs build -d distribute` diff --git a/docs/index.md b/docs/index.md index 4db24f48..71c6d364 100644 --- a/docs/index.md +++ b/docs/index.md @@ -10,8 +10,6 @@ 框架主要用途为 HTTP/WebSocket 服务器,机器人搭建框架。尤其对于聊天机器人消息处理较为方便和全面,提供了众多会话机制和内部调用机制,可以以各种方式设计你自己的模块。 -在 HTTP 和 WebSocket 服务器上,PHP 的扩展 Swoole 提供了高性能的支持,使其效率可媲美 nginx 静态网页处理的效率。 - 此外,QQ 机器人方面此框架基于 OneBot 标准的反向 WebSocket 连接,比传统 HTTP 通信更快。 ```php @@ -36,7 +34,7 @@ public function index() { 首先,你需要了解你需要知道哪些事情才能开始着手使用框架: 1. Linux 命令行(会跑 Linux 程序) -2. php 7.2+ 开发环境(项目会持续支持最新的 PHP 版本) +2. php >=7.2 开发环境(项目会持续支持最新的 PHP 版本) 4. OneBot 机器人聊天接口标准 需要值得注意的是,本教程中所涉及的内容均为尽可能翻译为白话的方式进行描述,但对于框架的组件或事件等需要单独拆分说明文档的部分则需要足够详细,所以本教程提供一个快速上手的教程,并且会将最典型的安装方式写到快速教程篇。