GitLab 不会为我呈现 HTML，而只是显示源代码：
背景：我使用 sphinx 生成 HTML 并尝试在 GitLab 上显示文档。
我查看了其他项目的存储库，例如pandas、sphinx。他们在存储库中只有 .rts 文件，而不是 HTML 文件。我猜他们会为自己的网站生成 HTML，但不会上传到 Git。
我没有网站，想在 GitLab 上展示文档。有没有办法做到这一点？还是我必须生成其他格式（HTML 除外，例如 PDF）？
【问题讨论】：
标签： html git gitlab python-sphinx
首先，Git 和 GitLab 和 GitHub 等产品是不同的东西。 Git 从不渲染任何东西。这是一个版本控制系统。它没有网络界面。
其次，GitLab 的核心产品不应该渲染任何东西。它不是一个网络主机，它是一个托管、共享和管理 Git 存储库的工具。不过你可能想试试GitLab Pages:
GitLab 页面是一项功能，可让您直接从 GitLab 的存储库中发布静态网站。
您可以将其用于个人或商业网站，例如作品集、文档、宣言和商业演示文稿。您还可以将任何许可归属于您的内容。
页面可供所有 GitLab.com 用户以及自我管理的实例（GitLab Core、Starter、Premium 和 Ultimate）免费使用。
GitLab Pages 将从存储库的 public/ 目录发布内容，因此您应该将文件移到那里。您还需要在存储库的根目录中有一个 .gitlab-ci.yml 文件，其中包含类似
image: alpine:latest
pages:
stage: deploy
script:
- echo 'Nothing to do...'
artifacts:
paths:
- public
only:
- master
（取自sample repository）。添加该文件，然后提交并推送。部署完成后，您的站点应该是available at https://youruser.gitlab.io/yourproject。
请注意，GitHub 有 a similar product（工作方式不同）。
最后，
我查看了其他项目的存储库，例如
pandas、sphinx。他们在存储库中只有.rts文件，而不是 HTML 文件。我猜他们会为自己的网站生成 HTML，但不会上传到 Git。
reStructured Text 文件很可能是唯一存在的源，并且 HTML 是从它们自动生成的。 Sphinx this format by default。如果您对使用其他格式（如 Markdown 或 reStructured Text）感兴趣，您可能需要探索 GitLab Pages 的 support for static site generators。
【讨论】：