Skip to content

Commit a51731c

Browse files
committed
rephrase Project structure Chinese
1 parent bbc4078 commit a51731c

File tree

5 files changed

+27
-27
lines changed

5 files changed

+27
-27
lines changed

docs/cn/file-tree.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
### 在开发过程中
44

5-
**注意**: 某些文件或文件夹可能会根据 `vue-cli` 脚手架中选择的设置而有所不同
5+
**注意**: 某些文件或文件夹可能会根据在 `vue-cli` 脚手架中所选设置的不同而有所不同
66

77
```
88
my-project

docs/cn/main-process.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
11
# 主进程
22

3-
> 在 Electron 中,运行 package.json 主脚本的过程称为主进程。在主进程中运行的脚本可以通过创建网页来显示其图形化界面。
3+
> 在 Electron 中,运行 package.json 主脚本的过程称为主进程 (main process)。在主进程中运行的脚本可以通过创建网页来显示其图形化界面。
44
5-
**来自** [**Electron 文档**](http://electron.atom.io/docs/tutorial/quick-start/#main-process)
5+
**摘自** [**Electron 文档**](http://electron.atom.io/docs/tutorial/quick-start/#main-process)
66

77
---
88

9-
由于 `main` 进程本质上是一个完整的 node 环境,所以除了以下两个文件之外,没有初始的项目结构
9+
由于 `main` 进程本质上是一个完整的 node 环境,所以除了以下两个文件之外,并没有什么初始的项目结构
1010

1111
#### `src/main/index.js`
1212

13-
这个文件是你应用程序的主文件,`electron` 也从这里启动。它也被用作 `webpack` 的产品构建的入口文件。所有的 `main` 进程工作都应该从这里开始。
13+
这个文件是你应用程序的主文件,`electron` 也从这里启动。它也被用作 `webpack` 产品构建的入口文件。所有的 `main` 进程工作都应该从这里开始。
1414

1515
#### `app/src/main/index.dev.js`
1616

17-
这个文件是专门用于开发阶段,因为它会安装 `electron-debug` `vue-devtools`。一般不需要修改此文件,但它可以用于扩展你开发的需求。
17+
这个文件专门用于开发阶段,因为它会安装 `electron-debug` `vue-devtools`。一般不需要修改此文件,但它可以用于扩展你开发的需求。
1818

1919
## 关于 `__dirname``__filename` 的使用
2020

21-
由于 `main` 进程是使用 `webpack` 绑定的,所以使用 `__dirname``__filename` **将不会** 在产品阶段提供一个预期的值。参考 [**文件树**](/file-tree.md)你会注意到,在产品阶段,`main.js` 被放在了 `dist/electron` 文件夹里面。应根据此点相应地使用 `__dirname``__filename`
21+
由于 `main` 进程是使用 `webpack` 来绑定的,所以使用 `__dirname``__filename` **将不会** 在产品阶段给你提供一个预期的值。若参考 [**文件树**](/file-tree.md) 你会注意到,在产品阶段,`main.js` 被放在了 `dist/electron` 文件夹里面。应根据此点相应地使用 `__dirname``__filename`
2222

23-
**如果您需要 `static/` 资源目录的路径,请务必阅读** [**使用静态资产**](/using-static-assets.md) **学习了解非常方便的 `__static` 变量。**
23+
**如果你需要 `static/` 资源目录的路径,请务必阅读** [**使用静态资源**](/using-static-assets.md) **学习了解非常方便的 `__static` 变量。**
2424

2525

2626
```

docs/cn/project_structure.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,23 @@
11
# 项目结构
22

