withStage helper (#253) #125

	name: docs_pages_workflow

	on:
	push:
	branches:
	- main

	jobs:
	build_docs_job:
	runs-on: ubuntu-latest
	env:
	GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
	steps:
	- name: Checkout
	uses: actions/checkout@v3
	- name: Set up Python
	uses: actions/[email protected]
	with:
	python-version: 3.11.0
	- name: Install dependencies
	run: \|
	python -m pip install -U sphinx
	python -m pip install sphinx-rtd-theme
	python -m pip install myst-parser
	- name: make the sphinx docs
	run: \|
	make -C docs clean
	make -C docs html
	- name: Init new repo in dist folder and commit
	run: \|
	cd docs/_build/html/
	git init
	touch .nojekyll
	git add -A
	git config --local user.email "[email protected]"
	git config --local user.name "GitHub Action"
	git commit -m 'deploy'
	- name: Force push to destination branch
	uses: ad-m/[email protected]
	with:
	github_token: ${{ secrets.GITHUB_TOKEN }}
	branch: gh-pages
	force: true
	directory: ./docs/_build/html

Provide feedback