静态站点和GitLab页面域

本文档是一个全面指南的开始，为那些想要使用GitLab Pages发布网站但不熟悉所涉及的整个过程的人而编写。

这第一个文档本系列的文章将向您介绍静态站点的概念，并介绍默认Pages域是如何工作的。

的第二个文档涵盖如何开始与GitLab页面:部署一个网站从一个分叉的项目或创建一个新的从零开始。

的第三个文档将向您展示如何为已部署的站点设置自定义域或子域。

的第四个文件将向您展示如何为GitLab页面创建和调整GitLab CI。

来启用GitLab CE(社区版)和GitLab EE(企业版)的GitLab页面，请阅读管理文档，和/或看这个视频教程．

注意:在本指南中，我们假设您已经为您的GitLab实例启动并运行了GitLab Pages服务器。

在开始之前你需要知道的

在我们开始之前，让我们先了解几个概念。

GitLab Pages只支持静态网站，也就是说，你的输出文件必须是HTML、CSS和JavaScript。

要创建静态站点，可以用HTML、CSS和JS硬编码，也可以使用静态站点生成器(SSG)简化代码并为您构建静态站点，这是非常值得推荐的，而且比硬编码快得多。

如果你在GitLab.com上建立了一个GitLab Pages项目，它将自动在一个子域名的namespace.gitlab.io．的名称空间由您在GitLab.com上的用户名或您在其中创建此项目的组名定义。

注意:如果您使用自己的GitLab实例来部署带有GitLab Pages的站点，请与系统管理员确认您的Pages通配符域是什么。本指南适用于任何GitLab实例，您只需要在GitLab.com上替换Pages通配符域(* .gitlab.io)和你自己的。

了解更多名称空间．

您创建了一个名为博客在你的用户名下约翰，因此您的项目URL为https://gitlab.com/john/blog/．一旦您为这个项目启用了GitLab Pages，并构建了您的站点，它将在下面可用https://john.gitlab.io/blog/．
你为你所有的网站创建了一个组网站，这个组中的一个项目称为博客．您的项目URL为https://gitlab.com/websites/blog/．一旦为该项目启用了GitLab Pages，该站点将位于https://websites.gitlab.io/blog/．

在你的用户名下，约翰，您创建了一个名为john.gitlab.io．您的项目URL将是https://gitlab.com/john/john.gitlab.io．一旦你为你的项目启用了GitLab Pages，你的网站将在下面发布https://john.gitlab.io．
在你的小组下网站，您创建了一个名为websites.gitlab.io．您的项目的URL将是https://gitlab.com/websites/websites.gitlab.io．一旦你为你的项目启用了GitLab Pages，你的网站将在下面发布https://websites.gitlab.io．

注意:GitLab页面做不支持子组．只能创建最高级别的群组网站。

一般的例子: