rollup-plugin-generate-html-template
v1.7.0
Published
Rollup plugin for automatically injecting a script tag with the final bundle into an html file.
Downloads
13,282
Maintainers
bengsfortReadme
rollup-plugin-generate-html-template
Auto-inject the resulting rollup bundle via script and link tags into an HTML template.
Installation
npm install --save-dev rollup-plugin-generate-html-templateUsage
// rollup.config.js
import htmlTemplate from 'rollup-plugin-generate-html-template';
export default {
entry: 'src/index.js',
dest: 'dist/js/bundle.js',
plugins: [
htmlTemplate({
template: 'src/template.html',
target: 'index.html',
}),
],
};On final bundle generation the provided template file will have a script tag injected directly above the closing body tag with a link to the js bundle and similarly a link tag above the closing head to the css bundle. By default it uses the same file name and places it directly next to the JS bundle.
<!-- src/index.html -->
<html>
<head>
<title>Example</title>
<head>
<body>
<canvas id="main"></canvas>
</body>
</html>
<!-- dist/index.html -->
<html>
<head>
<title>Example</title>
<link rel="stylesheet" type="text/css" href="bundle.css">
<head>
<body>
<canvas id="main"></canvas>
<script src="bundle.js"></script>
</body>
</html>Options
template: (required) The path to the source template.target: The directory and file name to use for the html file generated with the bundle.attrs: The attributes provided to the generated bundle script tag. Passed as an array of strings Example:attrs: ['async', 'defer]will generate<script async defer src="bundle.js"></script>replaceVars: An object containing variables that will be replaced in the generated html. Example:replaceVars: { '__CDN_URL__': process.env.NODE_ENV === 'production' ? 'https://mycdn.com' : '' }will replace all instances of__CDN_URL__withhttp://mycdn.comif the environment is production
License
MIT