docs.yml

name: Docs

on:
  merge_group:
  push:
    branches:
      - master
    paths:
      - 'src/**'
      - 'docs/**'
      - 'presentation/**'
      - '.github/workflows/docs.yml'
  pull_request:
    branches:
      - master
    paths:
      - 'src/**'
      - 'docs/**'
      - 'presentation/**'
      - '.github/workflows/docs.yml'

concurrency:
  group: docs-${{ github.ref }}
  cancel-in-progress: true

permissions:
  contents: write

jobs:
  create_documentation:
    runs-on: ubuntu-24.04
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Fetch tags
        run: git fetch --prune --unshallow --tags

      - name: Update apt
        run: sudo apt -q update

      - name: Install dependencies
        run: sudo apt install -y cmake ninja-build catch2 unixodbc-dev sqlite3 libsqlite3-dev libsqliteodbc valgrind uuid-dev g++-14 libyaml-cpp-dev doxygen

      - name: CMake configure
        run: cmake --preset linux-gcc-release -D LIGHTWEIGHT_BUILD_DOCUMENTATION=ON

      - name: Build documentation
        run: cmake --build --preset linux-gcc-release --target doc

      # Build presentation
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install presentation dependencies
        working-directory: presentation
        run: npm ci

      - name: Build presentation
        working-directory: presentation
        run: npm run build

      # Copy presentation to docs output
      - name: Copy presentation to docs
        run: cp -r presentation/dist html/presentation

      - name: Deploy
        uses: JamesIves/github-pages-deploy-action@v4
        with:
          folder: html