jekyll模板、语法

页面头部

---
layout:   post
title:    title
category: blog #或者categories: [blog, photo]
description: description
published: false # default true
permalink: /photo # 重置当前页面的访问地址
---

全局变量

• site _config.yml 中配置的信息
• page 当前页面的配置信息
• content 模板中,用于引入子节点的内容
• paginator 分页信息

site下的变量

• site.time 运行 jekyll 的时间
• site.pages 所有页面
• site.posts 所有文章
• site.related_posts 类似的10篇文章,默认最新的10篇文章,指定lsi为相似的文章
• site.static_files 没有被 jekyll 处理的文章,有属性 path, modified_time 和 extname.
• site.html_pages 所有的html页面
• site.collections 所有集合
• site.data _data 目录下的数据
• site.documents 所有集合中的文档
• site.categories 所有的category
• site.tags 所有的tag

page下的变量

• page.content 页面的内容
• page.title 标题
• page.excerpt 摘要
• page.url 链接
• page.date 时间
• page.id 唯一标示
• page.categories 分类
• page.tags 标签
• page.path 源代码位置
• page.next 下一篇文章
• page.previous 上一篇文章

paginator下的变量

• paginator.per_page 每页记录数
• paginator.posts 当前页的文章列表
• paginator.page 当前页码
• paginator.total_posts 文章总数
• paginator.total_pages 总页数
• paginator.previous_page 上页页码
• paginator.next_page 下页页码
• paginator.previous_page_path 上页路径
• paginator.next_page_path 下页路径

模板语法

循环

-反向排序并循环输出前10-20条文章

{% for post in site.posts limit:20 offset:10 reversed %}
    {{ post.title }} {{ post.excerpt | remove: 'fuck' }}
{% endfor %}

判断

• and 且
• or 或
• contains 包含

{% if page.excerpt %}
    {{ page.excerpt| strip_html }}
{% elsif page.description %}
    {{ page.description }}
{% else %}
    {{ site.description }}
{% endif %}

多条件

{% case condition %}
    {% when 1 %}
    here is 1
    {% when 2 or 3 %}
    herer is 2 or 3
    {% else %}
    ... else ...
{% endcase %}

赋值

{% assign index = 1 %}

代码高亮

-显示行号 linenos 支持的语言参考Rough Wiki

{% highlight js linenos %}
console.log('Hello world!')
{% endhighlight %}

常用过滤器

• | date 日期格式化 e.g. date: “%Y %h”
• | size 输出数组长度
• | number_of_words 输出单词个数-按照空格split后的数组长度
• | array_to_sentence_string 逗号拼接数组-最后两个使用and拼接
• | sort:'title' 排序
• | remove:'fuck' 过滤内容
• | strip_html 删除html标签
• | xml_escape xml转义
• | escape 字符串转义
• | capitalize 首字符大写
• | cgi_escape url转义，from ‘x,y;z?’ to ‘x%2Cy%3Bz%3F’
• | jsonify 格式化json数据输出
• | where:'title', 'today' 查找title为’today’的数据

日期格式化

• | date_to_string 07 Nov 2008
• | date_to_long_string 07 November 2008
• | date_to_rfc822 Mon, 07 Nov 2008 13:07:54 -0800
• | date_to_xmlschema 2008-11-07T13:07:54-08:00