+.docs-base:
+ extends: .ci-run-policy
+ image: alpine
+ script:
+ - apk --no-cache add py3-pip
+ - pip3 install sphinx sphinx_rtd_theme
+ - sphinx-build -b html docs public
+
+pages:
+ extends: .docs-base
+ stage: deploy
+ artifacts:
+ paths:
+ - public
+ rules:
+ - if: '$CI_PROJECT_NAMESPACE == "mesa" && $CI_COMMIT_REF_NAME == "master"'
+ changes: &docs-or-ci
+ - docs/**/*
+ - .gitlab-ci.yml
+ when: always
+ # Other cases default to never
+
+test-docs:
+ extends: .docs-base
+ stage: container+docs
+ rules:
+ - if: '$CI_PROJECT_NAMESPACE == "mesa"'
+ when: never
+ - if: '$GITLAB_USER_LOGIN == "marge-bot"'
+ changes: *docs-or-ci
+ when: on_success
+ - changes: *docs-or-ci
+ when: manual
+ # Other cases default to never