Execute jekyll manually (#10)

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

@@ -1,17 +1,17 @@
-# Sample workflow for building and deploying a Jekyll site to GitHub Pages
-name: Deploy Jekyll with GitHub Pages dependencies preinstalled
+name: Deploy Docs
 
 on:
-  # Runs on pushes targeting the default branch
   push:
     branches: ["main"]
     paths:
       - "docs/**"
 
-  # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+defaults:
+  run:
+    working-directory: docs
+
 permissions:
   contents: read
   pages: write
@@ -24,23 +24,27 @@ concurrency:
   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.3"
+          bundler-cache: true
+          cache-version: 1
       - name: Setup Pages
+        id: pages
         uses: actions/configure-pages@v5
       - name: Build with Jekyll
-        uses: actions/jekyll-build-pages@v1
-        with:
-          source: ./docs
-          destination: ./_site
+        run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
+        env:
+          JEKYLL_ENV: production
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
 
-  # Deployment job
   deploy:
     environment:
       name: github-pages

docs/Gemfile

@@ -1,6 +1,6 @@
 source 'https://rubygems.org'
 
-# gem "jekyll", "~> 4.3.4" # installed by `gem jekyll`
+gem "jekyll", "~> 4.3.4" # installed by `gem jekyll`
 # gem "webrick"        # required when using Ruby >= 3 and Jekyll <= 4.2.2
 
 gem "just-the-docs", "0.10.0" # pinned to the current release

docs/Gemfile.lock

@@ -71,11 +71,12 @@ GEM
     rexml (3.3.7)
     rouge (4.3.0)
     safe_yaml (1.0.5)
-    sass-embedded (1.78.0)
-      google-protobuf (~> 4.27)
-      rake (>= 13)
     sass-embedded (1.78.0-arm64-darwin)
       google-protobuf (~> 4.27)
+    sass-embedded (1.78.0-x86_64-linux-gnu)
+      google-protobuf (~> 4.27)
+    sass-embedded (1.78.0-x86_64-linux-musl)
+      google-protobuf (~> 4.27)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
     unicode-display_width (2.6.0)
@@ -87,6 +88,7 @@ PLATFORMS
   x86_64-linux-musl
 
 DEPENDENCIES
+  jekyll (~> 4.3.4)
   just-the-docs (= 0.10.0)
 
 BUNDLED WITH