build docs:
  stage: build
  image:
    name: $CONTAINER_GCC_IMAGE

  before_script:
    # HACK to easier linking to the generated pages
    - echo '<meta http-equiv="REFRESH" content="0;URL=build/docs/index.html">' >> Doxygen.html
    - mkdir -p build
    - cd build

  script:
    - cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release -DOGS_USE_CONAN=OFF -DOGS_BUILD_PROCESSES=GroundwaterFlow
    - cmake --build . --target doc > >(tee make-docs.output)

  artifacts:
    expose_as: 'Doxygen'
    paths:
      - Doxygen.html
      - build/docs/
    expire_in: 1 week