📝 migrate admonition title syntax to Docusaurus v3 bracket form

This commit is contained in:
StarHeartHunt
2026-07-22 22:59:41 +08:00
parent 3ffdedb8e2
commit 972bfe623b
143 changed files with 358 additions and 358 deletions
@@ -178,7 +178,7 @@ op.drop_table("weather_weather") # DROP TABLE weather_weather;
对了,不要忘记还有一段注释:`commands auto generated by Alembic - please adjust!`。
它在提醒我们,这些代码是由 Alembic 自动生成的,我们应该检查它们,并且根据需要进行调整。
:::warning 注意
:::warning[注意]
迁移脚本冗长且繁琐,我们一般不会手写它们,而是由 Alembic 自动生成。
一般情况下,Alembic 足够智能,可以正确地生成迁移脚本。
但是,在复杂或有歧义的情况下,我们可能需要手动调整迁移脚本。
@@ -235,7 +235,7 @@ async def _(session: async_scoped_session, args: Message = CommandArg()):
`async_scoped_session` 是一个有作用域限制的会话,作用域为当前事件、当前事件响应器。
会话产生的模型实例(例如此处的 `wea := await session.get(Weather, location)`)作用域与会话相同。
:::warning 注意
:::warning[注意]
此处提到的“会话”指的是 ORM 会话,而非 [NoneBot 会话](../../../appendices/session-control),两者的生命周期也是不同的(NoneBot 会话的生命周期中可能包含多个事件,不同的事件也会有不同的事件响应器)。
具体而言,就是不要将 ORM 会话和模型实例存储在 NoneBot 会话状态中:
+2 -2
View File
@@ -8,7 +8,7 @@ description: 用户指南
`nonebot-plugin-orm` 功能强大且复杂,使用上有一定难度。
不过,对于用户而言,只需要掌握部分功能即可。
:::warning 注意
:::warning[注意]
请注意区分插件的项目名(如:`nonebot-plugin-wordcloud`)和模块名(如:`nonebot_plugin_wordcloud`)。`nonebot-plugin-orm` 中统一使用插件模块名。参见 [插件命名规范](../../developer/plugin-publishing#插件命名规范)。
:::
@@ -152,7 +152,7 @@ SQLALCHEMY_ENGINE_OPTIONS='{
SQLALCHEMY_ECHO=true
```
:::warning 注意
:::warning[注意]
以上配置之间有覆盖关系,遵循特殊优先于一般的原则,具体为 [`sqlalchemy_database_url`](#sqlalchemy_database_url) > [`sqlalchemy_bind`](#sqlalchemy_bind) > [`sqlalchemy_echo`](#sqlalchemy_echo) > [`sqlalchemy_engine_options`](#sqlalchemy_engine_options)。
但覆盖顺序并非显而易见,出于清晰考虑,请只配置必要的选项。
:::