documentation.yml

name: Build and Deploy Documentation

on:
  workflow_dispatch:

jobs:
  documentation-test:
      runs-on: ubuntu-24.04
      steps:
        - uses: actions/checkout@v4
          with:
            ref: ${{ github.ref }}
            
        - run: |
            cp CHANGELOG.md docs/source/CHANGELOG.md
            docker build . -t=docs -f docs/Dockerfile 
            docker run -v $(pwd):/map2loop docs bash map2loop/docs/build_docs.sh
        - name: upload artifacts
          uses: actions/upload-artifact@v4
          with:
            name: docs
            path: docs/build/html
            
  documentation-deploy:
      runs-on: ubuntu-24.04
      if: GitHub.ref == 'refs/heads/master'
      steps:
        - uses: actions/checkout@v4
        - uses: actions/download-artifact@v4
          with:
            name: docs
            path: docs
        - name: ls
          run: |
            ls -l docs
        - name: Deploy 🚀
          uses: JamesIves/github-pages-deploy-action@v4
          with:
            branch: gh-pages # The branch the action should deploy to.
            folder: docs # The folder the action should deploy.