Docs

Merge pull request #587 from AMHermansen/Update-recommended-Icetray #230

	# This is a simple workflow to automatically generate API docs
	name: Docs

	# Controls when the workflow will run
	on:
	# Triggers the workflow on push to the main branch
	push:
	branches: [ main ]

	# Allows you to run this workflow manually from the Actions tab
	workflow_dispatch:

	# A workflow run is made up of one or more jobs that can run sequentially or in parallel
	jobs:
	docs:
	name: Build and publish
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v3
	- name: Install package
	uses: ./.github/actions/install
	- name: Build documentation
	run: \|
	cd docs
	python parse_about.py -i ../paper/paper.md -o source/about.md
	python parse_install.py -i ../README.md -o source/install.md
	python parse_contributing.py -i ../CONTRIBUTING.md -o source/contribute.md
	make clean
	sphinx-apidoc \
	--module-first \
	--separate \
	--force \
	-d 2 \
	--templatedir=source/_templates/ \
	-o source/api ../src/
	sed -i "2s/.*/API/" source/api/graphnet.rst
	make html
	- name: Deploy to Github Pages
	uses: JamesIves/[email protected]
	with:
	branch: gh-pages # The branch the action should deploy to.
	folder: docs/build/html # The folder the action should deploy.
	git-config-email: [email protected]
	git-config-name: Andreas Søgaard

Provide feedback