Blame view

node_modules/optimize-css-assets-webpack-plugin/README.md 2.03 KB
2a09d1a4   liuqimichale   添加宜春 天水 宣化
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
  # Optimize CSS Assets Webpack Plugin
  
  A Webpack plugin to optimize \ minimize CSS assets.
  
  ## What does the plugin do?
  
  It will search for CSS assets during the Webpack build and will optimize \ minimize the CSS (by default it uses [cssnano](http://github.com/ben-eb/cssnano) but a custom CSS processor can be specified).
  
  ### Solves [extract-text-webpack-plugin](http://github.com/webpack/extract-text-webpack-plugin) CSS duplication problem:
  
  Since [extract-text-webpack-plugin](http://github.com/webpack/extract-text-webpack-plugin) only bundles (merges) text chunks, if its used to bundle CSS, the bundle might have duplicate entries (chunks can be duplicate free but when merged, duplicate CSS can be created).
  
  ## Installation:
  
  Using npm:
  ```shell
  $ npm install --save-dev optimize-css-assets-webpack-plugin
  ```
  
  ## Configuration:
  
  The plugin can receive the following options (all of them are optional):
  * assetNameRegExp: A regular expression that indicates the names of the assets that should be optimized \ minimized, defaults to `/\.css$/g`
  * cssProcessor: The CSS processor used to optimize \ minimize the CSS, defaults to [cssnano](http://github.com/ben-eb/cssnano). This should be a function that follows cssnano.process interface (receives a CSS and options parameters and returns a Promise).
  * cssProcessorOptions: The options passed to the cssProcessor, defaults to `{}`
  * canPrint: A boolean indicating if the plugin can print messages to the console, defaults to `true`
  
  ## Example:
  
  ``` javascript
  var OptimizeCssAssetsPlugin = require('optimize-css-assets-webpack-plugin');
  module.exports = {
  	module: {
  		loaders: [
  			{ test: /\.css$/, loader: ExtractTextPlugin.extract("style-loader", "css-loader") }
  		]
  	},
  	plugins: [
  		new ExtractTextPlugin("styles.css"),
      new OptimizeCssAssetsPlugin({
        assetNameRegExp: /\.optimize\.css$/g,
        cssProcessor: require('cssnano'),
        cssProcessorOptions: { discardComments: {removeAll: true } },
        canPrint: true
      })
  	]
  }
  ```
  
  ## License
  
  MIT (http://www.opensource.org/licenses/mit-license.php)