使用类似 django 的液体块/继承的 Jekyll 模板

问题描述 投票:0回答:2

我正在大力研究 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%,最后一点需要修复。

ruby django inheritance jekyll liquid
2个回答
7
投票

我不确定这是否会在 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++),并且做同样的事情。


0
投票

尝试使用

{% raw %} {% endraw %}
Jekyll 标签

© www.soinside.com 2019 - 2024. All rights reserved.