feat: update sync docs

Author: xiaoyu2er

.github/workflows/update-en-docs.yml renamed to .github/workflows/sync-docs.yml

@@ -1,4 +1,4 @@
-name: Update Next.js English Documentation
+name: Sync Next.js Official Documentation
 
 on:
   workflow_dispatch: # Manual trigger
@@ -13,61 +13,71 @@ permissions:
   pull-requests: write
 
 jobs:
-  update-docs:
-    name: Update Next.js Docs
+  check-branch:
+    name: Check if PR branch exists
     runs-on: ubuntu-latest
+    outputs:
+      should_sync: ${{ steps.check_branch.outputs.should_sync }}
     steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
       - name: Check if PR branch exists
         id: check_branch
         run: |
-          if git ls-remote --heads origin "docs/sync-nextjs-documentation" | grep -q "docs/sync-nextjs-documentation"; then
+          if git ls-remote --heads https://github.com/${{ github.repository }}.git | grep -q "docs/sync-nextjs-documentation"; then
             echo "Branch already exists, skipping update"
-            echo "branch_exists=true" >> $GITHUB_OUTPUT
+            echo "should_sync=false" >> $GITHUB_OUTPUT
           else
             echo "Branch does not exist, proceeding with update"
-            echo "branch_exists=false" >> $GITHUB_OUTPUT
+            echo "should_sync=true" >> $GITHUB_OUTPUT
           fi
 
+  sync-docs:
+    name: Sync Next.js Docs
+    runs-on: ubuntu-latest
+    needs: check-branch
+    if: needs.check-branch.outputs.should_sync == 'true'
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
       - name: Clone Next.js repository (canary)
-        if: steps.check_branch.outputs.branch_exists == 'false'
         run: |
           git clone --depth 1 --branch canary --single-branch https://github.com/vercel/next.js.git nextjs-canary
           mkdir -p apps/docs/content/en/docs
           rsync -av --delete nextjs-canary/docs/ apps/docs/content/en/docs/ --exclude="13" --exclude="14"
           rm -rf nextjs-canary
 
       - name: Clone Next.js repository (v14.2.28)
-        if: steps.check_branch.outputs.branch_exists == 'false'
         run: |
           git clone --depth 1 --branch v14.2.28 --single-branch https://github.com/vercel/next.js.git nextjs-v14
           mkdir -p apps/docs/content/en/docs/14
           rsync -av --delete nextjs-v14/docs/ apps/docs/content/en/docs/14/
           rm -rf nextjs-v14
 
       - name: Clone Next.js repository (v13.5.11)
-        if: steps.check_branch.outputs.branch_exists == 'false'
         run: |
           git clone --depth 1 --branch v13.5.11 --single-branch https://github.com/vercel/next.js.git nextjs-v13
           mkdir -p apps/docs/content/en/docs/13
           rsync -av --delete nextjs-v13/docs/ apps/docs/content/en/docs/13/
           rm -rf nextjs-v13
 
+      - name: Setup Tools
+        uses: ./.github/actions/setup
+ 
+      - name: Sync blog & learn
+        run: |
+          node packages/crawler/dist/index.js
+
       - name: Find available translation locales
-        if: steps.check_branch.outputs.branch_exists == 'false'
         id: find_locales
         run: |
           cd apps/docs/content
-          LOCALES=$(find . -maxdepth 1 -type d | grep -v "^.$" | grep -v "/en$" | sed 's|^\./||')
+          LOCALES=$(find . -maxdepth 1 -type d | grep -v "^.$" | grep -v "/en$" | sed 's|^\./||' | tr '\n' ' ' | sed 's/ $//')
           echo "Available translation locales: $LOCALES"
           echo "locales=$LOCALES" >> $GITHUB_OUTPUT
       
       - name: Stage changes to detect renames
-        if: steps.check_branch.outputs.branch_exists == 'false'
         run: |
           # Stage all changes so Git can detect renames
           git add .
@@ -76,13 +86,12 @@ jobs:
           git status --porcelain
 
       - name: Process file renames and deletions
-        if: steps.check_branch.outputs.branch_exists == 'false'
         run: |
           # Get list of renamed files from git status
-          RENAMES=$(git status --porcelain | grep -E "^R[[:space:]]+apps/docs/content/en/docs" | sed 's/^R[[:space:]]*//')
+          RENAMES=$(git status --porcelain | grep -E "^R[[:space:]]+apps/docs/content/en" | sed 's/^R[[:space:]]*//')
           
           # Get list of deleted files from git status
-          DELETES=$(git status --porcelain | grep -E "^D[[:space:]]+apps/docs/content/en/docs" | sed 's/^D[[:space:]]*//')
+          DELETES=$(git status --porcelain | grep -E "^D[[:space:]]+apps/docs/content/en" | sed 's/^D[[:space:]]*//')
           
           # Generate current timestamp in ISO format
           CURRENT_TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
@@ -184,7 +193,6 @@ jobs:
           fi
 
       - name: Check for modifications
-        if: steps.check_branch.outputs.branch_exists == 'false'
         id: check_changes
         run: |
           if [[ $(git status --porcelain | grep -E "apps/docs/content/" | wc -l) -gt 0 ]]; then
@@ -196,7 +204,7 @@ jobs:
           fi
 
       - name: Create Pull Request
-        if: steps.check_branch.outputs.branch_exists == 'false' && steps.check_changes.outputs.has_changes == 'true'
+        if: steps.check_changes.outputs.has_changes == 'true'
         uses: peter-evans/create-pull-request@v5
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
@@ -207,6 +215,8 @@ jobs:
             - Updates from `canary` branch to `apps/docs/content/en/docs`
             - Updates from `v14.2.28` branch to `apps/docs/content/en/docs/14`
             - Updates from `v13.5.11` branch to `apps/docs/content/en/docs/13`
+            - Updates blog to `apps/docs/content/en/blog`
+            - Updates learn to `apps/docs/content/en/learn`
           branch: docs/sync-nextjs-documentation
           delete-branch: true
           base: main

package.json

@@ -18,7 +18,8 @@
     "docs:dev": "pnpm --filter @next-i18n/docs dev",
     "docs:build": "pnpm --filter @next-i18n/docs build",
     "docs:start": "pnpm --filter @next-i18n/docs start",
-    "docs:update-search-index": "pnpm --filter @next-i18n/docs update-search-index"
+    "docs:update-search-index": "pnpm --filter @next-i18n/docs update-search-index",
+    "crawler": "node packages/crawler/dist/index.js"
   },
   "keywords": [],
   "devDependencies": {

packages/crawler/src/util.ts

@@ -22,7 +22,7 @@ export async function writeFiles(learns: Writeable[]) {
     try {
       await fs$.mkdir(dirname, { recursive: true });
       await fs$.writeFile(fileName, learn.content);
-      console.log(`Written file to ${fileName}`);
+      console.log(`Write file to ${fileName}`);
     } catch (error) {
       console.error(`Failed to write file ${learn.filename}:`, error);
     }