name: Publish documentation on: push: branches: - main paths: - docs/** workflow_dispatch: permissions: contents: read pages: write id-token: write concurrency: group: pages cancel-in-progress: false jobs: build: runs-on: ubuntu-latest steps: - name: Checkout uses: actions/checkout@v6 - name: Install python uses: actions/setup-python@v6 with: python-version: 3.x - name: Setup Pages id: pages uses: actions/configure-pages@v5 - name: Install dependencies run: pip install mkdocs-material mkdocs-glightbox mkdocs-minify-plugin - name: Build site run: mkdocs build - name: Upload artifact uses: actions/upload-pages-artifact@v4 with: path: ./site deploy: environment: name: github-pages url: ${{ steps.deployment.outputs.page_url }} runs-on: ubuntu-latest needs: build steps: - name: Deploy to GitHub Pages id: deployment uses: actions/deploy-pages@v4