doc: VuePress infrastructure upgrade

Author: mrdrivingduck

.github/workflows/docs-build.yml

@@ -23,7 +23,7 @@ jobs:
       - name: setup pnpm
         uses: pnpm/action-setup@v3
         with:
-          version: 8
+          version: 10
       - name: setup Node.js
         uses: actions/setup-node@v4
         with:

.github/workflows/docs-format-check.yml

@@ -18,7 +18,7 @@ jobs:
       - name: setup pnpm
         uses: pnpm/action-setup@v3
         with:
-          version: 8
+          version: 10
       - name: setup Node.js
         uses: actions/setup-node@v4
         with:

polar-doc/docs/.vuepress/config.ts

@@ -2,7 +2,8 @@ import { defineUserConfig } from "vuepress";
 import { path } from "vuepress/utils";
 import { defaultTheme } from "@vuepress/theme-default";
 import { docsearchPlugin } from "@vuepress/plugin-docsearch";
-import { mdEnhancePlugin } from "vuepress-plugin-md-enhance";
+import { markdownMathPlugin } from "@vuepress/plugin-markdown-math";
+import { markdownExtPlugin } from "@vuepress/plugin-markdown-ext";
 import { registerComponentsPlugin } from "@vuepress/plugin-register-components";
 import { navbar, sidebar } from "./configs";
 import { viteBundler } from "@vuepress/bundler-vite";
@@ -124,8 +125,10 @@ export default defineUserConfig({
         },
       },
     }),
