koa-views
Template rendering middleware for koa.
Note: This master branch is for koa's upcoming version
koa@2
. Take a look at thev1.x
branch forkoa@1
.
Note: This is a fork of the koa-views to add support for templates.
Installation
$ npm install koa-views-templates
Templating engines
koa-views
is using consolidate under the hood.
Example
var views = ; // Must be used before any router is usedapp; app;
For more examples you can take a look at the tests.
API
views(root, opts)
root
: Where your views are located. Must be an absolute path. All rendered views must be relative to this pathopts
(optional)opts.extension
: Default extension for your views
Instead of providing the full file extension you can omit it.
app
vs.
app app
opts.map
: Map a file extension to an engine
In this example, each file ending with .html
will get rendered using the nunjucks
templating engine.
app // render `user.html` with nunjucksapp
Debug
Set the DEBUG
environment variable to koa-views
when starting your server.
$ DEBUG=koa-views