ci: add mutli version support

Author: SWHL

.github/workflows/ci.yml .github/workflows/docs_build_develop.yml.github/workflows/ci.yml renamed to .github/workflows/docs_build_develop.yml

@@ -1,4 +1,4 @@
-name: ci
+name: Build/Publish Develop Docs
 on:
   push:
     branches:
@@ -25,5 +25,7 @@ jobs:
           path: .cache
           restore-keys: |
             mkdocs-material-
-      - run: pip install mkdocs-material jieba mkdocs-git-revision-date-localized-plugin mkdocs-git-committers-plugin-2
-      - run: mkdocs gh-deploy --force
+      - run: pip install mike mkdocs-material jieba mkdocs-git-revision-date-localized-plugin mkdocs-git-committers-plugin-2 mkdocs-static-i18n
+      - run: |
+          git fetch origin gh-pages --depth=1
+          mike deploy --push --update-aliases main latest

.github/workflows/docs_build_release.yml

@@ -0,0 +1,31 @@
+name: Build/Publish Release Docs
+on:
+  push:
+    tags:
+      - v*
+
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email github-actions[bot]@users.noreply.github.com
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+      - run: pip install mike mkdocs-material jieba mkdocs-git-revision-date-localized-plugin mkdocs-git-committers-plugin-2 mkdocs-static-i18n
+      - run: |
+          git fetch origin gh-pages --depth=1
+          mike deploy --push "${{ github.ref_name }}"