Initial commit to SQD public repository. #13
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
name: Build Sphinx docs | |
on: | |
workflow_dispatch: | |
push: | |
tags: | |
- "[0-9]+.[0-9]+.[0-9]+*" | |
branches: | |
- main | |
- 'stable/**' | |
pull_request: | |
branches: | |
- main | |
- 'stable/**' | |
jobs: | |
build_and_deploy_docs: | |
runs-on: ubuntu-latest | |
timeout-minutes: 20 | |
steps: | |
- uses: actions/checkout@v4 | |
with: | |
fetch-depth: 0 | |
- uses: actions/setup-python@v5 | |
with: | |
python-version: '3.10' | |
- name: Install dependencies | |
run: | | |
python -m pip install --upgrade pip | |
pip install tox | |
sudo apt-get update | |
sudo apt-get install -y pandoc | |
- name: Build docs | |
shell: bash | |
run: | | |
tox -edocs | |
- name: Prepare docs artifact | |
if: always() | |
shell: bash | |
run: | | |
mkdir artifact | |
cp -a docs/_build/html artifact/addon_sqd_html_docs | |
- name: Upload docs artifact | |
if: always() | |
uses: actions/upload-artifact@v4 | |
with: | |
name: addon_sqd_html_docs | |
path: ./artifact | |
- name: Deploy docs | |
if: ${{ github.ref == 'refs/heads/stable/0.3' }} | |
uses: peaceiris/actions-gh-pages@v4 | |
with: | |
github_token: ${{ secrets.GITHUB_TOKEN }} | |
publish_dir: ./docs/_build/html/ |