Skip to content

Commit

Permalink
Merge pull request webpack#134 from dear-lizhihua/cn
Browse files Browse the repository at this point in the history
/content/concepts/index.md 校对
  • Loading branch information
dear-lizhihua authored Feb 6, 2017
2 parents 09bc8b5 + 247027e commit e64a222
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 10 deletions.
16 changes: 8 additions & 8 deletions content/concepts/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,15 +8,15 @@ contributors:
- johnstew
---

*webpack* 是一个现代的 JavaScript 应用_模块打包器(module bundler)_。它有着[难以置信的配置](/configuration),然而,我们认为你必须在开始前先了解**四个核心概念**
*webpack* 是一个现代的 JavaScript 应用程序的_模块打包器(module bundler)_。它有着[难以置信的配置](/configuration),然而,我们认为你必须在开始前先了解**四个核心概念**

作为您的 webpack 学习旅程的一部分,我们写这篇文档目的在于向你传递这些概念的**高度**概述,同时仍然提供特定概念的相关用例。

## 入口(Entry)

webpack 将创建所有应用程序依赖关系图表(dependency graph)。图表的起点被称之为_入口起点(entry point)__入口起点_告诉 webpack _从哪里开始_并遵循着依赖关系图表知道_打包什么_。可以将您的应用_入口起点_认为是**根上下文(contextual root)****app 第一个启动文件**
webpack 将创建所有应用程序的依赖关系图表(dependency graph)。图表的起点被称之为_入口起点(entry point)__入口起点_告诉 webpack _从哪里开始_并遵循着依赖关系图表知道_要打包什么_。可以将您应用程序的_入口起点_认为是**根上下文(contextual root)****app 第一个启动文件**

在 webpack 中,我们使用 [webpack 配置对象](/configuration) 中的 `entry` 属性来定义_入口_
在 webpack 中,我们使用 [webpack 配置对象(webpack configuration object)](/configuration) 中的 `entry` 属性来定义_入口_

接下来我们看一个最简单的例子:

Expand All @@ -34,7 +34,7 @@ module.exports = {

## 出口(Output)

一旦你已经将所有 资源(assets) 打包在一起,我们仍然需要告诉 webpack **哪里**打包我们的应用。wepback`output` 属性描述了**如何处理打包代码**
将所有的资源(assets)归拢在一起后,我们还需要告诉 webpack **在哪里**打包我们的应用程序。webpack`output` 属性描述了**如何处理归拢在一起的代码**(bundled code)

**webpack.config.js**

Expand All @@ -50,24 +50,24 @@ module.exports = {
};
```

在上面例子中,我们正在通过 `output.filename``output.path` 属性来描述 webpack 包的名称,以及我们想要 生成(emit) 在哪里。
在上面例子中,我们正在通过 `output.filename``output.path` 属性来描述 webpack bundle 的名称,以及我们想要生成(emit)在哪里。

T> 你可能看到项目**生成(emitted 或 emit)**贯穿我们整个文档和[插件 API](/api/plugins)。它是“生产(produced) 或 排放(discharged)”的特殊术语。

`output` 属性具有[更多可配置的特性](/configuration/output)但让我们花一些时间了解 `output` 属性的一些最常见的用例
`output` 属性还有[更多可配置的特性](/configuration/output)但让我们花一些时间先了解一些 `output` 属性的最常见的用例

[了解更多!](/concepts/output)


## 加载器(Loader)

webpack 的目标是,让项目中的所有资源都成为 **webpack** 的关注点,而浏览器不需要考虑这些(这并不意味着资源都必须打包在一起)。 webpack 把 [每个文件(.css, .html, .scss, .jpg, etc.) 都作为模块](/concepts/modules) 处理。然而 webpack **只了解 JavaScript**
webpack 的目标是, **webpack** 聚焦于项目中的所有资源(asset),而浏览器不需要关注考虑这些(这并不意味着资源(asset)都必须打包在一起)。webpack 把[每个文件(.css, .html, .scss, .jpg, etc.) 都作为模块](/concepts/modules)处理。而且 webpack **只理解 JavaScript**

**因为文件已被添加到了依赖图表,所以 webpack 加载器会_将这些文件转换为模块_**

webpack 配置在更高层面有两个目标。

1. 识别出(identify)应该被特定的加载器转换(transform)的文件
1. 识别出(identify)应该被指定的加载器转换(transform)的文件
2. 转换能够被添加到依赖图表的文件(并且最终打包)(`use` 属性)

**webpack.config.js**
Expand Down
2 changes: 1 addition & 1 deletion content/configuration/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ contributors:
- mattce
---

webpack 是需要传入一个配置对象。取决于你如何使用 webpack,可以通过两种方式之一:终端或 Node.js。下面指定了所有可用的配置选项。
webpack 是需要传入一个配置对象(configuration object)。取决于你如何使用 webpack,可以通过两种方式之一:终端或 Node.js。下面指定了所有可用的配置选项。

T> 刚接触 webpack?请查看我们提供的指南,从 webpack 一些[核心概念](/concepts)开始学习吧!
T> 注意整个配置中我们使用 Node 内置的 [path 模块](https://nodejs.org/api/path.html),并在它前面加上 [__dirname](https://nodejs.org/docs/latest/api/globals.html#globals_dirname)这个全局变量。可以防止不同操作系统之间的文件路径问题,并且可以使相对路径按照预期工作。更多「POSIX 和 Windows」的相关信息请查看[此章节](https://nodejs.org/api/path.html#path_windows_vs_posix)
Expand Down
2 changes: 1 addition & 1 deletion content/configuration/other-options.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ W> 不要在不同选项的调用之间共享缓存。

`boolean`

捕获一个应用程序"配置文件",包括统计和提示,然后可以使用 [Analyze](https://webpack.github.io/analyse/) 工具进行详细分析
捕获一个应用程序"配置文件",包括统计和提示,然后可以使用 [Analyze](https://webpack.github.io/analyse/) 分析工具进行详细分析

T> 使用 [StatsPlugin](https://www.npmjs.com/package/stats-webpack-plugin) 可以更好地控制生成的配置文件。

Expand Down

0 comments on commit e64a222

Please sign in to comment.