我正在大力研究 Jekyll,并希望将其用作通用前端开发平台,但遇到了 Liquid 模板语言的限制,特别是它与 Django 模板的区别。
我发现了 Liquid-inheritance gem,它添加了 Django 中最重要的 Extends 和 Block 语法。这篇博文进一步扩展了 gem 以适应 Jekyll 的文件系统: http://www.sameratiani.com/2011/10/22/get-jekyll-working-with-liquid-inheritance.html
问题在于,它似乎没有以与 Django 完全相同的方式实现块,这本质上使得 gem 毫无用处。
为了便于理解,我有两个 jekyll“布局”,称为parent.html 和 child.html。这些都不包含 YAML 部分。
家长
<html>
{% block foo %} {% endblock %}
</html>
孩子
{% extends _layouts/parent.html %}
{% block foo %}
<div>
Bar comes next:
{% block bar %} {% endblock %}
</div>
{% endblock %}
然后我有一个 jekyll 页面,其中包含 YAML 部分:
---
title: test
---
{% extends _layouts/child.html %}
{% block bar %}My title is {{ page.title }} {% endblock %}
我的期望:
<html>
<div>
Bar comes next:
My title is test
</div>
</html>
我得到了什么:
<html>
<div>
Bar comes next:
</div>
</html>My title is test
似乎有些东西未能将 mypage.html 中的块视为有资格插入父/子的合适位置,尽管它显然仍在做一些事情。
我不是 ruby 开发人员,而且对 Jekyll 相当陌生,因此我需要帮助来确定该堆栈的哪一部分出现了故障。 github 上的液体继承问题表明其他人正在经历此块嵌套问题:https://github.com/danwrong/liquid-inheritance/issues/3
我已经尝试了几种液体继承的分支,其中许多显然解决了正则表达式的问题,但似乎没有一个能解决这个问题。
我想做的事情从根本上来说是不可能的吗?看来我至少已经完成了 85%,最后一点需要修复。
我不确定这是否会在 Jekyll 中发挥作用。我可能是错的,但这是我的推理:
每个页面都使用 do_layout 渲染出来 https://github.com/mojombo/jekyll/blob/master/lib/jekyll/convertible.rb
它以递归方式工作 - 它处理页面的内容,然后处理页面的布局,然后处理该布局的布局等等,将 YAML 变量沿链向上传递(因此它们始终在父模板中可用,如 {{页。随便}})。
这意味着唯一被传递的是 YAML 值,以及经过 Liquid 处理后“内容”的值是什么。我不知道其他地方是如何完成的,但这似乎与块的想法不兼容,因为它们要求您分别传递两个块。
从根本上来说,在我看来,问题在于 Jekyll 已经有了一种简单的继承形式——通过您可以赋予布局的“布局”属性。从根本上讲,我认为这与液体模板兼容。
尽管如此,我不确定您是否已经耗尽了使用 YAML、_includes 和模板逻辑的限制。如果您要将 Django 样式块放入您的 content 中,为什么不这样做:
内容:
---
title: some title
secondary_content: |
Here is some *secondary* content that will be [markdownified](http://example.com).
It can run to multiple lines and include
* Lists
* Good things
* Etc
---
And here is the main content, as per usual
模板:
<html>
<article>
<h1>{{ page.title }}</h1>
{{ content }}
</article>
<aside>
{{ page.secondary_content | markdownify}}
</aside>
如果您想保持模板干净,并为不同类型的页面提供不同的内容,您可以使用各种包含:
模板:
<aside>
{% include sidebar_negotiation.html %}
</aside>
_includes/sidebar_negotiation.html:
{% if page.type = 'foo' %}
{% include sidebar_foo.html %}
{% else if page.type = 'bar' %}
{% include sidebar_bar.html %}
{% endif %}
然后将页面类型特定的内容放入这些文件中。显然,您可以直接包含它,但将其抽象出来可能会更好。这些包含将获取 YAML 中的所有变量。
如果这些都不是胜利,你可以随时尝试 Hyde:http://hyde.github.com/,它是用 Python 编写的,使用 Jinja2(基本上是 Django templates++),并且做同样的事情。
尝试使用
{% raw %} {% endraw %}
Jekyll 标签