SuperAPI AI 工具集

eleventy-nunjucks

通用与其它

查看项目

更新于 10-15 23:57

技能介绍

用途:在编写模板、修改构建配置或合并部署前审查静态输出时加载,适用于 Eleventy(11ty)与 Nunjucks 静态站点,也支持独立 Nunjucks 工作。

版本边界:默认以 Eleventy 3.1.6 为稳定基线;Build Awesome 4.0.0-alpha.10 为预发布,经 @11ty/eleventy@canary 或 @awesome.me/buildawesome@alpha 获取,涉及 v4 安装或迁移前须先查看 v4 参考。

主要能力:覆盖目录布局、配置面、过滤器清单、自动转义规则、稳定性与安全检查;提供数据级联优先级、布局链、过滤器(如 normalize_path、jsonScript)、Nunjucks 语法、构建流水线、生产模式与安全清单等参考。

关键规则:站点外壳优先用 layout: 与 {{ content | safe }};任何 | safe 视为安全边界,未净化的外部 HTML 不得标记安全;script 内联数据用 jsonScript/jsonCompact;透传复制用显式映射,不盲目复制 src/**/*;CSP 优先用 HTTP 头,frame-ancestors 不可用 meta;未受信 Markdown 保持 html: false,且 .md 模板本身不可当作沙箱,未受信文本应作为数据经 md 过滤器渲染。

使用方式:先读 package.json、锁文件与生效的 Eleventy 配置,确认包与版本、模块类型、Node 引擎及配置文件名解析顺序,再按任务加载对应参考;项目内既有行为优先于本技能约定。

限制:v4 执行未获认证,合成版本清单不代表可运行;通用静态站点或安全话题、仅凭 .data./.server. 文件名不足以选中本技能;完成前应以项目自身的构建、开发服务器冒烟检查或测试通过为准。