Fix Jekyll build workflow for Just the Docs theme

- Use Ruby setup with bundler for proper gem installation
- Install just-the-docs gem directly
- Build from docs folder
- Use theme: instead of remote_theme:

Author: prajwalendra

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

@@ -1,44 +1,70 @@
-# Sample workflow for building and deploying a Jekyll site to GitHub Pages
-name: Deploy Jekyll with GitHub Pages dependencies preinstalled
+# Build and deploy Jekyll site with Just the Docs theme to GitHub Pages
+name: Deploy Documentation
 
 on:
-  # Runs on pushes targeting the default branch
   push:
     branches: ["main"]
-
-  # Allows you to run this workflow manually from the Actions tab
+    paths:
+      - 'docs/**'
+      - '.github/workflows/jekyll-gh-pages.yml'
   workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:
   contents: read
   pages: write
   id-token: write
 
-# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
-# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
 concurrency:
   group: "pages"
   cancel-in-progress: false
 
 jobs:
-  # Build job
   build:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+          bundler-cache: true
+          working-directory: docs
+
+      - name: Create Gemfile
+        run: |
+          cd docs
+          cat > Gemfile << 'EOF'
+          source "https://rubygems.org"
+          gem "jekyll", "~> 4.3"
+          gem "just-the-docs", "~> 0.10.1"
+          gem "jekyll-seo-tag"
+          gem "jekyll-sitemap"
+          gem "jekyll-relative-links"
+          EOF
+
+      - name: Install dependencies
+        run: |
+          cd docs
+          bundle install
+
       - name: Setup Pages
+        id: pages
         uses: actions/configure-pages@v5
+
       - name: Build with Jekyll
-        uses: actions/jekyll-build-pages@v1
-        with:
-          source: ./
-          destination: ./_site
+        run: |
+          cd docs
+          bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
+        env:
+          JEKYLL_ENV: production
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_site
 
-  # Deployment job
   deploy:
     environment:
       name: github-pages

docs/_config.yml

@@ -10,12 +10,11 @@ url: "https://aws-samples.github.io"
 repository: aws-samples/sample-bedrock-agentcore-gateway-user-federation
 
 # Theme - Just the Docs for left navigation
-remote_theme: just-the-docs/just-the-docs@v0.10.1
+theme: just-the-docs
 color_scheme: light
 
 # Plugins
 plugins:
-  - jekyll-remote-theme
   - jekyll-seo-tag
   - jekyll-sitemap
   - jekyll-relative-links