docs.yml

name: Documentation Build and Deploy

on:
  push:
    branches:
      - main
      - '**' # Run on all branches for build/test
  workflow_dispatch:

jobs:
  deploy:
    runs-on: ubuntu-latest
    concurrency:
      group: ${{ github.workflow }}-${{ github.ref }}
    permissions:
      contents: write # Für peaceiris/actions-gh-pages@v3
      pages: write
      id-token: write

    steps:
      - name: Checkout
        uses: actions/checkout@v4
   
   
   # Includes the AsciiDoctor GitHub Pages Action to convert adoc files to html and publish to gh-pages branch
      - name: asciidoctor-ghpages
        if: github.ref == 'refs/heads/main'
        uses: manoelcampos/asciidoctor-ghpages-action@v2
        with:
          pdf_build: false
          source_dir: docs/ 
          asciidoctor_attributes: "docinfo=shared toc=left toclevels=2"