我可以在 GitLab 上渲染 HTML 吗？

Question

GitLab 不为我呈现 HTML，而只是显示源代码：

背景：我使用 sphinx 生成 HTML 并尝试在 GitLab 上显示文档。

我查看了其他项目的存储库，例如 pandas ， sphinx 。他们只有 .rts 存储库中的文件，而不是 HTML 文件。我猜他们会为他们的网站生成 HTML，但不会上传到 Git。

我没有网站，想在 GitLab 上展示文档。有没有办法做到这一点？还是我必须生成其他格式（HTML 除外，例如 PDF）？

原文由 YJZ 发布，翻译遵循 CC BY-SA 4.0 许可协议

Answer 1

首先，Git 与 GitLab 和 GitHub 等产品是不同的东西。 Git 从不渲染任何东西；这是一个版本控制系统。它没有网络界面。

其次，GitLab 的核心产品不 应该 渲染任何东西。它不是网络主机，而是用于托管、共享和管理 Git 存储库的工具。但是你可能想尝试 GitLab Pages ：

GitLab Pages 是一项允许您直接从 GitLab 中的存储库发布静态网站的功能。

您可以将它用于个人或企业网站，例如投资组合、文档、宣言和业务演示。您还可以将任何许可归因于您的内容。

所有 GitLab.com 用户以及自我管理的实例（GitLab Core、Starter、Premium 和 Ultimate）均可免费使用 Pages。

GitLab Pages 将从您的存储库的 public/ 目录发布内容，因此您应该将文件移到那里。您还需要在存储库的根目录中包含一个 .gitlab-ci.yml 文件，其中包含类似

image: alpine:latest

pages:
  stage: deploy
  script:
  - echo 'Nothing to do...'
  artifacts:
    paths:
    - public
  only:
  - master

（取自 示例存储库）。添加该文件，然后提交并推送。部署完成后，您的站点应该 在 https://youruser.gitlab.io/yourproject 可用。

请注意，GitHub 有 类似的产品（工作方式不同）。

最后，

我查看了其他项目的存储库，例如 pandas ， sphinx 。他们只有 .rts 存储库中的文件，而不是 HTML 文件。我猜他们会为他们的网站生成 HTML，但不会上传到 Git。

重组文本 文件很可能是唯一存在的来源，并且 HTML 是从中自动生成的。 Sphinx 默认采用这种格式。如果您对使用 Markdown 或重组文本等其他格式感兴趣，您可能想探索 GitLab Pages 对静态站点生成器的支持。

原文由 Chris 发布，翻译遵循 CC BY-SA 4.0 许可协议

Answer 2

我在 这篇文章 中找到了一个超级简单的解决方案：

前：

https://gitlab.com/[用户]/[存储库]/raw/[分支]/[文件名.ext]

后：

开发（节流）

https://gl.githack.com/[用户]/[存储库]/raw/[分支]/[文件名.ext]

生产（CDN）

https://glcdn.githack.com/[用户]/[存储库]/raw/[分支]/[文件名.ext]

原文由 j_5chneider 发布，翻译遵循 CC BY-SA 4.0 许可协议