Gitlab不为我呈现HTML,只显示源代码:
背景:我使用sphinx生成html,并试图在gitlab上显示文档。
我查看了其他项目的存储库,如pandas
,sphinx
。它们在存储库中只有.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(工作方式不同)。
最后,
我查看了其他项目的存储库,如
pandas
,sphinx
。它们在存储库中只有.rts
文件,而不是html文件。我猜他们会为他们的网站生成html,但不会上传到git。很可能,文件是唯一存在的源,HTML是从它们自动生成的。reStructured Text。如果您对使用另一种格式(如标记或重新构造的文本)感兴趣,您可能希望浏览gitlab页面'Sphinx this format by default。