CompileMKDocsToPDF.yml

name: Build Documentation PDF

on:
  push:
    branches:
      - main
    paths:
      - '.github/workflows/CompileMKDocsToPDF.yml'
      - 'docs/**'
  workflow_dispatch:

jobs:
  build-pdf:
    name: Build PDF Documentation
    runs-on: ubuntu-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Create MkDocs Config
        working-directory: ./docs
        run: |
          if [ -f create-mkdocs-pdf-config.sh ]; then
            chmod +x create-mkdocs-pdf-config.sh
            ./create-mkdocs-pdf-config.sh
          fi

      - name: Build PDF
        uses: kartoza/mkdocs-deploy-build-pdf@master
        env:
          EXTRA_PACKAGES: build-base
          CONFIG_FILE: docs/mkdocs.yml
          REQUIREMENTS: docs/requirements.txt

      - name: Upload PDF Artifact
        uses: actions/upload-artifact@v4
        with:
          name: documentation-pdf
          path: pdfs
          retention-days: 30