gravitymon/.github/workflows/doc-build.yaml
2022-01-08 16:04:48 +01:00

40 lines
1.1 KiB
YAML

name: Sphinx Build
on:
push:
branches:
- dev
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: ammaraskar/sphinx-action@master
with:
docs-folder: "src_docs/"
pre-build-command: "pip install sphinx_rtd_theme"
build-command: "sphinx-build -b html ./source ../docs"
# .nojekyll file must exist in docs
- name: Commit documentation changes
run: |
git clone https://github.com/mp-se/gravitymon.git --branch ghpages --single-branch ghpages
cp -r docs/_build/html/* ghpages/
cd ghpages
git config --local user.email "action@noreply.github.com"
git config --local user.name "GitHub Action"
git add .
git commit -m "Update documentation" -a || true
# The above command will fail if no changes were present, so we ignore
# the return code.
- name: Push changes
uses: ad-m/github-push-action@master
with:
branch: ghpages
directory: docs
github_token: ${{ secrets.GITHUB_TOKEN }}