publish.yaml

name: Documentation

# Controls when the action will run. Triggers the workflow on push or pull request
# events but only for the master branch
on:
  push:
    branches: [ develop-weekly ]

jobs:
  build-documentation:
    runs-on: ubuntu-latest

    steps:

    - name: Get appimage to generate config docs
      uses: actions/checkout@v4
      with:
        ref: develop-weekly-appimage

    - name: Generate config markdown doc from appimage
      run: |
        sudo apt-get install fuse
        ./Ginan-x86_64.AppImage -Y 3
        mkdir Docs
        mv defaultConfiguration.md Docs

    - name: Checkout the updated branch
      uses: actions/checkout@v4

    - name: Create folders and move readme
      run: |
        cp README.md Docs/readme.md
        mkdir -p src/build

    - name: Build doxygen docs from code
      uses: mattnotmitt/doxygen-action@v1.1.0
      with:
          doxyfile-path: ../doc_templates/Doxyfile.in
          working-directory: ./src/build

    - name: Deploy the HTML documentation to GitHub Pages
      uses: peaceiris/actions-gh-pages@v3
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: ./Docs/
        enable_jekyll: false
        allow_empty_commit: false
        force_orphan: true
        publish_branch: gh-pages-staging