Gitlab不为我呈现HTML,只显示源代码:
html - 我可以在GitLab上渲染HTML吗?-LMLPHP
背景:我使用sphinx生成html,并试图在gitlab上显示文档。
我查看了其他项目的存储库,如pandassphinx。它们在存储库中只有.rts文件,而不是html文件。我猜他们会为他们的网站生成html,但不会上传到git。
我没有网站,想在gitlab上展示医生。有办法吗?或者我必须生成其他格式(除了html,例如pdf)来代替?

最佳答案

首先,git和gitlab、github等产品是不同的。git从来不会呈现任何东西;它是一个版本控制系统。它没有网络接口。
其次,gitlab的核心产品不应该呈现任何内容。它不是一个web主机,而是一个托管、共享和管理git存储库的工具。不过,您可能想尝试GitLab Pages
Gitlab Pages是一项功能,允许您直接从Gitlab中的存储库发布静态网站。
您可以将它用于个人或企业网站,如公文包、文档、宣言和业务演示。您还可以为内容授予任何许可证。
所有gitlab.com用户以及自管理实例(gitlab core、starter、premium和ultimate)都可以免费使用页面。
gitlab页面将从存储库的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(工作方式不同)。
最后,
我查看了其他项目的存储库,如pandassphinx。它们在存储库中只有.rts文件,而不是html文件。我猜他们会为他们的网站生成html,但不会上传到git。
很可能,文件是唯一存在的源,HTML是从它们自动生成的。reStructured Text。如果您对使用另一种格式(如标记或重新构造的文本)感兴趣,您可能希望浏览gitlab页面'Sphinx this format by default

07-28 01:42
查看更多