Security News
Supply Chain Attack Detected in Solana's web3.js Library
A supply chain attack has been detected in versions 1.95.6 and 1.95.7 of the popular @solana/web3.js library.
By Sarah Gooding - Dec 03, 2024
Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More →
templates
Advanced tools
templates
System for creating and managing template collections, and rendering templates with any node.js template engine. Can be used as the basis for creating a static site generator or blog framework.
templates 
System for creating and managing template collections, and rendering templates with any node.js template engine. Can be used as the basis for creating a static site generator or blog framework.
(TOC generated by verb using markdown-toc)
Install
Install with npm:
$ npm i templates --save
Features
- create custom view collections using
app.create('foo') - register any template engine for rendering views
- register helpers
- partial support
- plugins and middleware
Example
This is just a very small glimpse at the templates API!
var templates = require('templates');
var app = templates();
// create a collection
app.create('pages');
// add views to the collection
app.page('a.html', {content: 'this is <%= foo %>'});
app.page('b.html', {content: 'this is <%= bar %>'});
app.page('c.html', {content: 'this is <%= baz %>'});
app.pages.getView('a.html')
.render({foo: 'home'}, function (err, view) {
//=> 'this is home'
});
Usage
var templates = require('templates');
var app = templates();
API
Common
This section describes API features that are shared by all Templates classes.
.option
Set or get an option value.
Params
key{String|Object}: Pass a key-value pair or an object to set.val{any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.returns{Object}: Returns the instance for chaining.
Example
app.option('a', 'b');
app.option({c: 'd'});
console.log(app.options);
//=> {a: 'b', c: 'd'}
.use
Run a plugin on the given instance. Plugins are invoked immediately upon instantiating in the order in which they were defined.
Example
The simplest plugin looks something like the following:
app.use(function(inst) {
// do something to `inst`
});
Note that inst is the instance of the class you're instantiating. So if you create an instance of Collection, inst is the collection instance.
Params
fn{Function}: Plugin function. If the plugin returns a function it will be passed to theusemethod of each item created on the instance.returns{Object}: Returns the instance for chaining.
Usage
collection.use(function(items) {
// `items` is the instance, as is `this`
// optionally return a function to be passed to
// the `.use` method of each item created on the
// instance
return function(item) {
// do stuff to each `item`
};
});
App
API for the main Templates class.
Templates
This function is the main export of the templates module. Initialize an instance of templates to create your application.
Params
options{Object}
Example
var templates = require('templates');
var app = templates();
.list
Create a new list. See the list docs for more information about lists.
Params
opts{Object}: List optionsreturns{Object}: Returns thelistinstance for chaining.
Example
var list = app.list();
list.addItem('abc', {content: '...'});
// or, create list from a collection
app.create('pages');
var list = app.list(app.pages);
.collection
Create a new collection. Collections are decorated with special methods for getting and setting items from the collection. Note that, unlike the create method, collections created with .collection() are not cached.
See the collection docs for more information about collections.
Params
opts{Object}: Collection optionsreturns{Object}: Returns thecollectioninstance for chaining.
.create
Create a new view collection to be stored on the app.views object. See
the create docs for more details.
Params
name{String}: The name of the collection to create. Plural or singular form may be used, as the inflections are automatically resolved when the collection is created.opts{Object}: Collection optionsreturns{Object}: Returns thecollectioninstance for chaining.
Engines
.engine
Register a view engine callback fn as ext.
Params
exts{String|Array}: String or array of file extensions.fn{Function|Object}: orsettingssettings{Object}: Optionally pass engine options as the last argument.
Example
app.engine('hbs', require('engine-handlebars'));
// using consolidate.js
var engine = require('consolidate');
app.engine('jade', engine.jade);
app.engine('swig', engine.swig);
// get a registered engine
var swig = app.engine('swig');
Helpers
.helper
Register a template helper.
Params
name{String}: Helper namefn{Function}: Helper function.
Example
app.helper('upper', function(str) {
return str.toUpperCase();
});
.helpers
Register multiple template helpers.
Params
helpers{Object|Array}: Object, array of objects, or glob patterns.
Example
app.helpers({
foo: function() {},
bar: function() {},
baz: function() {}
});
.helper
Get a sync helper that was previously registered.
Params
name{String}: Helper namefn{Function}: Helper function.
Example
app.helper('upper', function(str) {
return str.toUpperCase();
});
.asyncHelper
Register an async helper.
Params
name{String}: Helper name.fn{Function}: Helper function
Example
app.asyncHelper('upper', function(str, next) {
next(null, str.toUpperCase());
});
.asyncHelpers
Register multiple async template helpers.
Params
helpers{Object|Array}: Object, array of objects, or glob patterns.
Example
app.asyncHelpers({
foo: function() {},
bar: function() {},
baz: function() {}
});
.helperGroup
Register a namespaced helper group.
Params
helpers{Object|Array}: Object, array of objects, or glob patterns.
Example
// markdown-utils
app.helperGroup('mdu', {
foo: function() {},
bar: function() {},
});
// Usage:
// <%= mdu.foo() %>
// <%= mdu.bar() %>
Built-in helpers
Params
name{String}collection{String}returns{String}
Example
<%= view("foo") %>
If the helper is used as a handlebars block helper, the collection
array will be exposed as context to options.fn(), otherwise
the List array is returned.
Params
options{Object}: Locals or handlebars options objectcallback{String}: Handled internally by the templates library.
Example
// create a collection
app.create('pages');
// use the `pages` helper
// {{#pages}} ... {{/pages}}
View
API for the View class.
View
Create an instance of View. Optionally pass a default object to use.
Params
view{Object}
Example
var view = new View({
path: 'foo.html',
content: '...'
});
.context
Creates a context object from front-matter data, view.locals and the given locals object.
Params
locals{Object}: Optionally pass locals to the engine.returns{Object}: Returns the context object.
Example
var ctx = page.context({foo: 'bar'});
.compile
Synchronously compile a view.
Params
locals{Object}: Optionally pass locals to the engine.returns{Object}View: instance, for chaining.
Example
var view = page.compile();
view.fn({title: 'A'});
view.fn({title: 'B'});
view.fn({title: 'C'});
.render
Asynchronously render a view.
Params
locals{Object}: Optionally pass locals to the engine.returns{Object}View: instance, for chaining.
Example
view.render({title: 'Home'}, function(err, res) {
//=> view object with rendered `content`
});
.isType
Return true if the view is the given view type. Since types are assigned by collections, views that are "collection-less" will not have a type, and thus will always return false (as expected).
Params
type{String}: (renderable,partial,layout)
Example
view.isType('partial');
View Data
.data
Set, get and load data to be passed to templates as context at render-time.
Params
key{String|Object}: Pass a key-value pair or an object to set.val{any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.returns{Object}: Returns an instance ofTemplatesfor chaining.
Example
view.data('a', 'b');
view.data({c: 'd'});
console.log(view.cache.data);
//=> {a: 'b', c: 'd'}
.context
Build the context for the given view and locals.
Params
view{Object}: The view being renderedlocals{Object}returns{Object}: The object to be passed to engines/views as context.
.mergePartials
Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.
Params
options{Object}: Optionally pass an array ofviewTypesto include onoptions.viewTypesreturns{Object}: Merged partials
Item
API for the Item class.
Item
Create an instance of Item. Optionally pass a default object to use.
Params
item{Object}
Example
var item = new Item({
path: 'foo.html',
content: '...'
});
.clone
Re-decorate Item methods after calling vinyl's .clone() method.
Params
options{Object}returns{Object}item: Cloned instance
Example
item.clone({deep: true}); // false by default
Item Data
.data
Set, get and load data to be passed to templates as context at render-time.
Params
key{String|Object}: Pass a key-value pair or an object to set.val{any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.returns{Object}: Returns an instance ofTemplatesfor chaining.
Example
item.data('a', 'b');
item.data({c: 'd'});
console.log(item.cache.data);
//=> {a: 'b', c: 'd'}
.context
Build the context for the given view and locals.
Params
view{Object}: The view being renderedlocals{Object}returns{Object}: The object to be passed to engines/views as context.
.mergePartials
Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.
Params
options{Object}: Optionally pass an array ofviewTypesto include onoptions.viewTypesreturns{Object}: Merged partials
Views
API for the Views class.
Views
Create an instance of Views with the given options.
Params
options{Object}
Example
var collection = new Views();
collection.addView('foo', {content: 'bar'});
.setView
Set a view on the collection. This is identical to addView except setView does not emit an event for each view.
Params
key{String|Object}: View key or objectvalue{Object}: If key is a string, value is the view object.returns{Object}: returns theviewinstance.
Example
collection.setView('foo', {content: 'bar'});
.addView
Similar to setView, adds a view to the collection but also fires an event and iterates over the loading queue for loading views from the addView event listener. If the given view is not already an instance of View, it will be converted to one before being added to the views object.
Params
key{String}value{Object}returns{Object}: Returns the instance of the createdViewto allow chaining view methods.
Example
var views = new Views(...);
views.addView('a.html', {path: 'a.html', contents: '...'});
.deleteView
Delete a view from collection views.
Params
key{String}returns{Object}: Returns the instance for chaining
Example
views.deleteView('foo.html');
.addViews
Load multiple views onto the collection.
Params
views{Object|Array}returns{Object}: returns thecollectionobject
Example
collection.addViews({
'a.html': {content: '...'},
'b.html': {content: '...'},
'c.html': {content: '...'}
});
.addList
Load an array of views onto the collection.
Params
list{Array}returns{Object}: returns theviewsinstance
Example
collection.addList([
{path: 'a.html', content: '...'},
{path: 'b.html', content: '...'},
{path: 'c.html', content: '...'}
]);
.getView
Get view name from collection.views.
Params
key{String}: Key of the view to get.fn{Function}: Optionally pass a function to modify the key.returns{Object}
Example
collection.getView('a.html');
.extendView
Load a view from the file system.
Params
view{Object}returns{Object}
Example
collection.loadView(view);
.isType
Return true if the collection belongs to the given view type.
Params
type{String}: (renderable,partial,layout)
Example
collection.isType('partial');
Views Data
.data
Set, get and load data to be passed to templates as context at render-time.
Params
key{String|Object}: Pass a key-value pair or an object to set.val{any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.returns{Object}: Returns an instance ofTemplatesfor chaining.
Example
views.data('a', 'b');
views.data({c: 'd'});
console.log(views.cache.data);
//=> {a: 'b', c: 'd'}
.context
Build the context for the given view and locals.
Params
view{Object}: The view being renderedlocals{Object}returns{Object}: The object to be passed to engines/views as context.
.mergePartials
Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.
Params
options{Object}: Optionally pass an array ofviewTypesto include onoptions.viewTypesreturns{Object}: Merged partials
Lookup methods
.find
Find a view by name, optionally passing a collection to limit the search. If no collection is passed all renderable collections will be searched.
Params
name{String}: The name/key of the view to findcolleciton{String}: Optionally pass a collection name (e.g. pages)returns{Object|undefined}: Returns the view if found, orundefinedif not.
Example
var page = app.find('my-page.hbs');
// optionally pass a collection name as the second argument
var page = app.find('my-page.hbs', 'pages');
.getView
Get view key from the specified collection.
Params
collection{String}: Collection name, e.g.pageskey{String}: Template namefn{Function}: Optionally pass arenameKeyfunctionreturns{Object}
Example
var view = app.getView('pages', 'a/b/c.hbs');
// optionally pass a `renameKey` function to modify the lookup
var view = app.getView('pages', 'a/b/c.hbs', function(fp) {
return path.basename(fp);
});
.getViews
Get all views from a collection using the collection's singular or plural name.
Params
name{String}: The collection name, e.g.pagesorpagereturns{Object}
Example
var pages = app.getViews('pages');
//=> { pages: {'home.hbs': { ... }}
var posts = app.getViews('posts');
//=> { posts: {'2015-10-10.md': { ... }}
Collections
API for the Collections class.
Collection
Create an instance of Collection with the given options.
Params
options{Object}
Example
var collection = new Collection();
collection.addItem('foo', {content: 'bar'});
.setItem
Set an item on the collection. This is identical to addItem except setItem does not emit an event for each item and does not iterate over the item queue.
Params
key{String|Object}: Item key or objectvalue{Object}: If key is a string, value is the item object.returns{Object}: returns theiteminstance.
Example
collection.setItem('foo', {content: 'bar'});
.addItem
Similar to setItem, adds an item to the collection but also fires an event and iterates over the item queue to load items from the addItem event listener. An item may be an instance of Item, if not, the item is converted to an instance of Item.
Params
key{String}value{Object}
Example
var list = new List(...);
list.addItem('a.html', {path: 'a.html', contents: '...'});
.deleteItem
Delete an item from collection items.
Params
key{String}returns{Object}: Returns the instance for chaining
Example
items.deleteItem('abc');
.addItems
Load multiple items onto the collection.
Params
items{Object|Array}returns{Object}: returns the instance for chaining
Example
collection.addItems({
'a.html': {content: '...'},
'b.html': {content: '...'},
'c.html': {content: '...'}
});
.addList
Load an array of items onto the collection.
Params
items{Array}: or an instance ofListfn{Function}: Optional sync callback function that is called on each item.returns{Object}: returns the Collection instance for chaining
Example
collection.addList([
{path: 'a.html', content: '...'},
{path: 'b.html', content: '...'},
{path: 'c.html', content: '...'}
]);
.getItem
Get an item from the collection.
Params
key{String}: Key of the item to get.returns{Object}
Example
collection.getItem('a.html');
.data
Set, get and load data to be passed to templates as context at render-time.
Params
key{String|Object}: Pass a key-value pair or an object to set.val{any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.returns{Object}: Returns an instance ofTemplatesfor chaining.
Example
collection.data('a', 'b');
collection.data({c: 'd'});
console.log(collection.cache.data);
//=> {a: 'b', c: 'd'}
.context
Build the context for the given view and locals.
Params
view{Object}: The view being renderedlocals{Object}returns{Object}: The object to be passed to engines/views as context.
.mergePartials
Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.
Params
options{Object}: Optionally pass an array ofviewTypesto include onoptions.viewTypesreturns{Object}: Merged partials
List
API for the List class.
List
Create an instance of List with the given options. Lists differ from collections in that items are stored as an array, allowing items to be paginated, sorted, and grouped.
Params
options{Object}
Example
var list = new List();
list.addItem('foo', {content: 'bar'});
.setItem
Set an item on the collection. This is identical to addItem except setItem does not emit an event for each item and does not iterate over the item queue.
Params
key{String|Object}: Item key or objectvalue{Object}: If key is a string, value is the item object.returns{Object}: returns theiteminstance.
Example
collection.setItem('foo', {content: 'bar'});
.addItem
Similar to setItem, adds an item to the list but also fires an event and iterates over the item queue to load items from the addItem event listener. If the given item is not already an instance of Item, it will be converted to one before being added to the items object.
Params
key{String}value{Object}returns{Object}: Returns the instance of the createdItemto allow chaining item methods.
Example
var items = new Items(...);
items.addItem('a.html', {path: 'a.html', contents: '...'});
.addItems
Load multiple items onto the collection.
Params
items{Object|Array}returns{Object}: returns the instance for chaining
Example
collection.addItems({
'a.html': {content: '...'},
'b.html': {content: '...'},
'c.html': {content: '...'}
});
.addList
Load an array of items or the items from another instance of List.
Params
items{Array}: or an instance ofListfn{Function}: Optional sync callback function that is called on each item.returns{Object}: returns the List instance for chaining
Example
var foo = new List(...);
var bar = new List(...);
bar.addList(foo);
.hasItem
Return true if the list has the given item (name).
Params
key{String}returns{Object}
Example
list.addItem('foo.html', {content: '...'});
list.hasItem('foo.html');
//=> true
.getIndex
Get a the index of a specific item from the list by key.
Params
key{String}returns{Object}
Example
list.getIndex('foo.html');
//=> 1
.getItem
Get a specific item from the list by key.
Params
key{String}: The item name/key.returns{Object}
Example
list.getItem('foo.html');
//=> '<Item <foo.html>>'
.getView
Proxy for getItem
Params
key{String}: Pass the key of theitemto get.returns{Object}
Example
list.getItem('foo.html');
//=> '<Item "foo.html" <buffer e2 e2 e2>>'
.deleteItem
Remove an item from the list.
Params
key{Object|String}: Pass aniteminstance (object) oritem.key(string).
Example
list.deleteItem('a.html');
.removeItem
Remove an item from the list.
Params
key{Object|String}: Pass aniteminstance oritem.key
Example
list.removeItem('a.html');
.extendItem
Decorate each item on the list with additional methods and properties. This provides a way of easily overriding defaults.
Params
item{Object}returns{Object}: Instance of item for chaining
.groupBy
Group all list items using the given property, properties or compare functions. See group-array for the full range of available features and options.
returns{Object}: Returns the grouped items.
Example
var list = new List();
list.addItems(...);
var groups = list.groupBy('data.date', 'data.slug');
.sortBy
Sort all list items using the given property, properties or compare functions. See array-sort for the full range of available features and options.
returns{Object}: Returns a newListinstance with sorted items.
Example
var list = new List();
list.addItems(...);
var result = list.sortBy('data.date');
//=> new sorted list
.paginate
Paginate all items in the list with the given options, See paginationator for the full range of available features and options.
returns{Object}: Returns the paginated items.
Example
var list = new List(items);
var pages = list.paginate({limit: 5});
.data
Set, get and load data to be passed to templates as context at render-time.
Params
key{String|Object}: Pass a key-value pair or an object to set.val{any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.returns{Object}: Returns an instance ofTemplatesfor chaining.
Example
list.data('a', 'b');
list.data({c: 'd'});
console.log(list.cache.data);
//=> {a: 'b', c: 'd'}
.context
Build the context for the given view and locals.
Params
view{Object}: The view being renderedlocals{Object}returns{Object}: The object to be passed to engines/views as context.
.mergePartials
Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.
Params
options{Object}: Optionally pass an array ofviewTypesto include onoptions.viewTypesreturns{Object}: Merged partials
Group
API for the Group class.
Group
Create an instance of Group with the given options.
Params
options{Object}
Example
var group = new Group({
'foo': { items: [1,2,3] }
});
Lookups
.find
Find a view by name, optionally passing a collection to limit the search. If no collection is passed all renderable collections will be searched.
Params
name{String}: The name/key of the view to findcolleciton{String}: Optionally pass a collection name (e.g. pages)returns{Object|undefined}: Returns the view if found, orundefinedif not.
Example
var page = app.find('my-page.hbs');
// optionally pass a collection name as the second argument
var page = app.find('my-page.hbs', 'pages');
.getView
Get view key from the specified collection.
Params
collection{String}: Collection name, e.g.pageskey{String}: Template namefn{Function}: Optionally pass arenameKeyfunctionreturns{Object}
Example
var view = app.getView('pages', 'a/b/c.hbs');
// optionally pass a `renameKey` function to modify the lookup
var view = app.getView('pages', 'a/b/c.hbs', function(fp) {
return path.basename(fp);
});
.getViews
Get all views from a collection using the collection's singular or plural name.
Params
name{String}: The collection name, e.g.pagesorpagereturns{Object}
Example
var pages = app.getViews('pages');
//=> { pages: {'home.hbs': { ... }}
var posts = app.getViews('posts');
//=> { posts: {'2015-10-10.md': { ... }}
Rendering
.compile
Compile content with the given locals.
Params
view{Object|String}: View object.locals{Object}isAsync{Boolean}: Load async helpersreturns{Object}: View object withfnproperty with the compiled function.
Example
var indexPage = app.page('some-index-page.hbs');
var view = app.compile(indexPage);
// view.fn => [function]
// you can call the compiled function more than once
// to render the view with different data
view.fn({title: 'Foo'});
view.fn({title: 'Bar'});
view.fn({title: 'Baz'});
.render
Render a view with the given locals and callback.
Params
view{Object|String}: Instance ofViewlocals{Object}: Locals to pass to template engine.callback{Function}
Example
var blogPost = app.post.getView('2015-09-01-foo-bar');
app.render(blogPost, {title: 'Foo'}, function(err, view) {
// `view` is an object with a rendered `content` property
});
Context
.data
Set, get and load data to be passed to templates as context at render-time.
Params
key{String|Object}: Pass a key-value pair or an object to set.val{any}: Any value when a key-value pair is passed. This can also be options if a glob pattern is passed as the first value.returns{Object}: Returns an instance ofTemplatesfor chaining.
Example
app.data('a', 'b');
app.data({c: 'd'});
console.log(app.cache.data);
//=> {a: 'b', c: 'd'}
.context
Build the context for the given view and locals.
Params
view{Object}: The view being renderedlocals{Object}returns{Object}: The object to be passed to engines/views as context.
.mergePartials
Merge "partials" view types. This is necessary for template engines have no support for partials or only support one type of partials.
Params
options{Object}: Optionally pass an array ofviewTypesto include onoptions.viewTypesreturns{Object}: Merged partials
Routes and middleware
.handle
Handle a middleware method for view.
Params
method{String}: Name of the router method to handle. See router methodsview{Object}: View objectcallback{Function}: Callback functionreturns{Object}
Example
app.handle('customMethod', view, callback);
.route
Create a new Route for the given path. Each route contains a separate middleware stack.
See the [route API documentation][route-api] for details on adding handlers and middleware to routes.
Params
path{String}returns{Object}Route: for chaining
Example
app.create('posts');
app.route(/blog/)
.all(function(view, next) {
// do something with view
next();
});
app.post('whatever', {path: 'blog/foo.bar', content: 'bar baz'});
.all
Special route method that works just like the router.METHOD() methods, except that it matches all verbs.
Params
path{String}callback{Function}returns{Object}this: for chaining
Example
app.all(/\.hbs$/, function(view, next) {
// do stuff to view
next();
});
.param
Add callback triggers to route parameters, where name is the name of the parameter and fn is the callback function.
Params
name{String}fn{Function}returns{Object}: Returns the instance ofTemplatesfor chaining.
Example
app.param('title', function(view, next, title) {
//=> title === 'foo.js'
next();
});
app.onLoad('/blog/:title', function(view, next) {
//=> view.path === '/blog/foo.js'
next();
});
is
Params
val{Object}: The value to test.returns{Boolean}
Example
var templates = require('templates');
var app = templates();
templates.isApp(templates);
//=> false
templates.isApp(app);
//=> true
Params
val{Object}: The value to test.returns{Boolean}
Example
var templates = require('templates');
var app = templates();
app.create('pages');
templates.isCollection(app.pages);
//=> true
Params
val{Object}: The value to test.returns{Boolean}
Example
var templates = require('templates');
var app = templates();
app.create('pages');
templates.isViews(app.pages);
//=> true
Params
val{Object}: The value to test.returns{Boolean}
Example
var templates = require('templates');
var List = templates.List;
var app = templates();
var list = new List();
templates.isList(list);
//=> true
Params
val{Object}: The value to test.returns{Boolean}
Example
var templates = require('templates');
var Group = templates.Group;
var app = templates();
var group = new Group();
templates.isGroup(group);
//=> true
Params
val{Object}: The value to test.returns{Boolean}
Example
var templates = require('templates');
var app = templates();
templates.isView('foo');
//=> false
var view = app.view('foo', {content: '...'});
templates.isView(view);
//=> true
Params
val{Object}: The value to test.returns{Boolean}
Example
var templates = require('templates');
var app = templates();
templates.isItem('foo');
//=> false
var view = app.view('foo', {content: '...'});
templates.isItem(view);
//=> true
Params
val{Object}: The value to test.returns{Boolean}
Example
var File = require('vinyl');
var templates = require('templates');
var app = templates();
var view = app.view('foo', {content: '...'});
templates.isVinyl(view);
//=> true
var file = new File({path: 'foo', contents: new Buffer('...')});
templates.isVinyl(file);
//=> true
History
v0.11.0
- Default
enginecan now be defined onappor a collection using usingapp.option('engine'),views.option('engine') - Default
layoutcan now defined usingapp.option('layout'),views.option('layout'). No changes have been made toview.layout, it should work as before. Resolves issue/#818 - Improves logic for finding a layout, this should make layouts easier to define and find going forward.
- The built-in
viewhelper has been refactored completely. The helper is now async and renders the view before returning its content. - Adds
isApp,isViews,isCollection,isList,isView,isGroup, andisItemstatic methods. All return true when the given value is an instance of the respective class. - Adds
deleteItemmethod to List and Collection, anddeleteViewmethod to Views. - Last, the static
_.protoproperty which is only exposed for unit tests was renamed to_.plugin.
v0.10.7
- Force-update base to v0.6.4 to take advantage of
isRegisteredfeature.
v0.10.6
- Re-introduces fs logic to
getView, now that the method has been refactored to be faster.
v0.10.0
getViewmethod no longer automatically reads views from the file system. This was undocumented before and, but it's a breaking change nonetheless. The removed functionality can easily be done in a plugin.
v0.9.5
- Fixes error messages when no engine is found for a view, and the view does not have a file extension.
v0.9.4
- Fixes a lookup bug in render and compile that was returning the first view that matched the given name from any collection. So if a partial and a page shared the same name, if the partial was matched first it was returned. Now the
renderableview is rendered (e.g. page)
v0.9.0
- breaking change: changes parameters on
app.contextmethod. It now only accepts two arguments,viewandlocals, sincectx(the parameter that was removed) was technically being merged in twice.
0.8.0
- Exposes
isTypemethod onview. Shouldn't be any breaking changes.
v0.7.0
- breaking change: renamed
.errormethod to.formatError - adds
mergeContextoption - collection name is now emitted with
viewanditemas the second argument - adds
isTypemethod for checking theviewTypeon a collection - also now emits an event with the collection name when a view is created
v0.5.1
- fixes bug where
defaultlayout was automatically applied to partials, causing an infinite loop in rare cases.
Related projects
You might also be interested in these projects:
- assemble: Assemble is a powerful, extendable and easy to use static site generator for node.js. Used… more | homepage
- en-route: Routing for static site generators, build systems and task runners, heavily based on express.js routes… more | homepage
- engine: Template engine based on Lo-Dash template, but adds features like the ability to register helpers… more | homepage
- layouts: Wraps templates with layouts. Layouts can use other layouts and be nested to any depth.… more | homepage
- verb: Documentation generator for GitHub projects. Verb is extremely powerful, easy to use, and is used… more | homepage
Running tests
Install dev dependencies:
$ npm i -d && npm test
Contributing
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Author
Jon Schlinkert
License
Copyright © 2016 Jon Schlinkert Released under the MIT license.
This file was generated by verb on January 30, 2016.
FAQs
System for creating and managing template collections, and rendering templates with any node.js template engine. Can be used as the basis for creating a static site generator or blog framework.
The npm package templates receives a total of 23,358 weekly downloads. As such, templates popularity was classified as popular.
We found that templates demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 3 open source maintainers collaborating on the project.
Package last updated on 31 Jan 2016
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Related posts
Research
Security News
Malicious npm Package Targets Solana Developers and Hijacks Funds
A malicious npm package targets Solana developers, rerouting funds in 2% of transactions to a hardcoded address.
By Socket Research Team - Dec 02, 2024
Security News
Research
Typosquatting Cryptographic Libraries: Malicious npm Packages Threaten Crypto Developers with Keylogging and Wallet Theft
Socket researchers have discovered malicious npm packages targeting crypto developers, stealing credentials and wallet data using spyware delivered through typosquats of popular cryptographic libraries.
By Kirill Boychenko - Nov 27, 2024