Jekyll是用ruby写的lib,可以按照一定的规则把markdown转成静态页面,这样就可以用markdown写博客文章,然后用Jekyll生成静态页面后放到线上。

安装Jekyll

Jekyll基于ruby,所以先要安装ruby,ruby的安装可以参考ruby-china的ruby安装wiki

安装好ruby和gem后,就可以用gem安装Jekyll.

gem install jekyll

创建博客

在命令行下输入:

gem install jekyll
jekyll new blog_path

运行后,会在当前目录生成一个名为blog_path的目录,这就是Jekyll的工程目录。目录结构如下:

├── about.md
├── _config.yml
├── css
│   └── main.scss
├── feed.xml
├── _includes
│   ├── footer.html
│   ├── header.html
│   └── head.html
├── index.html
├── _layouts
│   ├── default.html
│   ├── page.html
│   └── post.html
├── _posts
│   └── 2014-09-27-welcome-to-jekyll.markdown
└── _sass
    ├── _base.scss
        ├── _layout.scss
            └── _syntax-highlighting.scss

然后运行:

# 加上-w后,jekyll会自动观察下面的文件,如果发生变更就会重新生成静态文件
jekyll serve -w

在浏览器打开:localhost:4000就可以看到创建出来的博客了。

写文章

Jekyll的文章都在_post下,对文章的命名规则有一定的要求,每篇文章的命名都是YYYY-MM-DD-TITLE.markdown。

写作时,首先要在最前面写一个front-matter,这里面可以指定使用的模板,链接,tag,类别。front-matter用”—“包围,这是个典型的front-matter:

---
layout: post
title: "用Jekyll写博客"
date: 2014-02-15 16:21:00
categories: Jekyll
tags: blog Jekyll 
---

如果没有错误,就可以回到localhost:4000看到新写的文章出现在页面上了。



comments powered by Disqus