-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
First attempt at github pages action file
Signed-off-by: Charlie Street <[email protected]>
- Loading branch information
1 parent
eea0725
commit d1a2e1a
Showing
1 changed file
with
54 additions
and
0 deletions.
There are no files selected for viewing
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,54 @@ | ||
|
||
name: Deploy | ||
# Deploy sphinx documentation to GitHub Pages in docs branch | ||
|
||
on: | ||
# Triggers the workflow on push or pull request events but only for the "main" branch | ||
push: | ||
branches: [ "main" ] | ||
|
||
jobs: | ||
build: | ||
runs-on: ubuntu-latest | ||
steps: | ||
# Checkout the repository | ||
- name: Checkout repository | ||
uses: actions/checkout@v2 | ||
# install the dependencies | ||
- name: Install dependencies | ||
run: pip install -r docs/requirements.txt | ||
# install doxygen | ||
- name: Install doxygen | ||
run: sudo apt install doxygen | ||
# build the documentation | ||
- name: Build documentation | ||
run: | | ||
cd docs | ||
make html | ||
# upload the documentation to GitHub Pages | ||
- name: Upload artifact | ||
uses: actions/upload-pages-artifact@v3 | ||
with: | ||
path: docs/build/html | ||
deploy: | ||
# Add a dependency to the build job | ||
needs: build | ||
|
||
# Grant GITHUB_TOKEN the permissions required to make a Pages deployment | ||
permissions: | ||
pages: write # to deploy to Pages | ||
id-token: write # to verify the deployment originates from an appropriate source | ||
|
||
# Deploy to the github-pages environment | ||
environment: | ||
name: github-pages | ||
url: ${{ steps.deployment.outputs.page_url }} | ||
|
||
runs-on: ubuntu-latest | ||
|
||
steps: | ||
# deploy the documentation to GitHub Pages | ||
- name: Deploy to github pages | ||
id: deployment | ||
uses: actions/deploy-pages@v4 | ||
|