From 218fdd20ba7c61cb85a121b509409d8a164e5f9f Mon Sep 17 00:00:00 2001 From: zousy1 Date: Fri, 9 Oct 2020 09:10:04 +0800 Subject: [PATCH 1/2] docs(cn): translate webpack.js.org\src\content\plugins\eval-source-map-dev-tool-plugin.md --- .../eval-source-map-dev-tool-plugin.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/src/content/plugins/eval-source-map-dev-tool-plugin.md b/src/content/plugins/eval-source-map-dev-tool-plugin.md index 2879e1e30077..b2fa33374cbe 100644 --- a/src/content/plugins/eval-source-map-dev-tool-plugin.md +++ b/src/content/plugins/eval-source-map-dev-tool-plugin.md @@ -15,37 +15,37 @@ related: url: https://survivejs.com/webpack/building/source-maps/#sourcemapdevtoolplugin-and-evalsourcemapdevtoolplugin --- -This plugin enables more fine grained control of source map generation. It is also enabled automatically by certain settings of the [`devtool`](/configuration/devtool/) configuration option. +本插件可以为 source map 的生成提供更好更细粒度的控制。[`devtool`](/configuration/devtool/) 中的某些配置会自动使用它。 ``` js new webpack.EvalSourceMapDevToolPlugin(options); ``` -## Options {#options} +## 选项 {#options} -The following options are supported: +支持以下选项： -- `test` (`string|RegExp|array`): Include source maps for modules based on their extension (defaults to `.js` and `.css`). -- `include` (`string|RegExp|array`): Include source maps for module paths that match the given value. -- `exclude` (`string|RegExp|array`): Exclude modules that match the given value from source map generation. -- `append` (`string`): Appends the given value to the original asset. Usually the `#sourceMappingURL` comment. `[url]` is replaced with a URL to the source map file. `false` disables the appending. -- `moduleFilenameTemplate` (`string`): See [`output.devtoolModuleFilenameTemplate`](/configuration/output/#outputdevtoolmodulefilenametemplate). -- `module` (`boolean`): Indicates whether loaders should generate source maps (defaults to `true`). -- `columns` (`boolean`): Indicates whether column mappings should be used (defaults to `true`). -- `protocol` (`string`): Allows user to override default protocol (`webpack-internal://`) +- `test` (`string|RegExp|array`): 默认值为 `.js` and `.css`，为与给定的模块扩展名相匹配的模块，添加 source map。 +- `include` (`string|RegExp|array`): 为与给定路径相匹配的模块，添加 source map。 +- `exclude` (`string|RegExp|array`): 排除一些与给定值相匹配的模块，不会为它们生成映射关系。 +- `append` (`string`): 将给定的值添加到源代码中，通常是 `#sourceMappingURL` 注释，`[url]` 在 source map 文件中将会被替换成 url，值为 `false` 表示不添加。 +- `moduleFilenameTemplate` (`string`): 查看 [`output.devtoolModuleFilenameTemplate`](/configuration/output/#outputdevtoolmodulefilenametemplate)。 +- `module` (`boolean`): 默认值为 `true`，表示是否为 loaders 添加 source map。 +- `columns` (`boolean`): 默认值为 `true`，表示是否使用列映射(column mapping)。 +- `protocol` (`string`): 默认协议名为 `webpack-internal://`，允许用户重新定义协议。 -T> Setting `module` and/or `columns` to `false` will yield less accurate source maps but will also improve compilation performance significantly. +T> 将 `module` 或者 `columns` 设置为 `false` 将产生较不精确的源映射，但会明显提高编译性能。 -T> If you want to use a custom configuration for this plugin in [development mode](/configuration/mode/#mode-development), make sure to disable the default one. I.e. set `devtool: false`. +T> 如果要在 [开发模式](/configuration/mode/#mode-development) 下对此插件使用自定义配置，请确保禁用默认配置。 即设置 `devtool: false`。 -## Examples {#examples} +## 示例 {#examples} -The following examples demonstrate some common use cases for this plugin. +以下示例演示了此插件的一些常见用例。 -### Basic Use Case {#basic-use-case} +### 基本用例 {#basic-use-case} -You can use the following code to replace the configuration option `devtool: eval-source-map` with an equivalent custom plugin configuration: +可以使用以下代码替换配置选项 `devtool: eval-source-map`，并使用等效的自定义插件配置： ```js module.exports = { @@ -57,9 +57,9 @@ module.exports = { }; ``` -### Exclude Vendor Maps {#exclude-vendor-maps} +### 排除 Vendor(第三方库) Maps {#exclude-vendor-maps} -The following code would exclude source maps for any modules in the `vendor.js` bundle: +下面的代码将排除 `vendor.js` 包中任何模块 source map 的生成： ``` js new webpack.EvalSourceMapDevToolPlugin({ From 1323fd22bc77a836b316b69fb7cbe1442ae9c5f4 Mon Sep 17 00:00:00 2001 From: niubaobaozsy <2335954337@qq.com> Date: Fri, 9 Oct 2020 22:48:49 +0800 Subject: [PATCH 2/2] Update src/content/plugins/eval-source-map-dev-tool-plugin.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 问题修改 Co-authored-by: QiChang Li --- src/content/plugins/eval-source-map-dev-tool-plugin.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/plugins/eval-source-map-dev-tool-plugin.md b/src/content/plugins/eval-source-map-dev-tool-plugin.md index b2fa33374cbe..f01635d2a12a 100644 --- a/src/content/plugins/eval-source-map-dev-tool-plugin.md +++ b/src/content/plugins/eval-source-map-dev-tool-plugin.md @@ -26,7 +26,7 @@ new webpack.EvalSourceMapDevToolPlugin(options); 支持以下选项： -- `test` (`string|RegExp|array`): 默认值为 `.js` and `.css`，为与给定的模块扩展名相匹配的模块，添加 source map。 +- `test` (`string|RegExp|array`): 默认值为 `.js` 和 `.css`，为与给定的模块扩展名相匹配的模块，添加 source map。 - `include` (`string|RegExp|array`): 为与给定路径相匹配的模块，添加 source map。 - `exclude` (`string|RegExp|array`): 排除一些与给定值相匹配的模块，不会为它们生成映射关系。 - `append` (`string`): 将给定的值添加到源代码中，通常是 `#sourceMappingURL` 注释，`[url]` 在 source map 文件中将会被替换成 url，值为 `false` 表示不添加。