Update admonitions syntax

docs/developer-guide/annotations-form.md

@@ -6,7 +6,7 @@ title: 元数据表单定义
 
 定义元数据编辑表单同样使用 `FormKit Schema`，但和主题或插件的定义方式稍有不同，其中输入组件类型可参考 [表单定义](./form-schema.md)。
 
-:::info 提示
+:::info[提示]
 因为 `metadata.annotations` 是一个键值都为字符串类型的对象，所以表单项的值必须为字符串类型。这就意味着，FormKit 的 `number`、`group`、`repeater` 等类型的输入组件都不能使用。`checkbox` 类型的输入组件应通过 `on-value` 和 `off-value` 指定字符串值，以替代默认的布尔值。
 :::
 

docs/developer-guide/core/run.md

@@ -15,7 +15,7 @@ description: 开发环境运行的指南
 2. UI，包括 Console 控制台和 UC 个人中心（托管在 Halo 主项目）
 3. 主题（Halo 主项目内已包含默认主题）
 
-:::info 说明
+:::info[说明]
 从 Halo 2.11 开始，Halo 项目的 `ui` 目录同时包含了 Console（管理控制台）和 UC（个人中心），以下统称为 UI。
 
 当前 Halo 主项目并不会将 UI 的构建资源托管到 Git 版本控制，所以在开发环境是需要同时运行 UI 项目的。当然，在我们的最终发布版本的时候会在 CI 中自动构建 UI 到 Halo 主项目。
@@ -56,7 +56,7 @@ VITE v8.0.0  ready in 805 ms
 ➜  Network: http://192.168.1.7:3000/
 ```
 
-:::info 提示
+:::info[提示]
 请不要直接使用 UI 的运行端口 3000 访问，会因为跨域问题导致无法正常登录，建议按照后续的步骤以 dev 的配置文件运行 Halo，在 dev 的配置文件中，我们默认代理了 UI 页面的访问地址，所以后续访问 UI 页面使用 `http://localhost:8090/console` 和 `http://localhost:8090/uc` 访问即可，代理的相关配置：
 
 ```yaml

docs/developer-guide/plugin/api-reference/server/extension-getter.md

@@ -47,7 +47,7 @@ public interface ExtensionGetter {
 2. `getEnabledExtensions(Class<T> extensionPoint)`: 根据传入的扩展点类获取所有已启用扩展。如果没有在扩展设置页面配置过则会返回所有可用的扩展。
 3. `getExtensions(Class<T> extensionPointClass)`: 获取所有与扩展点类相关的扩展，无论是否在扩展设置中启用它。
 
-:::tip Note
+:::tip
 使用 `getEnabledExtension` 方法或者 `getEnabledExtensions` 方法取决于扩展点声明的 `type` 是 `SINGLETON` 还是 `MULTI_INSTANCE`。
 
 通过使用 `ExtensionGetter`，开发者可以轻松地在插件中访问和管理各种扩展点，提升插件的功能和灵活性。

docs/developer-guide/plugin/api-reference/server/extension.md

@@ -210,7 +210,7 @@ Halo 默认会为每个自定义模型建立以下几个索引，因此不需要
 
 创建了索引的字段可以在查询时使用 `fieldSelector` 参数来查询，参考 [自定义模型 API](#extension-apis)。
 
-:::tip Note
+:::tip
 
 - 索引是一种存储数据结构，可提供对数据集中字段的高效查找。
 - 索引将自定义模型中的字段映射到数据库行，以便在查询特定字段时不需要完整的扫描。

docs/developer-guide/plugin/api-reference/ui/api-request.md

@@ -65,6 +65,6 @@ axiosInstance.get("/apis/foo.halo.run/v1alpha1/bar").then(response => {
 
 此外，在最新的 `@halo-dev/ui-plugin-bundler-kit@2.17.0` 中，已经排除了 `@halo-dev/api-client`、`axios` 依赖，所以最终产物中的相关依赖会自动使用 Halo 本身提供的依赖，无需关心最终产物大小。
 
-:::info 提醒
+:::info[提醒]
 如果插件中使用了 `@halo-dev/api-client@2.17.0` 和 `@halo-dev/ui-plugin-bundler-kit@2.17.0`，需要提升 `plugin.yaml` 中的 `spec.requires` 版本为 `>=2.17.0`。
 :::

docs/developer-guide/plugin/api-reference/ui/components/attachment-selector-modal.md

@@ -5,7 +5,7 @@ description: 附件选择组件
 
 此组件用于调出附件选择器，以供用户选择附件。
 
-:::info 注意
+:::info[注意]
 此组件当前仅在 Console 中可用。
 :::
 

docs/developer-guide/plugin/api-reference/ui/route.md

@@ -94,7 +94,7 @@ export interface RouteRecordAppend {
     - `PostsRoot`（文章）
     - `NotificationsRoot`（消息）
 
-:::info 提示
+:::info[提示]
 `RouteRecordRaw` 来自 Vue Router，详见 [API 文档 | Vue Router](https://router.vuejs.org/zh/api/#Type-Aliases-RouteRecordRaw)
 :::
 

docs/developer-guide/plugin/basics/manifest.md

@@ -98,7 +98,7 @@ halo:
       - C:\path\to\halo-plugin-hello-world
 ```
 
