Fix deployment of mdbook export to GitHub pages (#397)

* Update GitHub Action workflows

This fixes the deployment.

* Fix links in SUMMARY

* Also run mdbook build on every PR

This should save us from failing builds in the future.

Author: rnestler

.github/workflows/gh-pages.yml

@@ -6,13 +6,13 @@ on:
       - main
 jobs:
   deploy:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     concurrency:
       group: ${{ github.workflow }}-${{ github.ref }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Setup mdBook
-        uses: peaceiris/actions-mdbook@v1
+        uses: peaceiris/actions-mdbook@v2
         with:
           mdbook-version: 'latest'
       - name: Emojify Book
@@ -23,7 +23,7 @@ jobs:
           find . -type f -name "*.md" -exec ./gh-actions-emojitsu emojify -i {} \;
       - run: mdbook build
       - name: Deploy
-        uses: peaceiris/actions-gh-pages@v3
+        uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./book

.github/workflows/linting.yml

@@ -9,12 +9,27 @@ on:
       - main
 jobs:
   lint:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     concurrency:
       group: ${{ github.workflow }}-${{ github.ref }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1
         with:
           bundler-cache: true # runs 'bundle install' and caches installed gems automatically
       - run: bin/check
+  build-mdbook:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup mdBook
+        uses: peaceiris/actions-mdbook@v2
+        with:
+          mdbook-version: 'latest'
+      - name: Emojify Book
+        run: |
+          set -x
+          wget --no-verbose https://github.com/shonfeder/emojitsu/releases/download/0.1.1/gh-actions-emojitsu
+          chmod +x gh-actions-emojitsu
+          find . -type f -name "*.md" -exec ./gh-actions-emojitsu emojify -i {} \;
+      - run: mdbook build

SUMMARY.md

@@ -19,7 +19,8 @@
       - [Push to Git Repository](ruby_on_rails/first_git_push.md)
       - [Initialise Gitflow](ruby_on_rails/initialise_gitflow.md)
       - [Configure Git Repository](configure_git_repository.md)
-      - [Create an Application Server](ruby_on_rails/create_application_server.md)
+      - [Create an Application Server (Heroku)](ruby_on_rails/create_application_server_heroku.md)
+      - [Create an Application Server (Deploio)](ruby_on_rails/create_application_server_deploio.md)
       - [Configure the CI/CD](ruby_on_rails/configure_ci.md)
   - [Tools]()
       - [RSpec](ruby_on_rails/rspec.md)