Jekyll 安装、使用方法与卸载

Jekyll 安装、使用与卸载方法

最近用Jekyll在Github上架网站,前后花了几天时间深入了解一下Jekyll,现在将Jekyll的安装、使用与卸载方法分享出来。

Jekyll 是一个简单的网站静态页面生成工具。由于是用Ruby语音编写的,所以在Windows系统上配置起来还是稍微有点繁琐的。主要步骤如下:

安装方法

从rubyinstalll下载安装包并安装到某个磁盘中,如E:\Ruby193,勾选上安装界面的所有选项(不要问我为什么);把下载的DevKit解压到某个目录,比如E:\devit

注意:安装DevKit时最好在安装目录新建一个文件夹devit然后,运行安装程序选定该文件夹

git bash 环境进入devit安装目录,运行如下命令

cd /E/devitruby dk.rb init

来生成一个config.yml配置文件,该配置文件包含了前面的Ruby的安装目录E:\Ruby193(系统会自动帮你寻找Ruby的安装目录,cat config.yml可以看到该文件里面已经写入了ruby目录的绝对路径)。

接下来运行ruby dk.rb install。

最后运行命令gem install jekyll结束整个流程

检测是否安装成功jekyll -v

简要介绍

在谈使用方法前有必要简单介绍一下什么是Jeklly、以及Jeklly的工作原理。这些核心的概念能解决你的一些疑惑,帮助你更深入的理解,也为后面学习使用模板使用打基础,不至于在出现错误的时候漫天的debug。

如果你只是想要简答了解或知道怎样使用jeklly,那么此部分可以跳过。

Jeklly是什么

Jekyll is a ruby gem you install on your local system. Once there you can call jekyll –server on a directory and provided that directory is setup in a way jekyll expects, it will do magic stuff like parse markdown/textile files, compute categories, tags, permalinks, and construct your pages from layout templates and partials.

Once parsed, Jekyll stores the result in a self-contained static _site folder. The intention here is that you can serve all contents in this folder statically from a plain static web-server.

Jeklly是一个静态站点生成器,它会根据网页源码生成静态文件。它提供了模板、变量、插件等功能,所以实际上可以用来编写整个网站。

Jeklly是怎么工作的

安装完jeklly后你需要以jeklly可以识别的方式来组织你的目录。

它希望你使用下面的目录结构:

.|– _config.yml|– _includes|– _layouts| |– default.html| |– post.html|– _posts| |– 2011-10-25-open-source-is-good.markdown| |– 2011-04-26-hello-world.markdown|– _site|– index.html|– assets|– css|– style.css|– javascripts

_config.yml: 配置文件数据

_includes This folder is for partial views.

_layouts 这个目录主要包含模板,你可以为不同的页面(page)使用不同的模板。

_posts 这个目录包含你的文章(post),且必须按照格式 @YEAR-MONTH-DATE-title.MARKUP@来进行命名

_site 这个目录将被用来存放Jekyll生成的静态网站。

assets 这个目录不属于Jekyll的标准结构。它代表了任何你希望放置在根目录下的目录,并且被Jekyll忽略。

(read more: https://github.com/mojombo/jekyll/wiki/Usage)

Jekyll怎样生成最终的静态文件

收集数据。

Jeklly扫描posts目录收集文章(post file)作为post对象。然后扫描layout、assets,最后在其他目录中搜索页面文件(pages file)。

计算数据。

Jeklly从上面那些对象中提取元数据(连接、标签、分类、标题、数据)并构造出一个很大的site对象来容纳所有的文章、页面、布局和元数据。在这一步中,你的站点简单来说就是一个ruby对象。

溶解文章和模板。

Jeklly遍历所有文章(post file)并将它们镶嵌到各自的布局中。溶解过程如下:Jeklly初始化一个Liquid模板,传递一个代表ruby站点对象的散列表和一个代表ruby文章对象的散列表,这两个散列表可以通过模板读取。

生成输出。

Liquid模板通过有模板提供的语法得到渲染,最终生成一个静态的表达文件。

使用方法

以bootstrap模板为例子简要介绍如何快速搭建起一个站点。

下载 Jekyll-bootstrap的模板项目到本地目录jekyll

git clone https://github.com/plusjade/jekyll-bootstrap.git demo

cd jekyll进入目录,jekyll serve启动服务

打开浏览器,地址栏输入:4000/可以看到如下主页面

编写新文章

通过命令生成新文章

gdw@GDW-PC /E/Git/demo (master)$ rake post title=”My first blog”Creating new post: ./_posts/2015-02-11-my-first-blog.md

在_posts目录中可以找到该文件,并用Markdown编辑内容。

也可以直接将编辑好的文章放置到_posts目录中,但一定要在编辑好的文章开头使用YAML Front Matter。模板、文章和页面都需要提供YAML Front Matter,,这样Jekyll才知道该如何处理你的文章。

在模板/文章/页面的开头需要提供如下格式的YAML Front Matter

—layout: postcategory : pagestags : [how-to, jekyll]—… contents …编写新页面

通过命令生成新页面

gdw@GDW-PC /E/Git/demo (master)$ rake pagemkdir -p .Creating new page: ./about.mdgdw@GDW-PC /E/Git/demo (master)$ rake pagemkdir -p ./pages/aboutCreating new page: ./pages/about/index.html卸载Jekyll

安装配置Jekyll难,卸载却极其的简单。只需一句

gem unistall jekyll

真正的强者,不是流泪的人,而是含泪奔跑的人。

Jekyll 安装、使用方法与卸载

相关文章:

你感兴趣的文章:

标签云: