deploy_docs.yml

name: Build and Deploy Jekyll and Doxygen Documentation

on:
  push:
    branches:
      - gh-pages
  workflow_dispatch:

permissions:
  contents: write
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: false

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      # Checkout the gh-pages branch to have access to the existing docs directory
      - name: Checkout gh-pages
        uses: actions/checkout@v4
        with:
          ref: gh-pages
          fetch-depth: 0

      # Setup Pages environment and dependencies
      - name: Setup Pages
        uses: actions/configure-pages@v5

      # Build Jekyll Site
      - name: Build with Jekyll
        uses: actions/jekyll-build-pages@v1
        with:
          source: .
          destination: ./_site

      # Install Doxygen and Dependencies
      - name: Install Doxygen and Dependencies
        run: sudo apt-get update && sudo apt-get install -y doxygen graphviz texlive

      # Generate Doxygen Documentation
      - name: Generate Doxygen Documentation
        run: |
          branches=("master:core" "duo" "handle" "orbit" "gloves" "desktop" "spark" "chromadeck")
          mkdir -p docs # Ensure the docs directory exists

          for item in "${branches[@]}"; do
            IFS=':' read -r branch dest <<< "$item"
            dest="${dest:-$branch}"

            # Create a worktree for each branch in a separate directory
            echo "Setting up worktree for branch: $branch"
            git worktree add --detach worktree/$branch $branch

            # Change directory to the worktree
            cd worktree/$branch

            # Ensure the output directory exists in the docs folder
            mkdir -p ../../docs/$dest

            # Change OUTPUT_DIRECTORY in Doxyfile for each branch
            echo "Adjusting Doxyfile for branch: $branch"
            sed -i "s|OUTPUT_DIRECTORY *=.*|OUTPUT_DIRECTORY = ../../docs/$dest|" Doxyfile

            echo "Running Doxygen for branch: $branch"
            doxygen Doxyfile || { echo "Doxygen failed for branch: $branch"; exit 1; }

            echo "Generated docs for $branch in docs/$dest"

            # Return to the root directory
            cd ../..

            # Remove the worktree after processing
            git worktree remove worktree/$branch -f
          done

      # Deploy to GitHub Pages
      - name: Deploy to GitHub Pages
        id: deployment
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./_site
          publish_branch: gh-pages
          keep_files: true