ci: build and upload docs to github pages

issue #33

.github/workflows/linux.yml

@@ -7,7 +7,7 @@ on:
  branches: [ "main" ]
 
 jobs:
- build-and-test:
+ build-test-docs:
  strategy:
  fail-fast: true
  matrix:
@@ -68,3 +68,30 @@ jobs:
  files: build/${{matrix.config.preset}}/coverage/coverage.xml
  fail_ci_if_error: true
  functionalities: fix
+
+ - name: Build Docs
+ run: |
+ cmake --build --preset ${{matrix.config.preset}} --target docs
+ mv build/${{matrix.config.preset}}/docs/sphinx _site
+
+ - name: Upload Pages Artifacts
+ uses: actions/upload-pages-artifact@v2
+
+ deploy-docs:
+ if: success() && github.ref == 'refs/heads/33-add-documentation-generator-to-build' # TODO on push to branch main
+ needs: build-test-docs
+ runs-on: ubuntu-latest
+
+ permissions:
+ pages: write # to deploy to Pages
+ id-token: write # to verify the deployment originates from an appropriate source
+
+ # Deploy to the github-pages environment
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+
+ steps:
+ - name: Deploy to GitHub Pages
+ id: deployment
+ uses: actions/deploy-pages@v2