GitHub 页面快速入门

可以使用 GitHub Pages 展示一些开源项目，共享您的简历或托管博客。 本指南将帮助您开始创建下一个网站。

谁可以使用此功能？

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共存储库，以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和专用存储库。 有关详细信息，请参阅 GitHub的计划。

在本文中

简介

在本指南中，你将在 <username>.github.io 创建用户站点。

创建网站

  1. 输入 username.github.io 作为存储库名称。 将 username 替换为你的 GitHub 用户名。 例如，如果用户名为 octocat，则存储库名称应为 octocat.github.io。

           ![存储库中 GitHub Pages 设置的屏幕截图。 存储库名称字段包含文本“octocat.github.io”，并用深橙色框出。](/assets/images/help/pages/create-repository-name-pages.png)

  2. 选择仓库可见性。 有关详细信息，请参阅“关于仓库”。1. 将 README 切换为 开启。1. 单击“创建存储库”。1. 在仓库名称下，单击 “Settings”****。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”。

    存储库标头的屏幕截图，其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。
    1. 在边栏的“代码和自动化”部分中，单击“ Pages”****。

  3. 在“生成和部署”的“源”下，选择“从分支进行部署”。

  4. 在“生成和部署”的“分支”下，使用分支下拉菜单并选择发布源。

           ![GitHub 存储库中 Pages 设置的屏幕截图。 用于为发布源选择分支的菜单（标有“无”）用深橙色框出。](/assets/images/help/pages/publishing-source-drop-down.png)

  5. （可选）打开存储库的 README.md 文件。 README.md 文件是你将为站点编写内容的位置。 您可以编辑文件或暂时保留默认内容。

  6. 访问 username.github.io 以查看新网站。 请注意，对站点的更改在推送到 GitHub 后，最长可能需要 10 分钟才会发布。

更改标题和说明

默认情况下，站点的标题为 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. 编辑完文件后，请单击“Commit changes”****。

后续步骤

你已成功创建、个性化设置并发布了首个 GitHub Pages 网站，不过还有更多精彩功能等待你探索！ 以下是一些有用的资源，可帮助你对 GitHub Pages 执行后续操作：

  •         [AUTOTITLE](/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll#about-content-in-jekyll-sites)：本指南将介绍如何向站点添加其他页面。
  • 为 GitHub Pages 网站配置自定义域：你可以在 GitHub 的 github.io 域或自己的自定义域上托管站点。