Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit 6dac46a

Browse filesBrowse files
Yucohnyzhper
andauthored
docs(cn): improve the translations of guides/output-management & development, modify the translations of code splitting (#1830)
Co-authored-by: zzzzp <72035646+zhper@users.noreply.github.com>
1 parent f287cef commit 6dac46a
Copy full SHA for 6dac46a

File tree

Expand file treeCollapse file tree

7 files changed

+68
-68
lines changed
Filter options
Expand file treeCollapse file tree

7 files changed

+68
-68
lines changed

‎src/content/api/module-methods.mdx

Copy file name to clipboardExpand all lines: src/content/api/module-methods.mdx
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,7 @@ import(/* webpackIgnore: true */ 'ignored-module.js');
142142

143143
`webpackIgnore`:设置为 true 时,禁用动态导入解析。
144144

145-
W> 注意:将 `webpackIgnore` 设置为 `true` 则不进行代码分割
145+
W> 注意:将 `webpackIgnore` 设置为 `true` 则不进行代码分离
146146

147147
`webpackChunkName`: 新 chunk 的名称。 从 webpack 2.6.0 开始,占位符 `[index]``[request]` 分别支持递增的数字或实际的解析文件名。 添加此注释后,将单独的给我们的 chunk 命名为 [my-chunk-name].js 而不是 [id].js。
148148

@@ -435,7 +435,7 @@ const page = 'Foo';
435435
__webpack_modules__[require.resolveWeak(`./page/${page}`)];
436436
```
437437

438-
T> `require.resolveWeak`_通用渲染_(服务器端渲染 SSR + 代码分割 Code Splitting)的基础。例如在 [react-universal-component](https://github.com/faceyspacey/react-universal-component) 等包中的用法。它允许代码在服务器端和客户端初始页面的加载上同步渲染。它要求手动或以某种方式提供 chunk。它可以在不需要指示应该被打包的情况下引入模块。它与 `import()` 一起使用,当用户导航触发额外的导入时,它会被接管。
438+
T> `require.resolveWeak`_通用渲染_(服务器端渲染 SSR + 代码分离 Code Splitting)的基础。例如在 [react-universal-component](https://github.com/faceyspacey/react-universal-component) 等包中的用法。它允许代码在服务器端和客户端初始页面的加载上同步渲染。它要求手动或以某种方式提供 chunk。它可以在不需要指示应该被打包的情况下引入模块。它与 `import()` 一起使用,当用户导航触发额外的导入时,它会被接管。
439439

440440
### warning
441441

‎src/content/blog/2020-10-10-webpack-5-release.mdx

Copy file name to clipboardExpand all lines: src/content/blog/2020-10-10-webpack-5-release.mdx
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -587,7 +587,7 @@ Webpack 过去总是在第一次构建时发出所有的输出文件,但在增
587587

588588
## 重大变更:长期未解决的问题 $#major-changes-long-outstanding-problems$
589589

590-
### 单一文件目标的代码分割 $#code-splitting-for-single-file-targets$
590+
### 单一文件目标的代码分离 $#code-splitting-for-single-file-targets$
591591

592592
只允许启动单个文件的目标(如 node、WebWorker、electron main)现在支持运行时自动加载引导所需的依赖代码片段。
593593

‎src/content/concepts/dependency-graph.mdx

Copy file name to clipboardExpand all lines: src/content/concepts/dependency-graph.mdx
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,4 +20,4 @@ related:
2020
当 webpack 处理应用程序时,它会根据命令行参数中或配置文件中定义的模块列表开始处理。
2121
[_入口_](/concepts/entry-points/) 开始,webpack 会递归的构建一个 _依赖关系图_,这个依赖图包含着应用程序中所需的每个模块,然后将所有模块打包为少量的 _bundle_ —— 通常只有一个 —— 可由浏览器加载。
2222

23-
T> 对于 _HTTP/1.1_ 的应用程序来说,由 webpack 构建的 bundle 非常强大。当浏览器发起请求时,它能最大程度的减少应用的等待时间。而对于 _HTTP/2_ 来说,你还可以使用[代码分割](/guides/code-splitting/)进行进一步优化。
23+
T> 对于 _HTTP/1.1_ 的应用程序来说,由 webpack 构建的 bundle 非常强大。当浏览器发起请求时,它能最大程度的减少应用的等待时间。而对于 _HTTP/2_ 来说,你还可以使用[代码分离](/guides/code-splitting/)进行进一步优化。

‎src/content/concepts/module-federation.mdx

Copy file name to clipboardExpand all lines: src/content/concepts/module-federation.mdx
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -301,7 +301,7 @@ T> [`output.publicPath`](/configuration/output/#outputpublicpath) 配置项也
301301

302302
你可以在模块联邦的高级 API 中将依赖设置为即时依赖,此 API 不会将模块放在异步 chunk 中,而是同步地提供它们。这使得我们在初始块中可以直接使用这些共享模块。但是要注意,由于所有提供的和降级模块是要异步下载的,因此,建议只在应用程序的某个地方提供它,例如 shell。
303303

304-
我们强烈建议使用异步边界(asynchronous boundary)。它将把初始化代码分割成更大的块,以避免任何额外的开销,以提高总体性能。
304+
我们强烈建议使用异步边界(asynchronous boundary)。它将把初始化代码分离成更大的块,以避免任何额外的开销,以提高总体性能。
305305

306306
例如,你的入口看起来是这样的:
307307

‎src/content/guides/development.mdx

Copy file name to clipboardExpand all lines: src/content/guides/development.mdx
+41-41Lines changed: 41 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -17,20 +17,20 @@ contributors:
1717
- maxloh
1818
- snitin315
1919
- f3ndot
20-
- Yucohny
2120
translators:
2221
- QC-L
2322
- jacob-lcs
2423
- dear-lizhihua
24+
- Yucohny
2525
---
2626

2727
T> 本指南继续沿用 [管理输出](/guides/output-management) 指南中的代码示例。
2828

29-
如果你一直跟随之前的指南,应该对一些 webpack 基础知识有着很扎实的理解。在我们继续之前,先来看看如何设置一个开发环境,使我们的开发体验变得更轻松一些。
29+
如果已经阅读过之前的指南,那么应该对 webpack 的基础知识有了扎实的理解。在我们继续之前,先来看看如何设置开发环境,使我们的开发体验变得更轻松一些。
3030

3131
W> 本指南中的工具 **仅用于开发环境**,请 **不要** 在生产环境中使用它们!
3232

33-
在开始前,我们先将 [`mode` 设置为 `'development'`](/configuration/mode/#mode-development),并将 `title` 设置为 `'Development'`
33+
首先将 [`mode` 设置为 `'development'`](/configuration/mode/#mode-development),并将 `title` 修改为 `'Development'`
3434

3535
**webpack.config.js**
3636

@@ -60,13 +60,13 @@ W> 本指南中的工具 **仅用于开发环境**,请 **不要** 在生产环
6060

6161
## 使用 source map $#using-source-maps$
6262

63-
当 webpack 打包源代码时,可能会很难追踪到 error(错误)和 warning(警告)在源代码中的原始位置。例如,如果将三个源文件(`a.js``b.js``c.js`)打包到一个 bundle(`bundle.js`)中,而其中一个源文件包含错误,那么堆栈跟踪就会直接指向到 `bundle.js`。但是你可能需要准确地知道错误来自于哪个源文件,所以这种提示这通常不会提供太多帮助
63+
当 webpack 打包源代码时,可能会很难追踪到错误和警告在源代码中的原始位置。例如,如果将三个源文件(`a.js``b.js``c.js`)打包到一个 bundle(`bundle.js`)中,而其中一个源文件包含错误,那么堆栈跟踪就会直接指向到 `bundle.js`,却无法准确知道错误来自于哪个源文件,所以这种提示通常无法提供太多帮助
6464

65-
为了更容易地追踪 error 和 warning,JavaScript 提供了 [source map](http://blog.teamtreehouse.com/introduction-source-maps) 功能,可以将编译后的代码映射回原始源代码。source map 会直接告诉你错误来源于哪一个源代码
65+
为了更容易地追踪错误与警告在源代码中的原始位置,JavaScript 提供了 [source map](http://blog.teamtreehouse.com/introduction-source-maps) 功能,可以帮助将编译后的代码映射回原始源代码。source map 会直接告诉开发者错误来源于哪一个源代码
6666

6767
source map 有许多 [可用选项](/configuration/devtool),请务必仔细阅读它们,以便根据需要进行配置。
6868

69-
在本指南中,我们将使用 `inline-source-map` 选项,这有助于解释说明示例意图(此配置仅用于示例,不要用于生产环境):
69+
本指南将使用有助于解释说明示例意图的 `inline-source-map` 选项(不要在生产环境中使用它):
7070

7171
**webpack.config.js**
7272

@@ -100,8 +100,8 @@ source map 有许多 [可用选项](/configuration/devtool),请务必仔细阅
100100

101101
```diff
102102
export default function printMe() {
103-
- console.log('I get called from print.js!');
104-
+ cosnole.log('I get called from print.js!');
103+
- console.log('我被 print.js 调用了!');
104+
+ cosnole.log('我被 print.js 调用了!');
105105
}
106106
```
107107

@@ -128,25 +128,25 @@ Uncaught ReferenceError: cosnole is not defined
128128
at HTMLButtonElement.printMe (print.js:2)
129129
```
130130

131-
可以看到,此错误包含有发生错误的文件(`print.js`)和行号(2)的引用。这将帮助我们确切知道所要解决问题的位置
131+
可以看到,此错误包含有发生错误的文件(`print.js`)和行号(2)的引用。这将帮助确切知道所要解决问题的位置
132132

133133
## 选择一个开发工具 $#choosing-a-development-tool$
134134

135-
W> 某些文本编辑器具有“safe write(安全写入)”功能,可能会干扰下面一些工具。阅读 [调整文本编辑器](#adjusting-your-text-editor) 以解决这些问题。
135+
W> 某些文本编辑器具有安全写入(safe write功能,可能会干扰下面介绍的一些工具。参阅 [调整文本编辑器](#adjusting-your-text-editor) 以解决这些问题。
136136

137-
在每次编译代码时,手动运行 `npm run build` 会显得很麻烦。
137+
每次编译代码都需要手动运行 `npm run build` 会显得很麻烦。
138138

139-
webpack 提供几种可选方式,帮助你在代码发生变化后自动编译代码
139+
webpack 提供了几种可选方式帮助在代码发生变化后自动编译代码
140140

141-
1. webpack 的 [Watch Mode(观察模式](/configuration/watch/#watch)
141+
1. webpack 的 [观察模式](/configuration/watch/#watch)
142142
2. [webpack-dev-server](https://github.com/webpack/webpack-dev-server)
143143
3. [webpack-dev-middleware](https://github.com/webpack/webpack-dev-middleware)
144144

145145
在多数场景中可能会使用 `webpack-dev-server`,但是不妨探讨一下以上的所有选项。
146146

147147
### 使用观察模式 $#using-watch-mode$
148148

149-
你可以指示 webpack “观察”依赖图中所有文件的更改。如果其中一个文件被更新,代码将被重新编译,所以不必再去手动运行整个构建。
149+
可以指示 webpack “观察”依赖图中所有文件的更改。如果其中一个文件被更新,代码将被自动重新编译,所以不必再去手动运行整个构建。
150150

151151
像下面这样添加一个用于启动 webpack 观察模式的 npm scripts:
152152

@@ -177,27 +177,27 @@ webpack 提供几种可选方式,帮助你在代码发生变化后自动编译
177177
}
178178
```
179179

180-
现在,你可以在命令行中运行 `npm run watch`,然后就会看到 webpack 是如何编译代码的。
181-
然而,你会发现它并没有退出命令行,这是因为该脚本当前还在观察你的文件。
180+
在命令行中运行 `npm run watch`,然后就会看到 webpack 是如何编译代码的。
181+
编译完成后会发现它并没有退出命令行,这是因为该脚本当前还在观察你的文件。
182182

183-
现在,在 webpack 仍在观察文件的同时,移除我们之前加入的错误
183+
现在,在 webpack 仍在观察文件的同时,移除之前故意加入的错误
184184

185185
**src/print.js**
186186

187187
```diff
188188
export default function printMe() {
189-
- cosnole.log('I get called from print.js!');
190-
+ console.log('I get called from print.js!');
189+
- cosnole.log('我被 print.js 调用了!');
190+
+ console.log('我被 print.js 调用了!');
191191
}
192192
```
193193

194-
现在,保存文件并检查 terminal(终端)窗口,应该可以看到 webpack 自动地重新编译修改后的模块
194+
现在,保存文件并检查窗口,应该可以看到 webpack 已经自动地重新编译修改后的模块
195195

196-
唯一的缺点是,为了看到修改后的实际效果,需要手动刷新浏览器。如果能够自动刷新浏览器就更好了!接下来我们会尝试通过 `webpack-dev-server` 实现此功能。
196+
观察模式唯一的缺点是需要手动刷新浏览器才能看到修改后的实际效果。实现 `webpack-dev-server` 将能够自动刷新浏览器!
197197

198198
### 使用 webpack-dev-server $#using-webpack-dev-server$
199199

200-
`webpack-dev-server` 提供了一个基本的 web server,并具有实时重新加载的功能。设置如下
200+
`webpack-dev-server` 提供了一个能够实时重新加载的基本的 web server。安装依赖如下
201201

202202
```bash
203203
npm install --save-dev webpack-dev-server
@@ -237,13 +237,13 @@ npm install --save-dev webpack-dev-server
237237
};
238238
```
239239

240-
以上配置告知 `webpack-dev-server``dist` 目录下的文件 serve 到 `localhost:8080` 下(译注:serve 意即将资源作为 server 的可访问文件)
240+
以上配置告知 `webpack-dev-server` `dist` 目录下的文件作为可访问资源部署在 `localhost:8080`
241241

242-
T> 由于在这个示例中单个 HTML 页面有多个入口,所以添加了 `optimization.runtimeChunk: 'single'` 配置,否则可能会遇到 [这个问题](https://bundlers.tooling.report/code-splitting/multi-entry/)查看 [代码分割](/guides/code-splitting/) 章节了解更多细节。
242+
T> 由于在这个示例中单个 HTML 页面有多个入口,所以添加了 `optimization.runtimeChunk: 'single'` 配置,否则可能会遇到 [这个问题](https://bundlers.tooling.report/code-splitting/multi-entry/)参阅 [代码分离](/guides/code-splitting/) 章节了解更多细节。
243243

244-
T> `webpack-dev-server` 会从 [`output.path`](/configuration/output/#outputpath) 中定义的目录中的 bundle 文件提供服务,即文件可以通过 `http://[devServer.host]:[devServer.port]/[output.publicPath]/[output.filename]` 进行访问。
244+
T> `webpack-dev-server` 会将在 [`output.path`](/configuration/output/#outputpath) 中定义的目录中的 bundle 文件作为可访问资源部署在 server 中,即文件可以通过 `http://[devServer.host]:[devServer.port]/[output.publicPath]/[output.filename]` 进行访问。
245245

246-
W> `webpack-dev-server` 在编译之后不会写入到任何输出文件,而是将 bundle 文件保留在内存中,然后将它们 serve 到 server 中,就好像它们是挂载在 server 根路径上的真实文件一样。如果你的页面希望在其他不同路径中找到 bundle 文件,可以通过 dev server 配置中的 [`devMiddleware.publicPath`](/configuration/dev-server/#devserverdevmiddleware) 选项进行修改
246+
W> `webpack-dev-server` 在编译之后不会写入任何输出文件,而是将 bundle 文件保留在内存中,然后将它们作为可访问资源部署在 server 中,就像是挂载在 server 根路径上的真实文件一样。如果页面希望在不同路径中找到 bundle 文件,可以修改 dev server 配置中的 [`devMiddleware.publicPath`](/configuration/dev-server/#devserverdevmiddleware) 选项
247247

248248
添加一个可以直接运行 dev server 的 script:
249249

@@ -276,23 +276,23 @@ W> `webpack-dev-server` 在编译之后不会写入到任何输出文件,而
276276
}
277277
```
278278

279-
现在,在命令行中运行 `npm start`,会看到浏览器自动加载页面。如果你更改任何源文件并保存它们,web server 将在编译代码后自动重新加载。试试看!
279+
现在,在命令行中运行 `npm start`,会看到浏览器自动加载页面。更改任何源文件并保存它们,web server 将在编译代码后自动重新加载。试试看!
280280

281-
`webpack-dev-server` 具有许多可配置的选项。关于其他更多配置,请查看 [配置文档](/configuration/dev-server)
281+
`webpack-dev-server` 具有许多可配置的选项。参阅 [配置文档](/configuration/dev-server) 以了解更多配置选项
282282

283-
T> 现在server 正在运行,你可能需要尝试 [模块热替换(hot module replacement)](/guides/hot-module-replacement)
283+
T> 现在 server 正在运行,也许你想试试 [热模块替换](/guides/hot-module-replacement)
284284

285285
### 使用 webpack-dev-middleware $#using-webpack-dev-middleware$
286286

287-
`webpack-dev-middleware` 是一个封装器(wrapper),它可以把 webpack 处理过的文件发送到 server。`webpack-dev-server` 在内部使用了它,然而它也可以作为一个单独的 package 使用,以便根据需求进行更多自定义设置。下面是一个 `webpack-dev-middleware` 配合 express server 的示例。
287+
`webpack-dev-middleware` 是一个包装器,它可以把 webpack 处理过的文件发送到 server。这是 `webpack-dev-server` 内部的原理,但是它也可以作为一个单独的包使用,以便根据需求进行更多自定义设置。下面是一个 `webpack-dev-middleware` 配合 `express` server 的示例。
288288

289289
首先,安装 `express` 和 `webpack-dev-middleware`
290290

291291
```bash
292292
npm install --save-dev express webpack-dev-middleware
293293
```
294294

295-
现在,我们需要调整 webpack 配置文件,以确保 middleware(中间件)功能能够正确启用
295+
现在调整 webpack 配置文件,以确保能够正确启用中间件
296296

297297
**webpack.config.js**
298298

@@ -324,7 +324,7 @@ npm install --save-dev express webpack-dev-middleware
324324
};
325325
```
326326

327-
我们将会在 server 脚本使用 `publicPath`以确保文件资源能够正确地 serve 在 `http://localhost:3000` 下,稍后我们会指定端口号。接下来是设置自定义 `express` server:
327+
server 脚本使用 `publicPath`以确保文件资源能够作为可访问资源正确部署在 `http://localhost:3000` 下,稍后我们会指定端口号。接下来是设置自定义 `express` server:
328328

329329
**project**
330330

@@ -366,7 +366,7 @@ app.listen(3000, function () {
366366
});
367367
```
368368

369-
现在,添加一个 npm script,以使更方便地运行 server:
369+
现在添加 npm script 以便更方便地运行 server:
370370

371371
**package.json**
372372

@@ -400,7 +400,7 @@ app.listen(3000, function () {
400400
}
401401
```
402402

403-
现在,在终端执行 `npm run server`,将会有类似如下信息输出:
403+
在终端执行 `npm run server`,将会有类似如下信息输出:
404404

405405
```bash
406406
Example app listening on port 3000!
@@ -422,20 +422,20 @@ Example app listening on port 3000!
422422
<i> [webpack-dev-middleware] Compiled successfully.
423423
```
424424

425-
现在,打开浏览器,访问 `http://localhost:3000`,应该看到 webpack 应用程序已经运行!
425+
打开浏览器,访问 `http://localhost:3000`,应该看到 webpack 应用程序已经运行!
426426

427-
T> 如果想要了解更多关于模块热替换的运行机制,我们推荐你参阅 [模块热替换](/guides/hot-module-replacement/) 指南
427+
T> 参阅 [热模块替换](/guides/hot-module-replacement/) 指南了解更多关于热模块替换的运行机制
428428

429429
## 调整文本编辑器 $#adjusting-your-text-editor$
430430

431-
使用自动编译代码时,可能会在保存文件时遇到一些问题。某些编辑器具有“safe write(安全写入)”功能,会影响重新编译。
431+
使用自动编译代码时,可能会在保存文件时遇到一些问题。某些编辑器具有安全写入功能,会影响重新编译。
432432

433-
在一些常见的编辑器中禁用此功能,查看以下列表
433+
查看以下列表以在常见编辑器中禁用此功能
434434

435-
- **Sublime Text 3**在“用户首选项(user preferences)”中添加 `atomic_save: 'false'`
436-
- **JetBrains IDE(如 WebStorm)**:在 `Preferences > Appearance & Behavior > System Settings` 中取消选中“使用安全写入(Use safe write)”
435+
- **Sublime Text 3**在用户偏好中添加 `atomic_save: 'false'`
436+
- **JetBrains IDE(如 WebStorm)**:在 `Preferences > Appearance & Behavior > System Settings` 中取消选中使用安全写入
437437
- **Vim**:在设置中增加 `:set backupcopy=yes`
438438

439439
## 总结 $#conclusion$
440440

441-
现在,你已经学会了如何自动编译代码,并运行一个简单的开发环境 server。查看下一个指南,学习 [代码分割(Code Splitting)](/guides/code-splitting/)
441+
现在已经学会了如何自动编译代码,并运行一个简单的开发环境 server。查看下一个指南学习 [代码分离](/guides/code-splitting/) 吧!

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.