Существует ли общее соглашение для расширений шаблонов при использовании Nunjucks?

При работе с шаблонами Nunjucks, которые требуют рендеринга или компиляции, существует ли стандартное соглашение об именах, которое будет использоваться для их обработки? то есть file.nunjucks, file.nunjucks.html или file.njs и т.д.

Я знаю, что при работе с другими языками шаблонов обычно используется их имя как расширение, такое как file.liquid, file.ejs и т.д., но я не видел много ссылок на Nunjucks.

Ответ 1

Jon Buckley nunjucks плагин для wintersmith поддерживает соглашение об именовании шаблонов

*.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, но он не может считаться "общим соглашением".

Возможно, можно узнать статистику использования nunjuck и примеры используемых соглашений об именах с помощью Google или GitHub или двигателя вычислительных знаний Wolfram Alpha или Служба IBM Watson Analytics...


Я думаю, что вы можете использовать любое соглашение об именах, если сможете повторно (переименовать) его в любое время позже

Ответ 2

Я лично предпочитаю расширение ".njk", это также то, что у них есть в качестве примера в Документах Nunjucks.

Расширения файлов

Хотя вы можете использовать любое расширение файла, которое требуется для файлов шаблонов Nunjucks, сообщество Nunjucks приняло .njk.

Если вы разрабатываете инструменты или синтаксические синтаксисы редактора для Nunjucks, включите распознавание расширения .njk.