Switch sphinx to dirhtml mode #146

	name: Build

	on:
	push:
	branches: [main]
	pull_request:

	permissions:
	contents: read
	pages: write
	id-token: write

	jobs:
	docs:
	runs-on: ubuntu-latest

	steps:
	- uses: actions/checkout@v3
	- uses: actions/setup-python@v4
	with:
	python-version: '3.8'
	- uses: actions/setup-node@v3
	with:
	node-version: '18'
	- name: Update APT
	run: sudo apt update
	- name: Install Poetry
	run: curl -sSL https://install.python-poetry.org/ \| python -
	- name: Add Poetry to PATH
	run: echo "$HOME/.poetry/bin" >> $GITHUB_PATH
	- name: Install dependencies
	run: poetry install
	- name: Build HTML docs
	run: poetry run sphinx-build -M dirhtml docs docs/_build -W --keep-going
	- name: Upload HTML docs
	uses: actions/upload-artifact@v3
	with:
	name: summiting_the_pyramid_docs_html
	path: docs/_build/html/

	github_pages:
	# This job only runs when committing or merging to main branch.
	if: github.ref_name == 'main'
	needs: docs
	runs-on: ubuntu-latest
	environment:
	name: github-pages
	url: ${{ steps.deployment.outputs.page_url }}

	steps:
	- name: Setup Pages
	uses: actions/configure-pages@v2
	- name: Download HTML docs
	uses: actions/download-artifact@v3
	with:
	name: summiting_the_pyramid_docs_html
	path: docs
	- name: Upload artifact
	uses: actions/upload-pages-artifact@v1
	with:
	path: ./docs
	- name: Deploy to GitHub Pages
	id: deployment
	uses: actions/deploy-pages@v1

Provide feedback