为何Pelican应传递的Jinja导入变量未在模板中显示?
问题分析与解决方案
你的问题核心在于错误地通过导入category.html来获取分类文章,Pelican在渲染自定义模板的分类页面时,不会把分类文章变量传递给你导入的模板文件。
问题原因
默认的category.html模板里的articles变量,是Pelican专门为默认分类页面渲染时注入的上下文变量。当你用自定义的cat2.html模板渲染分类页面时,Pelican会直接把当前分类的文章列表注入到cat2.html的上下文里,变量名就是articles,但你通过{% from 'category.html' import articles as cat_articles %}尝试导入的articles,在这个场景下并没有被赋值,所以是空的。
修复步骤
- 移除无效的导入语句,直接使用Pelican注入的
articles变量。如果需要按自定义元数据字段排序,用Jinja的sort过滤器处理:
{% extends "article.html" %} {% block content %} <ol> {# 假设你要按自定义元数据字段custom_order排序,替换为你的实际字段名即可 #} {% for article in articles | sort(attribute='custom_order') %} <li> <a href="{{ SITEURL }}/{{ article.url }}">{{ article.title }}</a> </li> {% endfor %} </ol> {% endblock content %}
- 确认分类页面元数据正确:确保你的分类Markdown文件里同时设置了
Category和Template元数据,示例如下:
Title: 我的自定义分类页 Category: 技术 Template: cat2
- 验证分类下存在有效文章:确认该分类下的文章都正确设置了匹配的
Category值,且没有被标记为草稿状态。
内容的提问来源于stack exchange,提问作者loomsofenitharmon
相关产品推荐
相关产品推荐

