onenote

在Windows上搭建Jekyll博客环境

安装GitHub for Windows

可以直接从GitHub下载，简单的双击安装即可。

使用Pages

在GitHub上新建一个Repository，并将该Repository命名为username/username.github.io。这一点可以参考GitHub关于Pages的说明。

需要注意的是：以前使用Pages时，新建的Repository名称是username/username.github.com，而现在是username/username.github.io。

安装Jekyll

Step One

Jekyll的Blog上给出了一个在Windows平台使用Jekyll的解决方案，这里只是简单记录一下版本信息。

  • Ruby 1.9.2-p290(XP-32) / Ruby 2.0.0-p0(Win7-32)
  • DevKit DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe(XP-32) / DevKit DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe(Win7-32)

假定Ruby安装在D盘根目录的Ruby192目录，DevKit解压在D盘根目录的DevKit目录，然后打开CMD。

cd D:\DevKit
D:\DevKit>ruby dk.rb init
D:\DevKit>ruby dk.rb install
D:\DevKit>gem install jekyll

Step Two

这一步我觉得在Windows上没有那么繁琐。

  • 先clone自己的username/username.github.io到本地（虽然里面没什么东西）
  • 然后直接去github上下载Jekyll Bootstrap，然后解压到本地的username.github.io文件夹里面。
  • 然后在Powershell（装好GitHub for Windows就有）里面操作。

没什么复杂的，简单的一套git命令

git add .
git commit -m 'initial load'
git push origin master

Step Three

最后去浏览器输入username.github.io看下效果。

注册DISQUS

这一步相对简单，天朝骚年的英文水平对付这个注册肯定没有问题，所以简单点写。

  • site url填username.github.io。
  • site name随意。
  • site shortname会根据site name生成，但是可以自己改，因为多半情况下是提示已经被占用。
  • 取消enable promoted discovery。
  • 然后改本地的username.github.io根目录下的_config.yml文件，找到disqus : <short_name>，改成DISQUS生成的site shortname即可。

解决Jekyll中文Encoding问题

找到<RUBY_PATH>\lib\ruby\gems\<RUBY_VERSION>\gems\jekyll-<VERSION>\lib\jekyll\convertible.rb文件，把里面的self.content = File.read(File.join(base, name))
换成
self.content = File.read(File.join(base, name), :encoding => "utf-8")即可。

需要注意的是这一行的位置根据Ruby版本的不同也不一样，大致在27行～29行的样子。