Skip to content

Trigger docs workflow for changes on main #54

Trigger docs workflow for changes on main

Trigger docs workflow for changes on main #54

# From https://github.com/eeholmes/readthedoc-test/blob/main/.github/workflows/docs_pages.yml
name: multiversion-docs
on:
workflow_dispatch:
push:
branches:
- dev
jobs:
build_docs:
runs-on: ubuntu-latest
steps:
- name: Checkout main
uses: actions/checkout@v3
with:
path: dev
fetch-depth: 0
fetch-tags: true
- name: Checkout gh-pages-dev
uses: actions/checkout@v3
with:
path: gh-pages-dev
ref: gh-pages-dev
- name: Set up Python
uses: actions/setup-python@v4
with:
python-version: 3.11
cache: "pip"
- name: Install dependencies
run: |
cd ./dev
python -m pip install .[docs]
- name: Create local branches
run: |
cd ./dev
git branch main remotes/origin/main
- name: Make the Sphinx docs
run: |
cd ./dev/docsrc
make clean
make docs-sequential
- name: Commit changes to docs
run: |
cd ./gh-pages-dev
git rm --quiet -rf .
cp -R ../dev/docs/* ./
git config --local user.email ""
git config --local user.name "github-actions"
git add -A
if ! git diff-index --quiet HEAD; then
git commit -m "auto: Rebuild docs."
git push
else
echo No commit made because the docs have not changed.
fi