modify pr-preview to show the exact running result

Author: yuanyl630

.github/workflows/pr-preview.yml

@@ -20,14 +20,16 @@ jobs:
           repository: ${{ github.event.pull_request.head.repo.full_name }}
           path: ivorysql_doc
 
-      - name: Fetch All Relevant Branches into Local Docs Repo
-        working-directory: ./ivorysql_doc
-        run: |
-          echo "Fetching all branches from origin to update local remote-tracking branches..."
-          git fetch origin --prune --no-tags
-          
-          echo "--- Fetched Remote-Tracking Branches ---"
-          git branch -r 
+      # Skip fetching other branches for PR preview to avoid conflicts
+      # The PR HEAD is already checked out and we only want to build that version
+      # - name: Fetch All Relevant Branches into Local Docs Repo
+      #   working-directory: ./ivorysql_doc
+      #   run: |
+      #     echo "Fetching all branches from origin to update local remote-tracking branches..."
+      #     git fetch origin --prune --no-tags
+      #     
+      #     echo "--- Fetched Remote-Tracking Branches ---"
+      #     git branch -r 
 
       - name: Checkout Doc Builder Repository (doc_builder)
         uses: actions/checkout@v4
@@ -46,13 +48,22 @@ jobs:
       - name: Modify Antora Playbooks for Local PR Build
         working-directory: ./ivory-doc-builder
         env:
-          DETECTED_VERSION: 'master'
+          PR_BASE_REF: ${{ github.event.pull_request.base.ref }}
           START_PAGE_COMPONENT_NAME: "ivorysql-doc"
           START_PAGE_FILE_PATH: "welcome.adoc"
         run: |
           PLAYBOOK_FILES=("antora-playbook-CN.yml" "antora-playbook-EN.yml")
           NEW_LOCAL_URL="../ivorysql_doc"
 
+          # Extract version from PR base branch (e.g., v5.1 -> 5.1)
+          if [[ "$PR_BASE_REF" =~ ^v([0-9]+\.[0-9]+) ]]; then
+            DETECTED_VERSION="${BASH_REMATCH[1]}"
+            echo "Detected version from PR base branch $PR_BASE_REF: $DETECTED_VERSION"
+          else
+            DETECTED_VERSION="master"
+            echo "Using default version: master (PR base: $PR_BASE_REF)"
+          fi
+
           for PLAYBOOK_FILE in "${PLAYBOOK_FILES[@]}"; do
             if [ -f "$PLAYBOOK_FILE" ]; then
               echo "--- Modifying Playbook: $PLAYBOOK_FILE ---"
@@ -65,13 +76,27 @@ jobs:
               yq -i ".content.sources[0].branches = [\"HEAD\"]" "$PLAYBOOK_FILE"
               
               yq -i ".content.sources[0].edit_url = false" "$PLAYBOOK_FILE"
-              if [[ -n "$DETECTED_VERSION" ]]; then
-                NEW_START_PAGE="${START_PAGE_COMPONENT_NAME}::${DETECTED_VERSION}/${START_PAGE_FILE_PATH}"
+              
+              # Disable runtime fetch to ensure we use local files
+              yq -i ".runtime.fetch = false" "$PLAYBOOK_FILE"
+              
+              if [[ -n "$DETECTED_VERSION" && "$DETECTED_VERSION" != "master" ]]; then
+                # v5.1+ uses flat structure (no version prefix in path)
+                # v5.0 and earlier use nested structure (version prefix in path)
+                # Use version comparison: if DETECTED_VERSION >= 5.1, use flat structure
+                if [[ "$(printf '%s\n' "5.1" "$DETECTED_VERSION" | sort -V | head -n1)" == "5.1" ]]; then
+                  # For v5.1+: ivorysql-doc:v5.1:welcome.adoc (no version prefix in path)
+                  NEW_START_PAGE="${START_PAGE_COMPONENT_NAME}:v${DETECTED_VERSION}:${START_PAGE_FILE_PATH}"
+                else
+                  # For v5.0 and earlier: ivorysql-doc:v5.0:v5.0/welcome.adoc (with version prefix)
+                  NEW_START_PAGE="${START_PAGE_COMPONENT_NAME}:v${DETECTED_VERSION}:v${DETECTED_VERSION}/${START_PAGE_FILE_PATH}"
+                fi
                 yq -i ".site.start_page = \"$NEW_START_PAGE\"" "$PLAYBOOK_FILE"
                 echo "Updated .site.start_page in $PLAYBOOK_FILE to: $NEW_START_PAGE"
               else
-                echo "WARNING: DETECTED_VERSION is empty. Skipping start_page update for $PLAYBOOK_FILE."
+                echo "INFO: DETECTED_VERSION is '$DETECTED_VERSION'. Keeping original playbook start_page configuration."
               fi
+              
               yq -i ".site.title = .site.title + \" (PR Preview)\"" "$PLAYBOOK_FILE"
               echo "Modified content of $PLAYBOOK_FILE:"
               cat "$PLAYBOOK_FILE"