Github Pages 依靠 Github 上项目的某些特定分支来工作。Github Pages 分为两种基本类型:用户/组织的站点和项目的站点。搭建这两种类型站 点的方法除了一小些细节之外基本一致。
用户和组织的站点
用户和组织的站点被放置在一个特殊的专用仓库中,在该仓库中只存在 Github Pages 的相关文件。这个仓库应该根据用户/组织的名称来命名, 例如: @mojombo 的用户站点仓库的用户站点仓库 应该被命名为mojombo.github.io
。
仓库中master
分支里的文件将会被用来生成 Github Pages 站点,所以请 确保你的文件储存在该分支上。
项目的站点
不同于用户和组织的站点,项目的站点文件存放在项目本身仓库的gh-pages
分支中。该分支下的文件将会被 Jekyll 处理,生成的站点会被 部署到你的用户站点的子目录上,例如username.github.io/project
(除非指定了一个自定义的域名)。
Jekyll 项目本身就是一个很好的例子,Jekyll 项目的代码存放在master
分支 , 而 Jekyll 的项目站点(就是你现在看见的网页)包含在同一仓库的gh-pages
分支中。
安装Jekyll
Github上的Jekyll帮助
,对Jekyll的安装描述的很详细
创建站点
也可以到Jekyll Theme
下载主题使用