@jeffjade 2016-03-27T02:54:22.000000Z 字数 4192 阅读 1893

Rake一键生成发布Jekyll

Jekyll

于想拥有个人站点品牌的人来讲，现如今是一个很好的时期。至少 Hexo、Jekyll、Leanote、WordPress 、FarBox Octopress、ghost、marboo、Medium、Logdown、prose.io 等诸多层出不穷的好工具，让建站写文已经变得异常简洁方便。分分钟可搭建起美观大方的个人博客，这样的教程已经充盈网络，在此不提。这篇要分享的是，以Rake一键生成Jekyll文章模版，一键预览效果，一键发布。

个人博客，目前主用这Hexo和jekyll，两者都很是轻量便捷。Hexo是一个开源的静态博客生成器,由以为台湾大学生用node.js开发而成，晚晴幽草轩就是用Hexo搭建而成。jekyll是Ruby写的一个轻量级的博客系统，也是Github Page默认搭配，而天意人间舫则是以Jekyll创造出的。

在设计上，jekyll框架将博客模块化，比如有负责网页显示样式的部分（即模板），有负责博客内容的部分，也就是我们使用markdown语言来写的内容。其次，它通过一定的规则，又将各个模块的内容组织起来，并创建各个页面之间的联系。如此是它可以使我们在写作的时候，尽最大的精力去集中在内容的创作上，而不用太在意格式以及排版。并且借助于git这个相当流行的分布式版本控制系统，可很有效的管理所写的文章，完全可以做到在没有网络的情况下写作｜预览，待有网络时再将内容同步。

使用Jekyll本已经非常方便了，不管是本地测试还是发布线上。但还是不够简洁，对于渴望极致的懒人来讲。比如发布文章到线上：

git add .
git commit -m "commit massge"
git push origin master

如果能够敲击一个命令完成，就不能忍受搞三行；虽然三行只多余费了不到半分钟。撰文写字，本就不易，一篇下来，已是很累；欲长久此好，必须尽可能减轻完成这事儿之成本；否则累觉不爱之后，爱好这种事儿，会在累烦的跌宕种被阉割抛弃的。在操纵Jekll博客方面，有很多可以利用的脚本，比如bash,Makefile,win下的bat等等；朋友@痞子达向我推荐了Rake，这些日子用了下很是方便，改写也颇为简单，就此录下一篇推荐给大家。

何为Rake？: Ruby Make，一个用ruby开发的代码构建工具，要了解更多Rake可以参看其官网，抑或是这里整理的简洁强大如斯：Rake。

下载安装Rake，可以使用 gem：

gem install rake

如何使用Rake，只需要写一个Rakefile为名的Rake脚本放置在Blog项目的根目录下，同时做一点简单的配置即可。Jekyll Rake Boilerplate是一个功能很完善的脚本，有以下诸多方式可供使用：

rake post["Title"]
rake draft["Title"]
rake publish
rake page["Title"]
    rake page["Title","Path/to/folder"]
rake build
rake watch
    rake watch[number]
    rake watch["drafts"]
rake preview
rake deploy["Commit message"]
rake transfer

这意味着使用Jekyll写文的流程可简化为：

写草稿：rake draft["Title"]

将草稿发表：rake publish

直接写博文：rake post["Title"]

做页面：rake page["Title"]

写完后发布，rake deploy["Commit message"]

那这个脚本目测是国外人编写的，于我们的需求还是需要调整的。并且这里采用 rake draft["Title"] 这样命令行来写，对于使用 zsh的人，就颇为有点蛋疼了。"[]"在zsh这里会被转义，所以需要这样 rake post\["TitleName"\]，否则会报如下错误：

zsh: no matches found: post[TitleName]

伊始用这个老报错，不懂的Ruby，去查看了下，用环境变量做参数可以，没报错（ENV["Title"]来接收消息）。这是费了点功夫才找到的原因，参见傳參數到 Rake 中。所以这边自己更改了下原有的写法，比如新建一篇文章：

