name: Build docs

on:

workflow_dispatch:

push:

branches:

- master

paths:

- 'resources/**'

- 'docs/**'

- 'demo/**'

permissions:

contents: write

jobs:

deploy:

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v6

- name: Configure Git Credentials

run: |

git config user.name github-actions[bot]

git config user.email 41898282+github-actions[bot]@users.noreply.github.com

- name: Setup PHP

uses: shivammathur/setup-php@v2

with:

php-version: 8.2

coverage: none

tools: composer:v2

- name: Install dependencies

env:

COMPOSER_ROOT_VERSION: dev-master

run: composer update --prefer-dist --no-progress

- name: Run Tests for Docs

run: vendor/bin/phpunit --filter=testDocs

- name: Run build script

run: php build/build-docs.php

- uses: actions/setup-python@v6

with:

python-version: 3.x

- run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV

- uses: actions/cache@v5

with:

key: mkdocs-material-${{ env.cache_id }}

path: .cache

restore-keys: |

mkdocs-material-

- run: pip install mkdocs-material

- run: mkdocs gh-deploy --force