footer
\n {{/block}}\n \n {{> footer}}\n \n\n```\n\n### Partial example\n\n```html\n\n```\n\n### Custom Helper example\n\nHelpers can either be an object or a single register function. If register is on the object, then it calls the register function, passing in the engine. \n\n```js\nmodule.exports.register = function (Handlebars, options) { \n Handlebars.registerHelper('foo', function () { \n return 'foo';\n });\n};\n```\n\n#### MD5 Helper (inspired by [handlebars-md5](https://github.com/neoziro/handlebars-md5))\n\n```js\n'use strict';\n\nvar crypto = require('crypto'),\n fs = require('fs');\n\n// The module to be exported\nvar helpers = {\n md5: function (path) {\n var content = fs.readFileSync(path);\n return crypto.createHash('md5').update(content).digest('hex');\n }\n};\n\n// Export helpers\nmodule.exports.register = function (Handlebars, options) {\n options = options || {};\n\n for (var helper in helpers) {\n if (helpers.hasOwnProperty(helper)) {\n Handlebars.registerHelper(helper, helpers[helper]);\n }\n }\n};\n```\n\n#### Foo and bar Helpers\n\n```js\n'use strict';\n\n// The module to be exported\nvar helpers = {\n foo: function () {\n return 'foo';\n },\n bar: function () {\n return 'bar';\n }\n};\n\n// Export helpers\nmodule.exports.register = function (Handlebars, options) {\n options = options || {};\n\n for (var helper in helpers) {\n if (helpers.hasOwnProperty(helper)) {\n Handlebars.registerHelper(helper, helpers[helper]);\n }\n }\n};\n```\n\n#### Handlebars Markdown Helper\n\nVery simple Markdown for partial. **do not forget** to add your .md files to the partial list.\n\n```js\noptions: {\n partials: 'src/partials/*.md',\n ...\n}\n```\n\n```js\n/**\n * Handlebars Markdown Helpers\n * Copyright (c) 2014 Thierry Charbonnel\n * Licensed under the MIT License (MIT).\n */\n'use strict';\n\nvar marked = require('marked');\n\n// Export helpers\nmodule.exports.register = function (Handlebars, options) {\n options = options || {};\n options.marked = options.marked || {\n renderer: new marked.Renderer(),\n gfm: true,\n tables: true,\n breaks: false,\n pedantic: false,\n sanitize: true,\n smartLists: true,\n smartypants: false\n };\n \n Handlebars.registerHelper('md', function(name, context){\n var result;\n marked.setOptions(options.marked);\n // Convert inline markdown by prepending the name string with `:`\n if(name.match(/^:/)) {\n result = marked(name.replace(/^:/, ''));\n } else {\n try {\n result = marked(Handlebars.partials[name]);\n } catch(err) {\n result = ''; \n }\n }\n return new Handlebars.SafeString(result); \n }); \n};\n\n```\n\n## npm Helpers \n\nAdd it in devDependencies and in gruntfiles.js\n\n```js\n\"devDependencies\": {\n \"handlebars-helper-moment\": \"*\"\n},\n```\n\nAdd it in gruntfiles.js\n\n```js\nhandlebarslayouts: {\n home: {\n files: {\n 'dist/home.html': 'src/home.html',\n 'dist/index.html': 'src/index.html'\n },\n options: {\n ...\n modules: ['src/helpers/helpers-*.js', 'handlebars-helper-moment'],\n ...\n }\n }\n}\n```\n\nor ( v0.1.4 > )\n\n```js\nhandlebarslayouts: {\n home: {\n files: {\n 'dist/*.html': 'src/*.hsb'\n },\n options: {\n ...\n modules: ['src/helpers/helpers-*.js', 'handlebars-helper-moment'],\n ...\n }\n }\n}\n```\n\n```\nnpm install\n```\n\n### Tested Helpers\n\n* [handlebars-helper-moment](https://github.com/helpers/handlebars-helper-moment)\n\n\n## suggested structure\n\n### A basic Handlebars-layouts site usually looks something like this:\n\n```\n.\n├── partials\n| ├── footer.(html|hsb|md)\n| └── header.(html|hsb|md)\n├── pages\n| ├── 2014-08-14-Handlebars-layouts-foo.(html|hsb)\n| └── 2014-08-14-Handlebars-layouts-bar.(html|hsb)\n├── data\n| └── members.json\n├── helpers\n| └── helpers-*.js\n└── index.html\n```\n\n\n## grunt file example\n\n\n```js\n\n/*global module:false*/\nmodule.exports = function(grunt) {\n 'use strict';\n grunt.initConfig({\n \n handlebarslayouts: {\n dev: {\n files: {\n //'dist/home.html': 'src/home.html'\n 'dist/*.html': 'src/*.hsb'\n },\n options: {\n partials: ['src/partials/*.hbs', 'src/partials/*.md', 'src/layout.html'],\n basePath: 'src/',\n modules: ['src/helpers/helpers-*.js', 'handlebars-helper-moment'],\n context: {\n title: 'Layout Test',\n projectName: 'Grunt handlebars layout',\n items: [\n 'apple',\n 'orange',\n 'banana'\n ]\n }\n }\n }\n },\n \n connect: {\n server: {\n options: {\n livereload: true,\n port: 8000,\n base:'dist/',\n open: true\n }\n }\n },\n \n watch: {\n layout: {\n files: 'src/layout.html',\n tasks: 'handlebarslayouts:dev'\n },\n hsb: {\n files: 'src/**/*.hsb',\n tasks: 'handlebarslayouts:dev'\n },\n options: {\n livereload: true\n }\n },\n \n });\n \n grunt.loadTasks('../tasks');\n \n grunt.loadNpmTasks('grunt-contrib-connect');\n grunt.loadNpmTasks('grunt-contrib-watch');\n\n grunt.registerTask('default', ['handlebarslayouts']);\n \n grunt.registerTask('serve', ['handlebarslayouts', 'connect:server', 'watch']);\n \n};\n\n\n\n\n\n``` \n\n=======\n\n## Other interesting projects \n\n* To precompile Handlebars templates to JST file use [grunt-contrib-handlebars](https://github.com/gruntjs/grunt-contrib-handlebars)\n* Static site generators for Grunt.js, Yeoman and Node.js. [Assemble](http://assemble.io)\n* This task renders Dust templates against a context to produce HTML. [grunt-dust-html](https://github.com/ehynds/grunt-dust-html) \n* Handlebars helpers which implement Jade-like layout blocks for Node project [handlebars-layouts](https://github.com/shannonmoeller/handlebars-layouts)\n* Library of 100+ handlebars helpers. [handlebars-helpers](https://github.com/assemble/handlebars-helpers)\n* Gulp-Dust Precompiles Dust templates [Gulp-Dust](https://github.com/sindresorhus/gulp-dust)\n\n## Release History and Roadmap\n\n * 2016-06-19 v0.2.7 Add New Varibale \\_\\_filename (the src file name)\n * 2016-01-05 v0.2.5 Parse object in context. bug fix (thanks [neagle](https://github.com/neagle))\n * 2016-01-05 v0.2.4 bug fix (thanks [giuseppepaul](https://github.com/giuseppepaul))\n * 2015-01-21 v0.2.1 context can be loaded as files (exemple_2)\n * 2015-01-21 v0.2.0 update code\n * 2015-01-21 v0.2.0b ready to work with grunt-contrib-connect and grunt-contrib-watch.\n * 2014-10-08 v0.1.6 windows fix.\n * 2014-10-08 v0.1.4 Add * for file list and unique name for Partials.\n * 2014-09-05 v0.1.3 Better log error + strict mode.\n * 2014-09-05 v0.1.1 Async optimization.\n * 2014-09-03 v0.1.0 First Release.\n * 2014-08-14 v0.0.* Alpha ans Beta Releases\n\n## License\n\nCopyright © 2014 Thierry Charbonnel, contributors. \nReleased under the MIT license\n\n## Gulp version. \n\nSoon. \nHelp is welcome. (contact me)\n\n\n","maintainers":[{"name":"thierryc","email":"info@autreplanete.com"}],"time":{"modified":"2022-06-18T15:07:51.593Z","created":"2014-08-14T19:38:58.633Z","0.0.2":"2014-08-14T19:38:58.633Z","0.0.3":"2014-08-14T19:43:06.832Z","0.0.4":"2014-08-14T19:58:45.085Z","0.0.5":"2014-08-15T05:20:56.145Z","0.0.6":"2014-08-15T08:30:08.443Z","0.0.7":"2014-08-15T15:59:40.456Z","0.0.8":"2014-08-15T16:23:19.624Z","0.0.9":"2014-08-16T06:42:43.677Z","0.0.10":"2014-08-16T13:42:48.342Z","0.0.11":"2014-08-16T18:00:03.349Z","0.0.12":"2014-08-17T08:21:14.956Z","0.1.0":"2014-09-05T09:35:52.056Z","0.1.1":"2014-09-05T11:09:57.355Z","0.1.2":"2014-09-05T11:51:50.353Z","0.1.3":"2014-09-10T12:53:59.210Z","0.1.4":"2014-10-08T10:33:06.563Z","0.1.5":"2014-10-08T11:18:31.846Z","0.1.6":"2014-10-09T17:34:42.060Z","0.1.7":"2014-10-15T17:54:07.862Z","0.2.0-b":"2015-02-21T11:24:00.523Z","0.2.0":"2015-02-21T12:55:51.425Z","0.2.1":"2015-08-11T11:05:36.387Z","0.2.4":"2016-01-05T11:03:22.645Z","0.2.5":"2016-01-12T22:05:28.972Z","0.2.7":"2016-06-19T09:00:14.617Z","0.3.0":"2017-01-11T07:08:06.896Z"},"homepage":"https://github.com/thierryc/grunt-handlebars-layouts","keywords":["gruntplugin","handlebars","template"],"repository":{"type":"git","url":"git://github.com/thierryc/grunt-handlebars-layouts.git"},"author":{"name":"Thierry Charbonnel","email":"info@autreplanete.com","url":"http://www.autreplanete.com"},"bugs":{"url":"https://github.com/thierryc/grunt-handlebars-layouts/issues"},"readmeFilename":"README.md","users":{"thierryc":true,"lonekorean":true}}