Grunt task to combine Knockout templates into one HTML for the Knockout.js-External-Template-Engine.

Based on https://blog.safaribooksonline.com/2014/01/31/using-external-templates-knockout-js/ and https://github.com/rniemeyer/SamplePresentation/blob/master/js/stringTemplateEngine.js

See also grunt-kot2js.

This plugin requires Grunt ~0.4.5

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

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

grunt.loadNpmTasks('grunt-kot2html');

Although I recommend using load-grunt-tasks

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

grunt.initConfig({
    kot2html: {
        dist: {
            prefix: '/theme/',
            src: 'templates/**/*.html',
            dest: 'custom-templates.html'
        }
    }
});

Example output:

<script type="text/html" id="/theme/templates/TemplateA">
    <span class="a" data-bind="text: foo"></span>
</script>
<script type="text/html" id="/theme/templates/TemplateB">
    <span class="a" data-bind="text: bar"></span>
</script>

Type: String

Prefix that is prepended to the template id along with the path. E.g. if the prefix is /theme/ and the path of a template is templates/bar.html, the templateId will be /theme/template/bar (without .html).

Type: String

Root of the input path. This part is not included in the template ID, in contrast to the src property.

Type: String

Input path. Location of the HTML Knockout Templates. Expects template files to have the .html extension

Type: String

Output path. Location of the combined HTML file.

In this example, the sources are files with the .html extension in the templates dir and the generated file is custom-templates.html in the root dir.

grunt.initConfig({
    kot2html: {
        dist: {
            prefix: '/theme/',
            src: 'templates/**/*.html',
            dest: 'custom-templates.html'
        }
    }
});

Follow the jshintrc settings for the code style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

• 2015-03-25 v0.1.0 initial release
• 2016-02-25 v0.3.0 added srcRoot property

• When committing got: warning: LF will be replaced by CRLF in test/expected/dev. This means that the unit test will fail.
• Add lintspaces
• add minification of generated HTML (at least remove all spaces)
• add template to unit test with same path as generated HTML