Pages
通过 GitCode 提供的 Pages App,您可以直接从 GitCode 中的仓库发布静态站点。
- 用于任何个人或企业网站
- 使用任何静态站点生成器(SSG)或纯 HTML
- 为您的项目,组织或用户帐户创建网站
- 免费在 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 网站:
- 通过 Push / Commit / MR 代码到指定部署的分支进行 Pages 网站更新;
- 通过 Pages 设置界面的 更新 Pages 按钮进行 Pages 网站更新;
Pages 设置界面:
- 从项目菜单栏点击 Pages 或从 【项目设置】-【Apps】点击 Pages 进入
- 选择 Pages 模板,目前支持 hugo / mdbook / html 三种
- 选择需要部署的分支
- 如果是 html ,还可以指定 部署 Html 的路径
- 最后点击保存更改即可,系统将会自动部署您选择好的分支
工作原理
要使用 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
的项目 - 在该项目中启用 Pages,等待 Pages 服务部署成功
- 访问
https://<namespace>.gitcode.host
即可访问 部署好的 Pages 项目
Pages 项目示例
有一些因特定原因而建立的 Pages 网站项目示例, 这些示例可以教您 Pages 的高阶用法并适应您自己的需求,当然更多的使用方法及技巧还需要您自己去使用和发现: