hail2u/Gruntfile.js

## generate.js
module.exports = function (grunt) {
  var _ = grunt.util._;
  var async = grunt.util.async;
  var hbs = require('handlebars');
  var path = require('path');

  var taskName = 'generate';
  var taskDescription = 'Generate files using Handlebars.js.';

  grunt.registerMultiTask(taskName, taskDescription, function () {
    var done = this.async();
    var dirTmpl = this.data.cwd;
    var metadataBase = grunt.file.readJSON(dirTmpl + 'metadata.json');

    hbs.registerHelper('include', function (file, options) {
      var rendered = _applyTemplate(dirTmpl + file, this);

      return new hbs.SafeString(rendered);
    });

    async.forEach(this.files, function (file, next) {
      var template = file.src[0];

      if (!grunt.file.exists(template)) {
        grunt.log.warn('Source file "' + template + '" not found.');
        next();
      }

      dirTmpl = path.dirname(template) + '/';
      var metadata = _extendData(template);
      var rendered = _applyTemplate(template, metadata);
      grunt.file.write(file.dest, rendered);
      grunt.log.writeln('File "' + file.dest + '" created.');
      next();
    }, function (err) {
      done(err);
    });

    function _applyTemplate(file, data) {
      var tmpl = hbs.compile(grunt.file.read(file));

      return tmpl(data);
    }

    function _extendData(file) {
      var data = _.extend({}, metadataBase);
      var fileMetadata = file.replace(/\.\w+?$/, '.json');

      if (grunt.file.isFile(fileMetadata)) {
        _.extend(data, grunt.file.readJSON(fileMetadata));
      }

      return data;
    }
  });
};

## Gruntfile.js
module.exports = function (grunt) {
  grunt.initConfig({
    generate: {
      all: {
        expand: true,
        cwd: '.grunt/html/',
        src: ['**/*.hbs', '!**/*.inc.hbs'],
        filter: 'isFile',
        dest: './',
        ext: '.html'
      }
    }
  });

  grunt.util.linefeed = '\n';

  grunt.loadTasks('.grunt/tasks/');

  grunt.registerTask('default', []);

  grunt.registerTask('rebuild', [
    'generate:all',
  ]);
};

## index.hbs
<!doctype html>
  <head>
    <meta charset="UTF-8">
    <meta name="description" content="{{description}}">
    <title>{{title}}</title>
    <link rel="canonical" href="{{canonical}}">
    {{include "./styles.inc.hbs"}}
  </head>
  <body>
    <h1>{{title}}</h1>
    <p>{{description}}</p>
  </body>
</html>

## index.json
{
  "canonical": "http://example.com/"
}

## metadata.json
{
  "title": "My Awesome Website",
  "description": "I love internet!"
}

## structure.txt
[.grunt]
  [html]
    metadata.json
    index.hbs
    index.json
    styles.inc.hbs
    [sub]
      subdir.hbs
      subdir.json
  [tasks]
    generate.js
Gruntfile.js

## styles.inc.hbs
<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/normalize/2.1.0/normalize.css">
<link rel="stylesheet" href="//fonts.googleapis.com/css?family=Open+Sans:400,700,400italic,700italic">
<link rel="stylesheet" href="/css/default.css">

## subdir.hbs
<!doctype html>
  <head>
    <meta charset="UTF-8">
    <meta name="description" content="{{description}}">
    <title>{{title}}</title>
    <link rel="canonical" href="{{canonical}}">
    {{! include template with real file system path}}
    {{include "../styles.inc.hbs"}}
  </head>
  <body>
    <h1>{{title}}</h1>
    <p>{{description}}</p>
  </body>
</html>

## subdir.json
{
  "canonical": "http://example.com/subdir/",
  "title": "My Awesome Sub-directory!",
  "description": "I love internet, too!"
}
	module.exports = function (grunt) {
	var _ = grunt.util._;
	var async = grunt.util.async;
	var hbs = require('handlebars');
	var path = require('path');

	var taskName = 'generate';
	var taskDescription = 'Generate files using Handlebars.js.';

	grunt.registerMultiTask(taskName, taskDescription, function () {
	var done = this.async();
	var dirTmpl = this.data.cwd;
	var metadataBase = grunt.file.readJSON(dirTmpl + 'metadata.json');

	hbs.registerHelper('include', function (file, options) {
	var rendered = _applyTemplate(dirTmpl + file, this);

	return new hbs.SafeString(rendered);
	});

	async.forEach(this.files, function (file, next) {
	var template = file.src[0];

	if (!grunt.file.exists(template)) {
	grunt.log.warn('Source file "' + template + '" not found.');
	next();
	}

	dirTmpl = path.dirname(template) + '/';
	var metadata = _extendData(template);
	var rendered = _applyTemplate(template, metadata);
	grunt.file.write(file.dest, rendered);
	grunt.log.writeln('File "' + file.dest + '" created.');
	next();
	}, function (err) {
	done(err);
	});

	function _applyTemplate(file, data) {
	var tmpl = hbs.compile(grunt.file.read(file));

	return tmpl(data);
	}

	function _extendData(file) {
	var data = _.extend({}, metadataBase);
	var fileMetadata = file.replace(/\.\w+?$/, '.json');

	if (grunt.file.isFile(fileMetadata)) {
	_.extend(data, grunt.file.readJSON(fileMetadata));
	}

	return data;
	}
	});
	};
	module.exports = function (grunt) {
	grunt.initConfig({
	generate: {
	all: {
	expand: true,
	cwd: '.grunt/html/',
	src: ['*/.hbs', '!*/.inc.hbs'],
	filter: 'isFile',
	dest: './',
	ext: '.html'
	}
	}
	});

	grunt.util.linefeed = '\n';

	grunt.loadTasks('.grunt/tasks/');

	grunt.registerTask('default', []);

	grunt.registerTask('rebuild', [
	'generate:all',
	]);
	};
	<!doctype html>
	<head>
	<meta charset="UTF-8">
	<meta name="description" content="{{description}}">
	<title>{{title}}</title>
	<link rel="canonical" href="{{canonical}}">
	{{include "./styles.inc.hbs"}}
	</head>
	<body>
	<h1>{{title}}</h1>
	<p>{{description}}</p>
	</body>
	</html>
	{
	"title": "My Awesome Website",
	"description": "I love internet!"
	}
	[.grunt]
	[html]
	metadata.json
	index.hbs
	index.json
	styles.inc.hbs
	[sub]
	subdir.hbs
	subdir.json
	[tasks]
	generate.js
	Gruntfile.js
	<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/normalize/2.1.0/normalize.css">
	<link rel="stylesheet" href="//fonts.googleapis.com/css?family=Open+Sans:400,700,400italic,700italic">
	<link rel="stylesheet" href="/css/default.css">
	{
	"canonical": "http://example.com/subdir/",
	"title": "My Awesome Sub-directory!",
	"description": "I love internet, too!"
	}