.documentation-tool-common:
  image: gitlab.exxcellent.de:4567/gilden/ci/exxcellent-documentation-tool:1.6.1
  variables:
    REV_NUMBER: $CI_COMMIT_SHORT_SHA
    CONFLUENCE_URL: "https://www.exxcellent.de/confluence/rest/api/"
    CREATE_SUB_PAGES: "true"
    REMOVE_ORPHANS: "true"
    COMPACT_CHAPTER_LABELS: "true"
    PAGE_PREFIX: ""
    PAGE_SUFFIX: ""
  before_script:
    - generate --type html
    - generate --type pdf

.documentation-check-confluence-validity:
  extends: .documentation-tool-common
  stage: verify
  needs: []
  variables:
    OUTPUT_DIR: merge_requests
  artifacts:
    paths: [ merge_requests/ ]
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
  script:
    - check-validity

.documentation-publish:
  extends: .documentation-tool-common
  stage: docs
  variables:
    OUTPUT_DIR: public
  script:
    - publish
  artifacts:
    paths: [ public/ ]
  rules:
    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH