separate jobs #24
Workflow file for this run
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: Deploy Sphinx documentation to Pages | |
on: | |
push: | |
branches: [main, ghpages] | |
permissions: | |
contents: read | |
pages: write | |
id-token: write | |
concurrency: | |
group: "pages" | |
cancel-in-progress: true | |
jobs: | |
build: | |
runs-on: ubuntu-20.04 | |
steps: | |
- name: Checkout repository | |
uses: actions/checkout@v2 | |
- name: Set up Python | |
uses: actions/setup-python@v2 | |
with: | |
python-version: '3.x' | |
- name: Print current working directory | |
run: | | |
echo "Current working directory:" | |
pwd | |
- name: Install dependencies | |
run: | | |
python -m pip install --upgrade pip | |
pip install sphinx pydata_sphinx_theme | |
- name: Build documentation | |
run: | | |
cd docs | |
make html | |
- name: List files for debugging | |
run: | | |
echo "Listing all files and directories after build:" | |
find "$(pwd)" -type d -print | |
find "$(pwd)" -type f -print | |
- name: Upload documentation | |
uses: actions/upload-artifact@v2 | |
with: | |
name: built-docs | |
path: docs/_build/html | |
deploy: | |
runs-on: ubuntu-20.04 | |
needs: build | |
steps: | |
- name: Checkout repository | |
uses: actions/checkout@v2 | |
- name: Download documentation | |
uses: actions/download-artifact@v2 | |
with: | |
name: built-docs | |
path: ./built-docs | |
- name: List downloaded documentation | |
run: | | |
echo "Listing contents of downloaded built-docs:" | |
find "$(pwd)/built-docs" -type d -print | |
find "$(pwd)/built-docs" -type f -print | |
- name: Deploy to GitHub Pages | |
id: deployment | |
uses: sphinx-notes/pages@v3 | |
with: | |
documentation_path: 'built-docs' | |
publish: 'true' |