refactor: add hidden base job

  # ENDSCRIPT

mkdocs:

  stage: build

.mkdocs-base:

  image: ${MKD_IMAGE}

  services:

    - name: "$TBC_TRACKING_IMAGE"

      command: ["--service", "mkdocs", "2.5.0"]

  before_script:

    - !reference [.mkdocs-scripts]

    - install_ca_certs "${CUSTOM_CA_CERTS:-$DEFAULT_CA_CERTS}"

    - cd "${MKD_WORKSPACE_DIR}"

mkdocs:

  extends: .mkdocs-base

  stage: build

  variables:

    PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"

  # Cache downloaded dependencies and plugins between builds.

    key: "$CI_COMMIT_REF_SLUG-mkdocs"

    paths:

      - ${PIP_CACHE_DIR}

  before_script:

    - !reference [.mkdocs-scripts]

    - install_ca_certs "${CUSTOM_CA_CERTS:-$DEFAULT_CA_CERTS}"

    - cd "${MKD_WORKSPACE_DIR}"

    - prepare_mkdocs

  script:

    - prepare_mkdocs

    - mkdocs build ${MKD_BUILD_ARGS}

  artifacts:

    name: "mkdocs build from $CI_COMMIT_REF_SLUG"

    expire_in: 1 day

mkdocs-lychee:

  extends: .mkdocs-base

  stage: test

  image:

    name: "$MKD_LYCHEE_IMAGE"

    entrypoint: [""]

  stage: test

  before_script:

    - !reference [.mkdocs-scripts]

    - install_ca_certs "${CUSTOM_CA_CERTS:-$DEFAULT_CA_CERTS}"

    - cd "${MKD_WORKSPACE_DIR}"

  script:

    - lychee ${MKD_LYCHEE_ARGS}

  rules: