summaryrefslogtreecommitdiff
path: root/docs/dev/webpack.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/dev/webpack.md')
-rw-r--r--docs/dev/webpack.md11
1 files changed, 4 insertions, 7 deletions
diff --git a/docs/dev/webpack.md b/docs/dev/webpack.md
index 3d35b28a..23bbd7a1 100644
--- a/docs/dev/webpack.md
+++ b/docs/dev/webpack.md
@@ -1,5 +1,4 @@
-Webpack
-===
+# Webpack
Webpack is a JavaScript build system for frontend code. You can find out all
about it on [the webpack website](https://webpack.js.org/).
@@ -15,7 +14,6 @@ The `index` group for example bundles all javascript files and libraries used fo
Entrypoints are referenced in the `plugins` section.
The `HtmlWebpackPlugin` uses templates in `public/views/includes` to include the path to the generated resources in new templates under `public/views/build`. These templates are then used by the backend to serve HTML to the browser.
-
**TODO:** Document which entry points are used for what.
## `webpack.htmlexport.js`
@@ -24,17 +22,16 @@ Packs all CSS from `public/js/htmlExport.js` to `build/html.min.css`.
This file is then downloaded by client-side JS and used to create the HTML.
See `exportToHTML()` in `public/js/extra.js`.
-
## `webpack.dev.js`
The development config uses both common configs, enables development mode and enables "cheap" source maps (lines only).
If you need more detailed source maps while developing, you might want to use the `source-maps` option.
-See https://webpack.js.org/configuration/devtool/ for details.
+See <https://webpack.js.org/configuration/devtool/> for details.
## `webpack.prod.js`
The production config uses both common configs and enables production mode.
-This automatically enables various optimizations (e.g. UglifyJS). See https://webpack.js.org/concepts/mode/ for details.
+This automatically enables various optimizations (e.g. UglifyJS). See <https://webpack.js.org/concepts/mode/> for details.
For the global app config, the name of the emitted chunks is changed to include the content hash.
-See https://webpack.js.org/guides/caching/ on why this is a good idea.
+See <https://webpack.js.org/guides/caching/> on why this is a good idea.
For the HTML export config, CSS minification is enabled.