按:

本文是以对git,github熟悉为前提的。



一,Install Jekyll in windows

http://www.madhur.co.in/blog/2011/09/01/runningjekyllwindows.html

Note:

1, 安装完成Ruby之后,需要设置Ruby的环境变量,之后的命令都基于此。

2, 在执行 clip_image001 命令的时候,会耗时很长,没有关系,继续执行第二步。


二,Github pages

http://pages.github.com/

目的:创建网站的repository,静态的相关文件都会存放在这里


三,Template

借用了模板:http://ellochen.github.io/

拷贝到对应的文件夹即可。


四,Jekyll和github page 关联

https://help.github.com/articles/using-jekyll-with-pages#keeping-jekyll-up-to-date

执行clip_image002,安装相应的关联包。

附加的,可以安装jekyll与github相关的插件:

https://help.github.com/articles/using-jekyll-plugins-with-github-pages


五,Build

在对应的文件夹下,执行jekyll build命令。


六,Publish

Note:commit 之后,不会立即生效。

clip_image004


七,遇到的问题

1, error: invalid byte sequence in GBK

http://jekyllrb.com/docs/windows/#installation

解决方法:执行命令 :chcp 65001

2, Missing dependency: rdiscount

其实是我拷贝的模板,安装的一个插件。

查看网上资料发现,原因是Jekyll默认的markdown解析器maruku对中文支持不够完善,所以果断换成RDiscount解析器,问题得到解决。

执行命令gem install rdiscount

3, Could not find a valid gem 'rdiscount' (>= 0)

https://github.com/davidfstr/rdiscount

clip_image006

4, 因为被墙掉的缘故,只能本地安装。

下载地址:http://rubygems.org/gems/rdiscount/versions/2.1.7

Cd到对应文件夹下,执行命名:gem install rdiscount-2.1.7.gem --local

5, 之后继续检查缺少的gem库,执行命令jekyll serve –watch

错误信息如下:

clip_image008

同样的方法,在本地安装。

6,invalid byte sequence in GBK。

编码的问题,解决方案,根据对应的版本选择即可:

http://kaiimeng.cn/my-first-octopress-blog/

7,增加dispus

8,没有反馈邮件的问题

犯了一个特别2b的问题,就是google page的名字必须和github的账号名字一致。


八,如何调试

其实就是如何输出log,帮助查找问题

1, Cd到目录下

2, 执行jekyll serve,即可在http://localhost:4000看到相应的页面效果。如果有问题,也会报错。


九,中文乱码的问题

http://www.cnblogs.com/aleda/articles/Jekyll-in-Windows-following-Chinese-encoding-problem-solutions.html


十,其他

1, 问题8耗费了很长的时间,建议阅读文档的时候一定细致。

2, 和模板的作者邮件沟通了下,虽然没帮助解决问题,但是心里上安慰踏实很多。

3, 最终发了封邮件给github的service,反应了下问题,不知道是不是因为是付费用户的缘故,反馈很快,很快解决了问题。