Docs test build #22
This file contains hidden or 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: Documentation | |
| on: | |
| push: | |
| branches: | |
| - master | |
| tags: '*' | |
| pull_request: | |
| permissions: | |
| actions: write # Allows the workflow to delete old caches created by previous runs, ensuring efficient cache management and preventing the cache from growing indefinitely. https://github.com/julia-actions/cache?tab=readme-ov-file#cache-retention | |
| contents: read | |
| concurrency: | |
| group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }} | |
| cancel-in-progress: true | |
| jobs: | |
| build: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Install Julia | |
| uses: julia-actions/setup-julia@latest | |
| with: | |
| version: '1' | |
| # Cache to speed up subsequent runs | |
| - uses: julia-actions/cache@v2 | |
| with: | |
| cache-name: docs-cache | |
| # Install Julia package dependencies for the documentation project | |
| - name: Install dependencies | |
| run: > | |
| julia --project=docs/ -e 'ENV["JULIA_PKG_SERVER"] = ""; using Pkg; Pkg.develop(PackageSpec(path=pwd())); Pkg.instantiate()' | |
| # Build and deploy the documentation using xvfb to simulate a display for GLMakie | |
| # xvfb-run: Runs Julia with a virtual display to support OpenGL rendering | |
| # --server-args: Configures the virtual display resolution and color depth | |
| - name: Build and deploy | |
| env: | |
| GKSwstype: "100" # Specifies the workstation type for GR framework rendering, https://discourse.julialang.org/t/generation-of-documentation-fails-qt-qpa-xcb-could-not-connect-to-display/60988/7 | |
| GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Required for permissions to deploy documentation | |
| DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }} # For authentication with SSH deploy key | |
| run: > | |
| julia --project=docs --color=yes --code-coverage=user docs/make.jl | |
| - name: Upload site as artifact | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: docs-artifact | |
| path: ./docs/build | |
| retention-days: 3 | |
| compression-level: 9 | |
| overwrite: true | |
| - uses: julia-actions/julia-processcoverage@v1 | |
| - uses: codecov/codecov-action@v5 | |
| with: | |
| file: lcov.info | |
| token: ${{ secrets.CODECOV_TOKEN }} | |
| fail_ci_if_error: false |