使用Nunjucks时是否有模板扩展的通用约定？

Question

使用Nunjucks模板时,需要使用标准的命名约定来处理渲染或编译？即file.nunjucks,file.nunjucks.html或file.njs等.

我知道在使用其他模板语言时,通常使用他们的名称作为扩展名,例如file.liquid,file.ejs等,但我没有多少参考Nunjucks.

Answer 1

我个人更喜欢扩展名'.njk',它也是Nunjucks文档中的一个例子.

文件扩展名

虽然您可以随意使用Nunjucks模板文件所需的任何文件扩展名,但Nunjucks社区已采用.njk.

如果您正在为Nunjucks开发工具或编辑器语法助手,请包含对.njk扩展名的识别.

Answer 2

Jon Buckley 为wintersmith设计的nunjucks插件 支持模板命名约定

*.html
*.nunjucks

有关证据,请参阅https://github.com/jbuck/wintersmith-nunjucks/issues/8

所以这个命名约定在使用wintersmith站点生成器的每个地方都很常见.特别是*.html其他地方似乎也相当普遍.

Nunjucks自己的文档使用了*.html使用{% include ..%}和{% extends ..%}标签的例子,它说

... nunjucks中提供的模板功能概述.Nunjucks本质上是jinja2的一个端口,所以如果你发现这里缺少什么,你可以阅读他们的文档......

而jinja自己的文档反过来说

...模板只是一个文本文件.它可以生成任何基于文本的格式(HTML,XML,CSV,LaTeX等).它没有特定的扩展名,.html或.xml就好了 ......

我的内部站点生成器也将nunjucks预处理器应用于具有扩展名的文件:*.md, *.markdown, *.htm, *.html, *.php, *.css, *.js, .htaccess但它不能被视为"常见约定".

有可能使用Google或GitHub或Wolfram Alpha计算知识引擎或IBM Watson Analytics服务找出nunjuck的使用统计信息和使用的命名约定示例...

我认为你可以使用任何命名约定,只要你以后能够重构(重命名)它