ci(pages): update GitHub Actions to artifact-v4-compatible workflow

Signed-off-by: https://github.com/Someshdiwan <[email protected]>

Author: Someshdiwan

.github/workflows/jekyll-gh-pages.yml

@@ -1,4 +1,4 @@
-name: "Deploy Jekyll with GitHub Pages (robust: Gemfile auto-detect)"
+name: "Deploy Jekyll with GitHub Pages (robust)"
 
 on:
   push:
@@ -7,7 +7,8 @@ on:
       - master
   workflow_dispatch: {}
   schedule:
-    - cron: '0 12 * * *'
+    # Run daily at 3:00 AM IST (21:30 UTC previous day)
+    - cron: '30 21 * * *'
 
 permissions:
   contents: read
@@ -22,71 +23,82 @@ jobs:
   build:
     name: Build site (Jekyll)
     runs-on: ubuntu-latest
+    timeout-minutes: 30
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
           submodules: true
           fetch-depth: 0
 
+      - name: Setup Pages (configure Pages environment)
+        uses: actions/configure-pages@v5
+
       - name: Detect Gemfile location
-        id: gemfile
+        id: detect_gemfile
         run: |
-          # Prefer site/Gemfile if it exists
           if [ -f "site/Gemfile" ]; then
-            echo "gemfile_dir=site" >> $GITHUB_OUTPUT
-            echo "Found Gemfile in site/ directory."
+            echo "gem_dir=site" >> $GITHUB_OUTPUT
+            echo "Found Gemfile in site/"
           elif [ -f "Gemfile" ]; then
-            echo "gemfile_dir=." >> $GITHUB_OUTPUT
-            echo "Found Gemfile in repo root."
+            echo "gem_dir=." >> $GITHUB_OUTPUT
+            echo "Found Gemfile in repo root"
           else
-            echo "No Gemfile found in repo root or site/ — failing early."
-            ls -la
-            exit 2
+            echo "gem_dir=NONE" >> $GITHUB_OUTPUT
+            echo "No Gemfile found in site/ or repo root — will use Jekyll builder action fallback."
           fi
 
-      - name: Setup Ruby (for Jekyll)
+      # If Gemfile exists, set up Ruby + Bundler and build with bundle exec
+      - name: Set up Ruby (only when Gemfile present)
+        if: ${{ steps.detect_gemfile.outputs.gem_dir != 'NONE' }}
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: '3.2'
-          bundler-cache: false   # we use explicit cache step below
+          bundler-cache: false
 
-      - name: Cache bundler gems (auto target)
+      - name: Cache bundler gems (only when Gemfile present)
+        if: ${{ steps.detect_gemfile.outputs.gem_dir != 'NONE' }}
         uses: actions/cache@v4
         id: cache-bundler
         with:
           path: vendor/bundle
-          # If Gemfile.lock is under site/, use that; else root path is used.
-          key: ${{ runner.os }}-gems-${{ steps.gemfile.outputs.gemfile_dir }}-${{ hashFiles(format('{0}/Gemfile.lock', steps.gemfile.outputs.gemfile_dir)) }}
+          key: ${{ runner.os }}-gems-${{ steps.detect_gemfile.outputs.gem_dir }}-${{ hashFiles(format('{0}/Gemfile.lock', steps.detect_gemfile.outputs.gem_dir)) }}
           restore-keys: |
-            ${{ runner.os }}-gems-${{ steps.gemfile.outputs.gemfile_dir }}-
+            ${{ runner.os }}-gems-${{ steps.detect_gemfile.outputs.gem_dir }}-
 
-      - name: Install Ruby gems (bundle install)
+      - name: Install Ruby gems with Bundler (only when Gemfile present)
+        if: ${{ steps.detect_gemfile.outputs.gem_dir != 'NONE' }}
         run: |
-          echo "Using Gemfile from: ${{ steps.gemfile.outputs.gemfile_dir }}"
-          cd ${{ steps.gemfile.outputs.gemfile_dir }}
+          echo "Using Gemfile from: ${{ steps.detect_gemfile.outputs.gem_dir }}"
+          cd ${{ steps.detect_gemfile.outputs.gem_dir }}
           bundle config set --local path 'vendor/bundle'
+          # retry logic to cope with transient network errors
           bundle install --jobs 4 --retry 3
         shell: bash
 
-      - name: Build Jekyll site
+      - name: Build site with Bundler (only when Gemfile present)
+        if: ${{ steps.detect_gemfile.outputs.gem_dir != 'NONE' }}
         run: |
-          echo "Building Jekyll from site/ to _site/"
-          # If your Jekyll source is in 'site', build from there; otherwise build from repository root.
-          if [ "${{ steps.gemfile.outputs.gemfile_dir }}" = "site" ]; then
-            cd site
-            bundle exec jekyll build --source . --destination ../_site
-          else
-            bundle exec jekyll build --source site --destination _site || bundle exec jekyll build --destination _site
-          fi
+          cd ${{ steps.detect_gemfile.outputs.gem_dir }}
+          echo "Building Jekyll with bundle exec..."
+          bundle exec jekyll build --source . --destination ../_site
         env:
           JEKYLL_ENV: production
         shell: bash
 
-      - name: Validate build
+      # Fallback: if there's no Gemfile, use the jekyll-build-pages action (best-effort)
+      - name: Build with actions/jekyll-build-pages (fallback)
+        if: ${{ steps.detect_gemfile.outputs.gem_dir == 'NONE' }}
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./site
+          destination: ./_site
+
+      - name: Validate _site exists
         run: |
           if [ ! -d "_site" ]; then
             echo "_site wasn't generated — failing the job."
+            ls -la
             exit 1
           fi
 
@@ -104,10 +116,10 @@ jobs:
       name: github-pages
     steps:
       - name: Deploy to GitHub Pages
-        id: deploy
+        id: deployment
         uses: actions/deploy-pages@v4
         with:
           artifact_name: java-evolution-pages
 
-      - name: Announce deploy URL
-        run: echo "Deployed to ${{ steps.deploy.outputs.page_url }}"
+      - name: Output deploy URL
+        run: echo "Deployed to ${{ steps.deployment.outputs.page_url }}"