通过 GitCode 提供的 Pages App,您可以直接从 GitCode 中的仓库发布静态站点。
注:Pages App 目前仅针对认证组织 开放使用。
要发布包含 Pages 的网站,您可以使用任何 SSG,例如 Hugo,Mdbook 等(后续我们将还支持 Jekyll、Hexo 等);您还可以发布直接用纯 HTML,CSS 和 JavaScript 编写的任何网站。
Pages不支持动态服务器端的处理,例如.php
和.asp
等。
如何搭建一个 Pages 网站:
Pages 模板 | 说明 |
---|---|
使用 Hugo 模板 | 使用 Hugo 模板来搭建 Pages 网站 |
使用 Mdbook 模板 | 使用 Mdbook 模板来搭建 Pages 网站 |
使用 Html | 使用纯 Html/CSS/JS 来搭建 Pages 网站 |
如果需要更新 Pages 网站:
Pages 设置界面:
要使用 Pages 页面,您必须在 GitCode 中创建一个公开项目以将您网站的文件上传到该项目,我们将始终从资源库中一个非常特定的文件夹public
部署您的网站。
为了部署您的站点,GitCode 会通过CI / CD
来构建您的站点并将其发布到 Pages 服务器,在您选定您要创建的网站项目模板后(可以是 Hugo / Mdbook / Html 中的任意一种) ,我们会使用其对应的.codechina-ci.yml
的脚本文件来运行 Pages 服务的Runner
及job
,并将对应生成的Public
部署到我们的 Pages 服务器上,完成 Pages 网站的部署工作。
目前我们提供的 Pages 服务域名默认为gitcode.host
,后续我们将会开放自定义域名功能。
<namespace>.gitcode.host
设置为 Pages 项目Pages 项目除了使用<namespace>.gitcode.host/repo_url
这种 链接形式外,我们还支持设置<namespace>.gitcode.host
这种二级域名形式的 Pages 项目,每个namespace 下最多支持一个项目使用这种二级域名的形式,其设置方法如下:
<namespace>.gitcode.host
的项目https://<namespace>.gitcode.host
即可访问 部署好的 Pages 项目有一些因特定原因而建立的 Pages 网站项目示例, 这些示例可以教您 Pages 的高阶用法并适应您自己的需求,当然更多的使用方法及技巧还需要您自己去使用和发现: