Skip to content

Update docs.yml

Update docs.yml #18

Workflow file for this run

name: "Deploy Sphinx gh-pages"
on:
push:
branches:
- master
jobs:
docs:
runs-on: ubuntu-latest
steps:
- name: Check git installation
run: git --version
- name: Print PATH variable
run: echo $PATH
- name: Print GITHUB_PATH variable
run: echo $GITHUB_PATH
- name: Add git to PATH
run: |
echo "/usr/bin" >> $GITHUB_PATH
- uses: actions/checkout@v2
- uses: ammaraskar/sphinx-action@master
with:
docs-folder: "docs/"
pre-build-command: "pip install -r requirements.txt"
# Create an artifact of the html output.
- uses: actions/upload-artifact@v1
with:
name: DocumentationHTML
path: docs/build/html/
# Publish built docs to gh-pages branch.
# ===============================
- name: Commit documentation changes
run: |
git clone https://github.com/tdkorn/sphinx-github-style.git --branch gh-pages --single-branch gh-pages
cp -r docs/build/html/* gh-pages/docs/
cd gh-pages
touch .nojekyll
git config --local user.email "action@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
# that.
- name: Push changes
uses: ad-m/github-push-action@master
with:
branch: gh-pages
directory: gh-pages
github_token: ${{ secrets.GITHUB_TOKEN }}
# ===============================