GitHub Pages 入门
您可以为个人、组织或项目设置基本的 GitHub Pages 站点。
谁可以使用此功能?
GitHub Pages 可用于具有 GitHub Free 和 GitHub Free for organizations 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。有关更多信息,请参阅“GitHub 的套餐”。
GitHub Pages 现在使用 GitHub Actions 来执行 Jekyll 构建。当使用分支作为构建源时,如果要使用内置 Jekyll 工作流程,则必须在您的仓库中启用 GitHub Actions。或者,如果 GitHub Actions 不可用或已禁用,则将.nojekyll
文件添加到源分支的根目录将绕过 Jekyll 构建过程并直接部署内容。有关启用 GitHub Actions 的更多信息,请参阅“管理仓库的 GitHub Actions 设置”。
关于 GitHub Pages
您可以使用 GitHub Pages 直接从 GitHub 上的仓库托管关于个人、组织或项目的网站。
创建 GitHub Pages 站点
您可以在新的或现有的仓库中创建 GitHub Pages 站点。
使用自定义工作流程与 GitHub Pages
您可以通过创建工作流程文件或从预定义的工作流程中进行选择,来利用 GitHub Actions 和 GitHub Pages。
配置 GitHub Pages 站点的发布源
您可以配置 GitHub Pages 站点,以便在将更改推送到特定分支时发布,或者您可以编写 GitHub Actions 工作流程来发布您的站点。
删除 GitHub Pages 站点
您可以删除 GitHub Pages 站点。
取消发布 GitHub Pages 站点
您可以取消发布 GitHub Pages 站点,以便删除当前部署,并且站点不再可用。这与删除站点不同。
为 GitHub Pages 站点创建自定义 404 页面
当用户尝试访问站点上不存在的页面时,您可以显示自定义的 404 错误页面。
使用 HTTPS 保护 GitHub Pages 站点
HTTPS 添加了一层加密,可以防止其他人窥探或篡改您站点的流量。您可以为 GitHub Pages 站点强制执行 HTTPS,以便透明地将所有 HTTP 请求重定向到 HTTPS。
在 GitHub Pages 中使用子模块
您可以使用子模块与 GitHub Pages 将其他项目包含在站点的代码中。
排查 GitHub Pages 站点的 404 错误
本指南将帮助您排查可能看到 404 错误的常见原因。