迁移博客至 Jekyll

原文地址:https://github.com/mojombo/jekyll/wiki/Blog-Migrations

这个页面中的大部分方法都需要拥有对原系统数据库的访问权限。每一种方法都是依据数据库中的文章条目来生成 _posts 目录下的 .markdown 文件。请查看生成页面,确保它已经被正确的转换了。同时,大多数的导入脚本并不会检查你的博客文章是公开的还是私人的,所以请仔细查看 Jekyll 为你生成的页面。

如何使用

这些 迁移方法 都是 Jekyll 的 Gem 的一部分.

  1. 添加一个名为_import的目录到你的项目中
  2. 打开一个命令终端
  3. gem install sequel mysqlplus
  4. 分别独立地运行下面的命令。

Jekyll 的 YAML 前置数据

原文地址:https://github.com/mojombo/jekyll/wiki/YAML-Front-Matter

所有包含 YAML 前置数据块的文件都会被 Jekyll 当做特殊文件来处理。这些前置数据必须存在于文件的首部,他们的格式是这样的:

Jekyll 模板数据

原文地址:https://github.com/mojombo/jekyll/wiki/Template-Data

Jekyll 会遍历你的站点,来寻找需要处理的文件。任何具有 YAML 前置数据 的文件都将会被处理,每一个这样的文件,Jekyll 都会通过 Liquid 模板系统 使用许多可用的页面变量。下面是一个可用变量的列表。

全局变量

变量 描述
site 全站的信息加 _config.yml 文件中的配置选项
page 这个变量中包含 YAML 前置数据,另外加上两个额外的变量值:url和content。
content 在布局模板文件中,这里变量包含了页面的子视图。这个变量将会把渲染后的内容插入到模板文件中。这个变量不能在文章和页面文件中使用。
paginator 一旦paginate配置选项被设置了,这个变量才能被使用。

Jekyll 固定链接

原文地址:https://github.com/mojombo/jekyll/wiki/Permalinks

Jekyll支持以一种灵活的方式来定制你站点的URL路径。你可以通过 配置文件YAML前置数据 来指定你站点的每个页面的固定链接。你可以使用内建的风格来创建你的链接,或者你也可以自己定制。默认的风格总是date

注意:即使 --auto 选项被打开了,当你在 Jekyll 运行时修改其固定链接的风格,你需要重新启动 Jekyll 才能使新的风格生效。

Jekyll 扩展的 Liquid 模板

原文地址:https://github.com/mojombo/jekyll/wiki/Liquid-Extensions

Jekyll 使用 Liquid 来处理模板数据。除了 标准的Liquid标签和过滤器,Jekyll还增加一些它自己特有的:

过滤器

日期-XML

将时间转换成 XML 格式

{{ site.time | date_to_xmlschema }} => 2008-11-17T13:07:54-08:00