[CI] Add Report Preview URLs Workflow

Author: ooooo-create

.github/workflows/preview-url-report.yml

@@ -0,0 +1,42 @@
+name: Report Preview URLs
+
+on:
+  pull_request:
+    branches: ["develop"]
+    paths:
+      - 'docs/**.rst'
+      - 'docs/**.md'
+
+jobs:
+  report-urls:
+    name: Report Preview URLs
+    runs-on: ubuntu-latest
+    if: github.repository_owner == 'PaddlePaddle'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Generate comment body
+        id: generate-comment
+        run: |
+          chmod +x ci_scripts/report_preview_url.sh
+          echo "comment_body=$(./ci_scripts/report_preview_url.sh ${{ github.event.pull_request.number }})" >> $GITHUB_OUTPUT
+
+      - name: Post or Update Comment
+        uses: peter-evans/find-comment@v4
+        id: fc
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          comment-author: 'github-actions[bot]'
+          body-includes: '本次 PR 文档预览链接'
+
+      - name: Create or Update Comment
+        uses: peter-evans/create-or-update-comment@v4
+        with:
+          comment-id: ${{ steps.fc.outputs.comment-id }}
+          issue-number: ${{ github.event.pull_request.number }}
+          body: ${{ steps.generate-comment.outputs.comment_body }}
+          edit-mode: replace

ci_scripts/report_preview_url.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+
+pr_id="$1"
+
+if [ -z "$pr_id" ]; then
+    echo "Error: Pull Request ID is not provided."
+    exit 1
+fi
+
+generate_preview_url() {
+    local file_path="$1"
+    local pr_id="$2"
+    local path_no_ext="${file_path%.*}"
+    local base_url="http://preview-pr-${pr_id}.paddle-docs-preview.paddlepaddle.org.cn/documentation/docs/zh/"
+    local final_url="${base_url}${path_no_ext}.html"
+    echo "$final_url"
+}
+
+mapfile -t all_git_files < <(git diff --name-only --diff-filter=ACMR upstream/develop | sed 's#^docs/##')
+
+output_lines=()
+
+for file in "${all_git_files[@]}"; do
+    if [[ "$file" == *.rst || "$file" == *.md ]]; then
+        url=$(generate_preview_url "$file" "$pr_id")
+        output_lines+=("- \`docs/${file}\`: [点击预览](${url})")
+    fi
+done
+
+if [ ${#output_lines[@]} -gt 0 ]; then
+    cat <<-EOF
+<details>
+<summary>📚 本次 PR 文档预览链接 (点击展开)</summary>
+
+以下是本次 PR 中变更文档的预览链接：
+
+$(printf '%s\n' "${output_lines[@]}")
+
+</details>
+EOF
+fi