Jekyll 的 YAML 前置数据
原文地址:https://github.com/mojombo/jekyll/wiki/YAML-Front-Matter
所有包含 YAML 前置数据块的文件都会被 Jekyll 当做特殊文件来处理。这些前置数据必须存在于文件的首部,他们的格式是这样的:
---
layout: post
title: Blogging Like a Hacker
---
在三条虚线之间,你可以设置一些预定义的变量(可以查看下面的参考说明)或者是你自己定义的变量。
注意:这很重要(尤其是对 Windows 用户)
当你使用 UTF-8
编码来编辑你的文件时,请确保没有 BOM
的头部字符在你的文件中,否则整个都会奔溃。
预定义的全局变量
变量 | 描述 |
---|---|
layout | 这个变量是用来设置选用的模板文件。使用模板文件的文件名,但不包括扩展名,模板文件必须存在于 _layout 目录中。 |
permalink | 如果你需要你的 URL 地址和默认的 /年份/月份/日期/标题.html 不同,那你就需要设置这个选项,它将会当做最终的 URL 地址。 |
自定义数据
在转换过程中,所有在前置数据中的非预定义变量都会被一起提交给 Liquid 模板引擎。举例来说,如果你设置了变量:title,你可以在你的布局模板文件中使用这个变量来设置页面的标题:
<title> {{ page.title }} </title>
为文章预定义的前置数据
下面是文章可用的前置数据变量:
变量 | 描述 |
---|---|
date | 这个日期变量将会覆盖文件名中的日期,这个变量能够用来确保文章的正确排序 |