从分叉的示例项目创建 GitLab Pages 网站

GitLab 提供了最受欢迎的静态网站生成器（SSG）的示例项目。 你可以分叉其中一个示例项目并运行 CI/CD 管道来生成一个 Pages 网站。

当你想测试 GitLab Pages 或启动一个已经配置好生成 Pages 网站的新项目时，可以分叉一个示例项目。

观看此操作的视频教程。

要分叉一个示例项目并创建一个 Pages 网站：

1. 通过导航到 GitLab Pages 示例 组来查看示例项目。
2. 选择你想要分叉的项目的名称。
3. 在右上角，选择 分叉，然后选择要分叉到的命名空间。
4. 对于你的项目，在左侧边栏，选择 构建 > 管道，然后选择 新建管道。 GitLab CI/CD 会构建并部署你的网站。

网站可能需要大约 30 分钟才能部署完成。 当管道完成后，转到 部署 > Pages 来找到你的 Pages 网站的链接。

每次向你的仓库推送更改时，GitLab CI/CD 都会运行一个新管道， 立即将你的更改发布到 Pages 网站。

移除分叉关系

如果你想为你分叉的项目做出贡献， 可以保留分叉关系。否则：

1. 在左侧边栏，选择 设置 > 常规。
2. 展开 高级设置。
3. 选择 移除分叉关系。

更改 URL

你可以更改 URL 以匹配你的命名空间。 如果你的 Pages 网站托管在 GitLab.com 上， 你可以将其重命名为 <namespace>.gitlab.io，其中 <namespace> 是你的 GitLab 命名空间 （即你在分叉项目时选择的那个）。

1. 在左侧边栏，选择 设置 > 常规。

2. 展开 高级。

3. 在 更改路径 中，将路径更新为 <namespace>.gitlab.io。

   例如，如果你的项目 URL 是 gitlab.com/gitlab-tests/jekyll，你的命名空间就是 gitlab-tests。

   如果你将仓库路径设置为 gitlab-tests.gitlab.io， 你的 Pages 网站最终 URL 就是 https://gitlab-tests.gitlab.io。

   

4. 打开你的 SSG 配置文件，将基础 URL 从 "project-name" 更改为 ""。项目名称设置因 SSG 而异，可能不在配置文件中。

相关主题

• 下载任务产物