使用Github Pages和Jekyll创建个人博客

Posted by mainliufeng on March 28, 2015

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文档Github帮助

也可以到Jekyll Theme下载主题使用

Jekyll Theme