Merge remote-tracking branch 'upstream/master'

赵可 · 赵可 · commit 57a33496ca6d · 2014-12-21T15:25:46.000+08:00
diff --git a/README.md b/README.md
@@ -367,11 +367,20 @@ While this guide explains the *what*, *why* and *how*, I find it helpful to see
 
   Note: When creating watches in a controller using `controller as`, you can watch the `vm.*` member using the following syntax. (Create watches with caution as they add more load to the digest cycle.)
 
+  ```html
+  <input ng-model="vm.title"/>
+  ```
+
   ```javascript
-  $scope.$watch('vm.title', function(current, original) {
-      $log.info('vm.title was %s', original);
-      $log.info('vm.title is now %s', current);
-  });
+  function SomeController($scope, $log) {
+      var vm = this;
+      vm.title = 'Some Title';
+    
+      $scope.$watch('vm.title', function(current, original) {
+          $log.info('vm.title was %s', original);
+          $log.info('vm.title is now %s', current);
+      });
+  }
   ```
 
 ### Bindable Members Up Top
@@ -539,7 +548,7 @@ While this guide explains the *what*, *why* and *how*, I find it helpful to see
   ```
 
 ### Defer Controller Logic
-###### [Style [Y035](#style-y036)]
+###### [Style [Y035](#style-y035)]
 
   - Defer logic in a controller by delegating to services and factories.
 
@@ -550,31 +559,49 @@ While this guide explains the *what*, *why* and *how*, I find it helpful to see
     *Why?*: Removes dependencies and hides implementation details from the controller.
 
   ```javascript
+
   /* avoid */
