当使用需要渲染或编译的 Nunjucks 模板时,是否有标准的命名约定来处理它们?即 file.nunjucks、file.nunjucks.html 或 file.njs 等。
我知道在使用其他模板语言时,通常使用它们的名称作为扩展名,例如 file.liquid、file.ejs 等,但我没有看到太多关于 Nunjucks 的参考。
当使用需要渲染或编译的 Nunjucks 模板时,是否有标准的命名约定来处理它们?即 file.nunjucks、file.nunjucks.html 或 file.njs 等。
我知道在使用其他模板语言时,通常使用它们的名称作为扩展名,例如 file.liquid、file.ejs 等,但我没有看到太多关于 Nunjucks 的参考。
我个人更喜欢扩展名“.njk”,这也是他们在Nunjucks 文档中作为示例的内容。
文件扩展名
尽管您可以自由地为您的 Nunjucks 模板文件使用您希望的任何文件扩展名,但 Nunjucks 社区已采用 .njk。
如果您正在为 Nunjucks 开发工具或编辑器语法助手,请包括对 .njk 扩展名的识别。
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 的使用统计信息和使用的命名约定示例......
我认为您可以使用任何命名约定,只要您能够在以后随时重构(重命名)它