|
|
|
# Pages
|
|
|
|
|
|
|
|
通过 CODE CHINA 提供的 Pages App，您可以直接从 CODE CHINA 中的仓库发布静态站点。
|
|
|
|
|
|
|
|
* 用于任何个人或企业网站
|
|
|
|
* 使用任何静态站点生成器（SSG）或纯 HTML
|
|
|
|
* 为您的项目，组织或用户帐户创建网站
|
|
|
|
* 免费在 CODE CHINA上托管您的网站
|
|
|
|
|
|
|
|
> 注：Pages App 目前仅针对 [认证组织](/docs/user/org/star-community-join-plan) 开放使用。
|
|
|
|
|
|
|
|
要发布包含 Pages 的网站，您可以使用任何 SSG，例如 Hugo，Mdbook 等（后续我们将还支持 Jekyll、Hexo 等）；您还可以发布直接用纯 HTML，CSS 和 JavaScript 编写的任何网站。
|
|
|
|
|
|
|
|
Pages***\*不\****支持动态服务器端的处理，例如 `.php`和`.asp` 等。
|
|
|
|
|
|
|
|
|
|
|
|
## 新手入门
|
|
|
|
|
|
|
|
如何搭建一个 Pages 网站：
|
|
|
|
|
|
|
|
| Pages 模板 | 说明 |
|
|
|
|
| --- | --- |
|
|
|
|
| [使用 Hugo 模板](/docs/user/project/pages/hugo) | 使用 Hugo 模板来搭建 Pages 网站 |
|
|
|
|
| [使用 Mdbook 模板](/docs/user/project/pages/mdbook) | 使用 Mdbook 模板来搭建 Pages 网站 |
|
|
|
|
| [使用 Html](/docs/user/project/pages/html) | 使用纯 Html/CSS/JS 来搭建 Pages 网站 |
|
|
|
|
|
|
|
|
如果需要更新 Pages 网站：
|
|
|
|
|
|
|
|
- 通过 Push / Commit / MR 代码到指定部署的分支进行 Pages 网站更新；
|
|
|
|
- 通过 Pages 设置界面的 **更新 Pages** 按钮进行 Pages 网站更新；
|
|
|
|
|
|
|
|
Pages 设置界面：
|
|
|
|
|
|
|
|
[](/docs/img/pages-settings.png)
|
|
|
|
|
|
|
|
1. 从项目菜单栏点击 Pages 或从 【项目设置】-【Apps】点击 Pages 进入
|
|
|
|
2. 选择 Pages 模板，目前支持 hugo / mdbook / html 三种
|
|
|
|
3. 选择需要部署的分支
|
|
|
|
4. 如果是 html ，还可以指定 部署 Html 的路径
|
|
|
|
5. 最后点击保存更改即可，系统将会自动部署您选择好的分支
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 工作原理
|
|
|
|
|
|
|
|
|
|
|
|
要使用 Pages 页面，您必须在 CODE CHINA 中创建一个公开项目以将您网站的文件上传到该项目，我们将始终从资源库中一个非常特定的文件夹`public`部署您的网站。
|
|
|
|
|
|
|
|
|
|
|
|
为了部署您的站点，CODE CHINA 会通过 `CI / CD`来构建您的站点并将其发布到 Pages 服务器，在您选定您要创建的网站项目模板后（可以是 Hugo / Mdbook / Html 中的任意一种) ，我们会使用其对应的 `.gitlab-ci.yml`的脚本文件来运行 Pages 服务的 `Runner`及`job`，并将对应生成的 `Public` 部署到我们的 Pages 服务器上，完成 Pages 网站的部署工作。
|
|
|
|
|
|
|
|
目前我们提供的 Pages 服务域名默认为 `gitcode.host`，后续我们将会开放自定义域名功能。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Pages 项目示例
|
|
|
|
|
|
|
|
|
|
|
|
有一些因特定原因而建立的 Pages 网站项目示例， 这些示例可以教您 Pages 的高阶用法并适应您自己的需求，当然更多的使用方法及技巧还需要您自己去使用和发现：
|
|
|
|
|
|
|
|
- [基于 Mdbook 的电子图书](http://codechina.gitcode.host/programmer/2017/)
|
|
|
|
- [项目地址](https://codechina.csdn.net/codechina/programmer/2017)
|
|
|
|
- [基于 Hugo 的电子图书目录](https://codechina.gitcode.host/programmer/mdbook/)
|
|
|
|
- [项目地址](https://codechina.csdn.net/codechina/programmer/mdbook/-/tree/pages)
|
|
|
|
- [基于 Hugo 的 1024 长沙·中国 PDF 下载项目](https://codechina.gitcode.host/1024-changsha/)
|
|
|
|
- [项目地址](https://codechina.csdn.net/codechina/1024-changsha) |
|
|
\ No newline at end of file |
