From 12cf5de1a8473c9b3a01a07f2ab46814dbecd9aa Mon Sep 17 00:00:00 2001 From: Ian Torres Date: Wed, 12 Mar 2025 15:30:20 -0300 Subject: [PATCH] Fix GitHub pages (#191) * Fix GitHub pages As `peaceiris/actions-gh-pages` README describes, the `permissions / contents / write` definition is required. In other hand, without that, the step will fail. Also a jump to the version 4 is recommended. Basically because i did a test and previous version, as-is doesn't work. * Space for testing * switch to ubunto for documentation workflow * build test without publish * try again * add tag restriction and pages back --------- Co-authored-by: Lars Melchior Co-authored-by: Lars Melchior --- .github/workflows/documentation.yaml | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/.github/workflows/documentation.yaml b/.github/workflows/documentation.yaml index 9e90bf5..454d91b 100644 --- a/.github/workflows/documentation.yaml +++ b/.github/workflows/documentation.yaml @@ -8,10 +8,14 @@ on: env: CPM_SOURCE_CACHE: ${{ github.workspace }}/cpm_modules +permissions: + contents: write + + jobs: build: name: Build and publish documentation - runs-on: macos-latest + runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 @@ -20,18 +24,22 @@ jobs: path: "**/cpm_modules" key: ${{ github.workflow }}-cpm-modules-${{ hashFiles('**/CMakeLists.txt', '**/*.cmake') }} - - name: Install dependencies + - name: Install python dependencies run: | - brew install doxygen - pip3 install jinja2 Pygments + pip3 install jinja2==3.1.6 Pygments==2.19.1 + - name: Install Doxygen + uses: ssciwr/doxygen-install@v1 + with: + version: "1.13.2" + - name: Build run: | cmake -Sdocumentation -Bbuild cmake --build build --target GenerateDocs - name: Publish - uses: peaceiris/actions-gh-pages@v3 + uses: peaceiris/actions-gh-pages@v4 with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: ./build/doxygen/html