# .github/workflows/publish.yml

name: Publish website

on:

  workflow_dispatch:

  release:

    types: [released, prereleased]

jobs:

  build-doc:

    name: Build doc

    runs-on: macOS-latest

    steps:

      - name: Check out code

        uses: actions/checkout@v4

      - name: Set up JDK 21

        uses: actions/setup-java@v4

        with:

          distribution: 'zulu'

          java-version: 21

      - name: Setup Gradle

        uses: gradle/actions/setup-gradle@v4

      - name: Build api doc

        run: ./gradlew :dokka:dokkaGenerate

      - name: Setup python

        uses: actions/setup-python@v5

        with:

          python-version: 3.x

      - run: pip install mkdocs-material

      - name: Build site

        run: mkdocs build

      - name: Upload artifact

        uses: actions/upload-pages-artifact@v3

        with:

          path: site

  publish-doc:

    environment:

      name: github-pages

      url: ${{ steps.deployment.outputs.page_url }}

    runs-on: ubuntu-latest

    needs: build-doc

    permissions:

      pages: write      # to deploy to Pages

      id-token: write   # to verify the deployment originates from an appropriate source

    steps:

      - name: Deploy to GitHub Pages

        id: deployment

        uses: actions/deploy-pages@v4