-    mdEnhancePlugin({
-      katex: true,
+    markdownMathPlugin({
+      type: "katex",
+    }),
+    markdownExtPlugin({
       footnote: true,
     }),
     registerComponentsPlugin({

polar-doc/docs/.vuepress/styles/index.scss

@@ -1,19 +1,14 @@
+// === colors ===
 :root {
   scroll-behavior: smooth;
 
-  // brand colors
-  --c-brand: #fc5207;
-  --c-brand-light: #fc5207;
+  // accent colors
+  --vp-c-accent: #fc5207;
+  --vp-c-accent-bg: #fc5207;
+  --vp-c-accent-hover: #fc5207;
 
-  --c-tip: #fc5207;
+  --badge-c-tip-text: #fc5207;
+  --badge-c-tip-bg: #fc51072c;
 
   --content-width: 1020px;
 }
-
-html.dark {
-  // brand colors
-  --c-brand: #fc5207;
-  --c-brand-light: #fc5207;
-
-  --c-tip: #fc5207;
-}

polar-doc/docs/README.md

@@ -11,8 +11,8 @@ footer: Apache 2.0 Licensed | Copyright © Alibaba Group, Inc.
 
 Pull the [local instance image](https://hub.docker.com/r/polardb/polardb_pg_local_instance/tags) of PolarDB for PostgreSQL based on local storage. Create and run the container, and try PolarDB-PG instance directly:
 
-:::: code-group
-::: code-group-item DockerHub
+::: code-tabs
+@tab DockerHub
 
 ```bash:no-line-numbers
 # pull the instance image and run the container
@@ -26,8 +26,7 @@ postgres=# SELECT version();
 (1 row)
 ```
 
-:::
-::: code-group-item Alibaba Cloud ACR
+@tab Alibaba Cloud ACR
 
 ```bash:no-line-numbers
 # pull the instance image and run the container
@@ -42,4 +41,3 @@ postgres=# SELECT version();
 ```
 
 :::
-::::

polar-doc/docs/deploying/db-localfs.md

@@ -16,22 +16,20 @@ minute: 15
 
 我们已提供 PolarDB-PG 的 [单机实例镜像](https://hub.docker.com/r/polardb/polardb_pg_local_instance/tags)，里面已包含启动 PolarDB-PG 单机实例的入口脚本。
 
-:::: code-group
-::: code-group-item DockerHub
+::: code-tabs
+@tab DockerHub
 
 ```bash:no-line-numbers
 docker pull polardb/polardb_pg_local_instance:15
 ```
 
-:::
-::: code-group-item 阿里云 ACR
+@tab 阿里云 ACR
 
 ```bash:no-line-numbers
 docker pull registry.cn-hangzhou.aliyuncs.com/polardb_pg/polardb_pg_local_instance:15
 ```
 
 :::
-::::
 
 ## 初始化数据库
 
@@ -43,8 +41,8 @@ docker pull registry.cn-hangzhou.aliyuncs.com/polardb_pg/polardb_pg_local_instan
 
 使用如下命令初始化数据库：
 
-:::: code-group
-::: code-group-item DockerHub
+::: code-tabs
+@tab DockerHub
 
 ```bash:no-line-numbers
 docker run -it --rm \
@@ -57,8 +55,7 @@ docker run -it --rm \
     echo 'done'
 ```
 
-:::
-::: code-group-item 阿里云 ACR
+@tab 阿里云 ACR
 
 ```bash:no-line-numbers
 docker run -it --rm \
@@ -72,14 +69,13 @@ docker run -it --rm \
 ```
 
 :::
-::::
 
 ## 启动数据库服务
 
 数据库初始化完毕后，使用 `-d` 参数以后台模式创建容器，启动 PolarDB-PG 服务。通常 PolarDB-PG 的端口需要暴露给外界使用，使用 `-p` 参数将容器内的端口范围暴露到容器外。比如，初始化数据库时使用的是 `5432-5434` 端口，如下命令将会把这三个端口映射到容器外的 `54320-54322` 端口：
 
-:::: code-group
-::: code-group-item DockerHub
+::: code-tabs
+@tab DockerHub
 
 ```bash:no-line-numbers
 docker run -d \
@@ -89,8 +85,7 @@ docker run -d \
     polardb/polardb_pg_local_instance:15
 ```
 
-:::
-::: code-group-item 阿里云 ACR
+@tab 阿里云 ACR
 
 ```bash:no-line-numbers
 docker run -d \
@@ -101,12 +96,11 @@ docker run -d \
 ```
 
 :::
-::::
 
 或者也可以直接让容器与宿主机共享网络：
 
-:::: code-group
-::: code-group-item DockerHub
+::: code-tabs
+@tab DockerHub
 
 ```bash:no-line-numbers
 docker run -d \
@@ -116,8 +110,7 @@ docker run -d \
     polardb/polardb_pg_local_instance:15
 ```
 
-:::
-::: code-group-item 阿里云 ACR
+@tab 阿里云 ACR
 
 ```bash:no-line-numbers
 docker run -d \
@@ -128,4 +121,3 @@ docker run -d \
 ```
 
 :::
-::::

polar-doc/docs/deploying/fs-pfs.md

@@ -16,8 +16,8 @@ PolarDB File System，简称 PFS 或 PolarFS，是由阿里云自主研发的高
 
 推荐使用 PolarDB-PG 的 [可执行文件镜像](https://hub.docker.com/r/polardb/polardb_pg_binary/tags)，其中已经包含了编译完毕的 PFS 工具，无需手动编译安装。通过以下命令进入容器即可：
 
-:::: code-group
-::: code-group-item DockerHub
+::: code-tabs
+@tab DockerHub
 
 ```shell:no-line-numbers
 docker pull polardb/polardb_pg_binary:15
@@ -31,8 +31,7 @@ docker run -it \
     bash
 ```
 
-:::
-::: code-group-item 阿里云 ACR
+@tab 阿里云 ACR
 
 ```shell:no-line-numbers
 docker pull registry.cn-hangzhou.aliyuncs.com/polardb_pg/polardb_pg_binary:15
@@ -46,7 +45,6 @@ docker run -it \
 ```
 
 :::
-::::
 
 PFS 的手动编译安装方式请参考 PFS 的 [README](https://github.com/ApsaraDB/polardb-file-system/blob/master/Readme-CN.md)，此处不再赘述。
 

polar-doc/docs/deploying/quick-start.md

@@ -27,8 +27,8 @@ minute: 5
 
 拉取 PolarDB for PostgreSQL 的 [单机实例镜像](https://hub.docker.com/r/polardb/polardb_pg_local_instance/tags)，运行容器并试用 PolarDB-PG：
 
-:::: code-group
-::: code-group-item DockerHub
+::: code-tabs
+@tab DockerHub
 
 ```bash:no-line-numbers
 # 拉取镜像并运行容器
@@ -42,8 +42,7 @@ postgres=# SELECT version();
 (1 row)
 ```
 
-:::
-::: code-group-item 阿里云 ACR
+@tab 阿里云 ACR
 
 ```bash:no-line-numbers
 # 拉取镜像并运行容器
@@ -58,4 +57,3 @@ postgres=# SELECT version();
 ```
 
 :::
-::::

polar-doc/docs/development/customize-dev-env.md

@@ -25,8 +25,8 @@ PolarDB-PG 提供已经构建完毕的开发镜像 [`polardb/polardb_pg_devel`](
 
 通过如下方式即可拉取相应发行版的镜像：
 
-:::: code-group
-::: code-group-item DockerHub
+::: code-tabs
+@tab DockerHub
 
 ```bash:no-line-numbers
 docker pull polardb/polardb_pg_devel:centos7
@@ -38,8 +38,7 @@ docker pull polardb/polardb_pg_devel:ubuntu22.04
 docker pull polardb/polardb_pg_devel:ubuntu24.04
 ```
 
-:::
-::: code-group-item 阿里云 ACR
+@tab 阿里云 ACR
 
 ```bash:no-line-numbers
 docker pull registry.cn-hangzhou.aliyuncs.com/polardb_pg/polardb_pg_devel:centos7
@@ -52,6 +51,5 @@ docker pull registry.cn-hangzhou.aliyuncs.com/polardb_pg/polardb_pg_devel:ubuntu
 ```
 
 :::
-::::
 
 另外，也提供了构建上述开发镜像的 [Dockerfile](https://github.com/ApsaraDB/polardb-pg-docker-images)，您可以根据自己的需要在 Dockerfile 中添加更多依赖，然后构建自己的开发镜像。

polar-doc/docs/development/dev-on-docker.md

@@ -12,22 +12,20 @@ minute: 10
 
 从 [GitHub](https://github.com/ApsaraDB/PolarDB-for-PostgreSQL) 上下载 PolarDB for PostgreSQL 的源代码，稳定分支为 `POLARDB_15_STABLE`：
 
-:::: code-group
-::: code-group-item GitHub
+::: code-tabs
+@tab GitHub
 
 ```bash:no-line-numbers
 git clone -b POLARDB_15_STABLE https://github.com/ApsaraDB/PolarDB-for-PostgreSQL.git
 ```
 
-:::
-::: code-group-item Gitee
+@tab Gitee
 
 ```bash:no-line-numbers
 git clone -b POLARDB_15_STABLE https://gitee.com/mirrors/PolarDB-for-PostgreSQL
 ```
 
 :::
-::::
 
 代码克隆完毕后，进入源码目录：
 
@@ -39,22 +37,20 @@ cd PolarDB-for-PostgreSQL/
 
 拉取 PolarDB-PG 的 [开发镜像](https://hub.docker.com/r/polardb/polardb_pg_devel/tags)。
 
-:::: code-group
-::: code-group-item DockerHub
+::: code-tabs
+@tab DockerHub
 
 ```bash:no-line-numbers
 docker pull polardb/polardb_pg_devel:ubuntu24.04
 ```
 
-:::
-::: code-group-item 阿里云 ACR
+@tab 阿里云 ACR
 
 ```bash:no-line-numbers
 docker pull registry.cn-hangzhou.aliyuncs.com/polardb_pg/polardb_pg_devel:ubuntu24.04
 ```
 
 :::
-::::
 
 ## 创建并运行容器
 
@@ -63,8 +59,8 @@ docker pull registry.cn-hangzhou.aliyuncs.com/polardb_pg/polardb_pg_devel:ubuntu
 - 在容器内的环境中编译源码
 - 在容器外（开发机器上）使用编辑器来查看或修改代码
 
-:::: code-group
-::: code-group-item DockerHub
+::: code-tabs
+@tab DockerHub
 
 ```bash:no-line-numbers
 docker run -it \
@@ -75,8 +71,7 @@ docker run -it \
     bash
 ```
 
-:::
-::: code-group-item 阿里云 ACR
+@tab 阿里云 ACR
 
 ```bash:no-line-numbers
 docker run -it \
@@ -88,7 +83,6 @@ docker run -it \
 ```
 
 :::
-::::
 
 进入容器后，为容器内用户获取源码目录的权限，然后编译部署 PolarDB-PG 实例。