publish-pages-only.yml

name: Publish Pages
on:
  workflow_dispatch:
    inputs:
      docs_version:
        description: 'Documentation version (for example, 1.0)'
        required: true
        type: string
permissions:
  contents: write
jobs:
  deploy-docs:
    runs-on: macos-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
        with:
          submodules: recursive
      - uses: actions/setup-java@v3
        with:
          distribution: 'temurin'
          java-version: '17'
      - uses: maxim-lobanov/setup-xcode@v1
        with:
          xcode-version: 26.3.0
      - uses: actions/setup-python@v5
        with:
          python-version: 3.x
      - run: pip install mkdocs-material==9.5.40
      - run: pip install mkdocs-material[imaging]==9.5.40
      - run: pip install mkdocs-macros-plugin==1.3.7
      - run: pip install mkdocs-open-in-new-tab
      - run: pip install mike
      - name: Set up Homebrew
        id: set-up-homebrew
        uses: Homebrew/actions/setup-homebrew@master
      - name: Install deps
        run: brew install cairo freetype libffi libjpeg libpng zlib
      - name: Build Dokka HTML
        run: |
          export DYLD_FALLBACK_LIBRARY_PATH=/opt/homebrew/lib
          ./gradlew mkDocsSite
        env:
          SIGN_LOCAL_REPO_ARTEFACTS: 'true'
          ORG_GRADLE_PROJECT_signingKeyId: ${{ secrets.PUBLISH_SIGNING_KEYID }}
          ORG_GRADLE_PROJECT_signingKey: ${{ secrets.PUBLISH_SIGNING_KEY }}
          ORG_GRADLE_PROJECT_signingPassword: ${{ secrets.PUBLISH_SIGNING_PASSWORD }}
      - name: Publish versioned documentation
        run: cd docs && mike deploy --push --update-aliases "${{ inputs.docs_version }}" latest