This plugin provides DocPad with Partials. Partials are documents which can be inserted into other documents, and are also passed by the docpad rendering engine.
npm install --save docpad-plugin-partials
To use, first create the src/partials directory, and place any partials you want to use in there.
Then in our templates we will be exposed with the @partial(filename,data) function. The data argument is optional, and can be used to send custom data to the partial's template data. If you would like to send over the current document's template data, then do the following @partial(filename,@,data).
If your partial only needs to be rendered once per (re)generation then you can specify cacheable: true in the partial's meta data, doing so greatly improves performance.
For instance we could create the file src/partials/hello.html.md.eco which contains **Hello <%=@name or 'World'%>**.
We could then render it by using <%-@partial('hello.html.md.eco')%> to get back <strong>Hello World</strong> or with <%-@partial('hello.html.md.eco',{name:'Apprentice'})%> to get back <strong>Hello Apprentice</strong>.
You can discover the history inside the History.md file
Licensed under the incredibly permissive MIT License
Copyright © 2012 Bevry Pty Ltd