docs.yml

name: Docs

on:
  push:
    branches: [ master ]
    paths: '**/*.md'
  workflow_dispatch:

jobs:
  Build:
    runs-on: ubuntu-latest
    permissions:
      actions: read
      contents: read
    steps:
    - name: Checkout
      uses: actions/checkout@v3
    - name: Checkout doxygen awesome
      uses: actions/checkout@v3
      with:
        repository: jothepro/doxygen-awesome-css
        path: doxygen-awesome-css
    - name: Install doxygen
      run: sudo apt-get update && sudo apt-get install doxygen graphviz -y
    - name: Generate Doxygen documentation
      run: doxygen Doxyfile
    - name: Copy LICENSE
      run: cp doxygen-awesome-css/LICENSE docs/html/LICENSE
    - name: Create .nojekyll
      run: touch docs/html/.nojekyll
    - name: Upload documentation
      uses: actions/upload-pages-artifact@v1
      with:
        path: docs/html
  Deploy:
    needs: Build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    permissions:
      actions: read
      contents: read
      pages: write
      id-token: write
    name: Deploy
    steps:
    - name: Deploy documentation
      id: deployment
      uses: actions/deploy-pages@v1