# Add 2016-03－01(rake post title="xx")
desc "Create a post in _posts"
task :new do
    puts "Input File Path(book/life/resource/tech/tool,default _posts Root)："
    @dir = STDIN.gets.chomp
    puts "Input File Name(for Url)："
    @url = STDIN.gets.chomp
    puts "Input Article Title(for Article)："
    @name = STDIN.gets.chomp
    puts "Input Article Categories(工具｜资源｜生活｜技术｜读书 Separated By Spaces)："
    @categories = STDIN.gets.chomp
    puts "Input Article Tags(Separated By ,)"
    @tags = STDIN.gets.chomp
    puts "Input Article Keywords(Separated By ,)"
    @keywords = STDIN.gets.chomp
    puts "Input Article Description(Article Desc)："
    @description = STDIN.gets.chomp
    @slug = "#{@url}"
    @slug = @slug.downcase.strip.gsub(' ', '-')
    @date = Time.now.strftime("%F")
    @post_url = (@dir=="") ? "" : ("/" + "#{@dir}");
    @post_name = "_posts#{@post_url}/#{@date}-#{@slug}.md"
    if File.exist?(@post_name)
       abort("Failed to create the file name already exists !")
    end
    FileUtils.touch(@post_name)
    open(@post_name, 'a') do |file|
        file.puts "---"
        file.puts "layout: post"
        file.puts "title: #{@name}"
        file.puts "date: #{Time.now}"
        file.puts "categories: #{@categories}"
        file.puts "tags: #{@tags}"
        file.puts "keywords: #{@keywords}"
        file.puts "description: #{@description}"
        file.puts "---"
    end
    exec "vi #{@post_name}"
end

运用的话，只需要rake new开启命令，按照其提示的一步步输入：title categories tags keywords description 等

➜  nicejade.github.io git:(master) ✗ rake new
Input File Path(book/life/resource/tech/tool,default _posts Root)：
life
Input File Name(for Url)：
the pleasure of thinking
Input Article Title(for Article)：
思维的的乐趣
Input Article Categories(工具｜资源｜生活｜技术｜读书 Separated By Spaces)：
生活
Input Article Tags(Separated By ,)
Thinking,Essay
Input Article Keywords(Separated By ,)
思维的乐趣
Input Article Description(Article Desc)：
王小波散文随笔：思维的录乐趣

Rake即可帮着在 _posts/life目录下创建命名为“2016-03-26-the-pleasure-of-thinking.md”的文件，并根据所输入的生成以下内容：

---
layout: post
title: 思维的乐趣
date: 2016-03-26 00:22:39 +0800
categories: 生活
tags: Thinking,Essay
keywords: 思维的乐趣
description: 王小波散文随笔：思维的乐趣
---

接下来只管产出内容即可。当然了，之前提到需要一点配置，就是需要在_config.yml种对template,page,git等进行配置，譬如：

post:
  template: _post.txt
  extension: md
page:
  template: _page.txt
  extension: md
editor: atom
git:
  branch: master
transfer:
  command: rsync
  settings: -av
  source: _site/
  destination: ~/Git/yourGithubName.github.com/

对应可以按需在_config.yml目录下创建_post.txt _page.txt即可；根据Html种Meta对于SEO的重要，以及站点分类需要，个人配置内容如下：

---
title:
date:
categories:
tags:
keywords:
description:
---

如此配置完毕，即可运行如下命令：

rake new // 新建文章
rake post["TitleName"] // 生成纯净文章模版配置
rake deploy "message"="Commit Message" //一键发布文章
rake preview //一键预览(自主协助打开浏览器)
rake build //Build the site
rake post["Title"] //创建文章(tags,keywords等洁净的)

以上改写脚本已上传这里jadeScriptCollect，会根据需要持续更新。

折腾不是为折腾而折腾，只为偷懒而勤奋；简洁才是王道。

Rake一键生成发布Jekyll

内容目录