docs

WIP GH #520

	name: docs

	on:
	push:
	branches:
	- main
	tags:
	- 'v*'
	pull_request:
	branches:
	- main

	jobs:
	build:
	name: build and deploy docs
	runs-on: windows-latest
	defaults:
	run:
	shell: bash -l {0}
	steps:
	- uses: actions/checkout@v2

	- uses: conda-incubator/[email protected]
	with:
	miniconda-version: "latest"
	activate-environment: wood
	channels: conda-forge
	python-version: 3.9.10

	- name: install Sphinx and nbsphinx
	run: \|
	conda install compas
	pip install -r requirements-dev.txt
	pip install nbsphinx

	- name: build (windows)
	run: \|
	invoke docs

	- uses: compas-dev/[email protected]
	id: docs
	with:
	dest: deploy
	build_to_subfolder: true
	install_dependencies: false
	build_docs: false

	- name: Deploy docs
	if: success() && steps.docs.outputs.commit_type != 'pull'
	uses: crazy-max/ghaction-github-pages@v2
	with:
	target_branch: gh-pages
	build_dir: deploy
	keep_history: true
	env:
	GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

	outputs:
	commit_type: ${{ steps.docs.outputs.commit_type }}
	current_version: ${{ steps.docs.outputs.current_version }}

	docVersions:
	needs: build
	if: needs.build.outputs.commit_type == 'tag'
	name: update doc versions
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v2
	with:
	ref: gh-pages

	- uses: compas-dev/[email protected]
	with:
	current_version: ${{ needs.build.outputs.current_version }}

	- name: Deploy docs
	if: success()
	uses: crazy-max/ghaction-github-pages@v2
	with:
	target_branch: gh-pages
	build_dir: ./
	keep_history: false
	env:
	GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Provide feedback