{{heading}}
\r\n```\r\n\r\n\r\n\r\n## Options\r\n\r\n### src\r\nType: `String` (optional)\r\n\r\nDefault: `undefined`\r\n\r\nThe file path of the file(s) to include. Glob patterns may be used.\r\n\r\n### cwd\r\nType: `String` (optional)\r\n\r\nDefault: `undefined`\r\n\r\nThe `cwd` for paths defined in the helper.\r\n\r\n### sep\r\nType: `String`\r\n\r\nDefault: `\\n`\r\n\r\nThe separator to append after each inlined file.\r\n\r\n### marked\r\nType: `Object`\r\n\r\nDefault: `\\n`\r\n\r\nThe separator to append after each inlined file.\r\n\r\n### filter\r\nType: `function`\r\n\r\nDefault: `undefined`\r\n\r\nA custom function for filtering the array of paths returned from the `src` property. This could potentially be more flexible, please make a feature request if you have a use case.\r\n\r\n### compare\r\nType: `Function`\r\n\r\nDefault: `function(a, b) {return a.index >= b.index ? 1 : -1;}`\r\n\r\nCompare function for sorting the aggregated files.\r\n\r\n\r\n\r\n\r\n\r\n## Defining options\r\n\r\n### \"assemble\" task options\r\n\r\n> If you use Grunt and [Assemble](http://assemble.io), you can pass options from the `assemble` task in the Gruntfile to the helper.\r\n\r\nIn your project's Gruntfile, options for the `{{#compose}}...{{/compose}}` helper can be defined in the Assemble task options:\r\n\r\n```javascript\r\nassemble: {\r\n options: {\r\n helpers: ['handlebars-helper-compose', 'foo/*.js'],\r\n compose: {\r\n cwd: './posts',\r\n sep: '',\r\n compare: function(a, b) {\r\n return a.index >= b.index ? 1 : -1;\r\n }\r\n }\r\n },\r\n files: {}\r\n}\r\n```\r\n\r\nNote that the options are defined in `options: {compose: {}}`, which is registered by this helper as a [custom property](http://assemble.io/docs/Custom-Helpers.html) in the Assemble options.\r\n\r\n\r\n\r\n## Examples\r\n\r\n### all options\r\n\r\n```js\r\nassemble: {\r\n options: {\r\n compose: {\r\n cwd: 'posts',\r\n sep: '',\r\n compare: function(a, b) {\r\n return a.index >= b.index ? 1 : -1;\r\n }\r\n }\r\n }\r\n}\r\n```\r\n\r\n### filtering\r\n\r\nExample: return only the last two items from the `src` files array:\r\n\r\n```js\r\nassemble: {\r\n options: {\r\n compose: {\r\n cwd: 'posts',\r\n sep: '',\r\n filter: function(arr) {\r\n return arr.slice(Math.max(arr.length - 2, 0));\r\n }\r\n }\r\n }\r\n}\r\n```\r\n\r\n\r\n\r\n### cwd option\r\n\r\nInstead of defining the entire path in the `src` hash option, like this:\r\n\r\n```handlebars\r\n{{compose src=\"path/to/my/blog/posts/*.md\"}}\r\n{{{@content}}}
\r\n{{/compose}}\r\n```\r\n\r\n### posts\r\n..and we have a few posts, `monday.md`, `tuesday.md`, and `wednesday.md`, for example:\r\n\r\n```handlebars\r\n---\r\ntitle: Monday\r\n---\r\n\r\nThis is the {{title}} post...\r\n```\r\n\r\n### result\r\n\r\nThe result, `blog/index.html` would look something like:\r\n\r\n```html\r\n\r\n\r\n \r\n \r\nThis is the Monday post...
\r\n\r\n \r\nThis is the Tuesday post...
\r\n\r\n \r\nThis is the Wednesday post...
\r\n \r\n\r\n```\r\n\r\n\r\n## Author\r\n\r\n**Jon Schlinkert**\r\n\r\n+ [twitter/jonschlinkert](http://twitter.com/jonschlinkert)\r\n+ [github/jonschlinkert](http://github.com/jonschlinkert)\r\n\r\n\r\n## License and Copyright\r\nLicensed under the [MIT License](./LICENSE-MIT).\r\nCopyright (c) 2014 Jon Schlinkert, contributors.\r\n","maintainers":[{"name":"jonschlinkert","email":"github@sellside.com"},{"name":"doowb","email":"brian.woodward@gmail.com"}],"time":{"modified":"2022-06-18T18:52:30.507Z","created":"2013-10-19T10:20:06.221Z","0.1.3":"2013-10-19T10:20:16.577Z","0.1.4":"2013-11-01T09:50:00.736Z","0.2.0":"2014-01-15T10:54:21.285Z","0.2.1":"2014-01-15T11:06:33.029Z","0.2.2":"2014-01-16T11:54:19.960Z","0.2.3":"2014-01-16T12:48:46.897Z","0.2.4":"2014-01-17T16:27:20.388Z","0.2.5":"2014-01-17T19:32:04.516Z","0.2.6":"2014-01-20T10:09:21.158Z","0.2.7":"2014-01-21T00:54:06.009Z","0.2.8":"2014-01-23T17:26:15.117Z","0.2.9":"2014-01-27T08:58:41.551Z","0.2.10":"2014-02-05T08:52:36.045Z","0.2.11":"2014-02-05T10:20:15.696Z","0.2.12":"2014-02-09T12:49:16.306Z"},"author":{"name":"Jon Schlinkert","url":"https://github.com/jonschlinkert"},"repository":{"type":"git","url":"https://github.com/helpers/handlebars-helper-compose.git"},"readmeFilename":"README.md"}