Copies file content to a given template and writes them to disk. You can place a marker in the template where the content of the given files are placed. This is use full when you create HTML files out of Markdown and want to wrap the result into a master layout.
This plugin requires Grunt ^1.0.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-template-replace --save-devOnce the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-template-replace');In your project's Gruntfile, add a section named template-replace to the data object passed into grunt.initConfig().
grunt.initConfig({
"template-replace": {
your_target: {
// Target-specific file lists and/or options go here.
},
},
});Type: String
Default value: ``
Path to master template file. This used for every processed file in this target.
Type: String
Default value: <!-- REPLACE -->
Marker which will be replaced with the content of given files.
This will use src/template.html as the master template file and will create new files in tmp/
grunt.initConfig({
'template-replace': {
'test': {
'options': {
'template': 'src/template.html',
'marker': '<!-- REPLACE -->'
},
'files': [{
expand: true,
cwd: "src/",
src: ["page-*.html"],
dest: "tmp/",
ext: ".html"
}]
},
},
});Input Files
src/template.html:
<html lang="en-EN">
<head>
<title>Sample Page</title>
</head>
<body>
<!-- REPLACE -->
</body>
</html>src/page-a.html:
<h1>Page A</h1>src/page-b.html:
<h1>Page B</h1>Output Files
tmp/page-a.html:
<html lang="en-EN">
<head>
<title>Sample Page</title>
</head>
<body>
<h1>Page A</h1>
</body>
</html>and tmp/page-b.html with <h1>Page A</h1> in the body tag.
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.
- 1.0.0 - Init project.