利用Github Pages建立仓库“门面”

嘛是Github Pages？

Github Pages 是一个静态网站托管服务，用来从你的Github仓库中直接发布
个人、组织或项目的网站页面

Github Pages发布的页面统一使用github.io域名，网站名称一般为
http(s)://<username>.github.io/<projectname>或者
http(s)://<orgname>.github.io/<projectname>

使用时有如下要求：

• Github Pages源仓库不应超过1GB
• 发布的网站大小不应该超过1GB
• Github Pages网站每月有100GB的带宽和100000请求量的限制
• Github Pages网站每小时构建次数不超过10次

配置Github Pages源仓库

Github Pages源文件可以配置为master、gh-pages分支或者master分支中的/docs文件夹，
如果是个人或组织的网站页面（域名为http(s)://<username>.github.io/或http(s)://<orgname>.github.io/）
则其源文件只可以配置为对应仓库（仓库名对应为<username>.github.io或<orgname.github.io>）的master分支

默认情况下Github Pages功能是被关闭的，可以在仓库的设置页面中的Github Pages面板看到：

配置项Source就是指Github Pages的源文件，
这里我选择了master分支下的/docs文件夹作为网站源文件目录，
然后单击旁边的Save按钮即可

接着我们就可以看到提示

这时候单击这个连接我们就可以看到一个404的页面（囧~~），
因为我们的/docs目录下还没有网站文件，默认是显示源目录下的index.html文件，
我们可以拷贝下来版本库自己编辑页面，可以通过Github提供的自动生成器来生成

生成Github Pages首页

设置页面中Github Pages面板下提供的Launch automatic page generator功能可以让我们使用指定模板生成单页面网站，

在弹出的页面中设置项目名称，页面标题，以及页面内容即可，
页面内容可以从README.md文件中导入并且支持MarkDown语法

编辑完成后单击Continue to layouts来选择要使用的布局模板

在上方选择模板，然后在下方进行预览，如果有不满意的地方，
点击右上角Edit按钮返回编辑页面，完成后点击Publish pages页面发布页面即可

然后就可以通过之前生成的链接来访问生成的页面了，这个时候再去/docs目录下看一下，
就会发现已经自动生成了一大堆的文件，自动生成器仅可以在改变Source的时候使用，
以后再更新页面可以通过修改源文件或使用Jekyll静态页面生成工具来实现

生成个人主页

之前生成的是某个仓库的项目主页（链接为http(s)://<username>.github.io/<projectname>），
若是想生成个人主页（链接为http(s)://<username>.github.io/）则只需添加名为<username>.github.io的仓库，
并设置相对应的Github Pages即可

参考连接：
https://help.github.com/articles/what-is-github-pages/
https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/
https://help.github.com/articles/creating-pages-with-the-automatic-generator/