11ty（Eleventy）继承Nunjucks布局时pagination分页功能失效问题

核心错误1：Front Matter 位置错误 #

Eleventy 要求所有 YAML Front Matter 必须放在模板文件的最开头，前面不允许存在任何内容（包括 Nunjucks 指令、空格、注释等）。你当前代码将 {% extends %} 写在 Front Matter 之前，导致 Eleventy 无法识别分页配置，分页功能直接失效，最终无页面生成。

核心错误2：分页模板逻辑不匹配 #

你已经配置了分页参数 size: 1 以及别名 alias: category，每个分页页面会自动注入单个分类对象到 category 变量中，不需要再遍历全量 categories 数组，否则逻辑和分页配置冲突。

修复后代码 #

---
pagination:
  data: categories
  size: 1
  alias: category
eleventyComputed:
  title: "{{ category.name }}"
---
{% extends "layouts/default.njk" %}

{% block content %}
    <h1>{{ category.name }}</h1>
{% endblock %}

补充验证点 #

• 确认你的分类数据已经正确配置：可放在项目根目录 _data/categories.json 或 _data/categories.js 中，导出格式为数组结构
• 如果需要分页输出分类列表而非单分类页面，可调整分页 size 参数为你需要的每页数量，模板内遍历 pagination.items 即可

内容的提问来源于stack exchange，提问作者Ibrahem Alhofe