Layout extension for the HTML Webpack Plugin
Enhances html-webpack-plugin
functionality by adding the {layout: 'layoutPath', replace : 'replaceStr'} option.
This is an extension plugin for the webpack plugin html-webpack-plugin - a plugin that simplifies the creation of HTML files to serve your webpack bundles.
Installation
You must be running webpack on node 0.12.x or higher
Install the plugin with npm:
$ npm install --save-dev html-webpack-layout-pluginBasic Usage
Add the plugin to your webpack config as follows:
plugins: [
new HtmlWebpackPlugin(),
new HtmlWebpackLayoutPlugin()
] The above configuration will actually do nothing due to the configuration defaults.
As soon as you now set layout to a path the generated output of the HtmlWebpackPlugin will
always add a layout.
plugins: [
new HtmlWebpackPlugin({
layout: path.join(__dirname, 'layout.html')
}),
new HtmlWebpackLayoutPlugin()
] layout.html
<html>
<head></head>
<body>
{{content}}
</body>
</html>Even if you generate multiple files make sure that you add the HtmlWebpackLayoutPlugin only once:
plugins: [
new HtmlWebpackPlugin({
layout: path.join(__dirname, 'layout.html')
}),
new HtmlWebpackPlugin({
layout: path.join(__dirname, 'layout.html'),
filename: 'demo.html'
}),
new HtmlWebpackPlugin({
layout: path.join(__dirname, 'layout.html'),
filename: 'test.html'
}),
new HtmlWebpackLayoutPlugin()
] 