TLDR yaml to deploy to gitlab pages,

basically the only thing that you need to do is:

  1. make sure the static site is present in a directory called public
  2. the public directory is a job artifact
  3. the pipeline is called pages
pages:
  stage: build
  script:
  # build command
  - make docs
  # copy docs and coverage report from build directory to public
  - cp -r docs/_build/html public
  - cp -r htmlcov/ public/coverage
  - ls public
  - ls public/coverage
  artifacts:
    paths:
    # make sure public is an artifact so that pages get deployed
    - public
    - docs
  only:
  - master