Skip to content

Commit 2a6a4fa

Browse files
docs: drop the built-in-superseded loaders and plugins from the README (#21855)
* docs: drop the built-in-superseded loaders and plugins from the README mini-css-extract-plugin, html-webpack-plugin, html-loader, style-loader and css-loader are no longer listed, and each section instead says in one line what webpack handles without a loader or plugin. * docs: narrow what the README claims is built in Neither line held: html-webpack-plugin's templates, hooks, chunksSortMode and xhtml have no built-in equivalent, and preprocessors and template engines keep their loaders. Both now point at the What's built-in scope tables instead of implying the packages are unnecessary.
1 parent 1f3264e commit 2a6a4fa

1 file changed

Lines changed: 10 additions & 17 deletions

File tree

‎README.md‎

Lines changed: 10 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -98,18 +98,18 @@ interface](https://webpack.js.org/plugins/). Most of the features
9898
within webpack itself use this plugin interface. This makes webpack very
9999
**flexible**.
100100

101+
Webpack can generate HTML pages and extract CSS files itself, both experimental —
102+
see what that covers, and what still needs a plugin, for
103+
[CSS](https://webpack.js.org/guides/native-css/#whats-built-in) and
104+
[HTML](https://webpack.js.org/guides/native-html/#whats-built-in).
105+
101106
| Name | Status | Install Size | Description |
102107
| :---------------------------------------: | :----------------: | :-----------------: | :-------------------------------------------------------------------------------------- |
103-
| [mini-css-extract-plugin][mini-css] | ![mini-css-npm] | ![mini-css-size] | Extracts CSS into separate files. It creates a CSS file per JS file which contains CSS. |
104108
| [compression-webpack-plugin][compression] | ![compression-npm] | ![compression-size] | Prepares compressed versions of assets to serve them with Content-Encoding |
105109
| [html-bundler-webpack-plugin][bundler] | ![bundler-npm] | ![bundler-size] | Renders a template (EJS, Handlebars, Pug) with referenced source asset files into HTML. |
106-
| [html-webpack-plugin][html-plugin] | ![html-plugin-npm] | ![html-plugin-size] | Simplifies creation of HTML files (`index.html`) to serve your bundles |
107110
| [pug-plugin][pug-plugin] | ![pug-plugin-npm] | ![pug-plugin-size] | Renders Pug files to HTML, extracts JS and CSS from sources specified directly in Pug. |
108111

109112
[common-npm]: https://img.shields.io/npm/v/webpack.svg
110-
[mini-css]: https://github.com/webpack-contrib/mini-css-extract-plugin
111-
[mini-css-npm]: https://img.shields.io/npm/v/mini-css-extract-plugin.svg
112-
[mini-css-size]: https://packagephobia.com/badge?p=mini-css-extract-plugin
113113
[component]: https://github.com/webpack-contrib/component-webpack-plugin
114114
[component-npm]: https://img.shields.io/npm/v/component-webpack-plugin.svg
115115
[component-size]: https://packagephobia.com/badge?p=component-webpack-plugin
@@ -119,9 +119,6 @@ within webpack itself use this plugin interface. This makes webpack very
119119
[bundler]: https://github.com/webdiscus/html-bundler-webpack-plugin
120120
[bundler-npm]: https://img.shields.io/npm/v/html-bundler-webpack-plugin.svg
121121
[bundler-size]: https://packagephobia.com/badge?p=html-bundler-webpack-plugin
122-
[html-plugin]: https://github.com/jantimon/html-webpack-plugin
123-
[html-plugin-npm]: https://img.shields.io/npm/v/html-webpack-plugin.svg
124-
[html-plugin-size]: https://packagephobia.com/badge?p=html-webpack-plugin
125122
[pug-plugin]: https://github.com/webdiscus/pug-plugin
126123
[pug-plugin-npm]: https://img.shields.io/npm/v/pug-plugin.svg
127124
[pug-plugin-size]: https://packagephobia.com/badge?p=pug-plugin
@@ -135,6 +132,11 @@ loaders](https://webpack.js.org/api/loaders/) using Node.js.
135132
Loaders are activated by using `loadername!` prefixes in `require()` statements,
136133
or are automatically applied via regex from your webpack configuration.
137134

135+
JavaScript, JSON and [assets](https://webpack.js.org/guides/asset-modules/) need no
136+
loader, and [CSS](https://webpack.js.org/guides/native-css/#whats-built-in) and
137+
[HTML](https://webpack.js.org/guides/native-html/#whats-built-in) have experimental
138+
built-in support — but preprocessors and template engines keep their loaders.
139+
138140
#### JSON
139141

140142
| Name | Status | Install Size | Description |
@@ -163,14 +165,11 @@ or are automatically applied via regex from your webpack configuration.
163165

164166
| Name | Status | Install Size | Description |
165167
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------: | :--------------: | :-------------------------------------------------------------------------------------- |
166-
| <a href="https://github.com/webpack-contrib/html-loader"><img width="48" height="48" src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/html5/html5-original.svg"></a> | ![html-npm] | ![html-size] | Exports HTML as string, requires references to static resources |
167168
| <a href="https://github.com/webdiscus/pug-loader"><img width="48" height="48" src="https://cdn.rawgit.com/pugjs/pug-logo/master/SVG/pug-final-logo-_-colour-128.svg"></a> | ![pug-npm] | ![pug-size] | Compiles Pug to a function or HTML string, useful for use with Vue, React, Angular |
168169
| <a href="https://github.com/peerigon/markdown-loader"><img width="48" height="48" src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/markdown/markdown-original.svg"></a> | ![md-npm] | ![md-size] | Compiles Markdown to HTML |
169170
| <a href="https://github.com/posthtml/posthtml-loader"><img width="48" height="48" src="https://posthtml.github.io/posthtml/logo.svg"></a> | ![posthtml-npm] | ![posthtml-size] | Loads and transforms a HTML file using [PostHTML](https://github.com/posthtml/posthtml) |
170171
| <a href="https://github.com/pcardune/handlebars-loader"><img width="48" height="48" src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/handlebars/handlebars-original.svg"></a> | ![hbs-npm] | ![hbs-size] | Compiles Handlebars to HTML |
171172

172-
[html-npm]: https://img.shields.io/npm/v/html-loader.svg
173-
[html-size]: https://packagephobia.com/badge?p=html-loader
174173
[pug-npm]: https://img.shields.io/npm/v/@webdiscus/pug-loader.svg
175174
[pug-size]: https://packagephobia.com/badge?p=@webdiscus/pug-loader
176175
[jade-npm]: https://img.shields.io/npm/v/jade-loader.svg
@@ -186,17 +185,11 @@ or are automatically applied via regex from your webpack configuration.
186185

187186
| Name | Status | Install Size | Description |
188187
| :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------: | :-------------: | :----------------------------------------------------------------------- |
189-
| <a href="https://github.com/webpack-contrib/style-loader">`<style>`</a> | ![style-npm] | ![style-size] | Add exports of a module as style to DOM |
190-
| <a href="https://github.com/webpack-contrib/css-loader"><img width="48" height="48" src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/css3/css3-original.svg"></a> | ![css-npm] | ![css-size] | Loads CSS file with resolved imports and returns CSS code |
191188
| <a href="https://github.com/webpack-contrib/less-loader"><img width="48" height="48" src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/less/less-plain-wordmark.svg"></a> | ![less-npm] | ![less-size] | Loads and compiles a LESS file |
192189
| <a href="https://github.com/webpack-contrib/sass-loader"><img width="48" height="48" src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/sass/sass-original.svg"></a> | ![sass-npm] | ![sass-size] | Loads and compiles a Sass/SCSS file |
193190
| <a href="https://github.com/shama/stylus-loader"><img width="48" height="48" src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/stylus/stylus-original.svg"></a> | ![stylus-npm] | ![stylus-size] | Loads and compiles a Stylus file |
194191
| <a href="https://github.com/postcss/postcss-loader"><img width="48" height="48" src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/postcss/postcss-original.svg"></a> | ![postcss-npm] | ![postcss-size] | Loads and transforms a CSS/SSS file using [PostCSS](https://postcss.org) |
195192

196-
[style-npm]: https://img.shields.io/npm/v/style-loader.svg
197-
[style-size]: https://packagephobia.com/badge?p=style-loader
198-
[css-npm]: https://img.shields.io/npm/v/css-loader.svg
199-
[css-size]: https://packagephobia.com/badge?p=css-loader
200193
[less-npm]: https://img.shields.io/npm/v/less-loader.svg
201194
[less-size]: https://packagephobia.com/badge?p=less-loader
202195
[sass-npm]: https://img.shields.io/npm/v/sass-loader.svg

0 commit comments

Comments
 (0)