grunt-consolidate

    1.0.2 • Public • Published

    grunt-consolidate

    Use Consolidate.js for templating of files in your Grunt projects. Very useful for preprocessing (build specific file content, such as: LiveReload snippet, non minified assets), and keeping things dry in HTML, JS etc.

    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-consolidate --save-dev

    One the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

    grunt.loadNpmTasks('grunt-consolidate');

    The "consolidate" task

    Overview

    In your project's Gruntfile, add a section named consolidate to the data object passed into grunt.initConfig().

    grunt.initConfig({
      consolidate: {
        options: {
          // Task-specific options go here.
        },
        your_target: {
          // Target-specific file lists and/or options go here.
        },
      },
    })

    Options

    options.engine

    Type: String Default value: null

    The name of the engine used to template your files, you should have the engine in your node_modules, so make sure it is installed before defining the engine, uses consolidate.js underhood.

    Check Consolidate.js for more information.

    options.locals

    Type: Object Default value: {}

    Passed through to the actual template engine, for example, if you use Dust.js as template engine for Consolidate, than this is passed raw as argument to render the template.

    Usage Examples

    Dust.js in src dir

    In this example, we are using Dust.js. As you can see, the local option is an object that is passed in to all templates, you could define your helpers, view logic here.

    grunt.initConfig({
      consolidate: {
        options: {
     
          // dust, handlebars, haml, swig and way more ... https://github.com/linkedin/dustjs
          engine: 'dust'
        },
        dev: {
          options: {
     
            // Data, helpers, partials etc.
            local: {
              users: [{
                name: 'tom',
                email: 'tom@mail.com',
                password: 'computer1'
              }, {
                name: 'rick',
                email: 'rick@mail.com',
                password: 'secret1'
              }]
            }
          },
          files: [{
            expand: true,
            cwd: 'src/',
     
            // All directories & subdirectories, files that have ".dust.html" in their
            // file extension.
            src: ['{,*/}*.dust.html'],
            dest: 'dist/',
            ext: '.html',
     
            // Ignore files with "_" prefix, so "partials/_html-doc.html.dust"
            // would be ignored.
            filter: function(srcFile) {
              return !/\/_/.test(srcFile);
            }
          }]
        }
      }
    })

    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.

    AUTHOR: Mike Vercoelen

    Install

    npm i grunt-consolidate

    DownloadsWeekly Downloads

    1

    Version

    1.0.2

    License

    none

    Last publish

    Collaborators

    • ckayacan