📝 Docs: 升级 docusaurus 3.8.1 (#3649)

.prettierignore

@@ -1 +1,2 @@
 .github/**/*.md
+website/docs/tutorial/application.mdx

website/docs/best-practice/alconna/matcher.mdx

@@ -150,7 +150,7 @@ async def handle(
 
 - `xxx: CommandResult`
 - `xxx: Arparma`：命令的[解析结果](./command.md#解析结果)
-- `xxx: Duplication`：命令的解析结果的 [`Duplication`](./command.md#Duplication)
+- `xxx: Duplication`：命令的解析结果的 [`Duplication`](./command.md#duplication)
 - `xxx: Alconna`：命令的源命令
 - `<key>: Match[<type>]`：上述的匹配项，使用 `key` 作为查询路径
 - `xxx: Query[<type>] = Query(<path>, default)`：上述的查询项，必需声明默认值以设置查询路径 `path`

website/docs/best-practice/alconna/uniseg/utils.mdx

@@ -159,7 +159,7 @@ async def _(target: MsgTarget):
 
 事实上，构造 `Target` 对象时，`self_id`, `scope`, `adapter` 和 `platform` 都会参与到 `selector` 的构造中。
 
-::tip
+:::tip
 
 你其实可以使用 `Target` 来帮你筛选 `Bot` 对象：
 

website/docs/best-practice/multi-adapter.mdx

@@ -42,7 +42,7 @@ async def handle_function():
 
 #### 处理近似事件
 
-对于一系列**差异不大**的事件，我们往往具有相同的处理逻辑。这时，我们不希望将相同的逻辑编写两遍，而应该复用代码，以实现在同一个事件处理函数中处理多个近似事件。我们可以使用[事件重载](../advanced/dependency.mdx#Event)的特性来实现这一功能。例如：
+对于一系列**差异不大**的事件，我们往往具有相同的处理逻辑。这时，我们不希望将相同的逻辑编写两遍，而应该复用代码，以实现在同一个事件处理函数中处理多个近似事件。我们可以使用[事件重载](../advanced/dependency.mdx#event)的特性来实现这一功能。例如：
 
 <Tabs groupId="python">
   <TabItem value="3.10" label="Python 3.10+" default>

website/docs/best-practice/testing/behavior.mdx

@@ -163,7 +163,7 @@ async def test_example(app: App):
    - `**kwargs`：send 方法的额外参数。
 
 2. `should_call_api`
-   定义事件响应器预期调用的平台 API 接口，即通过[调用平台 API](../../appendices/api-calling.mdx#调用平台-API)进行的操作。`should_call_api` 有四个参数：
+   定义事件响应器预期调用的平台 API 接口，即通过[调用平台 API](../../appendices/api-calling.mdx#调用平台-api)进行的操作。`should_call_api` 有四个参数：
 
    - `api`：API 名称。
    - `data`：预期的请求数据。

website/docs/tutorial/application.mdx

@@ -33,7 +33,8 @@ import TabItem from "@theme/TabItem";
 
 1. （可选）创建虚拟环境，以 venv 为例
 
-   <Tabs groupId="platform"><TabItem value="windows" label="Windows" default>
+   <Tabs groupId="platform">
+   <TabItem value="windows" label="Windows" default>
 
    ```bash
    # 创建虚拟环境
@@ -42,7 +43,8 @@ import TabItem from "@theme/TabItem";
    .venv\Scripts\activate
    ```
 
-   </TabItem><TabItem value="linux/macos" label="Linux/macOS">
+   </TabItem>
+   <TabItem value="linux/macos" label="Linux/macOS">
 
    ```bash
    # 创建虚拟环境
@@ -51,23 +53,27 @@ import TabItem from "@theme/TabItem";
    source .venv/bin/activate
    ```
 
-   </TabItem></Tabs>
+   </TabItem>
+   </Tabs>
 
 2. 安装 nonebot2 以及驱动器，以 Fastapi 驱动器为例
 
-   <Tabs groupId="platform"><TabItem value="windows" label="Windows" default>
+   <Tabs groupId="platform">
+   <TabItem value="windows" label="Windows" default>
 
    ```bash
    pip install "nonebot2[fastapi]"
    ```
 
-   </TabItem><TabItem value="linux/macos" label="Linux/macOS">
+   </TabItem>
+   <TabItem value="linux/macos" label="Linux/macOS">
 
    ```bash
    pip install "nonebot2[fastapi]"
    ```
 
-   </TabItem></Tabs>
+   </TabItem>
+   </Tabs>
 
    驱动器包名可以在 [驱动器商店](/store/drivers) 中找到，请替换上文方括号中的内容。
 

website/docusaurus.config.ts

@@ -300,6 +300,7 @@ export default async function createConfigAsync() {
 
     future: {
       experimental_faster: true,
+      v4: true,
     },
 
     plugins: [

website/versioned_docs/version-2.4.1/best-practice/multi-adapter.mdx

@@ -40,7 +40,7 @@ async def handle_function():
 
 ### 处理近似事件
 
-对于一系列**差异不大**的事件，我们往往具有相同的处理逻辑。这时，我们不希望将相同的逻辑编写两遍，而应该复用代码，以实现在同一个事件处理函数中处理多个近似事件。我们可以使用[事件重载](../advanced/dependency.mdx#Event)的特性来实现这一功能。例如：
+对于一系列**差异不大**的事件，我们往往具有相同的处理逻辑。这时，我们不希望将相同的逻辑编写两遍，而应该复用代码，以实现在同一个事件处理函数中处理多个近似事件。我们可以使用[事件重载](../advanced/dependency.mdx#event)的特性来实现这一功能。例如：
 
 <Tabs groupId="python">
   <TabItem value="3.10" label="Python 3.10+" default>

website/versioned_docs/version-2.4.1/best-practice/testing/behavior.mdx

@@ -163,7 +163,7 @@ async def test_example(app: App):
    - `**kwargs`：send 方法的额外参数。
 
 2. `should_call_api`
-   定义事件响应器预期调用的平台 API 接口，即通过[调用平台 API](../../appendices/api-calling.mdx#调用平台-API)进行的操作。`should_call_api` 有四个参数：
+   定义事件响应器预期调用的平台 API 接口，即通过[调用平台 API](../../appendices/api-calling.mdx#调用平台-api)进行的操作。`should_call_api` 有四个参数：
 
    - `api`：API 名称。
    - `data`：预期的请求数据。

website/versioned_docs/version-2.4.2/best-practice/multi-adapter.mdx

@@ -40,7 +40,7 @@ async def handle_function():
 
 ### 处理近似事件
 
-对于一系列**差异不大**的事件，我们往往具有相同的处理逻辑。这时，我们不希望将相同的逻辑编写两遍，而应该复用代码，以实现在同一个事件处理函数中处理多个近似事件。我们可以使用[事件重载](../advanced/dependency.mdx#Event)的特性来实现这一功能。例如：
+对于一系列**差异不大**的事件，我们往往具有相同的处理逻辑。这时，我们不希望将相同的逻辑编写两遍，而应该复用代码，以实现在同一个事件处理函数中处理多个近似事件。我们可以使用[事件重载](../advanced/dependency.mdx#event)的特性来实现这一功能。例如：
 
 <Tabs groupId="python">
   <TabItem value="3.10" label="Python 3.10+" default>

website/versioned_docs/version-2.4.2/best-practice/testing/behavior.mdx

@@ -163,7 +163,7 @@ async def test_example(app: App):
    - `**kwargs`：send 方法的额外参数。
 
 2. `should_call_api`
-   定义事件响应器预期调用的平台 API 接口，即通过[调用平台 API](../../appendices/api-calling.mdx#调用平台-API)进行的操作。`should_call_api` 有四个参数：
+   定义事件响应器预期调用的平台 API 接口，即通过[调用平台 API](../../appendices/api-calling.mdx#调用平台-api)进行的操作。`should_call_api` 有四个参数：
 
    - `api`：API 名称。
    - `data`：预期的请求数据。

website/versioned_docs/version-2.4.3/best-practice/alconna/matcher.mdx

@@ -150,7 +150,7 @@ async def handle(
 
 - `xxx: CommandResult`
 - `xxx: Arparma`：命令的[解析结果](./command.md#解析结果)
-- `xxx: Duplication`：命令的解析结果的 [`Duplication`](./command.md#Duplication)
+- `xxx: Duplication`：命令的解析结果的 [`Duplication`](./command.md#duplication)
 - `xxx: Alconna`：命令的源命令
 - `<key>: Match[<type>]`：上述的匹配项，使用 `key` 作为查询路径
 - `xxx: Query[<type>] = Query(<path>, default)`：上述的查询项，必需声明默认值以设置查询路径 `path`

website/versioned_docs/version-2.4.3/best-practice/alconna/uniseg/utils.mdx

@@ -159,7 +159,7 @@ async def _(target: MsgTarget):
 
 事实上，构造 `Target` 对象时，`self_id`, `scope`, `adapter` 和 `platform` 都会参与到 `selector` 的构造中。
 
-::tip
+:::tip
 
 你其实可以使用 `Target` 来帮你筛选 `Bot` 对象：
 

website/versioned_docs/version-2.4.3/best-practice/multi-adapter.mdx

@@ -42,7 +42,7 @@ async def handle_function():
 
 #### 处理近似事件
 
-对于一系列**差异不大**的事件，我们往往具有相同的处理逻辑。这时，我们不希望将相同的逻辑编写两遍，而应该复用代码，以实现在同一个事件处理函数中处理多个近似事件。我们可以使用[事件重载](../advanced/dependency.mdx#Event)的特性来实现这一功能。例如：
+对于一系列**差异不大**的事件，我们往往具有相同的处理逻辑。这时，我们不希望将相同的逻辑编写两遍，而应该复用代码，以实现在同一个事件处理函数中处理多个近似事件。我们可以使用[事件重载](../advanced/dependency.mdx#event)的特性来实现这一功能。例如：
 
 <Tabs groupId="python">
   <TabItem value="3.10" label="Python 3.10+" default>

website/versioned_docs/version-2.4.3/best-practice/testing/behavior.mdx

@@ -163,7 +163,7 @@ async def test_example(app: App):
    - `**kwargs`：send 方法的额外参数。
 
 2. `should_call_api`
-   定义事件响应器预期调用的平台 API 接口，即通过[调用平台 API](../../appendices/api-calling.mdx#调用平台-API)进行的操作。`should_call_api` 有四个参数：
+   定义事件响应器预期调用的平台 API 接口，即通过[调用平台 API](../../appendices/api-calling.mdx#调用平台-api)进行的操作。`should_call_api` 有四个参数：
 
    - `api`：API 名称。
    - `data`：预期的请求数据。