docs(cn): translate src/content/api/loaders.md #755

alvin-xin · 2020-06-15T14:03:38Z

翻译 API/Loader Interface 部分文档

@QC-L @dear-lizhihua @yuqingc

…cn/src/content/api/loaders.md

netlify · 2020-06-15T14:06:12Z

Deploy preview for cn-webpack ready!

Built with commit c13edee

https://deploy-preview-755--cn-webpack.netlify.app

lcxfs1991 · 2020-06-17T03:26:30Z

这个怎么closed了

alvin-xin · 2020-06-17T14:50:13Z

这个怎么closed了

之前没添加Reviewers，找了一圈没有找到怎么添加，直接Reopen吧

QC-L · 2020-06-18T02:33:15Z

src/content/api/loaders.md


-T> Loaders may be added inline in requests and disabled via inline prefixes, which will impact the order in which they are "pitched" and executed. See [`Rule.enforce`](/configuration/module/#ruleenforce) for more details.
+module.exports = {


这里是复制多了，还是删少了...

应该是一不小心加进来的

QC-L · 2020-06-18T02:34:36Z

认真核对下中英文，建议查看 Files Change

QC-L

请尽快修改

lcxfs1991 · 2020-07-26T03:19:54Z

@Aastasia 请尽快修改

dear-lizhihua · 2020-09-01T05:14:55Z

在翻译的时候，建议恢复 `xxx` 左右的 ` 符号，这是 markdown 提供的高亮颜色

dear-lizhihua · 2020-09-01T08:11:13Z

src/content/api/loaders.md


 ``` diff
 |- a-loader `pitch`
  |- b-loader `pitch` returns a module
 |- a-loader normal execution
 ```

-See the [bundle-loader](https://github.com/webpack-contrib/bundle-loader) for a good example of how this process can be used in a more meaningful way.
+查看 [bundle-loader](https://github.com/webpack-contrib/bundle-loader) 了解如何以更有意义的方式使用此过程。


 ## The Loader Context


The Loader Context 改为 loader context

dear-lizhihua · 2020-09-01T08:14:58Z

src/content/api/loaders.md


-Given the following example, this require call is used:
+下面提供一个例子，将使用 require 进行调用：

 In `/abc/file.js`:


In /abc/file.js:
在 /abc/file.js 中：

dear-lizhihua · 2020-09-01T08:16:36Z

src/content/api/loaders.md


+在我们的例子中：因为 resource.js 在这个目录中，这个属性为 /abc


严格点应该说：这个属性的值为 /abc

dear-lizhihua · 2020-09-01T08:18:21Z

src/content/api/loaders.md

-
-T> Since webpack 5, `this.getOptions` is available in loader context. It substitutes `getOptions` method from [loader-utils](https://github.com/webpack/loader-utils#getoptions).
-
+提取给定的 loader 选项，接受一个可选的 JSON 格式化对象作为参数


JSON schema 不需要翻译

dear-lizhihua · 2020-09-01T08:23:35Z

src/content/api/loaders.md

@@ -282,6 +273,7 @@ loaders = [{request: string, path: string, query: string, module: function}]
 ```

 In the example:


这行应该删除

dear-lizhihua · 2020-09-01T09:27:36Z

src/content/api/loaders.md

@@ -649,8 +626,8 @@ module.exports = function(source) {

 ## Logging

-Logging API is available since the release of webpack 4.37. When `logging` is enabled in [`stats configuration`](/configuration/stats/#statslogging) and/or when [`infrastructure logging`](/configuration/other-options/#infrastructurelogging) is enabled, loaders may log messages which will be printed out in the respective logger format (stats, infrastructure).
+自webpack 4.37发布以来，日志API就可用了。当 [`stats configuration`](/configuration/stats/#statslogging) 或者 [`infrastructure logging`](/configuration/other-options/#infrastructurelogging) 开启 logging 时，加载程序可以记录消息，这些消息将以相应的日志格式（stats，infrastructure）打印出来。


加载程序 => loader

dear-lizhihua · 2020-09-01T09:27:40Z

src/content/api/loaders.md

- Loaders should prefer to use `this.getLogger()` for logging which is a shortcut to `compilation.getLogger()` with loader path and processed file. This kind of logging is stored to the Stats and formatted accordingly. It can be filtered and exported by the webpack user.
- Loaders may use `this.getLogger('name')` to get an independent logger with a child name. Loader path and processed file is still added.
- Loaders may use special fallback logic for detecting logging support `this.getLogger() ? this.getLogger() : console` to provide a fallback when an older webpack version is used which does not support `getLogger` method.
+- Loaders 最好使用 this.getLogger() 用于日志记录，这是指向 compilation.getLogger() 具有加载程序路径和已处理的文件。这种日志记录被存储到Stats中并相应地格式化。它可以被webpack用户过滤和导出。


加载程序 => loader

dear-lizhihua · 2020-09-01T09:27:42Z

src/content/api/loaders.md

- Loaders may use `this.getLogger('name')` to get an independent logger with a child name. Loader path and processed file is still added.
- Loaders may use special fallback logic for detecting logging support `this.getLogger() ? this.getLogger() : console` to provide a fallback when an older webpack version is used which does not support `getLogger` method.
+- Loaders 最好使用 this.getLogger() 用于日志记录，这是指向 compilation.getLogger() 具有加载程序路径和已处理的文件。这种日志记录被存储到Stats中并相应地格式化。它可以被webpack用户过滤和导出。
+- Loaders 可以使用 this.getLogger("name") 获取具有子名称的独立记录器。仍会添加加载程序路径和已处理的文件。


加载程序 => loader

dear-lizhihua · 2020-09-01T09:28:46Z

src/content/api/loaders.md

- Loaders may use `this.getLogger('name')` to get an independent logger with a child name. Loader path and processed file is still added.
- Loaders may use special fallback logic for detecting logging support `this.getLogger() ? this.getLogger() : console` to provide a fallback when an older webpack version is used which does not support `getLogger` method.
+- Loaders 最好使用 this.getLogger() 用于日志记录，这是指向 compilation.getLogger() 具有加载程序路径和已处理的文件。这种日志记录被存储到Stats中并相应地格式化。它可以被webpack用户过滤和导出。
+- Loaders 可以使用 this.getLogger("name") 获取具有子名称的独立记录器。仍会添加加载程序路径和已处理的文件。


记录器 => logger

dear-lizhihua · 2020-09-01T09:30:02Z

src/content/api/loaders.md

- Loaders may use special fallback logic for detecting logging support `this.getLogger() ? this.getLogger() : console` to provide a fallback when an older webpack version is used which does not support `getLogger` method.
+- Loaders 最好使用 this.getLogger() 用于日志记录，这是指向 compilation.getLogger() 具有加载程序路径和已处理的文件。这种日志记录被存储到Stats中并相应地格式化。它可以被webpack用户过滤和导出。
+- Loaders 可以使用 this.getLogger("name") 获取具有子名称的独立记录器。仍会添加加载程序路径和已处理的文件。
+- Loaders 可以使用特殊的回退逻辑来检测日志支持 this.getLogger() ? this.getLogger() : console。 在使用不支持 getLogger 方法的旧webpack版本时提供回退选项。


提供回退选项 => 提供回退方法

docs(cn): translate https://github.com/docschina/webpack.js.org/blob/…

c13edee

…cn/src/content/api/loaders.md

alvin-xin changed the title ~~docs(cn): translate https://github.com/docschina/webpack.js.org/blob/…~~ docs(cn): translate src/content/api/loaders.md Jun 15, 2020

alvin-xin closed this Jun 17, 2020

alvin-xin reopened this Jun 17, 2020

alvin-xin closed this Jun 17, 2020

alvin-xin reopened this Jun 17, 2020

QC-L reviewed Jun 18, 2020

View reviewed changes

QC-L requested changes Jun 26, 2020

View reviewed changes

QC-L mentioned this pull request Jun 26, 2020

文档核心翻译任务认领 #752

Closed

49 tasks

dear-lizhihua self-requested a review September 1, 2020 05:15

dear-lizhihua suggested changes Sep 1, 2020

View reviewed changes

jacob-lcs mentioned this pull request Jan 31, 2021

docs(cn): translate src/content/api/loaders.md #951

Merged

4 tasks

jacob-lcs closed this Feb 3, 2021

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs(cn): translate src/content/api/loaders.md #755

docs(cn): translate src/content/api/loaders.md #755

alvin-xin commented Jun 15, 2020 •

edited

Loading

netlify bot commented Jun 15, 2020

lcxfs1991 commented Jun 17, 2020

alvin-xin commented Jun 17, 2020 •

edited

Loading

QC-L Jun 18, 2020

alvin-xin Jun 19, 2020

QC-L commented Jun 18, 2020

QC-L left a comment

lcxfs1991 commented Jul 26, 2020

dear-lizhihua commented Sep 1, 2020 •

edited

Loading

dear-lizhihua Sep 1, 2020

dear-lizhihua Sep 1, 2020

dear-lizhihua Sep 1, 2020

dear-lizhihua Sep 1, 2020

dear-lizhihua Sep 1, 2020

dear-lizhihua Sep 1, 2020

dear-lizhihua Sep 1, 2020

dear-lizhihua Sep 1, 2020

dear-lizhihua Sep 1, 2020

dear-lizhihua Sep 1, 2020


		T> Loaders may be added inline in requests and disabled via inline prefixes, which will impact the order in which they are "pitched" and executed. See [`Rule.enforce`](/configuration/module/#ruleenforce) for more details.
		module.exports = {


		在我们的例子中：因为 resource.js 在这个目录中，这个属性为 /abc


		T> Since webpack 5, `this.getOptions` is available in loader context. It substitutes `getOptions` method from [loader-utils](https://github.com/webpack/loader-utils#getoptions).

		提取给定的 loader 选项，接受一个可选的 JSON 格式化对象作为参数

		@@ -282,6 +273,7 @@ loaders = [{request: string, path: string, query: string, module: function}]
		```

		In the example:

docs(cn): translate src/content/api/loaders.md #755

docs(cn): translate src/content/api/loaders.md #755

Conversation

alvin-xin commented Jun 15, 2020 • edited Loading

netlify bot commented Jun 15, 2020

lcxfs1991 commented Jun 17, 2020

alvin-xin commented Jun 17, 2020 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

QC-L commented Jun 18, 2020

QC-L left a comment

Choose a reason for hiding this comment

lcxfs1991 commented Jul 26, 2020

dear-lizhihua commented Sep 1, 2020 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

alvin-xin commented Jun 15, 2020 •

edited

Loading

alvin-xin commented Jun 17, 2020 •

edited

Loading

dear-lizhihua commented Sep 1, 2020 •

edited

Loading