# GitHub Pages 文档

GitHub Pages 将任何 GitHub 存储库转换为实时网站 - 无需单独托管。

## Links

### Getting started

* [GitHub 页面快速入门](/zh/pages/quickstart)

  可用于GitHub Pages展示开放源代码项目、主持博客，甚至共享简历。 本指南将帮助您开始创建下一个网站。

* [什么是 GitHub Pages?](/zh/pages/getting-started-with-github-pages/what-is-github-pages)

  你可以使用 GitHub Pages 直接从 GitHub 上的存储库托管介绍你自己、你的组织或你的项目的网站。

## Articles

* [GitHub 页面快速入门](/zh/pages/quickstart)

  可用于GitHub Pages展示开放源代码项目、主持博客，甚至共享简历。 本指南将帮助您开始创建下一个网站。

* [什么是 GitHub Pages?](/zh/pages/getting-started-with-github-pages/what-is-github-pages)

  你可以使用 GitHub Pages 直接从 GitHub 上的存储库托管介绍你自己、你的组织或你的项目的网站。

* [创建GitHub Pages网站](/zh/pages/getting-started-with-github-pages/creating-a-github-pages-site)

  您可以在新仓库或现有仓库中创建 GitHub Pages 站点。

* [GitHub Pages 限制](/zh/pages/getting-started-with-github-pages/github-pages-limits)

  了解 GitHub Pages 的限制和局限。

* [将自定义工作流与 GitHub Pages 配合使用](/zh/pages/getting-started-with-github-pages/using-custom-workflows-with-github-pages)

  您可以通过创建工作流文件或从预定义的工作流中进行选择，来利用 GitHub Actions 和 GitHub Pages。

* [为您的 GitHub Pages 网站配置发布源](/zh/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)

  你可以将你的 GitHub Pages 站点配置为在更改推送到特定分支时发布，也可以编写一个 GitHub Actions 工作流来发布你的站点。

* [删除GitHub Pages 站点](/zh/pages/getting-started-with-github-pages/deleting-a-github-pages-site)

  可以删除 GitHub Pages 站点。

* [取消发布 GitHub Pages 站点](/zh/pages/getting-started-with-github-pages/unpublishing-a-github-pages-site)

  可以取消发布 GitHub Pages 站点，以便删除当前部署并使该站点不再可用。 这与删除站点不同。

* [更改 GitHub Pages 站点的可见性](/zh/changing-the-visibility-of-your-github-pages-site)

  您可以管理项目站点的访问控制，通过公开或私下发布该站点。

* [为您的 GitHub Pages 网站创建自定义 404 页面](/zh/pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site)

  您可以自定义在人们尝试访问您站点上不存在的页面时显示的 404 错误页面。

* [使用 HTTPS 保护 GitHub Pages 服务](/zh/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https)

  HTTPS 增加一层加密，用于防止其他人窥探或篡改您的站点的流量。 您可对 GitHub Pages 站点强制实施 HTTPS，从而将所有 HTTP 请求透明地重定向到 HTTPS。

* [将子模块与 GitHub Pages 配合使用](/zh/pages/getting-started-with-github-pages/using-submodules-with-github-pages)

  您可以使用子模块与 GitHub Pages 集成，以在您的站点代码中包含其他项目。

* [排查 GitHub Pages 网站的 404 错误](/zh/pages/getting-started-with-github-pages/troubleshooting-404-errors-for-github-pages-sites)

  本指南将帮助你排查出现 404 错误的常见原因。

* [关于 GitHub Pages 和 Jekyll](/zh/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll)

  Jekyll 是一个静态站点生成器，内置 GitHub Pages 支持。

* [使用 Jekyll 创建 GitHub Pages 网站](/zh/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll)

  可以使用 Jekyll 在新的存储库或现有存储库中创建 GitHub Pages 站点。

* [使用 Jekyll 在本地测试 GitHub Pages 网站](/zh/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll)

  您可以在本地构建 GitHub Pages 站点，以预览和测试对站点的更改。

* [使用 Jekyll 将内容添加到 GitHub Pages 网站](/zh/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll)

  您可以在 GitHub Pages 上向 Jekyll 站点添加新页面或帖子。

* [使用 Jekyll 为 GitHub Pages 网站设置 Markdown 处理器](/zh/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll)

  您可以选择一个 Markdown 处理器来确定 Markdown 在 GitHub Pages 站点上的呈现方式。

* [使用 Jekyll 向 GitHub Pages 网站添加主题](/zh/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll)

  您可以通过添加和自定义主题来个性化 Jekyll 站点。

* [关于 GitHub Pages 站点的 Jekyll 构建错误](/zh/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites)

  如果 Jekyll 在本地或在 GitHub Pages 上构建你的 GitHub 站点时遇到错误，你将收到一条包含更多信息的错误消息。

* [排查 GitHub Pages 网站的 Jekyll 生成错误](/zh/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites)

  您可以使用 Jekyll 构建错误消息来排查 GitHub Pages 站点的问题。

* [关于自定义域名和 GitHub 页面](/zh/pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages)

  GitHub Pages 支持使用自定义域，或者将网站 URL 的根目录从默认域（例如 `octocat.github.io`）更改为你拥有的任何域。

* [管理 GitHub Pages 网站的自定义域](/zh/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site)

  您可以设置或更新某些 DNS 记录和仓库设置，以将 GitHub Pages 站点的默认域指向自定义域。

* [验证 GitHub Pages 的自定义域](/zh/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages)

  您可以通过验证您的域来提高自定义域的安全性并避免接管攻击。

* [自定义域和 GitHub Pages 故障排除](/zh/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages)

  可以检查是否存在常见错误，以解决网站 GitHub Pages 自定义域或 HTTPS 的问题。