GithubPages教程 在GithubPages上搭建项目主页
版权声明：转载请注明本文转自严振杰的博客: http://blog.csdn.net/yanzhenjie1003
对我的博客感情趣的同学可以加我博客左侧的群来一起交流学习，共同进步。本篇博客公有三个目的，同样也会举三个实际操作的例子来和大家一起玩Github pages。
第一个目的，有的开发者平常会做自己的网站，大部分是还是买的空间吧，有人买的阿里云、新浪SEA或者linode、aws加nginx，今天看完这篇博客，你就可以用Github Pages免费搭建自己的主页了。
第二个目的，如何在Github为自己的帐号（个人或者组织）搭建个人主页，比如我的Github地址是：https://github.com/yanzhenjie，我为自己的帐号搭建的主页就是https://yanzhenjie.github.io。
（由于篇幅太长，在Github为自己的帐号（个人或者组织）搭建个人主页传送门）
第三个目的，如何为自己在Github上的开源项目搭建项目主页，比如我的开源项目NoHttp的Github地址是：https://github.com/yanzhenjie/NoHttp，我为NoHttp搭建的项目主页就是https://yanzhenjie.github.io/NoHttp。
我的个人主页就放在Github Pages并且绑定了我的域名：yanzhenjie.com，非常好记：严振杰.com，是不是一下就记住了，如果没有请再记一次，记不住就不要往下看了，哈哈哈开个玩笑啦。
Github Pages是什么
Github Pages主页：https://pages.github.com，其实官网这里已经有教程了，怕好多同学看不懂，所以来一篇博客。
Github Pages是什么，来自官网的解释：https://help.github.com/articles/what-are-github-pages，不想打开官网的人看图片：
不要夸我，我就是这么贴心，提大家翻译好了中文版： 
按我的理解，Github Pages是Github免费提供给开发者的一款托管个人网站的产品，这绝对是个好东西啊。目前来看只能托管静态内容，但是这已经足够我们用了，如果咱发挥的好，犹如鲤鱼跃龙门啊。
Github Pages怎么玩
我刚开始做这事之前也不知道怎么办，我有个习惯就是对于不明白的事情习惯去官网看帮助，于是乎我看了Github Helper：https://help.github.com/，我看到这里的时候心中大喜，其实这就是教程，不够是英文版的，喜欢的同学也可以直接去看：
我是一步步看过来的，为了不浪费大家时间，我们只要看这条就行：User, Organization, and Project Pages。这里我把最重要的信息贴出来：
看到这里我就基本猜到了要怎么做了，后面的就不一一带各位看了，我直接说原理。Github的个人主页是可以绑定一个域名的，后面带各位看官一步步实现。在没有绑定自己的域名之前，这里的地址都是有规律的，比如我的帐号是yanzhenjie，那么我的主页地址就是yanzhenjie.github.io，比如我的帐号是xxoo，那么我的主页地址就是xxoo.github.io；比如我的项目叫NoHttp，那么项目对应的地址就是yanzhenjie.github.io/NoHttp。如果你是组织帐号也一样。
为Github上的开源项目搭建项目主页
比如我的开源项目NoHttp的Github地址是：https://github.com/yanzhenjie/NoHttp，我的项目主页就是https://yanzhenjie.github.io/NoHttp。那么地址规则我们知道，我们是不是要为项目再建一个项目主页的仓库呢，答案是不需要。下面用Github Pages官网的两种办法来讲解：
官网给的两种方案
来教大家看Github Pages官网的教程，打开Github Pages官网：https://pages.github.com/，这里选中Project site项目网站，下面会出来两个选项，Generate a site（生成一个网站）和Start from scratch（从头开始）：
两个方案的区别是，第一个由Github Pages自动生成，我们只需要用Markdown填写内容即可，Github Pages最后会提供给我们几套模板供我们选择，大大的节省了我们开发的成本。第二个和上面搭建个人主页一样，需要我们自己写网页。
方案一、用Github的工具生成一个网站
上面用鼠标选择一号方案Generate a site，下面会出来英文版的教程，这里不再赘述。
第一步在项目主页，选择Setting标签，接着会出现下面的画面：
然后往下拉会看到一个GitHub Pages的tab，点击这里的Launch automatic page generator按钮：
点击后会打开一个网站编辑页面：
我们可以用Markdown写我们网站的内容，当然如果你的ReadMe写的好话，直接点击Load README.md就自动生成了网站内容。最后点击网站右下角的Continue to layouts去选择网站的模板后确定就立刻生成网站内容了，而且有项目下载连接等，非常人性化：
这个时候我们可以输入我们项目主页的地址去访问了，比如NoHttp的地址：yanzhenjie.github.io/NoHttp，这里要注意，如果你的个人主页已经搭建好了，这里的地址也可以是你的域名+/项目名称，比如我的：www.yanzhenjie.com/NoHttp。
方案二、完全由自己从头开始一个网站
还是回去上面用鼠标选择二号方案Start from scratch，下面也会出现英文版的教程。二号方案要求我们为项目新建一个名为’gh-pages’的分支，其实一号方案做好后我们也会发现，系统为我们自动新建了一个gh-pages的分支。
下面新建分支，在项目主页，点击分支预览按钮，会出现一个输入框和你的所有分支，这里我们输入gh-pages，下面会出现Create branch gh-pages的一栏，点击这一栏就创建好了：
创建好分支后，下面要把gh-pages设置为默认分支，然后为这个分支提交网站内容即可，在项目主页选择Setting，然后选择左侧的Braches，在右侧的按钮中选择gh-pages分支即可：
最后就是往这个分支添加内容了，如何提交内容到Github请求参考上一篇博客。
版权声明：转载请注明本文转自严振杰的博客: http://blog.csdn.net/yanzhenjie1003