# 创建GitHub Pages网站
您可以在新仓库或现有仓库中创建 GitHub Pages 站点。
## 为站点创建仓库
可以为站点创建存储库或选择现有存储库。
如果存储库中并非所有文件都与站点相关，且要为存储库创建 GitHub Pages 站点，则能够为站点配置发布源。 例如，可以使用专用分支和文件夹来保存站点源文件，也可以使用自定义 GitHub Actions 工作流来生成和部署站点源文件。 若要将GitHub Actions用作GitHub Pages的发布源，网站管理员必须为GitHub Actions启用GitHub Enterprise Server。 有关详细信息，请参阅 [为 GitHub Enterprise Server 启用 GitHub Actions](/zh/enterprise-server@3.22/admin/managing-github-actions-for-your-enterprise/enabling-github-actions-for-github-enterprise-server)。
如果要在现有存储库中创建站点，请跳至[创建站点](#creating-your-site)。
1. 在任何页面的右上角，选择 ，然后单击“新建存储库”。
2. 使用“所有者”下拉菜单选择你想要拥有存储库的帐户。
3. 输入仓库的名称和说明（可选）。 如果要创建用户或组织站点，则存储库必须命名为 `.github.io` 或 `.github.io`。 如果您的用户或组织名称包含大写字母，您必须小写字母。
有关详细信息，请参阅“[什么是 GitHub Pages?](/zh/enterprise-server@3.22/pages/getting-started-with-github-pages/what-is-github-pages#types-of-github-pages-sites)”。
4. 选择仓库可见性。 有关详细信息，请参阅“[关于仓库](/zh/enterprise-server@3.22/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)”。
5. 将 **README** 切换为 **开启**。
6. 单击“创建存储库”。
## 创建站点
必须先在 GitHub 上有站点的仓库，然后才可创建站点。 如果未在现有存储库中创建站点，请参阅[为站点创建存储库](#creating-a-repository-for-your-site)。> \[!WARNING]
> 如果站点管理员已启用公共页面， GitHub Pages 则网站在 Internet 上公开可用，即使站点的存储库是专用的还是内部的。 如果站点的存储库中有敏感数据，你可能想要在发布前删除数据。 有关详细信息，请参阅 [为企业配置GitHub页面](/zh/enterprise-server@3.22/admin/configuring-settings/configuring-user-applications-for-your-enterprise/configuring-github-pages-for-your-enterprise#enabling-public-sites-for-github-pages) 和 [关于仓库](/zh/enterprise-server@3.22/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)。
1. 在 GitHub 上，导航到站点的仓库。
2. 确定要使用的发布源。 请参阅“[为您的 GitHub Pages 网站配置发布源](/zh/enterprise-server@3.22/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)”。
3. 为站点创建入口文件。 GitHub Pages 将查找 `index.html`、`index.md` 或 `README.md` 文件，作为站点的入口文件。
如果发布源是分支和文件夹，则入口文件必须位于源分支上源文件夹的顶层。 例如，如果发布源是 `/docs` 分支上的 `main` 文件夹，则入口文件必须位于名为 `/docs` 的分支上的 `main` 文件夹。
如果发布源是 GitHub Actions 工作流，则部署的项目必须在项目的顶层包含入口文件。 可以选择使用 GitHub Actions 工作流在工作流运行时生成入口文件，而不是将入口文件添加到存储库。
4. 配置发布源。 请参阅“[为您的 GitHub Pages 网站配置发布源](/zh/enterprise-server@3.22/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)”。
## 查看已发布的站点
1. 在仓库名称下，单击 “Settings”\*\*\*\*。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”。
1. 在边栏的“代码和自动化”部分中，单击“ Pages”\*\*\*\*。
2. 若要查看已发布的网站，请在“GitHub Pages”下单击“ Visit site”\*\*\*\*。
> \[!NOTE]
> 对站点的更改在推送到 GitHub 后，最长可能需要 10 分钟才会发布。 如果一小时后仍然在浏览器中看不到 GitHub Pages 站点更改，请参阅 [关于 GitHub Pages 站点的 Jekyll 构建错误](/zh/enterprise-server@3.22/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites)。> \[!NOTE]
>
> * 如果你将从分支发布，并且你的站点没有自动发布，请确保拥有管理员权限和经过验证的电子邮件地址的人已将其推送到发布源。
> * 由使用 `GITHUB_TOKEN` 的 GitHub Actions 工作流推送的提交不会触发 GitHub Pages 生成。
## 静态站点生成器
GitHub Pages 会发布您推送到仓库的任何静态文件。 您可以创建自己的静态文件或使用静态站点生成器为您构建站点。 您还可以在本地或其他服务器上自定义自己的构建过程。
如果使用自定义生成过程或 Jekyll 以外的静态站点生成器，可以编写 GitHub Actions 工作流来生成和发布站点。 GitHub 为多个静态站点生成器提供工作流模板。 有关详细信息，请参阅“[为您的 GitHub Pages 网站配置发布源](/zh/enterprise-server@3.22/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)”。
如果从源分支发布站点，GitHub Pages 将默认使用 Jekyll 生成站点。 如果想使用 Jekyll 以外的静态站点生成器，则建议编写 GitHub Actions 来生成和发布站点。 否则，通过在发布源的根目录中创建一个名为 `.nojekyll` 的空文件来禁用 Jekyll 生成过程，然后按照静态站点生成器的说明在本地生成站点。
> \[!NOTE] GitHub Pages 不支持服务器端语言，例如 PHP、Ruby 或 Python。
## GitHub Pages 上的 MIME 类型
MIME 类型是服务器发送到浏览器的标头，提供有关浏览器所请求文件性质和格式的信息。 GitHub Pages 支持数千种文件扩展名中 750 多种 MIME 类型。 支持的 MIME 类型列表是从 [mime-db 项目](https://github.com/jshttp/mime-db)生成的。
虽然无法基于每个文件或每个仓库指定自定义 MIME 类型，但您可以添加或修改 MIME 类型以在 GitHub Pages 上使用。 有关详细信息，请参阅 [mime-db 贡献指南](https://github.com/jshttp/mime-db#adding-custom-media-types)。
## 后续步骤
您可以通过创建更多新文件向网站添加更多页面。 每个文件都会在您的网站上以与发布源相同的目录结构提供。 例如，如果项目网站的发布源是 `gh-pages` 分支，并且你在 `/about/contact-us.md` 分支上创建了名为 `gh-pages` 的新文件，该文件将在 `http(s):///pages///about/contact-us.html` 下。
您还可以添加主题以自定义网站的外观。 有关详细信息，请参阅“[使用 Jekyll 向 GitHub Pages 网站添加主题](/zh/enterprise-server@3.22/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll)”。
## 其他阅读材料
* [关于 GitHub Pages 和 Jekyll](/zh/enterprise-server@3.22/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll)。
* [排查 GitHub Pages 网站的 Jekyll 生成错误](/zh/enterprise-server@3.22/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites)
* [管理存储库中的分支](/zh/enterprise-server@3.22/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository)
* [创建新文件](/zh/enterprise-server@3.22/repositories/working-with-files/managing-files/creating-new-files)
* [排查 GitHub Pages 网站的 404 错误](/zh/enterprise-server@3.22/pages/getting-started-with-github-pages/troubleshooting-404-errors-for-github-pages-sites)