GitHub Pages 使用入门

Github

A-什么是 GitHub Pages

打开 GitHub Pages 的首页我们会看到如下图所示：

他可以当做你或者你的项目的 Websites，那么我们可以知道 GitHub Pages 有两种最基本的用法：

1. 作为你自己（或者组织）的网站（访问地址示例：http://username.github.io）
2. 作为你某一个项目的网站（访问地址示例：http://username.github.io/projectname）

B-用作自己（或者组织）的网站

一、创建一个仓库

并以 username.github.io 作为仓库名，其中 username 是你 github 的用户名，这个名字不能出错。如果出错，那么需要你删掉这个仓库重来，更改仓库名是无效的。

二、为此仓库添加内容

你可以直接在 github 网站上的此项目的仓库下直接点击 create new file（比如index.html），然后输入内容，并保存。也可以将此项目从 github 克隆到本地，然后在本地添加要展示的内容，并 push 到远程仓库。

三、访问

完成以上步骤，你就可以在浏览器用 http://username.github.io 格式的网址访问你的网页了。
注意：在访问之前你可能需要等待一段时间，等待刷新 github 分配的新域名。
至此，你的网站就可以正常使用了。

四、个性化设置

你可以在此项目的 Setting 选项下边更改你的个性化设置，比如绑定你的个人域名、开启 HTTPS 等等。

C-用作某一个项目的网站

一、创建一个仓库

如果是为已有项目创建，此步省略，直接进入下一步。

二、创建 index.html 并提交

这里只提一种在线操作的方式，你也可以将仓库克隆下来到本地操作
1. 进入目标仓库，点击 create new file

2. 提交文件

这里需要注意的是选择提交到哪个分支，你可以像图中那样提交到 master分支，但我建议你创建一个 gh-pages 分支，这样更新项目的网站就不会影响项目的开发。

三、设置 GitHub Pages 的 source

点击项目的 Settings 按钮，找到 GitHub Pages 选项，然后选择相应的分支作为 source，如果你在上一步选择了创建 gh-pages 分支，那么这里就无需设置，因为 github 默认 gh-pages 分支作为项目的 GitHub Pages source，当你创建 gp-pages 分支的时候就会自动为你设置好。

四、访问

为项目创建的 websit 的网址格式是：http://username.github.io/projecname

D-用 GitHub Pages 测试静态网页

通过以上内容，你应该可以发现，GitHub Pages 是可以测试静态网页的，操作也很简单。在完成以上两种设置的任何一种后，将需要测试的文件（如：test.html）放到对应的目录下（为方便，放在和上文中的 index.html 同一目录下是最佳选择），然后就可以以一下格式网址访问静态网页：
http://username.github.io/test.html
或
http://username.github.io/projecname/test.html

E-结尾的 PS

GitHub Pages 还有许多其他用处，你可以参看其官方帮助文档，如果你想把它作为你的博客，那么还有 jekyll 等开源项目能帮你减少许多工作量。