Fix documentation pages #15

	---


	name: "Pages"

	concurrency:
	group: "pages"
	cancel-in-progress: true

	on:
	push:

	jobs:

	"pages-build":

	runs-on: "ubuntu-22.04"

	services:

	redis:
	image: "redis"
	options: >-
	--health-cmd "redis-cli ping"
	--health-interval 10s
	--health-timeout 5s
	--health-retries 5
	ports:
	- "6379:6379/tcp"

	steps:

	- name: "Setup Python"
	uses: "actions/setup-python@v4" # tested with v4.7.0
	with:
	python-version: "3.10" # tested with v3.10.13

	- name: "Checkout"
	uses: "actions/checkout@v4" # tested with v4.0.0

	- name: "Create conda environment"
	run: "conda env create --file conda-environment.yml"

	- name: "Install dependencies with Poetry"
	run: "conda run --name mxcubeweb poetry install"

	- name: "Build documentation with Sphinx"
	run: "conda run --name mxcubeweb make --directory=./docs/ html"

	- name: "Upload artifact for GitHub Pages"
	# TODO if: "github.ref_name == github.event.repository.default_branch"
	uses: "actions/upload-pages-artifact@v2" # tested with v2.0.0
	with:
	path: "docs/build/html"

	"pages-deploy":

	if: "github.ref_name == github.event.repository.default_branch"

	environment:
	name: "github-pages"
	url: "${{ steps.deployment.outputs.page_url }}"

	needs:
	- "pages-build"

	permissions:
	pages: "write"
	id-token: "write"

	runs-on: "ubuntu-22.04"

	steps:

	- name: "Setup GitHub Pages"
	uses: "actions/configure-pages@v3" # tested with v3.0.6

	- name: "Deploy to GitHub Pages"
	id: "deployment"
	uses: "actions/deploy-pages@v2" # tested with 2.0.4


	... # EOF

Provide feedback