离线下载
PDF版 ePub版

Jekyll · 更新于 2017-11-19 18:00:53

模板

Jekyll 使用 Liquid 模板语言,支持所有标准的 Liquid 标签过滤器 。 Jekyll 甚至增加了几个过滤器和标签,方便使用。

过滤器

标签

引用

如果你需要在多个地方引用一小代码片段,可以使用 include 标签。

{% include footer.html %}

Jekyll 要求所有被引用的文件放在根目录的 _includes 文件夹,上述代码将把 <source>/_includes/footer.html 的内容包含进来。

ProTip™: Use variables as file name

The name of the file you wish to embed can be literal (as in the example above), or you can use a variable, using liquid-like variable syntax as in {% include {{ my_variable }} %}.

你还可以传递参数:

{% include footer.html param="value" %}

这些变量可以通过 Lquid 调用:

{{ include.param }}

Code snippet highlighting

Jekyll 已经支持 超过 100 种语言 代码高亮显示,在此感谢 Pygments 。要使用 Pygments ,你必须安装 Python 并且在配置文件中设置 pygmentstrue

Alternatively, you can use Rouge to highlight your code snippets. It doesn’t support as many languages as Pygments does but it should fit in most cases and it’s written in pure Ruby ; you don’t need Python on your system!

使用代码高亮的例子如下:

{% highlight ruby %}
def foo
  puts 'foo'
end
{% endhighlight %}

highlight 的参数 (本例中的 ruby) 是识别所用语言,要使用合适的识别器可以参照 Lexers 页 的 “short name” 。

行号

highlight 的第二个可选参数是 linenos ,使用了 linenos会强制在代码上加入行号。例如:

{% highlight ruby linenos %}
def foo
  puts 'foo'
end
{% endhighlight %}

代码高亮的样式

要使用代码高亮,你还需要包含一个样式。例如你可以在 syntax.css 找到,这里有 跟 GitHub 一样的样式,并且免费。如果你使用了 linenos ,可能还需要在 syntax.css 加入 .lineno样式。

Post URL

如果你想使用你某篇文章的链接,标签 post_url 可以满足你的需求。

{% post_url 2010-07-21-name-of-post %}

If you organize your posts in subdirectories, you need to include subdirectory path to the post:

{% post_url /subdir/2010-07-21-name-of-post %}

当使用 post_url标签时,不需要写文件后缀名。

还可以用 Markdown 这样为你的文章生成超链接:

[Name of Link]({% post_url 2010-07-21-name-of-post %})

Gist

使用 gist 标签可以轻松的把 GitHub Gist 签入到网站中:

{% gist 5555251 %}

你还可以配置 gist 的文件名,用以显示:

{% gist 5555251 result.md %}

gist 同样支持私有的 gists ,这需要 gist 所属的 github 用户名:

{% gist parkr/931c1c8d465a04042403 %}

私有的 gist 同样支持文件名。

上一篇: 博客迁移 下一篇: 永久链接