Docs

Oct 2023 update #68

	name: Docs

	on:
	push:
	branches:
	- master
	pull_request:
	branches:
	- master

	jobs:
	build:
	runs-on: ubuntu-latest

	steps:
	- uses: actions/checkout@v1
	# Standard drop-in approach that should work for most people.
	- uses: ammaraskar/sphinx-action@master
	with:
	docs-folder: "docs/"

	# Publish built docs to gh-pages branch.
	# ===============================
	- name: Commit documentation changes
	run: \|
	git clone https://github.com/WelbornGroup/ELECTRIC --branch gh-pages --single-branch gh-pages
	cp -r docs/_build/html/* gh-pages/
	cd gh-pages
	git config --local user.email "action@github.com"
	git config --local user.name "GitHub Action"
	git add .
	git commit -m "Update documentation" -a \|\| true
	# The above command will fail if no changes were present, so we ignore
	# that.
	# Push if this is a push to master.
	- name: Push changes
	if: ${{ github.event_name == 'push' }}
	uses: ad-m/github-push-action@master
	with:
	branch: gh-pages
	directory: gh-pages
	github_token: ${{ secrets.PUSH_DOCS }}
	# ===============================

Provide feedback