3-
当涉及制作 electron 应用程序时,项目结构会有些不同。如果你以前使用过官方的设置 [`vuejs-templates/webpack`](https://github.com/vuejs-templates/webpac),那么这个结构应该感觉起来很熟悉。本文档在此章节将尝试解释样板代码的工作原理以及应用程序在构建中的区别
3+
当涉及制作 electron 应用程序的问题时,项目结构会有些不同。如果你以前使用过官方的 [`vuejs-templates/webpack`](https://github.com/vuejs-templates/webpac) 设置,那么你对这个结构应该很熟悉。本文档在此章节将尝试解释样板代码的工作原理以及应用程序在构建中的一些区别
44

55
### 单一的 `package.json` 设置
66

7-
就在不久之前,两个 `package.json` 的设置是必需的,但是由于 [@electron-userland](https://github.com/electron-userland) 的努力,[`electron-packager`](https://github.com/electron-userland/electron-packager)[`electron-builder`](https://github.com/electron-userland/electron-builder) 现在完全支持单一的 `package.json` 设置。
7+
就在不久之前,两个 `package.json` 的设置是必需的,但是,感谢 [@electron-userland](https://github.com/electron-userland) 的努力,[`electron-packager`](https://github.com/electron-userland/electron-packager)[`electron-builder`](https://github.com/electron-userland/electron-builder) 现在完全支持单一的 `package.json` 设置。
88

99
#### `dependencies`
1010

11-
这些依赖项 **将会被** 包含在你的最终产品的应用程序中。所以如果你的应用程序需要某个模块才能运行,那么请在此安装!
11+
这些依赖项 **将会被** 包含在你最终产品的应用程序中。所以,如果你的应用程序需要某个模块才能运行,那么请在此安装!
1212

1313
#### `devDependencies`
1414

15-
这些依赖项 **不会被** 包含在你的最终产品的应用程序中。在这里,你可以安装专门用于开发的模块,如构建脚本、`webpack` 加载器等等。
15+
这些依赖项 **不会被** 包含在你最终产品的应用程序中。在这里,你可以安装专门用于开发的模块,如构建脚本、`webpack` 加载器等等。
1616

1717
#### 安装原生 NPM 模块
1818

19-
我们需要确保我们本地的 npm 模块是针对 electron 构建的。为了做到这一点,我们可以使用 [`electron-rebuild`](https://github.com/electron/electron-rebuild)但是为了使事情更简单,强烈建议使用 [`electron-builder`](https://github.com/electron-userland/electron-builder) 作为你的构建工具,因为它会为你处理很多任务。
19+
我们需要确保我们本地的 npm 模块是针对 electron 来构建的。为了做到这一点,我们可以使用 [`electron-rebuild`](https://github.com/electron/electron-rebuild)但是为了使事情变得更简单,我们强烈建议使用 [`electron-builder`](https://github.com/electron-userland/electron-builder) 作为你的构建工具,因为它会为你处理很多任务。
2020

2121
### 关于 `main` 进程
2222

23-
在开发过程中,你可能会注意到 `src/main/index.dev.js`。该文件专门用于开发以及安装开发工具。该文件原则上不应该被修改,但是可以用来扩展你的开发需求。在构建的过程中,`webpack` 将介入其中并创建一个以 `src/main/index.js` 作为入口文件的捆绑
23+
在开发过程中,你可能会注意到 `src/main/index.dev.js`。该文件专门用于开发以及安装开发工具。原则上,该文件不应该被修改,但是可以被用来扩展你的开发需求。在构建的过程中,`webpack` 将介入其中并创建一个的捆绑,以 `src/main/index.js` 作为该捆绑的入口文件

docs/cn/renderer-process.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
# 渲染器进程
22

3-
> 由于 Electron 使用 Chromium 显示网页,Chromium 的多进程架构也被使用。Electron 中的每个网页都在自己的进程中运行,称为渲染器进程。
3+
> 由于 Electron 使用 Chromium 显示网页,那么,Chromium 的多进程架构也被使用。Electron 中的每个网页都在自己的进程中运行,称为渲染器进程 (renderer process)
44
>
55
> 在正常的浏览器中,网页通常运行在沙盒封装化的环境中,并且不允许访问本机资源。然而,Electron 用户有权在网页中使用 Node.js 的 API,从而允许较低级别的操作系统交互。
66
7-
**来自** [**Electron 文档**](http://electron.atom.io/docs/tutorial/quick-start/#renderer-process)
7+
**选自** [**Electron 文档**](http://electron.atom.io/docs/tutorial/quick-start/#renderer-process)
88

99
---
1010

1111
## 关于 `vue``vuex`
1212

1313
### vue 组件
1414

15-
如果你不熟悉 Vue 组件,请阅读 [此处](http://vuejs.org/v2/guide/single-file-components.html)组件的使用使我们的大型复杂应用程序更加有组织化。每个组件都有能力封装自己的 CSS、模板 和 JavaScript 功能
15+
如果你不熟悉 Vue 组件,请阅读 [此处](http://vuejs.org/v2/guide/single-file-components.html)组件的使用使我们大型、复杂的应用程序更加有组织化。每个组件都有能力封装自己的 CSS、模板 和 JavaScript 的功能
1616

17-
组件存储在 `src/renderer/components` 。创建子组件时,一个常用的的组织化实践是将它们放置在一个使用其父组件名称的新文件夹中。在协调不同的路由时,这一点特别有用。
17+
组件存放在 `src/renderer/components` 。创建子组件时,一个常用的组织化实践是将它们放置在一个使用其父组件名称的新文件夹中。在协调不同的路由时,这一点特别有用。
1818

1919
```
2020
src/renderer/components
@@ -26,7 +26,7 @@ src/renderer/components
2626

2727
### vue 路由
2828

29-
有关 `vue-router` 的更多信息请点击 [这里](https://github.com/vuejs/vue-router)。 简而言之,我们鼓励使用 `vue-router`,因为创建 单页应用程序 (Single Page Application) 在制作 electron 应用程序的时候更加实用。你真的想管理一堆 BrowserWindows,然后在之间传达信息吗?恐怕不会。
29+
有关 `vue-router` 的更多信息请点击 [这里](https://github.com/vuejs/vue-router)。 简而言之,我们鼓励使用 `vue-router`,因为创建 单页应用程序 (Single Page Application) 在制作 electron 程序的时候更加实用。你真的想管理一堆 BrowserWindows,然后在其之间传达信息吗?恐怕不会。
3030

3131
路由被保存在 `src/renderer/router/index.js` 里并定义如下...
3232

@@ -42,12 +42,12 @@ src/renderer/components
4242

4343
##### 注意
4444

45-
在使用 `vue-router` 时,不要使用 [**HTML5 历史模式**](http://router.vuejs.org/en/essentials/history-mode.html)。 此模式严格用于通过 `http` 协议提供文件,并且不能正常使用 `file` 协议,electron 在产品构建中提供文件。 默认的 `hash` 模式正是我们所需要的。
45+
在使用 `vue-router` 时,不要使用 [**HTML5 历史模式**](http://router.vuejs.org/en/essentials/history-mode.html)。 此模式严格用于通过 `http` 协议提供文件,并且不能正常使用 `file` 协议,但是 electron 在产品构建中使用此协议提供文件。默认的 `hash` 模式正是我们所需要的。
4646

4747
### vuex 模块
4848

4949
描述 `vuex` 并不是简单的事情,所以请阅读 [这里](http://vuex.vuejs.org/en/intro.html),以便更好地了解它试图解决的问题及其工作原理。
5050

5151
electron-vue 利用 `vuex` 的模块结构创建多个数据存储,并保存在 `src/renderer/store/modules` 中。
5252

53-
拥有多个数据存储对于组织化来说可能很好,但必须导入每一个数据也可能令人厌烦。但是不要担心,因为 `src/renderer/store/modules/index.js` 对我们来说是麻烦的工作!这个小脚本让 `src/renderer/store/index.js` 以一次性的方式导入我们所有的模块。如果所有这些都没有,只要知道你可以轻松地复制给定的 `Counter.js` 模块,它将以 "神奇" 的方式被加载进来。
53+
拥有多个数据存储对于组织化来说可能很好,但你必须导入每一个数据,这也可能令人厌烦。但是不要担心,因为 `src/renderer/store/modules/index.js` 对我们来说是麻烦的工作!这个简单的脚本让 `src/renderer/store/index.js` 一次性导入我们所有的模块。如果所有这些都没有,只要知道你可以轻松地复制给定的 `Counter.js` 模块,它将以 "神奇" 的方式被加载进来。

docs/cn/webpack-configurations.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
# Webpack 配置
22

3-
electron-vue 包含三个单独的、位于 `.electron-vue/` 目录中的 webpack 配置文件。除了可选使用 `web` 输出以外,`main``renderer` 在安装过程中都是相似的。两者都使用 `babel-preset-env` 来针对 `node@7` 的功能特性、使用`babili`、并把所有的模块都视为 `externals`
3+
electron-vue 包含三个单独的、位于 `.electron-vue/` 目录中的 webpack 配置文件。除了可选de的使用 `web` 输出以外,`main``renderer` 在安装过程中都是相似的。两者都使用 `babel-preset-env` 来针对 `node@7` 的功能特性、使用`babili`、并把所有的模块都视为 `externals`
44

55
### `.electron-vue/webpack.main.config.js`
66

7-
针对 electron 的 `main` 进程。这种配置是相简陋的,但确实包括一些常见的 `webpack` 做法。
7+
针对 electron 的 `main` 进程。这种配置是相当简单的,但确实包括一些常见的 `webpack` 做法。
88

99
### `.electron-vue/webpack.renderer.config.js`
1010

11-
针对 electron 的 `renderer` 进程。此配置操控你的 Vue 应用程序,因此它包含 `vue-loader` 和许多其他可在官方 `vuejs-templates/webpack` 样板中找到的配置。
11+
针对 electron 的 `renderer` 进程。此配置用来处理你的 Vue 应用程序,因此它包含 `vue-loader` 和许多其他可在官方 `vuejs-templates/webpack` 样板中找到的配置。
1212

13-
##### White-listing Externals
13+
##### 白名单里的外部组件
1414

15-
关于这个配置的一个重要的事情是,你可以将特定的模块列入白名单,而不是把它视为 webpack 的 `externals`。并没有很多情况需要这个功能,但是对于提供原始的 `*.vue` 组件的 Vue UI 库的情况,他们需要被列入白名单,所以 `vue-loader` 能够编译它们。另一个使用情况是使用 webpack 的 `alias`,例如设置 `vue` 来导入完整 编译+运行环境 的构建。因此,`vue` 已经在白名单中了。
15+
一个关于此配置的重要的事情是,你可以将特定的模块列入白名单,而不是把它视为 webpack 的 `externals`。并没有很多情况需要这个功能,但在某些情况下,对于提供原始的 `*.vue` 组件的 Vue UI ,他们需要被列入白名单,以至于 `vue-loader` 能够编译它们。另一个使用情况是使用 webpack 的 `alias`,例如设置 `vue` 来导入完整的 编译+运行环境 的构建。因此,`vue` 已经在白名单中了。
1616

1717
### `.electron-vue/webpack.web.config.js`
1818

19-
针对为浏览器构建你的 `renderer` 进程源代码。如果你需要把代码发布到网上,则此配置是其强大的起步基础**electron-vue 不支持更多其他的 Web 输出。** 与 Web 输出相关的 Issues 有很大的可能被推迟或关闭
19+
针对为浏览器构建你的 `renderer` 进程的源代码。如果你需要把代码发布到网上,此配置则是其强大的起步基础**electron-vue 不支持更多其他的 Web 输出。** 与 Web 输出相关的 Issues 很可能会被推迟或关闭

0 commit comments

Comments
 (0)