Workflows #396

	name: Build Docs

	# We don't want pushes (or PRs) to gh-pages to kick anything off
	on:
	push:
	branches: [ main ]
	pull_request:
	branches: [ main ]

	jobs:
	# Build docs on Linux
	Docs:
	name: linux docs
	runs-on: ubuntu-latest
	env:
	DOC_VERSION: dev
	defaults:
	run:
	shell: bash -l {0}
	steps:
	- name: Checkout source
	uses: actions/checkout@v3
	- name: install tomli
	run: pip install tomli
	- name: Generate env spec
	run: python make_env.py doc
	- name: Setup environment
	uses: conda-incubator/setup-miniconda@v2
	with:
	python-version: "3.9"
	miniforge-variant: Mambaforge
	channels: conda-forge,defaults
	channel-priority: strict
	environment-file: environment.yml
	activate-environment: hydromt-wflow

	- name: Install HydroMT-Wflow plugin
	run: pip install .

	- name: Build docs
	run: \|
	pushd docs
	make html
	popd

	- name: Set doc version
	run: echo "DOC_VERSION=$(python -c 'from hydromt_wflow import __version__ as v; print("dev" if "dev" in v else "v"+v.replace(".dev",""))')" >> $GITHUB_ENV

	- name: Upload to GitHub Pages
	if: ${{ github.event_name != 'pull_request'}}
	uses: peaceiris/[email protected]
	with:
	github_token: ${{ secrets.GITHUB_TOKEN }}
	publish_dir: ./docs/_build/html
	exclude_assets: '.buildinfo,_sources/,_examples/.ipynb'
	destination_dir: ./${{ env.DOC_VERSION }}
	keep_files: false
	full_commit_message: Deploy ${{ env.DOC_VERSION }} to GitHub Pages

Provide feedback