doxygen.yml

name: Game Documentation

on:
  push:
    branches:
    - master

permissions:
  pages: write
  deployments: write
  id-token: write

env:
  CONAN_REVISIONS_ENABLED: 1
  CPPFLAGS: "-D_HAS_STD_BYTE=0"
  CXXFLAGS: "-D_HAS_STD_BYTE=0"

jobs:
  docs:
    runs-on: windows-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}

    steps:
      - name: Check Installed Software
        run: where git & where python & where pip
        shell: cmd

      - name: Checkout
        uses: actions/checkout@v3
        with:
          submodules: 'recursive'

      - name: Install Conan
        run: pip install conan>=2.0

      - name: Set Conan Home
        run: echo "CONAN_HOME=${{ github.workspace }}\packages" | Out-File -Append $env:GITHUB_ENV
        shell: powershell

      - name: Detect Conan Profile
        run: conan profile detect

      - name: Install Doxygen
        run: conan install --requires="doxygen/1.16.1" -o doxygen/*:enable_search=False --deployer=full_deploy --deployer-folder="${{ github.workspace }}\packages" -r conancenter --build=missing -s compiler.cppstd=17 -c tools.cmake.cmaketoolchain:generator=Ninja -c tools.build:cxxflags='["-D_HAS_STD_BYTE=0"]' -c tools.build:cflags='["-D_HAS_STD_BYTE=0"]'

      - name: Find Doxygen Executable Path
        run: |
          $doxygenPath = Get-ChildItem -Path "${{ github.workspace }}\packages" -Recurse -Filter doxygen.exe | Select-Object -First 1 -ExpandProperty FullName
          echo "DOXYGEN_EXE_PATH=$doxygenPath" | Out-File -Append $env:GITHUB_ENV
        shell: powershell

      - name: Run Doxygen
        run: ${{ env.DOXYGEN_EXE_PATH }} ${{ github.workspace }}\Doxygen\Doxyfile

      - name: Setup Pages
        uses: actions/configure-pages@v2

      - name: Upload Docs
        uses: actions/upload-pages-artifact@v3
        with:
          path: Documentation\html

      - name: Deploy To GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4