倘若微小 - 为你和你的项目建立一个站点--Github Pages

什么是GitHub Pages?
- 两种站点服务
- 好处不言而喻
建站开始
- User or organization Site
- project Site

什么是GitHub Pages?

Github Pages是GitHub推出的一个新的服务
可以用来为你的GitHub账户和你的每一个托管在GitHub的项目建立一个web站点,show you and show your projects

两种站点服务

GitHub提供两种类型的站点服务:

User or organization Site – 个人或组织站点
Project Site – 项目站点

每一个GitHub用户只可以创建一个个人站点，同时，你可以建立多个项目站点

好处不言而喻

建立个人或组织站点，让更多的人更好的认识你或你的组织
建立项目站点，你可以可视化的展示你的每一个项目，而不是让你的partner(或者更多喜欢这个项目的人)看着一堆源代码而手足无措

你可以很轻松建立一个网站(尽管它是static),有专门的主机托管，还可以通过git进行版本控制，那不是很酷吗？

好了，该做出你的选择了…

建站开始

User or organization Site

创建一个仓库

从GitHub开始，创建一个名为username.github.io的仓库
其中,仓库名的第一部分username是你在GitHub上的用户名(或组织名)
假如username和你的用户名不匹配，站点将不能工作，因此，请确保它正确
在GirHub上新建一个仓库

选择你正在使用的git客户端

这里讲述三种客户端：

Terimal – 这种经常用在Unix或类Unix系统下(Linux,mac当然也可以)
GitHub for Windows – 一看就知道，这是windows下的客户端
GitHub for Mac – 这个是Mac下的客户端

好了，开始咯

Terimal(终端)

克隆刚创建的仓库

在terimal下转到你想存放你项目的地方，然后clone这个新的仓库

$ git clone https://github.com/username/username.github.io

Hello World

进入项目目录，新建一个index.html,如下

$ cd username.github.io
$ echo "Hello World" > index.html

push你的项目到github

添加，提交，推送你对项目做出的改变

$ git add --all
$ git commit -m "Initial commit"
$ git push

GitHub for Windows or Mac

Clone仓库

点击绿色的”Set up in Desktop”按钮
当GitHub桌面app打开，保存这个项目
从GitHub上启动桌面app
假如app没有启动，那么双击的桌面app启动它，并且在app里克隆你的项目

Create一个index.html文件

使用你最喜欢的编辑器，新建index.html,内容如下

<!DOCTYPE html>
<html>
<body>
<h1>Hello World</h1>
<p>I'm hosted with GitHub Pages.</p>
</body>
</html>

然后，添加到你的项目

commit && Sync

进入你的仓库(app里),commit你的变化，然后按下sync(同步)按钮
假如你在Windows下：
windows提交并同步变化到项目
假如你在Mac下：
Mac提交并同步变化到项目

未知区域

假如你不知道你的平台，额，我无能为力了

浏览你的网站吧

启动你的浏览器，输入http://username.github.io,然后，回车，接着，404，哈哈
等一下吧，新生成一个网站需要一段时间滴
时间也不是很长，大概10分钟吧
未来可能会做的更好，期待吧

project Site

创建项目站点，有两种办法

Generate a Site
Start from scratch

实际上两者创建了分支gh-pages，只是第一种办法是在当前项目的主分支的当前状态开辟新的分支；第二种则是开辟一个没有父节点的分支
说的简单点，第一种的gh-pages分支有当前项目的主分支的内容,所以被称为半路出家；而第二种则没有当前项目主分支的内容，完全像一个新的仓库,所以被称为白手起家(Start from scratch)