Pelican 的 Jinja 模板为何无法通过 import 获取分类文章列表?
问题出在这条导入语句:{% from 'category.html' import articles as cat_articles %}。Pelican 渲染分类页时传入的 articles 属于那次渲染的上下文,不能通过导入 category.html 取出。Template: cat2 只为当前内容指定模板,也不会让它自动获得分类索引页的上下文。
为什么循环没有输出?
Jinja 的 import 用于导入模板导出的宏或变量,例如在模板顶层通过 set 定义的变量。外部传入的上下文变量不会自动成为模板导出项。导入 category.html 也不会让 Pelican 重新生成分类页或查询分类文章。
因此,如果 category.html 没有显式导出 articles,得到的 cat_articles 就是未定义值。Jinja 默认允许遍历未定义值,且不会产生输出,这与问题中的空列表现象一致。如果配置了更严格的未定义值处理方式,则可能直接报错。Jinja 模板文档
给导入语句加上 with context 也无法取得分类文章。它只会把当前上下文传给被导入的模板,不会创建分类页上下文,也不会自动导出传入的变量。Jinja 上下文规则
从 categories 中取得目标分类的文章
Pelican 提供公共变量 categories,它是一个由 (category, articles) 元组组成的列表。可以遍历这个列表,按分类的 slug 找到对应的文章。直接使用当前模板中的 articles 时,要注意它的含义:在分类页中,它表示该分类的文章;在其他页面中,它可能表示全站文章。Pelican 模板变量文档
下面保留原来的 article.html 继承方式,适用于该 Markdown 文件被 Pelican 当作 article 处理的情况。将 your-category-slug 替换为目标分类的实际 slug,先按标题排序,确认文章能正常显示:
{% extends "article.html" %}
{% block content %}
{% set target_slug = 'your-category-slug' %}
{% for cat, cat_articles in categories if cat.slug == target_slug %}
<ol>
{% for entry in cat_articles | sort(attribute='title') %}
<li>
<a href="{{ SITEURL }}/{{ entry.url }}">{{ entry.title }}</a>
</li>
{% else %}
<li>该分类没有可显示的文章。</li>
{% endfor %}
</ol>
{% else %}
<p>未找到指定分类,请检查分类 slug。</p>
{% endfor %}
{% endblock content %}
这里通过 categories 选取分类,不依赖当前页面是否正在生成分类索引。
改为按自定义元数据排序
确认列表正常后,可以将内部循环替换为下面的形式。your_metadata_field 是占位名称,需要换成文章对象上实际可访问的元数据属性:
{% for entry in cat_articles | sort(attribute='your_metadata_field') %}
需要降序时使用:
{% for entry in cat_articles | sort(attribute='your_metadata_field', reverse=true) %}
sort 的 attribute 参数用于指定排序属性,reverse=true 用于反转排序方向。Jinja sort 文档
排序前,应保证每篇待排序文章都有该字段,且字段值之间能够比较。看起来像数值的字符串仍可能按字符串顺序排列,例如 "10" 排在 "2" 前面。需要按数值顺序排列时,应先在数据处理阶段将它们转换为数值。
检查当前 Markdown 文件的类型
Template: cat2 用于选择生成当前内容所用的模板。文件位于某个分类目录下,并不会因此变成一个额外的分类索引页。Pelican 元数据说明
如果该文件实际上被识别为 page,应根据主题结构继承 page.html 或合适的公共布局,并使用主题实际定义的内容块。普通索引文章如果被归入目标分类,也可能出现在自己的列表里。不希望显示它时,需要明确排除该内容。
备注:内容仅供参考。
