update mike config

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+name: ci
+on:
+  push:
+    branches:
+      - develop
+      - release/1.0
+      - release/1.1
+      - release/1.2
+      - release/1.2.1
+      - deploy_in_gitpage
+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 "41898282+github-actions[bot]@users.noreply.github.com"
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.9
+      - 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 -r docs/requirements.txt
+      - run: pip install mike
+      - run: mkdocs gh-deploy --force
+
+      - name: Deploy documentation
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # 获取当前分支名称
+          BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+          # 根据分支名称部署相应的文档版本
+          if [ "$BRANCH" == "deploy_in_gitpage" ]; then
+            VERSION="latest"
+            mike deploy --push --update-aliases $VERSION
+            # 设置 latest 为默认版本
+            mike set-default --push latest
+          elif [ "$BRANCH" == "release/1.2" ]; then
+            VERSION="release-1.2"
+            mike deploy --push --update-aliases $VERSION
+          fi

mkdocs.yml

@@ -159,12 +159,18 @@ plugins:
   - mkdocstrings:
       handlers:
         python:
-          paths: [./ppsci]
+          setup_commands:
+            - import sys
+            - sys.path.append("../")
+          paths: [../ppsci]
+          selection:
+            new_path_syntax: true
   - mkdocs-video
   - git-revision-date-localized:
       enable_creation_date: true
       fallback_to_build_date: true
       type: date
+  - mike
 
 # Extensions
 markdown_extensions: