Merge pull request #1 from vuejs-fr/master

test sync forked repo by UI

Author: yann-yinn

README.md

@@ -22,11 +22,14 @@ La traduction pour ce projet de documentation est actuellement maintenu dans des
 
 ### Japonais
 
+La traduction japonaise est maintenue par [Vue.js japan user group](https://github.com/vuejs-jp)
+
 * Dépôt de traduction - [/vuejs/jp.vuejs.org](https://github.com/vuejs/jp.vuejs.org)
+* Mainteneur principal - [kazupon](https://github.com/kazupon)
 
 ### Russe
 
-La traduction Russe est maintenu par Translation Gang.
+La traduction russe est maintenue par Translation Gang.
 
 * Dépôt de traduction — [/translation-gang/ru.vuejs.org](https://github.com/translation-gang/ru.vuejs.org)
 * Mainteneur principal - [Grigoriy Beziuk](https://gbezyuk.github.io)
@@ -37,9 +40,18 @@ La traduction Russe est maintenu par Translation Gang.
 
 ### Coréen
 
-À FAIRE : fournir des informations ici
+La traduction coréenne est maintenue par [Vue.js Korean User group](https://github.com/vuejs-kr).
+
+* Dépôt de traduction - [/vuejs-kr/kr.vuejs.org](https://github.com/vuejs-kr/kr.vuejs.org)
+* Mainteneur principal - [ChangJoo Park](https://github.com/ChangJoo-Park)
+
+### Français
+
+La traduction française est maintenue par Vuejs-FR.
+
+* Dépôt de traduction — [/vuejs-fr/vuejs.org](https://github.com/vuejs-fr/vuejs.org)
 
-### Vous voulez participer à la traduction ?
+### Voulez-vous participer à la traduction ?
 
 Si vous vous sentez d'attaque pour une traduction seul, forkez simplement ce dépôt, créez un ticket « work-in-progress » pour informer les autres que vous êtes entrain de le traduire, et en avant.
 

src/support-vuejs/index.md

@@ -25,8 +25,6 @@
     <img src="/images/htmlburger.png">
   </a><a href="https://starter.someline.com/" target="_blank">
     <img src="/images/someline.png">
-  </a><a href="http://gold.xitu.io/?utm_source=vuejs&utm_medium=image&utm_content=juejin&utm_campaign=q3_website" target="_blank">
-    <img width="180px" src="/images/juejin.png">
   </a><a href="http://monterail.com/" target="_blank">
     <img src="/images/monterail.png">
   </a><a href="https://www.trisoft.ro/" target="_blank">
@@ -37,6 +35,10 @@
     <img src="/images/2mhost.png">
   </a><a href="https://vuejobs.com/?ref=vuejs" target="_blank" style="position:relative;top:6px">
     <img src="/images/vuejobs.png">
+  </a><a href="https://leanpub.com/vuejs2" target="_blank">
+    <img src="/images/tmvuejs2.png">
+  </a><a href="https://stdlib.com/" target="_blank">
+    <img src="/images/stdlib.png">
   </a>
 </p>
 

src/v2/api/index.md

@@ -447,7 +447,7 @@ type: api
 
   <p class="tip">Note that __you should not use an arrow function to define a computed property__ (e.g. `aDouble: () => this.a * 2`). The reason is arrow functions bind the parent context, so `this` will not be the Vue instance as you expect and `this.a` will be undefined.</p>
 
-  Computed properties are cached, and only re-computed on reactive dependency changes.
+  Computed properties are cached, and only re-computed on reactive dependency changes. Note that if a certain dependency is out of the instance's scope (i.e. not reactive), the computed property will __not__ be updated.
 
 - **Example:**
 
@@ -662,7 +662,7 @@ All lifecycle hooks automatically have their `this` context bound to the instanc
 
   Called after a data change causes the virtual DOM to be re-rendered and patched.
 
-  The component's DOM will be in updated state when this hook is called, so you can perform DOM-dependent operations in this hook. However, in most cases you should avoid changing state in this hook, because it may lead to an infinite update loop.
+  The component's DOM will have been updated when this hook is called, so you can perform DOM-dependent operations here. However, in most cases you should avoid changing state inside the hook. To react to state changes, it's usually better to use a [computed property](#computed) or [watcher](#watch) instead.
 
   **This hook is not called during server-side rendering.**
 

src/v2/guide/class-and-style.md

@@ -146,7 +146,7 @@ C'est aussi vrai pour la liaison de classe :
 Quand `isActive` est évalué à vrai, le rendu HTML sera :
 
 ``` html
-<p class="foo bar active"></p>
+<p class="foo bar active">Hi</p>
 ```
 
 ## Liaison de Styles HTML

src/v2/guide/comparison.md

@@ -221,9 +221,9 @@ Puisque vous n'avez pas besoin de connaître JSX, ES2015 ou les outils de build
 
 ### Rendu natif
 
-ReactNative vous permet d'écrire des applications natives iOS et Android et Android en utilisant le même modèle de composant que React. C'est génial car en tant que développeur, vous pouvez appliquer vos connaissances d'un framework sur de multiple plateformes. De ce côté, Vue a une collaboration officielle avec [Weex](https://alibaba.github.io/weex/), un framework de développement d'UI multiplateforme développé par le groupe Alibaba, qui utilise Vue en tant que framework JavaScript d'exécution. Cela signifie qu'avec Weex, vous pouvez utiliser la même syntaxe de composant Vue pour concevoir des composants qui peuvent non seulement être utilisés sur navigateur mais également nativement sur iOS ou Android !
+React Native vous permet d'écrire des applications natives iOS et Android et Android en utilisant le même modèle de composant que React. C'est génial car en tant que développeur, vous pouvez appliquer vos connaissances d'un framework sur de multiple plateformes. De ce côté, Vue a une collaboration officielle avec [Weex](https://alibaba.github.io/weex/), un framework de développement d'UI multiplateforme développé par le groupe Alibaba, qui utilise Vue en tant que framework JavaScript d'exécution. Cela signifie qu'avec Weex, vous pouvez utiliser la même syntaxe de composant Vue pour concevoir des composants qui peuvent non seulement être utilisés sur navigateur mais également nativement sur iOS ou Android !
 
-Actuellement, Weex est toujours activement en développement et n'est pas aussi mature et bien testé que ReactNative, son développement est soutenu par les besoins en production du plus gros business e-commerce au monde, et l'équipe de Vue est aussi en étroite collaboration avec l'équipe de Weex pour assurer un passage en douceur pour les développeurs depuis Vue.
+Actuellement, Weex est toujours activement en développement et n'est pas aussi mature et bien testé que React Native, son développement est soutenu par les besoins en production du plus gros business e-commerce au monde, et l'équipe de Vue est aussi en étroite collaboration avec l'équipe de Weex pour assurer un passage en douceur pour les développeurs depuis Vue.
 
 ### Avec MobX
 

src/v2/guide/components.md

@@ -1041,7 +1041,7 @@ components: {
 Within HTML templates though, you have to use the kebab-case equivalents:
 
 ``` html
-<!-- alway use kebab-case in HTML templates -->
+<!-- always use kebab-case in HTML templates -->
 <kebab-cased-component></kebab-cased-component>
 <camel-cased-component></camel-cased-component>
 <title-cased-component></title-cased-component>

src/v2/guide/computed.md

@@ -75,7 +75,7 @@ console.log(vm.reversedMessage) // -> 'eybdooG'
 
 You can open the console and play with the example vm yourself. The value of `vm.reversedMessage` is always dependent on the value of `vm.message`.
 
-You can data-bind to computed properties in templates just like a normal property. Vue is aware that `vm.reversedMessage` depends on `vm.message`, so it will update any bindings that depend on `vm.reversedMessage` when `vm.message` changes. And the best part is that we've created this dependency relationship declaratively: the computed getter function is pure and has no side effects, which makes it easy to test and reason about.
+You can data-bind to computed properties in templates just like a normal property. Vue is aware that `vm.reversedMessage` depends on `vm.message`, so it will update any bindings that depend on `vm.reversedMessage` when `vm.message` changes. And the best part is that we've created this dependency relationship declaratively: the computed getter function has no side effects, which makes it easy to test and reason about.
 
 ### Computed Caching vs Methods
 
@@ -228,12 +228,12 @@ var watchExampleVM = new Vue({
     // _.throttle), visit: https://lodash.com/docs#debounce
     getAnswer: _.debounce(
       function () {
-        var vm = this
         if (this.question.indexOf('?') === -1) {
-          vm.answer = 'Questions usually contain a question mark. ;-)'
+          this.answer = 'Questions usually contain a question mark. ;-)'
           return
         }
-        vm.answer = 'Thinking...'
+        this.answer = 'Thinking...'
+        var vm = this
         axios.get('https://yesno.wtf/api')
           .then(function (response) {
             vm.answer = _.capitalize(response.data.answer)

src/v2/guide/events.md

@@ -67,7 +67,9 @@ var example2 = new Vue({
       // `this` inside methods points to the Vue instance
       alert('Hello ' + this.name + '!')
       // `event` is the native DOM event
-      alert(event.target.tagName)
+      if (event) {
+        alert(event.target.tagName)
+      }
     }
   }
 })
@@ -91,7 +93,9 @@ var example2 = new Vue({
   methods: {
     greet: function (event) {
       alert('Hello ' + this.name + '!')
-      alert(event.target.tagName)
+      if (event) {
+        alert(event.target.tagName)
+      }
     }
   }
 })

src/v2/guide/index.md

@@ -53,7 +53,7 @@ var app = new Vue({
 </script>
 {% endraw %}
 
-We have already created our very first Vue app! This looks pretty similar to just rendering a string template, but Vue has done a lot of work under the hood. The data and the DOM are now linked, and everything is now **reactive**. How do we know? Just open up your browser's JavaScript console and set `app.message` to a different value. You should see the rendered example above update accordingly.
+We have already created our very first Vue app! This looks pretty similar to just rendering a string template, but Vue has done a lot of work under the hood. The data and the DOM are now linked, and everything is now **reactive**. How do we know? Just open your browser's JavaScript console (right now, on this page) and set `app.message` to a different value. You should see the rendered example above update accordingly.
 
 In addition to text interpolation, we can also bind element attributes like this:
 

src/v2/guide/installation.md

@@ -2,11 +2,11 @@
 title: Installation
 type: guide
 order: 1
-vue_version: 2.1.8
-dev_size: "217.56"
-min_size: "70.37"
-gz_size: "25.75"
-ro_gz_size: "17.87"
+vue_version: 2.1.10
+dev_size: "218.92"
+min_size: "70.99"
+gz_size: "25.86"
+ro_gz_size: "18.01"
 ---
 
 ### Compatibilité

src/v2/guide/instance.md

@@ -34,7 +34,7 @@ Bien qu'il soit possible de créer des instances étendues de manière impérati
 
 ## Propriétés et méthodes
 
-Chaque instance de vue **"proxifie"** toutes les propriétés contenues dans son objet `data`
+Chaque instance de vue **« proxifie »** toutes les propriétés contenues dans son objet `data`
 
 ``` js
 var data = { a: 1 }
@@ -79,7 +79,7 @@ Consultez [l'API](../api) pour une liste complète des propriétés et méthodes
 
 ## Les hooks de cycle de vie d'une instance
 
-Chaque instance de vue traverse une série d'étapes d'initialisation au moment de sa création - par exemple, elle doit mettre en place l'observation des données, compiler le template, monter l'instance sur le DOM et mettre à jour le DOM quand les données changent. En cours de route, elle va aussi invoquer des **hooks de cycle de vie**, qui nous donnent l'opportunité d'exécuter une logique personnalisée. Par exemple, le hook `created` est appelé une fois l'instance créée.
+Chaque instance de vue traverse une série d'étapes d'initialisation au moment de sa création - par exemple, elle doit mettre en place l'observation des données, compiler le template, monter l'instance sur le DOM et mettre à jour le DOM quand les données changent. En cours de route, elle va aussi invoquer des **hooks de cycle de vie**, qui nous donnent l'opportunité d'exécuter une logique personnalisée. Par exemple, le hook [`created`](../api/#created) est appelé une fois l'instance créée.
 
 ``` js
 var vm = new Vue({
@@ -94,7 +94,7 @@ var vm = new Vue({
 // -> "a is: 1"
 ```
 
-Il y aussi d'autres hooks qui seront appelés à différentes étapes du cycle de vie d'une instance, par exemple `mounted`, `updated`et `destroyed`. Tous ces hooks de cycle de vie sont appelés avec leur `this` pointant sur l'instance de la vue qui les invoque. Vous vous êtes peut-être demandé où se trouvait le concept de "contrôleur" dans le monde de Vue et la réponse est : il n'y pas de contrôleurs. Votre logique personnalisée pour un composant sera répartie entre ces hooks de cycle de vie.
+Il y aussi d'autres hooks qui seront appelés à différentes étapes du cycle de vie d'une instance, par exemple [`mounted`](../api/#mounted), [`updated`](../api/#updated) et [`destroyed`](../api/#destroyed)`. Tous ces hooks de cycle de vie sont appelés avec leur `this` pointant sur l'instance de la vue qui les invoque. Vous vous êtes peut-être demandé où se trouvait le concept de « contrôleur » dans le monde de Vue et la réponse est : il n'y pas de contrôleurs. Votre logique personnalisée pour un composant sera répartie entre ces hooks de cycle de vie.
 
 ## Diagramme de cycle de vie
 

src/v2/guide/join.md

@@ -6,7 +6,7 @@ order: 30
 
 <p class="tip">**Cette page est en cours de traduction française. Revenez une autre fois pour lire une traduction achevée ou [participez à la traduction française ici](https://github.com/vuejs-fr/vuejs.org).**</p>Vue's community is growing incredibly fast and if you're reading this, there's a good chance you're ready to join it. So... welcome!
 
-Now we'll answer both what the community can do for and what you can do for the community.
+Now we'll answer both what the community can do for you and what you can do for the community.
 
 ## Resources You'll Enjoy
 

src/v2/guide/list.md

@@ -331,7 +331,7 @@ new Vue({
 
 ### `v-for` with `v-if`
 
-When they exists on the same node, `v-for` has a higher priority than `v-if`. That means the `v-if` will be run on each iteration of the loop separately. This is very useful when you want to render nodes for only _some_ items, like below:
+When they exist on the same node, `v-for` has a higher priority than `v-if`. That means the `v-if` will be run on each iteration of the loop separately. This is very useful when you want to render nodes for only _some_ items, like below:
 
 ``` html
 <li v-for="todo in todos" v-if="!todo.isComplete">

src/v2/guide/migration.md

@@ -341,6 +341,44 @@ On root Vue instances (i.e. instances created with `new Vue({ ... })`), you must
 </div>
 {% endraw %}
 
+## Computed properties
+
+### `cache: false` <sup>deprecated</sup>
+
+Caching invalidation of computed properties will be removed in future major versions of Vue. Replace any uncached computed properties with methods, which will have the same result.
+
+For example:
+
+``` js
+template: '<p>message: {{ timeMessage }}</p>',
+computed: {
+  timeMessage: {
+    cache: false,
+    get: function () {
+      return Date.now() + this.message
+    }
+  }
+}
+```
+
+Or with component methods:
+
+``` js
+template: '<p>message: {{ getTimeMessage }}</p>',
+methods: {
+  getTimeMessage: function () {
+    return Date.now() + this.message
+  }
+}
+```
+
+{% raw %}
+<div class="upgrade-path">
+  <h4>Upgrade Path</h4>
+  <p>Run the <a href="https://github.com/vuejs/vue-migration-helper">migration helper</a> on your codebase to find examples of the <code>cache: false</code> option.</p>
+</div>
+{% endraw %}
+
 ## Built-In Directives
 
 ### Truthiness/Falsiness with `v-bind` <sup>changed</sup>

src/v2/guide/single-file-components.md

@@ -39,7 +39,6 @@ Une chose importante à souligner est que **la séparation des préoccupations n
 
 Si vous n'aimez pas l'idée des composants monofichiers, vous pouvez toujours tirer parti du rechargement à chaud et la précompilation pour mettre le CSS et le JavaScript dans des fichiers séparés.
 
-
 ``` html
 <!-- my-component.vue -->
 <template>
@@ -68,4 +67,3 @@ Dans Webpack, chaque module peut être transformé par un "loader" avant d'être
 ### Pour les utilisateurs avancés
 
 Que vous préfériez Webpack ou Browserify, nous avons des templates documentés à la fois pour les projets simples et les projets plus complexes. Nous vous recommandons d'explorer [github.com/vuejs-templates](https://github.com/vuejs-templates), de choisir un template qui vous convient et de suivre les instructions du README pour générer un nouveau projet avec [vue-cli](https://github.com/vuejs/vue-cli).
-

src/v2/guide/state-management.md

@@ -44,7 +44,7 @@ var store = {
   },
   clearMessageAction () {
     this.debug && console.log('clearMessageAction triggered')
-    this.state.message = 'clearMessageAction triggered'
+    this.state.message = ''
   }
 }
 ```