Jekyll多级Frontmatter能否使用?嵌套配置无效如何解决?
问题原因及解决方法
核心问题
你的代码存在两个关键问题:
- Frontmatter结构错误:
link1被定义为数组(开头的-是数组元素标识),但你直接将其当作单个对象调用,导致无法获取对应值。 - HTML语法错误:
<a>标签的href属性未闭合双引号,会引发渲染异常。
解决方法
方法一:单个链接(移除数组结构)
如果仅需这一个链接,删除Frontmatter中的数组标记 -,将link1改为普通对象:
--- # Homepage layout: default title: Homepage # links link1: title: External Link url: https://www.example.com ---
同时修正布局代码的引号问题:
<a href="{{ page.link1.url }}">{{ page.link1.title }}</a>
方法二:多个链接(保留数组结构,循环渲染)
若后续需要添加多个链接,保留数组结构,使用Jekyll循环语法遍历渲染:
Frontmatter保持不变:
--- # Homepage layout: default title: Homepage # links link1: - title: External Link url: https://www.example.com - title: Another Link url: https://www.example2.com ---
布局代码修改为循环形式:
{% for link in page.link1 %} <a href="{{ link.url }}">{{ link.title }}</a> {% endfor %}
此方式会渲染出所有定义的链接。
内容的提问来源于stack exchange,提问作者Malvinka
相关产品推荐
相关产品推荐

