gh-pages-mdbook.yml

name: Build & Deploy mdBook documentation

on:
  workflow_dispatch:
  push:
    branches:
      - main

jobs:
  build-docs:
    name: Build
    runs-on: ubuntu-22.04
    steps:
      - uses: actions/checkout@v4
      - uses: extractions/setup-just@v2
      - name: Setup mdBook
        uses: peaceiris/actions-mdbook@v2
      - name: Install Dependencies
        shell: bash
        run: sudo apt-get install -y libwayland-dev libxkbcommon-dev # Required for winit
      - name: Build
        working-directory: docs/mdbook
        shell: bash
        run: mdbook build
      - uses: actions/upload-artifact@v4
        with:
          name: book
          path: docs/mdbook/book/

  deploy-docs:
    needs: build-docs
    name: Deploy
    runs-on: ubuntu-22.04
    steps:
      - uses: actions/checkout@v4
      - name: Download book
        uses: actions/download-artifact@v4
        with:
          name: book
          path: artifacts/book
      - name: Deploy
        uses: JamesIves/github-pages-deploy-action@v4.6.3
        with:
          branch: gh-pages
          folder: artifacts/book
          target-folder: docs/book