-  function Order($http, $q) {
+  function Order($http, $q, config, userInfo) {
       var vm = this;
       vm.checkCredit = checkCredit;
+      vm.isCreditOk;
       vm.total = 0;
 
-      function checkCredit() { 
-          var orderTotal = vm.total;
-          return $http.get('api/creditcheck').then(function(data) {
-              var remaining = data.remaining;
-              return $q.when(!!(remaining > orderTotal));
-          });
+      function checkCredit() {
+		  var settings = {};
+          // Get the credit service base URL from config
+          // Set credit service required headers
+          // Prepare URL query string or data object with request data
+          // Add user-identifying info so service gets the right credit limit for this user.
+          // Use JSONP for this browser if it doesn't support CORS
+          return $http.get(settings)
+              .then(function(data) {
+	             // Unpack JSON data in the response object
+                 // to find maxRemainingAmount
+                 vm.isCreditOk = vm.total <= maxRemainingAmount
+              })
+              .catch(function(error) {
+                 // Interpret error
+                 // Cope w/ timeout? retry? try alternate service?
+                 // Re-reject with appropriate error for a user to see
+              });
       };
   }
   ```
 
   ```javascript
+
   /* recommended */
   function Order(creditService) {
       var vm = this;
       vm.checkCredit = checkCredit;
+      vm.isCreditOk;
       vm.total = 0;
 
       function checkCredit() { 
-         return creditService.check();
+         return creditService.isOrderTotalOk(vm.total)
+			.then(function(isOk) { vm.isCreditOk = isOk; })
+            .catch(showServiceError);
       };
   }
   ```
diff --git a/i18n/PT-BR.md b/i18n/PT-BR.md
@@ -1535,13 +1535,13 @@ ou *Minificação e Anotação*
     > Nota: Apartir do AngularJS 1.3 use o parâmetro `ngStrictDi` da diretiva  [`ngApp`](https://docs.angularjs.org/api/ng/directive/ngApp). Quando presente, o injetor será criado no modo "strict-di" fazendo com que a aplicação falhe ao tentar invocar funções que não usem anotação explícita de função (elas podem não ser seguras para minificação). Informação de debug será logada no console para ajudar a rastrear o código ofensivo.
     `<body ng-app="APP" ng-strict-di>`
 
-### Use Gulp or Grunt for ng-annotate
+### Utilize Gulp ou Grunt para o ng-annotate
 
-  - Use [gulp-ng-annotate](https://www.npmjs.org/package/gulp-ng-annotate) or [grunt-ng-annotate](https://www.npmjs.org/package/grunt-ng-annotate) in an automated build task. Inject `/* @ngInject */` prior to any function that has dependencies.
+  - Utilize [gulp-ng-annotate](https://www.npmjs.org/package/gulp-ng-annotate) ou [grunt-ng-annotate](https://www.npmjs.org/package/grunt-ng-annotate) para tarefas de build automatizadas. Injete `/* @ngInject */` antes de qualquer função que tenha dependências.
   
-    *Why?*: ng-annotate will catch most dependencies, but it sometimes requires hints using the `/* @ngInject */` syntax.
+    *Por que?*: ng-annotate vai capturar todas as dependências, mas as vezes requer dicas utilizando a sintaxe `/* @ngInject */` .
 
-    The following code is an example of a gulp task using ngAnnotate
+    O código abaixo é um exemplo de uma task Gulp utilizando ngAnnotate
 
     ```javascript
     gulp.task('js', ['jshint'], function() {
@@ -1570,11 +1570,11 @@ ou *Minificação e Anotação*
 
 ### decorators
 
-  - Use a [decorator](https://docs.angularjs.org/api/auto/service/$provide#decorator), at config time using the [`$provide`](https://docs.angularjs.org/api/auto/service/$provide) service, on the [`$exceptionHandler`](https://docs.angularjs.org/api/ng/service/$exceptionHandler) service to perform custom actions when exceptions occur.
+  - Utilize um [decorator](https://docs.angularjs.org/api/auto/service/$provide#decorator), no seu configutilizando o serviço [`$provide`](https://docs.angularjs.org/api/auto/service/$provide) , no serviço [`$exceptionHandler`](https://docs.angularjs.org/api/ng/service/$exceptionHandler) para realizar ações customizadas quando um erro ocorrer.
   
-    *Why?*: Provides a consistent way to handle uncaught AngularJS exceptions for development-time or run-time.
+    *Por que?*: Fornece um caminho consistente para manipular erros não tratados pelo AngularJS em tempo de desenvolvimento ou run-time.
 
-    Note: Another option is to override the service instead of using a decorator. This is a fine option, but if you want to keep the default behavior and extend it a decorator is recommended.
+    Nota: Outra opção é sobrescrever o serviço ao invés de utilizar um decorator. Esta é uma boa opção, mas se você quer manter o comportamento padrão e estender o decorator é recomendado.
 
   	```javascript
     /* recommended */
@@ -1610,9 +1610,9 @@ ou *Minificação e Anotação*
 
 ### Exception Catchers
 
-  - Create a factory that exposes an interface to catch and gracefully handle exceptions.
+  - Criar um factory que expôe uma interface para capturar excessões.
 
-    *Why?*: Provides a consistent way to catch exceptions that may be thrown in your code (e.g. during XHR calls or promise failures).
+    *Por que?*: Provides a consistent way to catch exceptions that may be thrown in your code (e.g. during XHR calls or promise failures).
 
     Note: The exception catcher is good for catching and reacting to specific exceptions from calls that you know may throw one. For example, when making an XHR call to retrieve data from a remote web service and you want to catch any exceptions from that service and react uniquely.
 
diff --git a/i18n/it-IT.md b/i18n/it-IT.md
@@ -370,11 +370,20 @@ Nonostante questa guida spieghi i *cosa*, *come* e *perché*, trovo che sia di a
    
   Nota: Quando di creano watch in un controller usando `controller as`, puoi fare il watch del membro `vm.*` usando la seguente sintassi. (Crea watch con cautela poiché aggiungono carico al ciclo di digest.)
 
+  ```html
+   <input ng-model="vm.title"/>
+  ```
+ 
   ```javascript
-  $scope.$watch('vm.title', function(current, original) {
-      $log.info('vm.title was %s', original);
-      $log.info('vm.title is now %s', current);
-  });
+  function SomeController($scope, $log) {
+      var vm = this;
+      vm.title = 'Some Title';
+    
+      $scope.$watch('vm.title', function(current, original) {
+          $log.info('vm.title was %s', original);
+          $log.info('vm.title is now %s', current);
+      });
+  }
   ```
 
 ### Membri che possono fare il bind in cima
@@ -553,31 +562,49 @@ Nonostante questa guida spieghi i *cosa*, *come* e *perché*, trovo che sia di a
     *Perché?*: Rimuove dipendenze e nasconde dettagli di implementazione dal controller.
 
   ```javascript
+
   /* evitare */
-  function Order($http, $q) {
+  function Order($http, $q, config, userInfo) {
       var vm = this;
       vm.checkCredit = checkCredit;
+      vm.isCreditOk;
       vm.total = 0;
 
-      function checkCredit() { 
-          var orderTotal = vm.total;
-          return $http.get('api/creditcheck').then(function(data) {
-              var remaining = data.remaining;
-              return $q.when(!!(remaining > orderTotal));
-          });
+      function checkCredit() {
+		  var settings = {};
+          // Prendi la URL di base per il servizio del credito
+          // Setta le intestazioni necessarie per il servizio del credito
+          // Prepara le URL della query string o i data object con i dati richiesti
+          // Aggiungi le informazioni sull'identificazione dell'utente così il servizio prende i dati sul limite del credito corretto
+          // Usare JSONP per questo browser se CORS non è supportato
+          return $http.get(settings)
+              .then(function(data) {
+	             // Unpack JSON data in the response object
+                 // to find maxRemainingAmount
+                 vm.isCreditOk = vm.total <= maxRemainingAmount
+              })
+              .catch(function(error) {
+                 // Errore dell'interprete
+                 // Affronta timeout? nuovo tentativo? provare servizi alternativi?
+                 // Rilancia con l'errore appropriato per essere letto dall'utente
+              });
       };
   }
   ```
 
   ```javascript
+
   /* consigliato */
   function Order(creditService) {
       var vm = this;
       vm.checkCredit = checkCredit;
+      vm.isCreditOk;
       vm.total = 0;
 
       function checkCredit() { 
-         return creditService.check();
+         return creditService.isOrderTotalOk(vm.total)
+			.then(function(isOk) { vm.isCreditOk = isOk; })
+            .catch(showServiceError);
       };
   }
   ```
@@ -2506,7 +2533,7 @@ Usa file template o snippet che ti aiutino a seguire stili e schemi consistentem
 
   - Snippet di AngularJS che seguono questi stili e linee guida. 
 
-    - Scarica gli [snippet di Angular per Sublime](assets/sublime-angular-snippets.zip) 
+    - Scarica gli [snippet di Angular per Sublime](assets/sublime-angular-snippets.zip?raw=true) 
     - Mettili nella tua cartella Packages
     - Riavvia Sublime 
     - In un file JavaScript digita questi comandi seguiti da `TAB`
@@ -2532,7 +2559,7 @@ Usa file template o snippet che ti aiutino a seguire stili e schemi consistentem
 
   - Snippet di Angular JS e file di template che seguono queste linee guida. Le puoi importare dentro i tuoi settaggi di WebStorm:
 
-    - Scarica i [file dei template e gli snippet diAngularJS per WebStorm](assets/webstorm-angular-file-template.settings.jar) 
+    - Scarica i [file dei template e gli snippet diAngularJS per WebStorm](assets/webstorm-angular-file-template.settings.jar?raw=true) 
     - Apri WebStorm e vai al menù `File`
     - Scegli la voce di menù `Import Settings`
     - Seleziona il file e clicca `OK`
diff --git a/i18n/mk-MK.md b/i18n/mk-MK.md
@@ -68,8 +68,8 @@
   /* избегнувајте */
   angular
     	.module('app', ['ngRoute'])
-    	.controller('someController' , someController)
-    	.factory('someFactory' , someFactory);
+    	.controller('someController', someController)
+    	.factory('someFactory', someFactory);
   	
   function SomeController() { }
 
@@ -92,7 +92,7 @@
   // someController.js
   angular
     	.module('app')
-    	.controller('SomeController' , SomeController);
+    	.controller('SomeController', SomeController);
 
   function SomeController() { }
   ```
@@ -103,7 +103,7 @@
   // someFactory.js
   angular
     	.module('app')
-    	.factory('someFactory' , someFactory);
+    	.factory('someFactory', someFactory);
   	
   function someFactory() { }
   ```
@@ -221,7 +221,7 @@
   ```javascript
   /* избегнувајте */
   var app = angular.module('app');
-  app.controller('SomeController' , SomeController);
+  app.controller('SomeController', SomeController);
   
   function SomeController() { }
   ```
@@ -230,7 +230,7 @@
   /* препорачано */
   angular
       .module('app')
-      .controller('SomeController' , SomeController);
+      .controller('SomeController', SomeController);
   
   function SomeController() { }
   ```
@@ -533,7 +533,7 @@
   ```
 
 ### Одлагање Логика во Контролерот
-###### [Style [Y035](#style-Y036)]
+###### [Style [Y035](#style-Y035)]
   - Одлагајте логика на во контролерот со делегирање до сервиси и фабрики.
 
     *Зошто?*: Логиката може да биде повторно искористена кога е во сервис, од повеќе контролери и изложена преку функција.
@@ -544,18 +544,31 @@
 
   ```javascript
   /* избегнувајте */
-  function Order($http, $q) {
+  function Order($http, $q, config, userInfo) {
       var vm = this;
       vm.checkCredit = checkCredit;
+      vm.isCreditOk;
       vm.total = 0;
 
-      function checkCredit() { 
-          var orderTotal = vm.total;
-          return $http.get('api/creditcheck').then(function(data) {
-              var remaining = data.remaining;
-              return $q.when(!!(remaining > orderTotal));
-          });
-      };
+      function checkCredit() {
+        var settings = {};
+        // Земете го URL-то на сервисот за кредит од config датотеката
+        // Поставете ги потребните заглавија
+        // Спремете го потребното URL барање или потребниот податочен објект за побарување на податоците
+        // Додадете инфо за идентификација на корисникот за сервисот да добие точниот лимит на кредитот за овој корисник
+        // Употребете JSONP за овој пребарувач доколку не подржува CORS
+        return $http.get(settings)
+            .then(function(data) {
+               // Отпакувајте го JSON податокот во одговорот
+               // за да го најдете maxRemainingAmount
+               vm.isCreditOk = vm.total <= maxRemainingAmount
+            })
+            .catch(function(error) {
+               // Интерпретирајте ја грешката
+               // Спремете се со истекување на време? пробување пак? друг сервис?
+               // Повторно одбиете за корисникот да ја забележи соодветната порака 
+            });
+    };
   }
   ```
 
@@ -564,10 +577,14 @@
   function Order(creditService) {
       var vm = this;
       vm.checkCredit = checkCredit;
+      vm.isCreditOk;
       vm.total = 0;
 
       function checkCredit() { 
-         return creditService.check();
+         return creditService.isOrderTotalOk(vm.total)
+          .then(function(isOk) { vm.isCreditOk = isOk; })
+          .catch(showServiceError);
+    };
       };
   }
   ```
@@ -2167,11 +2184,11 @@
         //TODO
     });
 
-    it('should have 10 Avengers', function() {}
+    it('should have 10 Avengers', function() {
         //TODO (mock data?)
     });
 
-    it('should return Avengers via XHR', function() {}
+    it('should return Avengers via XHR', function() {
         //TODO ($httpBackend?)
     });
 
@@ -2422,7 +2439,7 @@
 ###### [Style [Y250](#style-Y250)]
   - AngularJS кратки кодови кои ги следат овие водичи и стилови на код. 
 
-    - Симнете ги [Sublime Angular кратки кодови](assets/sublime-angular-snippets.zip) 
+    - Симнете ги [Sublime Angular кратки кодови](assets/sublime-angular-snippets.zip?raw=true) 
     - Поставете ги во вашата Packages папка
     - Рестартирајте го Sublime 
     - Во JavaScript датотека напишете ја следната команда и потоа кликнете на `TAB`
@@ -2446,7 +2463,7 @@
 ###### [Style [Y252](#style-Y252)]
   - AngularJS кратки кодови и датотечни шаблони кои ги следат овие стилови и водичи на код. Можете да ги внесете во вашите WebStorm подесувања:
 
-    - Симнете ги [WebStorm AngularJS датотечни шаблони и кратки кодови](assets/webstorm-angular-file-template.settings.jar) 
+    - Симнете ги [WebStorm AngularJS датотечни шаблони и кратки кодови](assets/webstorm-angular-file-template.settings.jar?raw=true) 
     - Отворете го WebStorm и одберете го `File` менито
     - Одберете го `Import Settings`
     - Одберете ја датотеката и кликнете `OK`
