📜 Haddock Site #4
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
| # This workflow builds and publishes the Haddock site to: | |
| # https://intersectmbo.github.io/plutus/haddock/$version | |
| # And optionally to: | |
| # https://intersectmbo.github.io/plutus/haddock/latest | |
| name: "📜 Haddock Site" | |
| on: | |
| workflow_dispatch: | |
| inputs: | |
| ref: | |
| description: | | |
| The $ref to build off of, e.g. "1.29.0.0", "master", or any other valid git ref. | |
| When making a release, this is usually the version tag, e.g. "1.29.0.0", and will be | |
| equal to the $destination input below. When back-porting this could be a commit sha instead. | |
| required: true | |
| type: string | |
| destination: | |
| description: | | |
| The $destination folder, e.g. when "1.29.0.0" the haddock will be deploy to: | |
| https://intersectmbo.github.io/plutus/haddock/1.29.0.0 | |
| required: true | |
| type: string | |
| latest: | |
| description: | | |
| If true, then the haddock site will also be deploy to: | |
| https://intersectmbo.github.io/plutus/haddock/latest. | |
| You want to leave this to true unless you are deploying old versions or back-porting. | |
| type: boolean | |
| required: true | |
| default: true | |
| jobs: | |
| deploy: | |
| name: Deploy | |
| runs-on: [self-hosted, plutus-shared] | |
| permissions: | |
| contents: write | |
| environment: | |
| name: github-pages | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@main | |
| with: | |
| ref: ${{ inputs.ref }} | |
| - name: Build Site | |
| run: | | |
| nix develop --no-warn-dirty --accept-flake-config --command ./scripts/combined-haddock.sh _haddock all | |
| - name: Deploy Site | |
| uses: JamesIves/[email protected] | |
| with: | |
| folder: _haddock | |
| target-folder: haddock/${{ inputs.destination }} | |
| single-commit: true | |
| - name: Deploy Site (latest) | |
| if: ${{ inputs.latest == true }} | |
| uses: JamesIves/[email protected] | |
| with: | |
| folder: _haddock | |
| target-folder: haddock/latest | |
| single-commit: true |