xpdf: comments #109

	name: Publish documentation

	on:
	push:
	branches:
	- master
	tags:
	- v*

	jobs:
	deploydocs:
	runs-on: ubuntu-22.04
	timeout-minutes: 32

	permissions:
	# NOTE: Needed to push to the repository.
	contents: write
	steps:
	- uses: actions/checkout@v3
	with:
	path: polytracker
	- name: Get the version
	id: get_version
	run: echo "::set-env name=VERSION::${GITHUB_REF#refs/*/}"
	env:
	# The use of ::set-env here is safe!
	ACTIONS_ALLOW_UNSECURE_COMMANDS: 'true'
	- name: Set up Python 3.x
	uses: actions/setup-python@v4
	with:
	python-version: '3.x'
	- name: Install dependencies
	run: \|
	cd polytracker
	python -m pip install --upgrade pip
	pip install setuptools
	pip install .[dev]
	- name: Build documentation
	run: \|
	cd polytracker/docs
	make html
	- name: Checkout gh-pages branch
	uses: actions/checkout@v3
	with:
	ref: gh-pages
	path: gh-pages
	fetch-depth: 0
	- name: Commit documentation changes
	run: \|
	cd gh-pages
	git pull
	rm -rf ${VERSION}
	mkdir ${VERSION}
	cp -r ../polytracker/docs/_build/html/* ${VERSION}/
	cd ${VERSION}
	git config --local user.email "[email protected]"
	git config --local user.name "GitHub Action"
	git add .
	if [ "$GITHUB_REF" == "refs/heads/master" ]; then
	cd ..
	# This is not tag, so it is the latest:
	rm -f latest
	ln -s ${VERSION} latest
	git add latest
	fi
	git commit -m "Update documentation for ${GITHUB_REF}" -a \|\| true
	# The above command will fail if no changes were present, so we ignore
	# the return code.
	- name: Push changes
	uses: ad-m/github-push-action@master
	with:
	branch: gh-pages
	directory: gh-pages
	github_token: ${{ secrets.GITHUB_TOKEN }}

Provide feedback