deploy_docs.yml

name: Deploy Docs
on:
  workflow_dispatch:  # manual trigger to kick off workflow
    inputs:
      logLevel:
        description: "Log level"
        required: true
        default: "warning"

jobs:
  build_docs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout iblenv doc build branch
        uses: actions/checkout@v3
        with:
          ref: master  # TODO: Change this for production

      - name: Checkout ibllib doc build branch
        uses: actions/checkout@v3
        with:
          repository: int-brain-lab/ibllib
          ref: docs
          path: ibllib-repo

      - name: Checkout ONE-api
        uses: actions/checkout@v3
        with:
          repository: int-brain-lab/one
          path: ONE

      - name: Move ibllib and ONE up a directory
        run: |
          mv ibllib-repo ..
          mv ONE ..

      - name: Setup Python
        uses: actions/setup-python@v4
        with:
          python-version: 3.9

      - name: Install docs requirements
        run: |
          sudo apt-get install -y pandoc
          pip install -r docs_gh_pages/requirements-docs.txt
          pip install -e ../ibllib-repo
          jupyter nbextension enable --py --sys-prefix ipyevents

      - name: ONE setup and build docs
        run: |
          cd docs_gh_pages
          python scripts/one_setup.py
          python make_script.py -e
          ls -l _build

      - name: Zip up documentation
        run: |
          sudo apt-get install -y zip
          zip -r build_zip docs_gh_pages/_build

      - name: Store zip file as artifacts
        uses: actions/upload-artifact@v3
        with:
          name: build_zip
          path: |
            build_zip.zip

      - name: Clean up documentation
        run: |
            cd docs_gh_pages
            python make_script.py -pc

      - name: Commit documentation changes
        run: |
          git clone https://github.com/mayofaulkner/bb_documentation.git --branch gh-pages --single-branch gh-pages
          cp -r docs_gh_pages/_build/html/* gh-pages/
          cd gh-pages
          touch .nojekyll
          git config --local user.email "action@github.com"
          git config --local user.name "GitHub Action"
          git add .
          git commit -m "Update documentation" -a || true

      - name: Push changes
        uses: ad-m/github-push-action@master
        with:
          branch: gh-pages
          directory: gh-pages
          force: True
          github_token: ${{ secrets.GITHUB_TOKEN }}