Skip to content

Commit 4851a80

Browse files
committed
📝 typos and wording in translation
fix typo and wording
2 parents 10c91ce + 4f0d151 commit 4851a80

File tree

7 files changed

+33
-33
lines changed

7 files changed

+33
-33
lines changed

zh-TW/part1/README.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212

1313
## 需求
1414

15-
至少,希望你了解基本的 node.js 和 npm。
15+
至少希望你了解基本的 node.js 和 npm。
1616

1717
## 貢獻
1818

@@ -57,16 +57,16 @@
5757

5858
* Bundle JS 檔案 - 讓你可以撰寫模組化的 JavaScript,但是你不需要 inclue 每個 JavaScript `<script>` 的檔案(如果你需要多個 JavaScript 檔案可以透過設定來完成)。
5959

60-
* 在你的前端程式碼中使用 npm packages - npm 在 internet 上是一個大型的 open source 生態系統。有機會你可以儲存你的程式碼,然後到 npm 看一看,可能包含你想要的前端套件。
60+
* 在你的前端程式碼中使用 npm packages - npm 在 internet 上是一個大型的 open source 生態系統。可以儲存或發佈你的程式碼,你可以到 npm 看一看,可能包含你想要的前端套件。
6161

6262
* ES6 和 ES7 - 加入一些 JavaScript 的新功能,讓撰寫程式碼可以更強大更容易,[請看這裡的介紹](https://github.com/DrkSephy/es6-cheatsheet)
6363

6464
* Minify 或優化程式碼 - 減少你所分配的檔案大小,好處包括像是更快的將頁面載入。
6565

66-
* 將 LESS 或 SCSS 轉換成 CSS - 更好的方式來撰寫 CSS,
66+
* 將 LESS 或 SCSS 轉換成 CSS - 使用更好的方式來撰寫 CSS,
6767
[如果你不熟悉的話,這裡有一些介紹](http://alistapart.com/article/why-sass)
6868

69-
* 使用 HMR - 增加生產力。每當你儲存程式碼的時候,它可以注入到網頁,而不需將網頁刷新。如果當編輯你的程式碼,你需要維護頁面的狀態,這是非常方便的。
69+
* 使用 HMR - 增加開發速度。每當你儲存程式碼的時候,它可以注入到網頁,而不需將網頁刷新。如果當編輯你的程式碼,你需要維護頁面的狀態,這是非常方便的。
7070

7171
* 包含任何類型的檔案到你的 JavaScript - 減少對其他 build 工具的需要,讓你可以透過程式的方式修改或使用這些檔案。
7272

@@ -164,7 +164,7 @@ body {
164164

165165
你可能會注意到,我在上方的範例做了一些奇怪的事情。我在 JavaScript 檔案中 `require` 一個 css 檔案。
166166

167-
關於 webpack 真的很酷,有趣的事情是,你可以 `require` 更多不只是 JavaScript 的檔案。
167+
關於 webpack 真的很酷,有趣的事情是,你可以 `require` 其他不只是 JavaScript 的檔案。
168168

169169
在 webpack 這些東西我們稱為 loader。使用這些 loader,你可以 `require` 任何 `.css``.png``.html` 檔。
170170

@@ -175,13 +175,13 @@ body {
175175
require('./styles.css')
176176
```
177177

178-
如果我在我的 webpack 設定檔中,inclue [style-loader](https://github.com/webpack/style-loader)[css-loader](https://github.com/webpack/css-loader)這不僅是可以的,還可以實際應用 CSS 到我的網頁。
178+
如果在我的 webpack 設定檔中,inclue [style-loader](https://github.com/webpack/style-loader)[css-loader](https://github.com/webpack/css-loader)這是可行的,還可以實際應用 CSS 到我的網頁。
179179

180180
你可以在 webpack 使用多個 loader,這裡只是一個單一的例子。
181181

182182
### Plugins
183183

184-
Plugin,顧名思義就是為 webpack 增加額外的功能。其中常使用到的一個 plugin 是 `UglifyJsPlugin`,它可以 minify 你的 JavaScript 程式碼。我們之後會介紹如何使用。
184+
Plugin,顧名思義就是替 webpack 增加額外的功能。其中常使用到的一個 plugin 是 `UglifyJsPlugin`,它可以 minify 你的 JavaScript 程式碼。我們之後會介紹如何使用。
185185

186186
## 你的 webpack 設定檔案
187187

@@ -234,7 +234,7 @@ module.exports = {
234234

235235
[範例三](https://github.com/neighborhood999/WebpackTutorial/tree/master/zh-TW/part1/example3)
236236

237-
想像一下,你使用 webpack 將你的檔案 bundle 在一起,然後你意識到 bundle 後的結果是 900KB。這裡有個問題,但是你可以透過 minify 你的 bundle 檔案來做改善。如果需要做到這一點,你需要使用一個我在前面稍早提到的 [UglifyJsPlugin](https://webpack.github.io/docs/list-of-plugins.html#uglifyjsplugin) plugin。
237+
想像一下,你使用 webpack 將你的檔案 bundle 在一起,然後你發現到 bundle 後的結果是 900KB。這裡有個問題,但是你可以透過 minify 你的 bundle 檔案來做改善。如果需要做到這一點,你需要使用一個我在前面稍早提到的 [UglifyJsPlugin](https://webpack.github.io/docs/list-of-plugins.html#uglifyjsplugin) plugin。
238238

239239
此外,你需要在本機安裝 webpack 才能實際的去使用這個 plugin。
240240

@@ -302,7 +302,7 @@ module.exports = {
302302

303303
## 一個更完整的範例
304304

305-
此外,比起單單使用 JavaScript,使用 webpack 可以做的更多,你可以避免複製-貼上並透過 webpack 管理你的整個專案。
305+
此外,比起單單使用 JavaScript,使用 webpack 可以做的更多,你可以避免複製貼上並透過 webpack 管理你的整個專案。
306306

307307
在下面的部份中,我們要使用 webpack 建立一個非常簡單的網站。如果你想要跟著這個範例,建立一個像下方的目錄結構:
308308

@@ -321,7 +321,7 @@ MyDirectory
321321

322322
1. [介紹 Loader](#introducing-loaders) - 我們將會加入 loader,這可以讓我 bundle 加入的 CSS。
323323
2. [加入更多 Plugin](#adding-more-plugins) - 我們加入一個 plugin 來幫助我們建立和使用一個 HTML 檔案。
324-
3. [開發伺服器](#the-development-server) - 我們會將 webpack 設定檔案分為 `development 和 `production` 兩種版本,然後使用 webpack-dev-server 來查看我們的網站並啟用 HMR。
324+
3. [開發伺服器](#the-development-server) - 我們會將 webpack 設定檔案分為 `development``production` 兩種版本,然後使用 webpack-dev-server 來查看我們的網站並啟用 HMR。
325325
4. [開始撰寫程式](#start-coding) - 我們來實際寫一些 JavaScript。
326326

327327
#### 介紹 Loader
@@ -403,7 +403,7 @@ You may need an appropriate loader to handle this file type.
403403

404404
[範例五](https://github.com/neighborhood999/WebpackTutorial/tree/master/zh-TW/part1/example5)
405405

406-
現在我們的網站有基礎的樣式,但我們還需要實際的網站樣式。
406+
現在我們的網站有一些基礎了,但我們還需要實際的網站樣式。
407407

408408
我們通過 [html-webpack-plugin](https://github.com/ampedandwired/html-webpack-plugin) 來做,它讓我們可以產生一個 HTML 頁面使用現有的。我們將使用一個目前現有的 `index.html`
409409

@@ -540,7 +540,7 @@ module.exports = {
540540

541541
**修改**
542542

543-
1. dev 設定檔省略了優化,當你不斷的 rebuild 時,他們不是必要的。所以不需要 `webpack.optimize` plugins。
543+
1. dev 設定檔省略了優化,當你不斷的 rebuild 時,他們是不必要的。所以不需要 `webpack.optimize` plugins。
544544

545545
2. dev 設定檔需要對 dev server 做必要的設定,你可以到[這裡](https://webpack.github.io/docs/webpack-dev-server.html)了解更多。
546546

@@ -588,7 +588,7 @@ module.exports = {
588588

589589
我也加入一個全新的屬性在 dev 和 prod 設定檔:
590590

591-
* [devtool](https://webpack.github.io/docs/configuration.html#devtool) - 這是協助 debug 。基本上,當你得到一個錯誤,它會幫助你找到哪裡發生了錯誤,像是 chrome developer console。`source-map``cheap-eval-source-map` 之間的差異從文件說明有點難解釋。我可以肯定的是,`source-map` 是用於 production,`cheap-eval-source-map` 是用於 `development`
591+
* [devtool](https://webpack.github.io/docs/configuration.html#devtool) - 這是協助 debug 的工具。基本上,當你得到一個錯誤,它會幫助你找到哪裡發生了錯誤,像是 chrome developer console。`source-map``cheap-eval-source-map` 之間的差異從文件說明有點難解釋。我可以肯定的是,`source-map` 是用於 `production``cheap-eval-source-map` 是用於 `development`
592592

593593
如果要執行 dev server,我們可以執行:
594594

@@ -624,7 +624,7 @@ npm run dev
624624

625625
你現在可以透過 `npm run dev`,並導到 `http://localhost:8080` 看到你的網站。
626626

627-
**備註:** 當我正在測試這個部份時,我明白到當我修改 `index.html` 檔案時,伺服器不能 hot reload。 解決這個問題的方法在 [html-reload](https://github.com/neighborhood999/WebpackTutorial/tree/master/zh-TW/part1/html-reload)。這裡涵蓋了一些 webpack 設定檔選項的有用資訊,我推薦你可以看一下,但是我把它分開了,因為我覺得會因為這個不太重要的原因,這會延長這個教學課程。
627+
**備註:** 當我正在測試這個部份時,我了解到,當我修改 `index.html` 檔案時,伺服器不能 hot reload。解決這個問題的方法在 [html-reload](https://github.com/neighborhood999/WebpackTutorial/tree/master/zh-TW/part1/html-reload)。這裡涵蓋了一些 webpack 設定檔選項的有用資訊,我推薦你可以看一下,但是我把它分開了,因為我覺得會因為這個不太重要的原因,這會延長這個教學課程。
628628

629629
#### 開始撰寫程式
630630

@@ -672,15 +672,15 @@ if (module.hot) {
672672

673673
然後我們就完成了!
674674

675-
**備註:** 你可能已經注意到在你的 css 被使用之前有些 delay,或許事實上你討厭你的 css 在你的 JavaScript 檔案中。我留了另一個範例:[css-extract](https://github.com/neighborhood999/WebpackTutorial/tree/master/zh-TW/part1/css-extract),描述如何將你的 CSS 放在不同的檔案。
675+
**備註:** 你可能已經注意到在你的 css 被使用之前有些 delay,或許事實上你討厭將你的 css 放入到 JavaScript 檔案中。我留了另一個範例:[css-extract](https://github.com/neighborhood999/WebpackTutorial/tree/master/zh-TW/part1/css-extract),描述如何將你的 CSS 放在不同的檔案。
676676

677677
## 結論
678678

679679
我希望這些是有幫助的。
680680

681681
首先 Webpack 最重要的它是一個模組整合工具。它是一個高度模組化的工具,事實上,它並不是被限於在 ES6 和 React。
682682

683-
現在考慮到
683+
現在考慮到
684684

685685
* Part 2 將解決使用 Webpack 透過 Babel 將 ES6 轉換到 ES5。
686686
* Part 3 將解決使用 Webpack 和 React + Babel。

zh-TW/part1/css-extract/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# 番外 - 提取你的 CSS
22

3-
好了,你現在已經完成了,但是在 production 你不想要將你的 CSS 檔案放入到你的 JavaScript。為了這個目的,我們將會使用 [Extract Text Plugin](https://github.com/webpack/extract-text-webpack-plugin)
3+
好了,你現在已經完成了,但是在 production 你不想要將你的 CSS 檔案放入到你的 JavaScript。為了這個目的,我們將會使用 [Extract Text Plugin](https://github.com/webpack/extract-text-webpack-plugin)
44

55
npm install --save-dev extract-text-webpack-plugin
66

@@ -40,11 +40,11 @@ module.exports = {
4040
}
4141
```
4242

43-
這些修改來自[官方 repo](https://github.com/webpack/extract-text-webpack-plugin) README 的描述。如果你想要知道它是怎麼運作的,可以到官方相關文件做更深入的了解。
43+
這些修改來自[官方 repository](https://github.com/webpack/extract-text-webpack-plugin) README 的描述。如果你想要知道它是怎麼運作的,可以到官方相關文件做更深入的了解。
4444

4545
> 它在進入點將每個 require("style.css") chunk 成獨立的 css 輸出檔案。所以你的樣式不會在 JavaScript 內,但是它會被分離到一個 css bundle 檔案(styles.css)。如果你的 stylesheet 很大,在 JavaScript bundle 時,stylesheet bundle 會被平行的載入,可以加快載入的速度。
4646
47-
如果現在你執行 `npm run build`,你的 CSS 會必獨立成一個檔案,有趣的是,它已經被引入到你的 `index.html` 了。
47+
如果現在你執行 `npm run build`,你的 CSS 會被獨立成一個檔案,有趣的是,它已經被引入到你的 `index.html` 了。
4848

4949
```html
5050
<html>

zh-TW/part1/example1/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ body {
6565

6666
你可能會注意到,我在上方的範例做了一些奇怪的事情。我在 JavaScript 檔案中 `require` 一個 css 檔案。
6767

68-
關於 webpack 真的很酷,有趣的事情是,你可以 `require` 更多不只是 JavaScript 的檔案。
68+
關於 webpack 真的很酷,有趣的事情是,你可以 `require` 其他不只是 JavaScript 的檔案。
6969

7070
在 webpack 這些東西我們稱為 loader。使用這些 loader,你可以 `require` 任何 `.css``.png``.html` 檔。
7171

@@ -76,6 +76,6 @@ body {
7676
require('./styles.css')
7777
```
7878

79-
如果我在我的 webpack 設定檔中,inclue [style-loader](https://github.com/webpack/style-loader)[css-loader](https://github.com/webpack/css-loader)這不僅是可以的,還可以實際應用 CSS 到我的網頁。
79+
如果在我的 webpack 設定檔中,inclue [style-loader](https://github.com/webpack/style-loader)[css-loader](https://github.com/webpack/css-loader)這是可行的,還可以實際應用 CSS 到我的網頁。
8080

8181
你可以在 webpack 使用多個 loader,這裡只是一個單一的例子。

zh-TW/part1/example3/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# 範例三 - 介紹 Plugins
22

3-
想像一下,你使用 webpack 將你的檔案 bundle 在一起,然後你意識到 bundle 後的結果是 900KB。這裡有個問題,但是你可以透過 minify 你的 bundle 檔案來做改善。如果需要做到這一點,你需要使用一個我在前面稍早提到的 [UglifyJsPlugin](https://webpack.github.io/docs/list-of-plugins.html#uglifyjsplugin) plugin。
3+
想像一下,你使用 webpack 將你的檔案 bundle 在一起,然後你發現到 bundle 後的結果是 900KB。這裡有個問題,但是你可以透過 minify 你的 bundle 檔案來做改善。如果需要做到這一點,你需要使用一個我在前面稍早提到的 [UglifyJsPlugin](https://webpack.github.io/docs/list-of-plugins.html#uglifyjsplugin) plugin。
44

55
此外,你需要在本機安裝 webpack 才能實際的去使用這個 plugin。
66

zh-TW/part1/example5/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# 範例五 - 加入更多的 Plugin
22

3-
現在我們的網站有基礎的樣式,但我們還需要實際的網站樣式。
3+
現在我們的網站有一些基礎了,但我們還需要實際的網站樣式。
44

55
我們通過 [html-webpack-plugin](https://github.com/ampedandwired/html-webpack-plugin) 來做,它讓我們可以產生一個 HTML 頁面使用現有的。我們將使用一個目前現有的 `index.html`
66

zh-TW/part1/example6/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ module.exports = {
4848

4949
**修改**
5050

51-
1. dev 設定檔省略了優化,當你不斷的 rebuild 時,他們不是必要的。所以不需要 `webpack.optimize` plugins。
51+
1. dev 設定檔省略了優化,當你不斷的 rebuild 時,他們是不必要的。所以不需要 `webpack.optimize` plugins。
5252

5353
2. dev 設定檔需要對 dev server 做必要的設定,你可以到[這裡](https://webpack.github.io/docs/webpack-dev-server.html)了解更多。
5454

@@ -97,7 +97,7 @@ module.exports = {
9797

9898
我也加入一個全新的屬性在 dev 和 prod 的設定檔:
9999

100-
* [devtool](https://webpack.github.io/docs/configuration.html#devtool) - 這是協助 debug 。基本上,當你得到一個錯誤,它會幫助你找到哪裡發生了錯誤,像是 chrome developer console。`source-map``cheap-eval-source-map` 之間的差異從文件說明有點難解釋。我可以肯定的是,`source-map` 是用於 production,`cheap-eval-source-map` 是用於 `development`
100+
* [devtool](https://webpack.github.io/docs/configuration.html#devtool) - 這是協助 debug 的工具。基本上,當你得到一個錯誤,它會幫助你找到哪裡發生了錯誤,像是 chrome developer console。`source-map``cheap-eval-source-map` 之間的差異從文件說明有點難解釋。我可以肯定的是,`source-map` 是用於 `production``cheap-eval-source-map` 是用於 `development`
101101

102102
如果要執行 dev server,我們可以執行:
103103

@@ -133,4 +133,4 @@ npm run dev
133133

134134
你現在可以透過 `npm run dev`,並導到 `http://localhost:8080` 看到你的網站。
135135

136-
**備註:** 當我正在測試這個部份時,我明白到當我修改 `index.html` 檔案時,伺服器不能 hot reload。 解決這個問題的方法在 [html-reload](https://github.com/AriaFallah/WebpackTutorial/tree/master/part1/html-reload)。這裡涵蓋了一些 webpack 設定檔選項的有用資訊,我推薦你可以看一下,但是我把它分開了,因為我覺得會因為這個不太重要的原因,這會延長這個教學
136+
**備註:** 當我正在測試這個部份時,我了解到,當我修改 `index.html` 檔案時,伺服器不能 hot reload。解決這個問題的方法在 [html-reload](https://github.com/AriaFallah/WebpackTutorial/tree/master/part1/html-reload)。這裡涵蓋了一些 webpack 設定檔選項的有用資訊,我推薦你可以看一下,但是我把它分開了,因為我覺得會因為這個不太重要的原因,這會延長這個教學課程

zh-TW/part2/README.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
# Webpack 初學者教學課程 Part 2 - 使用 Webpack 與 Babel :zap:
22

3-
現在我們已經學習了基礎的 webpack 使用方式,為了撰寫 ES6,我們要學會利用 babel 6,因為它是 JavaScript 新的規範。
3+
現在我們已經學習了基礎的 webpack 使用方式,為了撰寫 ES6,我們要學會利用 babel 6,因為 ES6 是 JavaScript 新的規範。
44

5-
如果你曾經撰寫過 ES6,應該就不想再回去寫 ES5 了。如果你還沒有機會撰寫 ES6,很大的原因可能是因為*不了解*開發環境該使用哪些設定選項,因為這些很令人沮喪
5+
如果你曾經撰寫過 ES6,應該就不想再回去寫 ES5 了。如果你還沒有機會撰寫 ES6,很大的原因可能是因為*不了解*開發環境該使用哪些設定選項,因為那些設定很令人沮喪
66

77
我希望這個教學課程可以讓這些過程可以變得更容易。
88

99
## 需求
1010

1111
1. 如果你還沒有準備好,請先閱讀 [part 1][2]
12-
2. 有關 ES6 的概述,[這個](https://github.com/DrkSephy/es6-cheatsheet)是一個很棒的資源。
12+
2. 有關 ES6 的概述,[es6-cheatsheet](https://github.com/DrkSephy/es6-cheatsheet) 是一個很棒的資源。
1313

1414
## 貢獻
1515

@@ -32,7 +32,7 @@
3232

3333
## Babel
3434

35-
如果你想要有更深入的說明,和更細微的設定 babel ,請參考這個[手冊][1]。我在這裡了解了一些基本的設定。
35+
如果你想要有更深入的說明,和更細微的設定 babel,請參考這個[手冊][1]。我在這裡了解了一些基本的設定。
3636

3737
### Babel 是做什麼用的?
3838

@@ -70,7 +70,7 @@ var square = function square(n) {
7070

7171
你只需要指定一個 `presets` 選項,下面是描述的摘錄:
7272

73-
> JavaScript 也有一些提案需要 TC39(背後的 ECMASript 標準為員會)的處理,才能將這些納入到標準中。
73+
> JavaScript 也有一些提案需要 TC39(背後的 ECMAScript 標準為員會)的處理,才能將這些納入到標準中。
7474
7575
> 這個程序被分為 5 個 statge(0-4)。如果提案獲得更多的同意,通過各個 stage,就很容易被接受納入標準中,最後在 stage 4 中被接受納入標準。
7676
@@ -90,7 +90,7 @@ var square = function square(n) {
9090

9191
## Webpack
9292

93-
我們可以使用與[part 1-範例七](https://github.com/neighborhood999/WebpackTutorial/tree/master/zh-TW/part1/example7)相同的設定檔,但是需要加入 ES6 所需要的功能。
93+
我們可以使用與 [part 1-範例七](https://github.com/neighborhood999/WebpackTutorial/tree/master/zh-TW/part1/example7)相同的設定檔,但是需要加入 ES6 所需要的功能。
9494

9595
目前設定檔:
9696

@@ -400,7 +400,7 @@ if (process.env.NODE_ENV !== 'production') {
400400
401401
## 結論
402402
403-
我已經把所有這一切的最終結果放入到[範例 1](https://github.com/neighborhood999/WebpackTutorial/tree/master/part2/example1)。如果你仍然有不理解的地方,可以在 issue 提出你的問題。
403+
我已經把所有這一切的最終結果放入到[範例一](https://github.com/neighborhood999/WebpackTutorial/tree/master/part2/example1)。如果你仍然有不理解的地方,可以在 issue 提出你的問題。
404404
405405
所以現在我們可以輕鬆的撰寫 ES6 程式碼,此外,也讓我們了解到如何撰寫設定檔 :tada:!
406406

0 commit comments

Comments
 (0)