Skip to content

Publish Pages

Publish Pages #33

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: |
git config user.name "asitplus"
git config user.email "plus@a-sit.at"
export DYLD_FALLBACK_LIBRARY_PATH=/opt/homebrew/lib
cd docs && mike deploy --push --update-aliases "${{ inputs.docs_version }}" latest