diff options
Diffstat (limited to '.github/workflows/docs.yml')
| -rw-r--r-- | .github/workflows/docs.yml | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml new file mode 100644 index 0000000..defe4e2 --- /dev/null +++ b/.github/workflows/docs.yml | |||
| @@ -0,0 +1,47 @@ | |||
| 1 | name: API Reference | ||
| 2 | |||
| 3 | on: | ||
| 4 | push: | ||
| 5 | branches: [master] | ||
| 6 | |||
| 7 | # Allow manually starting the workflow. | ||
| 8 | workflow_dispatch: | ||
| 9 | |||
| 10 | # If two concurrent runs are started, | ||
| 11 | # prefer the latest one. | ||
| 12 | concurrency: | ||
| 13 | group: "pages" | ||
| 14 | cancel-in-progress: true | ||
| 15 | |||
| 16 | jobs: | ||
| 17 | |||
| 18 | build: | ||
| 19 | name: Build website | ||
| 20 | runs-on: ubuntu-latest | ||
| 21 | steps: | ||
| 22 | - uses: actions/checkout@v4 | ||
| 23 | - uses: goto-bus-stop/setup-zig@v2.0.1 | ||
| 24 | with: | ||
| 25 | version: master | ||
| 26 | - name: Build | ||
| 27 | run: zig build docs | ||
| 28 | - name: Upload | ||
| 29 | uses: actions/upload-pages-artifact@v2 | ||
| 30 | with: | ||
| 31 | path: "zig-out/docs/" | ||
| 32 | |||
| 33 | publish: | ||
| 34 | name: Publish website | ||
| 35 | runs-on: ubuntu-latest | ||
| 36 | needs: build # wait for build to finish | ||
| 37 | permissions: | ||
| 38 | # Request sufficient permissions to publish the website. | ||
| 39 | pages: write | ||
| 40 | id-token: write | ||
| 41 | steps: | ||
| 42 | - name: Deploy to GitHub Pages | ||
| 43 | id: deployment | ||
| 44 | uses: actions/deploy-pages@v3 | ||
| 45 | environment: | ||
| 46 | name: github-pages | ||
| 47 | url: ${{ steps.deployment.outputs.page_url }} | ||