Github

GitHub 是一个面向开源及私有软件项目的托管平台，因为只支持 Git 作为唯一的版本库格式进行托管，故名 GitHub。

GitHub Pages

GitHub Pages
Websites for you and your projects.
Hosted directly from your GitHub repository. Just edit, push, and your changes are live.
为您和您的项目的网站。
直接从您的GitHub存储库托管。只需编辑，推送，您的更改即可生效。

jekyll

Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录，其中包含原始文本格式的文档，通过一个转换器（如 Markdown）和我们的 Liquid 渲染器转化成一个完整的可发布的静态网站，你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 GitHub Page 上，也就是说，你可以使用 GitHub 的服务来搭建你的项目页面、博客或者网站，而且是完全免费的。

准备安装

Ruby（including development headers, Jekyll 2 需要 v1.9.3 及以上版本，Jekyll 3 需要 v2 及以上版本）
RubyGems
NodeJS, 或其他 JavaScript 运行环境（Jekyll 2 或更早版本需要 CoffeeScript 支持）。
Python Jekyll 2 或更早版本）

Linux, Unix, Mac OS 安装

$ gem install jekyll

Windows 安装

安装 Jekyll 的最好方式就是使用 RubyGems. 所有 Jekyll 的 gem 依赖包都会被自动安装
$ gem install jekyll

代码高亮

如果你是一个使用 Jekyll 的程序员，用 Pygments 或者 Rouge 来支持代码高亮吧

版本

查看你的Jekyll版本

1 2	jekyll --version gem list jekyll

你可以在RubyGem找到任何gem软件包的最新版本，同时也可以通过gem命令行工具来查看：

gem search jekyll --remote
这样你会查到名为jekyll的gem包，并且在方括号中显示最新版本。另一个检查本机是否是最新版本的办法是执行命令gem outdated，它会显示出当前系统中所有需要更新的gem包列表，如果你的jekyll不是最新版本，执行命令：

gem update jekyll

搭建

创建Github仓库

登录 Github
点击 “+” 选择 New repository
填写 Repository name 使用 “用户名.github.io”
选择 Public
勾选 Initialize this repository with a README
Create repository 创建

运行jekyll模板

把 jekyll 模板 clone 到本地
cd jekyll-theme 进入jekyll模板
jekyll serve --watch 启动
http://127.0.0.1:4000/jekyll-theme 查看
修改配置 _config.yml 参考这里

提交到自己的仓库中

cd jekyll-theme 进入jekyll模板
git remote set-url origin https://...git 更新/更改 URL
git remote -v 查看 origin 的地址

遇到的问题

sudo gem update –system

1 2	ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/update_rubygems

sudo gem update -n /usr/local/bin –system

gem install jekyll

1 2	ERROR: While executing gem ... (Gem::FilePermissionError) You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.

sudo gem install jekyll

1 2	ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/safe_yaml

sudo gem install jekyll -n /usr/local/bin

1 2	ERROR: Error installing jekyll: invalid gem: package is corrupt, exception while verifying: undefined method `size' for nil:NilClass (NoMethodError) in /Library/Ruby/Gems/2.0.0/cache/ffi-1.9.17.gem

sudo gem install jekyll

1 2	ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/listen

sudo gem install jekyll -n /usr/local/bin
安装成功