$ npm install nunjucks
Une fois installé, utilisez simplement require('nunjucks') pour le charger.
Nunjucks supporte les versions de Node.js qui sont même supportées par la fondation Node.js, c’est-à-dire la version la plus récente et les unes actuellement en mode maintenance.
Utilisez nunjucks.js (min) pour avoir l’intégralité de la bibliothèque ou nunjucks-slim.js (min) pour avoir une version allégée qui fonctionne uniquement avec les templates précompilés.
Utilisez nunjucks.js pour charger dynamiquement les templates, pour auto-recharger les templates quand ils sont modifiés, et pour utiliser les templates précompilés. Comme le fichier est livré avec le compilateur complet, il est plus volumineux (20K min/gzipped). Utilisez-le pour commencer et vous pouvez vous en servir en production si la taille du fichier ne vous dérange pas.
Utilisez nunjucks-slim.js pour charger et utiliser les templates précompilés. Comme le fichier est livré uniquement avec le runtime, il est plus petit (8K min/gzipped), mais il fonctionne seulement avec les templates précompilés. Généralement utilisé en production, il est quand même possible de s’en servir en développement à condition de lancer la tâche grunt ou gulp pour recompiler automatiquement les templates.
Il suffit d’inclure nunjucks avec une balise script dans la page :
<script src="nunjucks.js"></script>
ou le charger comme un module AMD :
define(['nunjucks'], function(nunjucks) {
});
Quoi que vous fassiez, assurez-vous de précompiler vos templates en production ! Il existe des tâches grunt et gulp pour vous aider à faire cela. Lisez Utilisation dans un navigateur pour en savoir plus sur les configurations optimales côté client.
Ceci est la façon la plus simple pour utiliser Nunjucks. Tout d’abord, définissez les indicateurs de configuration comme par exemple l’autoéchappement puis faites le rendu d’une chaine :
nunjucks.configure({ autoescape: true });
nunjucks.renderString('Hello {{ username }}', { username: 'James' });
Généralement, vous n’utiliserez pas renderString, au lieu de cela, vous devez écrire
des templates dans des fichiers individuels et utiliser render. De cette façon, vous pouvez
hériter et inclure des templates. Dans ce cas, vous devez dire à nunjucks
où se trouvent ces fichiers templates avec le premier argument de configure :
nunjucks.configure('views', { autoescape: true });
nunjucks.render('index.html', { foo: 'bar' });
Dans node, 'views' serait un chemin relatif par rapport au répertoire de travail
actuel. Dans le navigateur, ce serait une URL relative et vous
voulez probablement qu’elle soit absolue, telle que '/views'.
En utilisant express ? Il suffit simplement de passer votre app express dans configure :
var app = express();
nunjucks.configure('views', {
autoescape: true,
express: app
});
app.get('/', function(req, res) {
res.render('index.html');
});
L’API ci-dessus fonctionne dans node et dans le navigateur (express est seulement dans node, évidemment). Dans node, nunjucks charge les templates à partir du système de fichiers par défaut et dans le navigateur il les charge depuis HTTP.
Si vous avez précompilé vos templates dans le navigateur, ils seront automatiquement repris par le système et vous ne devez rien faire de plus. Cela facilite l’utilisation du même code dans les environnements de développement et de production, en utilisant des templates précompilés en production.
Ce qui précède n’est que la pointe de l’iceberg. Regardez API pour les docs de l’API et Templating pour le langage des templates.