obs-studio/.github/workflows/docs.yml

name: Generate Documentation

on:
  push:
    paths-ignore:
      - "cmake/**"
  pull_request:
    paths:
      - "docs/sphinx/**"

jobs:
  docs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
      - name: Setup Environment
        id: setup
        run: |
          echo "commitHash=$(git describe --exact-match --tags 2> /dev/null || git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
      - name: Bump Version Number
        shell: bash
        if: github.event_name == 'push'
        run: |
          VERTEST="\#define\sLIBOBS_API_\w+_VER\s([0-9]{1,2})"
          VER=""
          MAJOR=""
          while IFS= read -r l
          do
              if [[ $l =~ $VERTEST ]]; then
                  if [[ $VER = '' ]]; then MAJOR="${BASH_REMATCH[1]}"; else VER+="."; fi
                  VER+="${BASH_REMATCH[1]}"
              fi
          done < "libobs/obs-config.h"

          SVER="version = '([0-9\.]+)'"
          RVER="version = '$VER'"
          SREL="release = '([0-9\.]+)'"
          RREL="release = '$VER'"
          SCOPY="copyright = '([A-Za-z0-9, ]+)'"
          RCOPY="copyright = '2017-$(date +"%Y"), Hugh Bailey'"
          sed -i -E -e "s/${SVER}/${RVER}/g" -e "s/${SREL}/${RREL}/g" -e "s/${SCOPY}/${RCOPY}/g" docs/sphinx/conf.py
      - uses: totaldebug/[email protected]
        with:
          sphinx_src: 'docs/sphinx'
          build_only: True
          target_branch: 'master'
          target_path: '../home/_build'
          pre_build_commands: 'pip install -Iv sphinx==5.1.1'
      - uses: actions/upload-artifact@v3
        with:
          name: 'OBS Studio Docs ${{ steps.setup.outputs.commitHash }}'
          path: |
            ${{ runner.temp }}/_github_home/_build
            !${{ runner.temp }}/_github_home/_build/.doctrees