gulp-template-store
A gulp plugin for storing all of your lodash templates in a single cache file.
thistmpl = { obj || obj = {}; var __t __p = '' __e = _escape; with obj __p += '<div>' + + '</div>'; return __p };
thistmpl = { return document; }
Install
Install using npm
npm install gulp-template-store
Example use
var gulp = tmplStore = sources = templates: 'src/html/templates/**/*.html' destinations = tmpl: './tmp/' ;gulp
The featured example will generate a single file named templates.js
containing all template files as keyed lodash template functions contained within an object named this.templateCache
. All keys under the file will be based to src/html
. In addition, the templates will also evaluate Handlebars style interpolation({{}}
) as that has been passed in as an option.
A possible output from say the files src/html/templates/a.html
and src/html/templates/b.html
would be;
thistemplateCache = "templates/a":
NOTE:: gulp-template-store
aims to be platform agnostic. It has been developed on a UNIX system. Whatever base
option is provided, gulp-template-store
will interpret them using the current OS path separator by converting any slashes.
By default, the keys in the resulting store will use forward slashes /
(UNIX style). For example; on Windows, your template may be located at \templates\a.html
. The output key will be templates/a
.
However, you can override this by setting the unix
option to false
if you wish for keys to use the platform path separator. Take into consideration that this may affect those working on a different platform.
Options
-
name: {String}
- Defines the filename for outputted template file. -
variable: {String}
- Defines the variable that shall be used to define the templates object. By default, this isthis.tmpl
. -
base: {String}
- Defines the base directory to generate key names from. By default, this is the root of the repo where your gulpfile is located. -
unix: {Bool}
- Defines whether to use forward slashes/
in keys. When false, will use platform specific path separator. For Windows,\
. Defaults totrue
. -
bare: {Bool}
- use with caution - Defines whether to use lodash templating or to simply create an object store for mapping file contents. Defaults tofalse
.For example,
thistmpl ={ return document; }{ console; } -
options: object
- defines an object containing options that will be passed to the lodash template compiler. Supported options areinterpolate
,imports
andvariable
.
Contributing
Contributions are welcome. Feel free to submit a PR or open an issue if there's something you think is missing.
License
MIT
@jh3y 2015