4. 建立主页

很多开源项目托管平台都支持为托管的项目建立主页，但主页的维护方式都没有GitHub这么酷。大多数托管平台无非是开放一个FTP或类似服务，用户把制作好的网页或脚本上传了事，而在GitHub用户通过创建特殊名称的Git版本库或在Git库中建立特别的分支实现对主页的维护。

创建个人主页

GitHub 为每一个用户分配了一个二级域名.github.io,用户为自己的二级域名创建主页很容易，只要在托管空间下创建一个名为.github.io 的版本库，向其master分支提交网站静态页面即可，其中网站首页为index.html。下面以gotgithub用户为例介绍如何创建个人主页。

• 用户gotgithub创建一个名为gotgithub.github.io的Git版本库。
• 在本地克隆新建立的版本库。

$ git clone [email protected]:gotgithub/gotgithub.github.io.git
$ cd gotgithub.github.io/

• 在版本库根目录中创建文件index.html作为首页。
  $ printf "

  GotGitHub's HomePage

  It works.\n" > index.html
• 建立提交。

$ git add index.html
$ git commit -m "Homepage test version."

• 推送到GitHub，完成远程版本库创建。

$ git push origin master

访问网址： http://gotgithub.github.io/ 最多等待10分钟，GitHub就可以完成新网站的部署。网站完成部署后版本库的所有者会收到邮件通知。还有要注意访问用户二级域名的主页要使用HTTP协议非HTTPS协议。

创建项目主页

如前所述，GitHub会为每个账号分配一个二级域名.github.io作为用户的首页地址。实际上还可以为每个项目设置主页，项目主页也通过此二级域名进行访问。例如gotgithub用户创建的helloworld项目如果启用了项目主页，则可通过网址http://gotgithub.github.io/helloworld/ 访问。
为项目启用项目主页很简单，只需要在项目版本库中创建一个名为gh-pages的分支，并向其中添加静态网页即可。也就是说如果项目的Git版本库中包含了名为gh-pages分支的话，则表明该项目提供静态网页构成的主页，可以通过网址http://.github.io/访问到。
下面以用户gotgithub的项目helloworld为例，介绍如何维护项目主页。

如果本地尚未从GitHub克隆helloworld版本库，执行如下命令。

$ git clone [email protected]:gotgithub/helloworld.git
$ cd helloworld

当前版本库只有一个名为master的分支，如果直接从master分支创建gh-pages分支操作非常简单，但是作为保存网页的gh-pages分支中的内容和master分支中的可能完全不同。如果不希望gh-pages分支继承master分支的历史和文件，即想要创建一个干净的gh-pages分支，需要一点小技巧。

• 基于master分支建立分支gh-pages。

$ git checkout -b gh-pages

• 删除暂存区文件，即相当于清空暂存区。

$ rm .git/index

• 创建项目首页index.html。

$ printf "hello world.\n" > index.html

• 添加文件index.html到暂存区。

$ git add index.html

• 用Git底层命令创建新的根提交，并将分支gh-pages重置。

$ git reset --hard $(echo "branch gh-pages init." | git commit-tree $(git write-tree))

• 执行推送命令，在GitHub远程版本库创建分支gh-pages。

$ git push -u origin gh-pages

无论哪种方法，一旦在GitHub远程版本库中创建分支gh-pages，项目的主页就已经建立。稍后（不超过10分钟），用浏览器访问下面的地址即可看到刚刚提交的项目首页： http://gotgithub.github.io/helloworld/ 。