-:::tip Note
+:::tip
 
 1. `development` 开发模式下，既可以运行 `fixed-plugin-path` 下的插件，也可以运行通过 `Console` 管理端安装的 JAR 格式的插件。
 2. 如果使用 [DevTools 运行方式](../hello-world.md#run-with-devtools) 来开发插件，则不需要配置 `runtime-mode` 和 `fixed-plugin-path`。

docs/developer-guide/plugin/basics/server/lifecycle.md

@@ -27,7 +27,7 @@ public void delete() {
 1. 继承 `run.halo.app.plugin.BasePlugin` 类后，你可以重写这些方法来干预插件的生命周期，例如在插件启动时初始化一些资源，在插件停止时清理掉这些资源。
 2. 一个插件项目只允许有一个类继承 `BasePlugin` 类且标记为 Bean，此时这个类将被作为插件的后端入口，如果有多个类继承了 `BasePlugin` 会导致插件无法启动或生命周期方法无法被调用。
 
-:::tip Note
+:::tip
 如果一个类继承了 `BasePlugin` 类但没有标记为 Bean，那么它将不会被 Halo 识别到，其中的生命周期方法也不会被调用。
 :::
 

docs/developer-guide/plugin/basics/structure.md

@@ -53,7 +53,7 @@ description: 了解插件项目的文件结构
 - `plugin.yaml`：这是插件的描述文件，位于 `src/main/resources` 目录下。该文件是必须的，包含插件的基本信息，如插件名称、版本、作者、描述以及依赖等内容。
 - `resources/console`：该文件夹通常包含前端部分打包后生成的文件，包括 main.js（JavaScript 文件）和 style.css（样式表）。如果插件不包含前端部分，此目录可以忽略。
 
-:::warning 注意
+:::warning[注意]
 从 2.11 开始，Halo 支持了 UC 个人中心，且个人中心和 Console 的插件机制共享，所以为了避免歧义，`resources/console` 在后续版本会被重命名为 `resources/ui`，但同时也会兼容 `resources/console`。
 :::
 

docs/developer-guide/plugin/extension-points/server/index.md

@@ -48,7 +48,7 @@ spec:
   description: "Support sending notifications to users via email"
 ```
 
-:::tip Note
+:::tip
 单实例或多实例的扩展点需要声明对应的 `ExtensionPointDefinition` 自定义模型对象被称之为扩展点定义，用于描述该扩展点的信息，例如：扩展点的名称、描述、扩展点的类型等。
 
 单实例或多实例扩展点的实现也必须声明一个对应的 `ExtensionDefinition` 自定义模型对象被称之为扩展定义，用于描述该扩展的信息，例如：扩展的名称、描述、对应扩展点的对象名称等。

docs/developer-guide/plugin/extension-points/ui/comment-subject-ref-create.md

@@ -5,7 +5,7 @@ description: 扩展评论来源显示 - comment:subject-ref:create
 
 Console 的评论管理列表的评论来源默认仅支持显示来自文章和页面的评论，如果其他插件中的业务模块也使用了评论，那么就可以通过该拓展点来扩展评论来源的显示。
 
-:::info 提示
+:::info[提示]
 此扩展点需要后端配合使用，请参考 [评论主体展示](../server/comment-subject.md)。
 :::
 

docs/developer-guide/plugin/extension-points/ui/default-editor-extension-create.md

@@ -17,7 +17,7 @@ export default definePlugin({
 });
 ```
 
-:::info 提示
+:::info[提示]
 AnyExtension 类型来自 [Tiptap](https://github.com/ueberdosis/tiptap)，这意味着 Halo 默认编辑器的扩展点返回类型与 Tiptap 的扩展完全一致，Tiptap 的扩展文档可参考：[https://tiptap.dev/docs/editor/api/extensions](https://tiptap.dev/docs/editor/api/extensions)。此外，Halo 也为默认编辑器的扩展提供了一些独有的参数，用于实现工具栏、指令等扩展。
 :::
 

docs/developer-guide/plugin/security/role-template.md

@@ -46,7 +46,7 @@ rules:
 - 以 `/api` 开头，且以 `/api/<version>/<resource>[/<resourceName>/<subresource>]` 规则组成 APIs，最少路径层级为 3 即 `/api/<version>/<resource>`，最多路径层级为 5 即包含 `<resourceName>` 和 `<subresource>`，例如 `/api/v1/posts`。
 - 以 `/apis/<group>/<version>/<resource>[/<resourceName>/<subresource>]` 规则组成的 APIs，最少路径层级为 4 即 `/apis/<group>/<version>/<resource>`，最多路径层级为 6 即包含 `<resourceName>` 和 `<subresource>`，例如 `/apis/my-plugin.halo.run/v1alpha1/persons`。
 
-:::info 注
+:::info[注意]
 `[]`包裹的部分表示可选，`/api` 前缀被 Halo 保留，不允许插件定义以 `/api` 开头的资源型 APIs，所以插件的资源型 APIs 都是以 `/apis` 开头的。
 :::
 

docs/developer-guide/restful-api/api-client.md

@@ -13,7 +13,7 @@ description: 介绍使用 API Client 请求库发起 API 请求的方式
 pnpm install @halo-dev/api-client axios
 ```
 
-:::info 提示
+:::info[提示]
 推荐在项目中引入 TypeScript，可以获得更好的类型提示。
 :::
 
@@ -107,6 +107,6 @@ coreApiClient.content.post.listPost().then(response => {
 })
 ```
 
-:::info 提示
+:::info[提示]
 认证方式的说明请参考：[认证方式](./introduction.md#认证方式)
 :::

docs/developer-guide/theme/finder-apis/category.md

@@ -12,7 +12,7 @@ import CategoryTreeVo from "../vo/_CategoryTreeVo.md"
 categoryFinder.getByName(name)
 ```
 
-:::info 提示
+:::info[提示]
 通常建议配合 [主题设置](../settings.md) 和 [分类选择器](../../form-schema.md#categoryselect) 使用，让用户自行选择所需的分类。
 :::
 
@@ -42,7 +42,7 @@ categoryFinder.getByName(name)
 categoryFinder.getByNames(names)
 ```
 
-:::info 提示
+:::info[提示]
 通常建议配合 [主题设置](../settings.md) 和 [分类选择器](../../form-schema.md#categoryselect) 使用，让用户自行选择所需的分类。
 :::
 

docs/developer-guide/theme/finder-apis/post.md

@@ -72,7 +72,7 @@ postFinder.cursor(postName);
 
 根据文章的 `metadata.name` 获取相邻的文章（上一篇 / 下一篇）。
 
-:::info 提示
+:::info[提示]
 上一篇文章是指发布时间较当前文章更早的文章，下一篇文章是指发布时间较当前文章更新的文章。
 :::
 

docs/developer-guide/theme/finder-apis/tag.md

@@ -11,7 +11,7 @@ import TagVo from "../vo/_TagVo.md"
 tagFinder.getByName(name)
 ```
 
-:::info 提示
+:::info[提示]
 通常建议配合 [主题设置](../settings.md) 和 [标签选择器](../../form-schema.md#tagselect) 使用，让用户自行选择所需的标签。
 :::
 
@@ -41,7 +41,7 @@ tagFinder.getByName(name)
 tagFinder.getByNames(names)
 ```
 
-:::info 提示
+:::info[提示]
 通常建议配合 [主题设置](../settings.md) 和 [标签选择器](../../form-schema.md#tagselect) 使用，让用户自行选择所需的标签。
 :::
 

docs/developer-guide/theme/prepare.md

@@ -53,11 +53,11 @@ spec:
       url: "https://github.com/halo-sigs/theme-foo/blob/main/LICENSE"
 ```
 
-:::info 提示
+:::info[提示]
 主题的配置文件详细文档请参考 [配置文件](./config.md)。
 :::
 
-:::info 提示
+:::info[提示]
 主题项目的目录结构请参考 [主题目录结构](./structure.md)。
 :::
 
@@ -69,7 +69,7 @@ spec:
 - [halo-sigs/theme-vite-starter](https://github.com/halo-dev/theme-vite-starter) - 与 Vite 集成的主题模板，由 Vite 负责资源构建。
 - [halo-sigs/theme-astro-starter](https://github.com/halo-sigs/theme-astro-starter) - 以 Astro 作为预渲染框架的主题模板。
 
-:::info 提示
+:::info[提示]
 以上 GitHub 都被设置为了模板仓库（Template repository），点击仓库主页的 `Use this template` 按钮即可通过此模板创建一个新的仓库。
 
 创建新的主题仓库并克隆到本地开发环境之后，需要确保主题文件夹名称和 `theme.yaml` 中的 `metadata.name` 字段一致，否则可能导致部分资源无法正常加载。

docs/developer-guide/theme/static-resources.md

@@ -24,7 +24,7 @@ description: 本文档介绍主题的静态资源的引用方法。
 
 以上方式仅支持在 HTML 标签中使用，且必须使用 `@{}` 包裹才能渲染为正确的路径。如果需要在非 HTML 标签中得到正确的路径，我们提供了 `#theme.assets()` API。
 
-:::info 注意
+:::info[注意]
 需要注意的是，调用 `#theme.assets()` 的时候，资源地址不需要添加 `/assets/`。
 :::
 
@@ -50,6 +50,6 @@ function loadScript(url) {
 </script>
 ```
 
-:::info 提示
+:::info[提示]
 关于在 JavaScript 中使用 Thymeleaf 语法可以参考 Thymeleaf 官方文档：[JavaScript inlining](https://www.thymeleaf.org/doc/tutorials/3.1/usingthymeleaf.html#javascript-inlining)
 :::

docs/developer-guide/theme/template-route-mapping.md

@@ -79,7 +79,7 @@ customTemplates:
 
 最终使用者即可在文章设置、独立页面设置、分类设置中选择自定义模板。
 
-:::info 提示
+:::info[提示]
 
 1. 自定义模板与默认模板的功能相同，区别仅在于可以让使用者选择不同于默认模板风格的模板。
 2. 自定义模板的文件名需要以 `.html` 结尾，且需要在 `/templates/` 目录下创建。

docs/developer-guide/theme/template-tag.md

@@ -51,6 +51,6 @@ Halo 为满足部分代码注入和模板扩展点的需求，提供了一些专
 </footer>
 ```
 
-:::info 注意
+:::info[注意]
 为了保证 Halo 的功能完整性，建议主题开发者尽可能在主题中实现此标签。
 :::

docs/developer-guide/theme/template-variables/error.md

@@ -8,7 +8,7 @@ description: 关于错误页面的模板变量
 - 模板路径：`/templates/error/{404,4xx,500,5xx,error}.html`
 - 访问路径：无固定访问路径，由异常决定
 
-:::info 提示
+:::info[提示]
 错误页面的可使用模板由状态码决定，例如 404 状态码对应的模板为 `/templates/error/404.html` 或者 `/templates/error/4xx.html`。也可以使用 `/templates/error/error.html` 作为默认模板。
 
 识别顺序如下：

docs/getting-started/install/1panel.md

@@ -74,11 +74,11 @@ import DockerArgs from "./slots/_docker-args.md"
 
 ## 升级 Halo
 
-:::info 提示
+:::info[提示]
 当 Halo 发布新版本之后，并不会在 1Panel 的应用商店中实时查看到新版本，通常需要等待一段时间才会显示，这取决于 1Panel 的应用商店更新频率。
 :::
 
-:::warning 注意
+:::warning[注意]
 目前 1Panel 不支持在升级应用的时候查看应用的更新日志，所以建议在升级前前往 [Halo 版本发布](https://releases.halo.run/) 查看对应版本的更新日志，了解新版本的变化。
 :::
 

docs/getting-started/install/cloud/alibaba-cloud-market.md

@@ -39,7 +39,7 @@ Halo 目前已上架至阿里云云市场，助力用户打造高效便捷的建
 
 首次访问会进入 Halo 初始化页面，填写初始化信息即可完成 Halo 的安装。
 
-:::info 提示
+:::info[提示]
 Halo 初始化文档可查阅：[初始化](../../setup.md)
 :::
 

docs/getting-started/install/config.md

@@ -133,7 +133,7 @@ Web 服务相关：
 | Oracle（付费版） | `r2dbc:pool:oracle://{HOST}:{PORT}/{DATABASE}`                                     | oracle                     |
 | H2 Database      | `r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE` | h2                         |
 
-:::warning 商城版需要注意
+:::warning[商城版需要注意]
 由于商城版的数据结构与 Halo 其他版本不同，所以暂时仅支持 PostgreSQL、MySQL、MariaDB、H2。
 :::
 

docs/getting-started/install/helm.md

@@ -66,7 +66,7 @@ To access your Halo site from outside the cluster follow the steps below:
   echo Password: $(kubectl get secret --namespace halo halo -o jsonpath="{.data.halo-password}" | base64 -d)
 ```
 
-:::info 参数说明
+:::info[参数说明]
 
 - 使用 Halo Helm Chart 仓库中 [values.yaml](https://github.com/halo-sigs/charts/blob/main/charts/halo/values.yaml) 文件中的默认参数进行安装；
 - 关于 PostgreSQL 数据库的更多参数说明，请参考 [Bitnami PostgreSQL Chart](https://github.com/bitnami/charts/tree/main/bitnami/postgresql#parameters)，在原有参数格式上增加 `postgresql.` 前缀即可。
@@ -88,7 +88,7 @@ To access your Halo site from outside the cluster follow the steps below:
 helm install halo halo/halo --set mysql.enabled=true --set postgresql.enabled=false
 ```
 
-:::info 参数说明
+:::info[参数说明]
 
 - `mysql.enabled=true`：自动安装 MySQL 数据库；
 - `postgresql.enabled=false`：不自动安装 PostgreSQL 数据库；
@@ -111,7 +111,7 @@ helm install halo halo/halo \
     --set externalDatabase.database=halo
 ```
 
-:::info 参数说明
+:::info[参数说明]
 
 - `mysql.enabled=true`：不自动安装 MySQL 数据库；
 - `postgresql.enabled=false`：不自动安装 PostgreSQL 数据库；

docs/getting-started/install/jar-file.md

@@ -127,7 +127,7 @@ title: 使用 JAR 文件部署
    | Oracle（付费版）   | `r2dbc:pool:oracle://{HOST}:{PORT}/{DATABASE}`                                     | oracle                     |
    | H2 Database        | `r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE` | h2                         |
 
-   :::warning 商城版需要注意
+   :::warning[商城版需要注意]
    由于商城版的数据结构与 Halo 其他版本不同，所以暂时仅支持 PostgreSQL、MySQL、MariaDB、H2。
    :::
 

docs/getting-started/install/slots/_docker-args.md

@@ -16,7 +16,7 @@
 | Oracle（付费版）   | `r2dbc:pool:oracle://{HOST}:{PORT}/{DATABASE}`                                     | oracle                     |
 | H2 Database        | `r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE` | h2                         |
 
-:::warning 商城版需要注意
+:::warning[商城版需要注意]
 由于商城版的数据结构与 Halo 其他版本不同，所以暂时仅支持 PostgreSQL、MySQL、MariaDB、H2。
 :::
 

docs/getting-started/prepare.md

@@ -76,7 +76,7 @@ Halo 目前支持以下数据库：
 
 其中，H2 不需要单独运行，其他数据库需要单独安装并配置。一般情况下，推荐按照 [使用 Docker Compose 部署](./install/docker-compose.md) 文档将 Halo 和数据库容器编排在一起。
 
-:::warning 商城版需要注意
+:::warning[商城版需要注意]
 由于商城版的数据结构与 Halo 其他版本不同，所以暂时仅支持 PostgreSQL、MySQL、MariaDB、H2。
 :::
 

docs/user-guide/activate.md

@@ -82,7 +82,7 @@ description: 介绍如何激活 Halo 付费版
 
 ![激活付费应用](/img/user-guide/activate/app-activate.png)
 
-:::info 提示
+:::info[提示]
 如果你在激活前就启动了插件，那么在激活后可能需要重启插件才会生效。
 :::
 

docs/user-guide/app-store.md

@@ -7,7 +7,7 @@ description: 内置应用市场的使用说明
 
 如果你使用了旧版本的 Halo，并且当前未安装应用市场插件，可以访问 [https://www.halo.run/store/apps/app-VYJbF](https://www.halo.run/store/apps/app-VYJbF) 手动下载并在 Console 的插件管理中安装。
 
-:::info 提示
+:::info[提示]
 这是目前唯一由 Halo 官方提供的服务，如果你当前的 Halo 网站处于无法访问公网的环境或者不需要此功能，你可以卸载或者停用此插件，不会影响网站的正常使用。
 :::
 

docs/user-guide/backup.md

@@ -7,7 +7,7 @@ description: 备份与恢复功能说明
 
 ## 备份
 
-:::warning 商城版注意事项
+:::warning[商城版注意事项]
 因为商城相关的功能数据存储结构不同，所以备份和恢复功能暂不支持商城相关的数据，建议直接备份数据库。
 
 所以如果你使用了 Halo 商城版的商城功能，备份文件不会包含商城相关的数据。
@@ -39,7 +39,7 @@ description: 备份与恢复功能说明
 
 ## 恢复
 
-:::info 在恢复前，需要了解以下几点：
+:::info[在恢复前，需要了解以下几点：]
 
 1. 恢复不限制部署方式，也不限制数据库，也就是说新站点的部署方式和数据库类型可以和备份的站点不同。
 2. 恢复过程可能会持续较长时间，期间请勿刷新页面。
@@ -59,7 +59,7 @@ Halo 支持三种恢复方式：
 2. 远程恢复：从远程 URL 下载备份文件进行恢复。
 3. 从备份文件恢复：支持从 [工作目录](../getting-started/prepare.md#工作目录) 的 backups 目录扫描备份文件，并选择文件进行恢复。
 
-:::info 提示
+:::info[提示]
 如果你的备份文件较大，推荐提前将备份文件上传到服务器，然后选择 `从备份文件恢复` 方式进行恢复，避免因为网络原因导致上传失败。
 :::