Build & Deploy Doxygen Docs #8

	name: "Build & Deploy Doxygen Docs"

	on:
	workflow_dispatch:
	pull_request:
	types: [closed]
	branches:
	- develop

	jobs:
	build-and-deploy:
	if: github.event_name == 'workflow_dispatch' \|\| github.event.pull_request.merged == true
	runs-on: ubuntu-latest

	permissions:
	contents: write
	pages: write

	steps:
	- name: Checkout code
	uses: actions/checkout@v3
	with:
	fetch-depth: 0

	- name: Install Doxygen
	run: sudo apt-get update && sudo apt-get install -y doxygen graphviz

	- name: Generate Doxygen HTML
	run: doxygen ./Doxyfile

	- name: Clone docs branch
	run: \|
	git clone --branch docs https://x-access-token:${{ secrets.USER_TOKEN }}@github.com/${{ github.repository }} docs-out

	- name: Copy generated HTML
	run: \|
	find docs-out -mindepth 1 ! -regex '^docs-out/\.git$/.*$?' -delete
	cp -R docs/html/* docs-out/

	- name: Commit & Push to `docs` branch
	run: \|
	git config user.name "github-actions[bot]"
	git config user.email "github-actions[bot]@users.noreply.github.com"
	git fetch origin docs \|\| git checkout --orphan docs
	git switch docs \|\| git checkout -b docs
	cp -r docs/html/* .
	git add .
	git commit -m "Regenerate Doxygen docs from ${{ github.sha }}" \|\| echo "No changes to commit"
	git push --force https://x-access-token:${{ secrets.USER_SECRET }}@github.com/${{ github.repository }}.git HEAD:docs

Provide feedback