a better default template for html-webpack-plugin
HTML JavaScript
Latest commit 3ad9fdd Dec 21, 2016 @joepin joepin committed with Allows users to specify custom meta tags by converting the meta optio…
…ns from an object to an array of objects (#39)

* Updates the meta option to use an array of objects to define meta tags, allowing for better customization of the template

* Adds a check to see if the meta options value is an array or object, this way we don't break existing apps that rely on passing an object

* Update README.md

* Consolidate method of specifying meta to array

Don't want multiple methods.

README.md

HTML Webpack Template

This is a template for the webpack plugin html-webpack-plugin. It has a few extra features than the default template which will hopefully make it less likely that you'll have to create your own index.html file in your webpack project.

Templates for the html-webpack-plugin are implemented using underscore templates (previously, in 2.x, blueimp templates). You can write your own as well.

Legacy version

For the legacy version that works with html-webpack-plugin@1.x, npm install html-webpack-plugin@2.

Installation

Install the template in your project with npm:

$ npm install html-webpack-template --save-dev

Basic Usage

There are a couple required parameters:

  • inject: Set to false. Controls asset addition to the template. This template takes care of that.
  • template: Specify this module's index.ejs file.

And some other optional:

  • appMountId: The <div> element id on which you plan to mount a JavaScript app.
  • appMountIds: An array of application element ids.
  • baseHref: Adjust the URL for relative URLs in the document (MDN).
  • devServer: Insert the webpack-dev-server hot reload script at this host:port/path; e.g., http://localhost:3000.
  • googleAnalytics.trackingId: Track usage of your site via Google Analytics.
  • googleAnalytics.pageViewOnLoad: Log a pageview event after the analytics code loads.
  • links: Array of <link> elements.
    • If an array element is a string, the value is assigned to the href attribute and the rel attribute is set to "stylesheet";
    • If an array element is an object, the object's properties and values are used as the attribute names and values, respectively.
  • meta: Array of objects containing key value pairs to be included as meta tags.
  • mobile: Sets appropriate meta tag for page scaling.
  • inlineManifestWebpackName: For use with inline-manifest-webpack-plugin.
  • scripts: Array of external script imports to include on page.
    • If an array element is a string, the value is assigned to the src attribute and the type attribute is set to "text/javascript";
    • If an array element is an object, the object's properties and values are used as the attribute names and values, respectively.
  • window: Object that defines data you need to bootstrap a JavaScript app.

Plus any html-webpack-plugin config options otherwise available.

Example

Here's an example webpack config illustrating how to use these options in your webpack.config.js:

{
  // ...
  plugins: [
    new HtmlWebpackPlugin({
      // Required
      inject: false,
      template: require('html-webpack-template'),
      // template: 'node_modules/html-webpack-template/index.ejs',

      // Optional
      appMountId: 'app',
      baseHref: 'http://example.com/awesome',
      devServer: 'http://localhost:3001',
      googleAnalytics: {
        trackingId: 'UA-XXXX-XX',
        pageViewOnLoad: true
      },
      meta: {
        description: 'A better default template for html-webpack-plugin.'
      },
      mobile: true,
      links: [
        'https://fonts.googleapis.com/css?family=Roboto',
        {
          href: '/apple-touch-icon.png',
          rel: 'apple-touch-icon',
          sizes: '180x180'
        },
        {
          href: '/favicon-32x32.png',
          rel: 'icon',
          sizes: '32x32',
          type: 'image/png'
        }
      ],
      inlineManifestWebpackName: 'webpackManifest',
      scripts: [
        'http://example.com/somescript.js',
        {
          src: '/myModule.js',
          type: 'module'
        }
      ],
      title: 'My App',
      window: {
        env: {
          apiHost: 'http://myapi.com/api/v1'
        }
      }

      // And any other config options from html-webpack-plugin:
      // https://github.com/ampedandwired/html-webpack-plugin#configuration
    })
  ]
}