Skip to main content

此版本的 GitHub Enterprise 已停止服务 2022-10-12. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

GitHub Pages 快速入门

您可以使用 GitHub Pages 来展示一些开源项目、主持博客甚或分享您的简历。 本指南将帮助您开始创建下一个网站。

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。

简介

GitHub Pages 是通过 GitHub Enterprise Server 托管和发布的公共网页。 启动和运行的最快方法是使用 Jekyll 主题选择器� 载预置主题。 然后,您可以修改 GitHub Pages 的内容和� �式。

本指南将引导� 在 username.github.io 创建用户站点。

创建网站

  1. 在任何页面的右上角,使用 下拉菜单选择“新建存储库”。 包含创建新存储库选项的下拉菜单

  2. 输入 username.github.io 作为存储库名称。 将 username 替换为� 的 GitHub 用户名。 例如,如果用户名为 octocat,则存储库名称应为 octocat.github.io存储库名称字段 1. 在存储库名称下,单击 “设置”。 “存储库设置”按钮

  3. In the left sidebar, click Pages. Page tab in the left-hand sidebar

  4. 单击“选择主题”。 “选择主题”按钮

  5. 主题选择器将打开。 浏览可用主题,然后单击“选择主题”以选择主题。 以后更改主题很容易,� 此,如果您不确定,请暂时选择一个。 “主题”选项和“选择主题”按钮

  6. 选择主题后,存储库的 README.md 文件将在文件编辑器中打开。 README.md 文件是� 将为站点编写内容的位置。 您可以编辑文件或暂时保留默认内容。

  7. 编辑完文件后,单击“提交更改”。

  8. 访问 username.github.io 以查看新网站。 注意:对站点的更改在推送到 GitHub Enterprise Server 后,最长可能需要 20 分钟才会发布。

更改� �题和说明

默认情况下,站点的� �题为 username.github.io。 可通过编辑存储库中的 _config.yml 文件来更改� �题。 您还可以为您的网站添� 说明。

  1. 单击存储库的“代� �”选项卡。

  2. 在文件列表中,单击 _config.yml 以打开该文件。

  3. 单击 编辑文件。

  4. _config.yml 文件已包含指定站点主题的行。 添� 一个新行,其中 title: 后跟所需的� �题。 添� 一个新行,其中 description: 后跟所需的描述。 例如:

    theme: jekyll-theme-minimal
    title: Octocat's homepage
    description: Bookmark this to keep an eye on my project updates!
    
  5. 编辑完文件后,单击“提交更改”。

后续步骤

若要详细了解如何向网站添� 其他页面,请参阅“使用 Jekyll 向 GitHub Pages 站点添� 内容”。

若要详细了解如何使用 Jekyll 设置 GitHub Pages 站点,请参阅“关于 GitHub Pages 和 Jekyll”。