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

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

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

2 ответа

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 и т.д.). <span> У него нет специального расширения,.html или .xml просто отлично</span>...

Мой встроенный генератор сайтов применяет препроцессор nunjucks также к файлам с расширениями: *.md, *.markdown, *.htm, *.html, *.php, *.css, *.js, .htaccess, но он не может считаться "общим соглашением".

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

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


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

<h2> Расширения файлов</h2>

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

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

licensed under cc by-sa 3.0 with attribution.