publish_docs.yml

name: 'Publish Docs Site'
on:
  push:
    branches:
      - master
    paths:
      - '**.md'
      - '.github/workflow/publish*'
  workflow_dispatch:
permissions:
  pages: 'write'
  id-token: 'write'
jobs:
  build-and-deploy:
    name: "Build and Deploy Docs"
    runs-on: 'ubuntu-latest'
    steps:
      - uses: 'actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683' # ratchet:actions/checkout@v4
      - name: 'Generate HTML from Markdown'
        uses: 'ldeluigi/markdown-docs@e51f9a21070db6a21dfbe27ac92f065823e006a1' # ratchet:ldeluigi/markdown-docs@latest
        with:
          src: 'docs'
          dst: 'generated-pages'
      - name: 'Install rsync'
        run: 'apt-get update && apt-get install -y rsync'
      - name: 'Deploy Docs'
        uses: JamesIves/github-pages-deploy-action@6c2d9db40f9296374acc17b90404b6e8864128c8 # ratchet:JamesIves/github-pages-deploy-action@v4
        with:
          folder: generated-pages
          force: false
          clean-exclude: pr-preview/