gitlab - GitLab 页面可以用于审核 mkdocs 项目上的应用程序吗？

Question

This answer通过 @joki到 previous question建议通过为可浏览的工件提供公共(public) URL，将 GitLab 存储库中的每个事件分支部署到动态环境中。

使用 mkdocs material 来尝试一下项目中，我发现了两个问题。

首先，如果 GitLab 存储库位于组或子组内，则 .gitlab-ci.yml 文件中的 URL 需要类似于以下内容:

    environment:
        name: review/$CI_COMMIT_REF_NAME
        url: "$CI_PAGES_URL/-/jobs/$CI_JOB_ID/artifacts/public/index.html"
        auto_stop_in: 1 week
    variables:
        PUBLIC_URL: "$CI_PAGES_URL/-/jobs/$CI_JOB_ID/artifacts/public/"

其次，网站内的相对链接效果不佳，导致大量 404 错误，以及样式文件等内容的丢失。可能上面的 URL 不正确，或者 mkdocs.yml 中的 site_url 需要更改为如下内容:

site_url: !!python/object/apply:os.getenv ["CI_ENVIRONMENT_URL"]

但是，这些对我来说都不太有效。

具有非常小的部署和审查应用程序的最小 MR 可以是 found here .

有人有 mkdocs 评论应用程序的工作秘诀吗？

Answer 1

您可以在管道中构建步骤的“浏览”按钮中看到所需的 URL。

这个有用吗？

develop:
    artifacts:
        paths:
          - public

    environment:
        name: Develop
        url: "https://$CI_PROJECT_NAMESPACE.gitlab.io/-/snim2-test-subgroup/$CI_PROJECT_NAME/-/jobs/$CI_JOB_ID/artifacts/public/index.html"

    script: |
        # whatever

    stage: deploy

    variables:
        PUBLIC_URL: "/-/snim2-test-subgroup/$CI_PROJECT_NAME/-/jobs/$CI_JOB_ID/artifacts/public"

您还需要将 mkdocs.yml 更改为实际上 use the PUBLIC_URL ，并确保它在绝对的任何地方使用 internal links生成:

site_url: !!python/object/apply:os.getenv ["PUBLIC_URL"]
use_directory_urls: false
…