grunt-simple-include
Super easy way to include files with a familiar syntax.
Getting Started
This plugin requires Grunt ~0.4.1
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-simple-include --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt;
File inclusion
To include a file use the familiar mustach syntax.
{% include: 'partials/content.html' %}
File inclusions multiple times
{% include: 'partials/article.html' @2 %}
Pass variables to included file
{% include: 'partials/article.html' @key:value @key2:value %}
Print variables (partials/article.html)
{{ key }} {{ key2 }}
The "simple_include" task
Overview
In your project's Gruntfile, add a section named simple_include
to the data object passed into grunt.initConfig()
.
grunt
Options
stripPrefix
Option to strip any prefix if you'd like to.
grunt
includeRegex
Type: String
Default: {%.*?include:.*?([a-zA-Z0-9_@/.-]+).*?\'?(.*?)%}
variableRegex
Type: String
Default: @(\\w+):[\'|]([^@]+)[\'|]
pathResolver
Type: Function
Default: (passes the path through unmodified)
baseDir
Type: String
Default: null (will be relative to the file doing the inclusion)
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.
Release History
2014-05-16 0.4.0 Added option to set custom parsing regex, path resolver & added support for automatic index file detection
2014-04-25 0.3.1 Bugfix with numbers in variables
2014-04-24 0.3.0 Added option to pass variables and updated include syntax
2014-03-06 0.2.0 Added option to run each include multiple times with a single statement
2013-10-09 0.1.2 Bugfix
2013-10-09 0.1.1 Added strip prefix option
2013-10-09 0.1.0 First release