Windows系统上利用github+Jykell搭建个人博客

隐藏

I 前言

很多人都说过分享知识的同时也有助于凝练提高自己的技术水平,所以我也尝试建立个人博客。

故尝试在github上建站同步更新,互为补充。同时也是给自己扩充一下网页相关知识。

折腾了十多天的时间,想着各种可以改进的思路。结果最后却发现有一个博客的Theme完美解决了我的问题。而且只需要改几个设置即可。心情很复杂。

关于jekyll+github搭建博客的技术贴很多。我就仅讲下windows系统下搭建历程,及一些周边的内容。

II 名词解释

1. git

git是软件开发的分布式版本控制系统。具有多人协作,多台设备代码共享,历史回退。分支管理等功能,可用于辅助软件项目管理。相当于软件界的dropbox吧 :),只不过学习曲线有点陡。刚开始有些不习惯。

2. github

本为git代码管理网站,而非真正意义上的个人网站。但其提供静态网页托管服务。所以算是非常规用法 :)

3. jekyll

jekyll是一个自定义blog网站模板,通过markdownLiquid 转换文本,通过使用 GitHub Pages作为引擎服务,免费的来发布个人的blog网站。

选用jekyll的原因参考下文

jekyll的优点在于,它和Github是有关系的,Github的Page功能就是它提供的。因此,你根本不需要将生成的静态传到Github上去。

4. markdown

该格式非常方便书写,并可以通过在线编辑器(例如MaHua)或者离线编辑器(例如HarooPad)支持该格式的网站框架(例如github,CSDN)转化为html格式或者pdf格式。)

5. Cygwin

Cygwin可理解为windows系统上的Linux系统的虚拟机,或者说把Linux系统上的一些重要软件移植到Windows系统下。总体而言,在windows下装jekyll实在太麻烦了,所以采用此方法。

III 搭建过程

0. 参考链接

1. 在github上创建主页仓库

主要步骤是:

  1. 创建github账户,例如账户名为YourName
  2. 创建名为YourName.github.com或者your-user-name.github.io的仓库(repository),网页上创建仓库步骤

主要参考下文

注册一个Github帐号pkuwwt,因此,我的github帐号是 github.com/pkuwwt

然后,我可以建立任意的github仓库(repository)。使用过git的人应该不会陌生。

Github提供了网页托管服务…[more]

2. 安装jekyll

Linux,Unix,Max OS X系统下的安装步骤

对于Linux,Unix,Max OS X用户而言,安装十分简单,参考http://jekyllcn.com/docs/installation/

Windows系统下的安装步骤

方案1. 便携版(直接忽略)

注:本文只测试了安装版本的jekyll安装,便携版(绿色版)的jekyll未经测试。

便携版下载地址 下载页面download ZIP

便携版安装方法:解压并直接用管理员权限运行setpath.cmd即可

缺点是太大了,801M,还不如用Cygwin了,遂放弃。

方案2. 安装版(忽略)

参考链接:http://jekyll-windows.juthilo.com/

注:安装过于繁杂在此略过,链接中步骤很清楚。就不补充了。已测试并成功安装

方案3. 在Cygwin中安装(推荐)

还是用Cygwin方便啊!

注:建议用x86版本的Cygwin,X64版本的可能会出现问题

参考:http://www.cnblogs.com/dreamFromHere/archive/2014/01/08/3506366.html

需要注意的是相关软件如ruby,make,gcc要装齐全。同时jekyll的路径最好加入到环境变量$PATH中。

IV 页面风格

1. 页面风格参考

基于jekyll的网站和源码:https://github.com/jekyll/jekyll/wiki/Sites

差不多十天的时间里面,参考了各种各样的模板,并且花了不少心思改进。结果最后发现一个模板满足了自己所有想要的需求。而且只需要改一下_config.yml即可。不需要太多心思设置。感觉自己白忙活了一阵子TT。这里对作者表示感谢!

有以下几个优点值得推荐:

  • 利用redcarpet渲染引擎对markdown格式支持比较好,支持大部分高级的markdown语法规则。
  • 页面整洁,非常好看,边栏内容丰富。
  • 对手机登陆界面支持较好,加载速度很快。
  • 有站内search功能。
  • 仅需该几个设置即可。

主题可以从 https://github.com/javachen/javachen-blog-theme 下载,感谢原作者!http:/blog.javachen.com

博主关于搭建博客的文章也很好,值得参考!

http://blog.javachen.com/2013/08/31/my-jekyll-config/

http://blog.javachen.com/2014/01/21/all-things-about-jekyll/

V 补充

data url

网页中如果加载小图标,可以将图标制作成data url。这样就能直接在网页中嵌入自己的个性图标(最好是小图片),例如将favicon.ico制作成data-url嵌入

在线制作data url:http://dataurl.net/#dataurlmaker

markdown引擎的选择

采用redcarpet引擎 具体参见博文: 解决redcarpet中Mathjax渲染问题及优化redcarpet的配置

-----EOF-----

Categories: tools Tags: github jykell redcarpet Cygwin markdown