GitHub Pages 快速入门

简介

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

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

创建网站

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

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

3. In the "Code and automation" section of the sidebar, click Pages.

4. 单击“选择主题”。

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

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

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

8. 访问 username.github.io 以查看新网站。 注意：对站点的更改在推送到 GitHub 后，最长可能需要 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”。