From c815ac7ca37797a1da8c78594b2d5797387ff6d8 Mon Sep 17 00:00:00 2001 From: yanyongyu Date: Mon, 27 Dec 2021 13:37:08 +0800 Subject: [PATCH] :fire: temp remove link in advanced --- website/docs/advanced/README.md | 9 +++++---- website/docs/advanced/publish-plugin.md | 2 +- website/docs/guide/README.md | 2 +- 3 files changed, 7 insertions(+), 6 deletions(-) diff --git a/website/docs/advanced/README.md b/website/docs/advanced/README.md index 2d6fd630..ed1065f1 100644 --- a/website/docs/advanced/README.md +++ b/website/docs/advanced/README.md @@ -36,7 +36,7 @@ options: 2. **调用 `API`**, 在**事件处理**的过程中，`nonebot` 可以通过 `bot` 调用协议端指定的 `API` 来获取更多数据，或者反馈响应给协议端; `nonebot` 也可以通过调用 `API` 向协议端主动请求数据或者主动推送数据。 -在**指南**模块， 我们已经叙述了[如何配置 nonebot](../guide/basic-configuration.md), [如何注册协议适配器](../guide/getting-started.md)，[如何加载插件](../guide/loading-a-plugin.md), 在这里便不再赘述。 + 下面，我们将对**事件处理**， **调用 API**进行说明。 @@ -44,7 +44,7 @@ options: 我们可以先看事件处理的流程图： -![handle-event](../guide/images/Handle-Event.png) + 在流程图里，我们可以看到，`nonebot` 会有三个阶段来处理事件： @@ -94,14 +94,15 @@ options: 关于`hook`的更多信息，可以查阅[这里](./runtime-hook.md) ::: -2. **Matcher**与**matcher**，在**指南**中，我们讲述了[如何注册事件响应器](../guide/creating-a-matcher.md)，这里的事件响应器或者说 `Matcher` 并不是一个具体的实例 `instance`，而是一个具有特定属性的类 `class`。只有当 `Matcher` **响应事件**时，才会实例化为具体的 `instance`，也就是 `matcher`。`matcher` 可以认为是 `nonebot` 处理 `Event` 的基本单位，运行 `matcher` 是`nonebot`工作的主要内容。 + 3. **handler**，或者说**事件处理函数**, 它们可以认为是 `nonebot` 处理 `Event` 的最小单位。在不考虑 `hook` 的情况下，**运行 matcher 就是顺序运行 matcher.handlers**，这句话换种表达方式就是，`handler` 只有添加到 `matcher.handlers` 时，才可以参与到 `nonebot` 的工作中来。 ::: tip 如何让 `handler` 添加到 `matcher.handlers`？ - 一方面，我们可以参照[这里](../guide/creating-a-handler.md)利用装饰器来添加；另一方面，我们在用 `on()` 或者 `on_*()` 注册事件响应器时，可以添加 `handlers=[handler1, handler2, ...]` 这样的关键词参数来添加。 + + ::: #### 处理 Event diff --git a/website/docs/advanced/publish-plugin.md b/website/docs/advanced/publish-plugin.md index 2de8293a..16c51324 100644 --- a/website/docs/advanced/publish-plugin.md +++ b/website/docs/advanced/publish-plugin.md @@ -9,7 +9,7 @@ options: ## 前注 -本章节仅包含插件发布流程指导，插件开发请查阅 **[创建插件](../guide/creating-a-plugin.md)** 章节与 **[Plugin API 文档](../api/plugin.md)** 。 + ## 插件发布流程 diff --git a/website/docs/guide/README.md b/website/docs/guide/README.md index 49306739..66312529 100644 --- a/website/docs/guide/README.md +++ b/website/docs/guide/README.md @@ -7,7 +7,7 @@ slug: /guide # 概览 :::tip 提示 -初次使用时可能会觉得这里的概览过于枯燥，可以先简单略读之后直接前往 [安装](./installation.md) 查看安装方法，并进行后续的基础使用教程。 +初次使用时可能会觉得这里的概览过于枯燥，可以先简单略读之后直接前往 [安装](./start/installation.md) 查看安装方法，并进行后续的基础使用教程。 ::: NoneBot2 是一个可扩展的 Python 异步机器人框架，它会对机器人收到的事件进行解析和处理，并以插件化的形式，按优先级分发给事件所对应的事件响应器，来完成具体的功能。