From 5c90688c1a9791fed2b256a0a9bfaa83115d7274 Mon Sep 17 00:00:00 2001 From: Zhicheng Wang Date: Thu, 20 Apr 2017 22:20:51 +0800 Subject: [PATCH] =?UTF-8?q?=E5=BE=AE=E8=B0=83=E9=A3=8E=E6=A0=BC=E4=B9=8B?= =?UTF-8?q?=E5=8D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- public/docs/ts/latest/guide/style-guide.jade | 33 +++++++++++--------- 1 file changed, 18 insertions(+), 15 deletions(-) diff --git a/public/docs/ts/latest/guide/style-guide.jade b/public/docs/ts/latest/guide/style-guide.jade index 401f0affdb..d3b814fd16 100644 --- a/public/docs/ts/latest/guide/style-guide.jade +++ b/public/docs/ts/latest/guide/style-guide.jade @@ -131,6 +131,8 @@ a#single-responsibility single responsibility principle (SRP) to all components, services, and other symbols. This helps make the app cleaner, easier to read and maintain, and more testable. + + 对所有的组件、服务等等应用单一职责原则 (SRP) ### Rule of One @@ -327,7 +329,10 @@ a(href="#toc").to-top 回到顶部 .l-main-section :marked - ### Separate File names with dots and dashes### 使用点和横杠来分隔文件名 + ### Separate File names with dots and dashes + + ### 使用点和横杠来分隔文件名 + #### Style 02-02 #### 风格 02-02 @@ -1397,7 +1402,7 @@ a(href="#toc").to-top 回到顶部 Use the naming conventions for files in this guide. 所有内容都遵循每个文件一个特性的原则。每个组件、服务和管道都在自己的文件里。 - 所有第三方程序包保存到其它目录里，不是`src`目录。 + 所有第三方程序包保存到其它目录里，而不是`src`目录。 你不会修改它们，所以不希望它们弄乱我们的应用程序。 使用本指南介绍的文件命名约定。 @@ -1409,8 +1414,6 @@ a(href="#toc").to-top 回到顶部 :marked ### _LIFT_ - ### _LIFT_ - #### Style 04-01 #### 风格 04-01 @@ -1653,13 +1656,13 @@ a(href="#toc").to-top 回到顶部 :marked **Why?** Helps keep the app structure small and easy to maintain in the early stages, while being easy to evolve as the app grows. - **为何？**在早期阶段能够帮助保持应用的结构小巧且易于维护，这样当应用增长时就容易进化了。 + **为何？** 在早期阶段能够帮助保持应用的结构小巧且易于维护，这样当应用增长时就容易进化了。 .s-why-last :marked **Why?** Components often have four files (e.g. `*.html`, `*.css`, `*.ts`, and `*.spec.ts`) and can clutter a folder quickly. - **为何?**组件通常有四个文件 (`*.html`、 `*.css`、 `*.ts` 和 `*.spec.ts`)，它们很容易把一个目录弄乱。 + **为何?** 组件通常有四个文件 (`*.html`、 `*.css`、 `*.ts` 和 `*.spec.ts`)，它们很容易把一个目录弄乱。 a(id='file-tree') :marked @@ -1950,7 +1953,7 @@ a(href="#toc").to-top 回到顶部 **Do** declare components, directives, and pipes in a shared module when those items will be re-used and referenced by the components declared in other feature modules. - **坚持**在共享模块中声明那些可能被那些特性模块引用的可复用组件、指令和管道。 + **坚持**在共享模块中声明那些可能被特性模块引用的可复用组件、指令和管道。 .s-rule.consider :marked @@ -2004,7 +2007,7 @@ a(href="#toc").to-top 回到顶部 :marked **Avoid** specifying app-wide singleton providers in a `SharedModule`. Intentional singletons are OK. Take care. - **避免**在`SharedModule`中指定应用级的单例服务提供商。但如果是故意设计的单例也可以，不过还是要小心。 + **避免**在`SharedModule`中指定应用级的单例服务提供商。如果是刻意要得到多个服务单例也行，不过还是要小心。 .s-why :marked @@ -2094,7 +2097,7 @@ a(href="#toc").to-top 回到顶部 :marked **Do** put a singleton service whose instance will be shared throughout the application in the `CoreModule` (e.g. `ExceptionService` and `LoggerService`). - **坚持**把一个要共享给整个应用的单例服务放进`CoreModule`中（例如`ExceptionService`和`LoggerService`）。 + **坚持**把要共享给整个应用的单例服务放进`CoreModule`中（例如`ExceptionService`和`LoggerService`）。 .s-rule.do :marked @@ -2112,7 +2115,7 @@ a(href="#toc").to-top 回到顶部 :marked **Why?** `CoreModule` will contain singleton services. When a lazy loaded module imports these, it will get a new instance and not the intended app-wide singleton. - **为何？**`CoreModule`将包含一些单例服务。而如果惰性加载模块导入这些服务，它就会得到一个新实例，而不是所期望的全应用级单例。 + **为何？**`CoreModule`将包含一些单例服务。而如果是由惰性加载模块来导入这些服务，它就会得到一个新实例，而不是所期望的全应用级单例。 .s-rule.do :marked @@ -2246,7 +2249,7 @@ a(href="#toc").to-top 回到顶部 Only the root `AppModule` should import the `CoreModule`. - 应该只有`AppModule`才能导入`CoreModule`。 + 应该只有`AppModule`才允许导入`CoreModule`。 .s-rule.do :marked @@ -2343,7 +2346,7 @@ a(href="#toc").to-top 回到顶部 :marked ## Components - ##组件 + ## 组件 ### Component selector nams @@ -2392,7 +2395,7 @@ a(href="#toc").to-top 回到顶部 :marked **Do** give components an _element_ selector, as opposed to _attribute_ or _class_ selectors. - **坚持**通过选择器把组件定义为元素。 + **坚持**给组建一个*元素*选择器，而不是*属性*或*类*选择器。 .s-why :marked @@ -2456,7 +2459,7 @@ a(href="#toc").to-top 回到顶部 :marked **Do** specify _component-relative_ URLs, prefixed with `./`. - **坚持**指定*相对于模块的* URL ，给它加上`./`前缀，并且往组件元数据中添加 `moduleId: module.id`。 + **坚持**指定*相对于模块的* URL ，给它加上`./`前缀。 .s-why :marked @@ -3052,7 +3055,7 @@ a(href="#toc").to-top 回到顶部 :marked **Do** refactor logic for making data operations and interacting with data to a service. - **坚持**把数据操作和互动重构到服务里。 + **坚持**把数据操作和与数据交互的逻辑重构到服务里。 .s-rule.do :marked