01 November 2014

之前有在公共博客或是专业的技术博客上写写文章、笔记。后来由于从事安全相关行业,转而把一些工作中的总结、笔记记录在了OneNote上,纯离线不对外开放。但这种转换导致文章产出率很低,常常半年写不了一篇文章。为了能够督促自己将技术或是生活点滴记录下来,寻找一种使用Markdown语法,干净整洁的写作环境:github+jekyll,这正是我想要的。

升级Command Line Tools

由于刚升级了"优圣美地",需要安装一下Command Line Tools,安装jekyll需要。

$ xcode-select --install

更新RubyGems到最新版本

安装jekyll需要RubyGems。https://rubygems.org/pages/download

$ gem update --system          # may need to be administrator or root
$ gem install rubygems-update  # again, might need to be admin/root
$ update_rubygems              # ... here too

安装jekyll

jekyll是纯静态blog,无需数据库支持,将markdown转为页面。 $ gem install jekyll # may need to be administrator or root

Clone jekyll-bootstrap

这是一个快捷搭建jekyll+github pages的工具。 $ git clone https://github.com/plusjade/jekyll-bootstrap.git $ cd jekyll-bootstrap $ jekyll serve

在Github上创建帐号,并创建一个USERNAME.github.io的仓库,这个就是你的个人主页的空间了。 然后将jekyll-bootstrap的目录结构导入到此仓库,jekyll的环境准备就绪。

替换jquery链接

由于默认theme里jquery使用了googleapis的连接,导致访问会很慢或挂掉,所以这里替换为本地的jquery。

下载一个jquery压缩版放入/assets/javascript/jquery-1.11.1.min.js 然后将_includes/themes/bootstrap-3/default.html中的

https://ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js

替换为:

/assets/javascript/jquery-1.11.1.min.js

中文支持

将jekyll默认的markdown解析引擎maruku 更换为RDiscount

sudo gem install rdiscount

然后在_config.yml中highlighter: pygments之后加一行markdown: rdiscount,这样再次生成网站的时候就使用RDiscount来解析md文件了。

个性化域名

USERNAME.github.io文件夹下新建一个CNAME文件,里面的内容就是你的域名,比如USERNAME.me

然后按照GitHub所说将你的域名指向204.232.175.78这个ip(最新地址:192.30.252.153、192.30.252.154),这样当再次访问你的域名的时候,就会指向GitHub Pages了(可能DNS更新会需要一段时间)。

安装&更换theme

安装一个jekyll模板,然后使用它来变更blog界面。

rake theme:install git="https://github.com/jekyllbootstrap/theme-the-program.git"
rake theme:switch name="the-program"

调整首页

页面可以适当做一些调整,比如菜单名称等等。

开始写作...

rake post title="Hello World"

使用jekyll命令行创建文章,然后去_post目录下用markdown编辑器或vim编辑文章。