sphinx-make-page.yml

name: "Build & Deploy Page"
on:
  workflow_dispatch:
  push:
    branches:
      - master
  schedule:
  # Run every morning to ensure component documentation is up to date on deployment
   - cron: '23 5 * * *'

jobs:
  build-deploy:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
      with:
        fetch-depth: 0
    - uses: actions/setup-python@v5
      with:
        python-version: '3.10'
        cache: 'pip'
    - name: Install Python dependencies
      run: |
        python -m pip install --upgrade pip
        pip install --upgrade --requirement requirements.txt
      shell: bash
    - name: Install generate_parameter_library
      run: |
        cd
        git clone https://github.com/PickNikRobotics/generate_parameter_library.git
        cd generate_parameter_library/generate_parameter_library_py/
        python -m pip install .
      shell: bash
    - name: Install doxygen and graphviz
      run: sudo apt-get install -y doxygen graphviz
    - name: Restore stats
      uses: actions/cache/restore@v4
      with:
        key: reviewer-stats-${{ github.run_id }}
        restore-keys: |
          reviewer-stats
        path: ~/reviews
    - name: Build multiversion with API
      run: |
        git config --local user.email "action@github.com"
        git config --local user.name "GitHub Action"
        make multiversion-with-api
    - name: clone gh-pages branch
      uses: actions/checkout@v4
      if: ${{ success() && github.event_name != 'pull_request' && !env.ACT }}
      with:
        ref: gh-pages
        path: gh-pages
    - name: Deploy Pages
      if: ${{ success() && github.event_name != 'pull_request' && !env.ACT }}
      uses: peaceiris/actions-gh-pages@v3
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: ./_build/html
        cname: control.ros.org