sync recent updates (vuejs#628)

* update to 2.5.11

* update sponsor logo

* update sponsor logos

* update sponsors

* update sponsors

* Avoid wrapping Support Vue menu item (#1326)

* Update team.md (#1330)

* Update Instance in Guide to mention Object.freeze (#1323)

* update instance in guide to mention object.freeze

* Small tweaks to Object.freeze example

* Revert changes to spaces before parens

* Add props and events diagram (#1310)

* Updated style guide (#1331)

Updated style guide based on Multi-attribute elements statement.

* upgrade vue

* fix error parsing api h3s

* Update events.md (#1333)

When using capture mode , parent is being handled before the children is being handled

* Update shentao’s repos and work (#1335)

* Update common.js

* fixed bug in team.md

Author: Jinjiang

assets/props_and_events.ai

@@ -44,9 +44,7 @@ Vue.js 是采用 MIT 许可的开源项目，使用完全免费。
 ### Patreon 黄金赞助商
 
 <p class="patreon-sponsors sponsor-section">
-  <a href="https://deepstreamhub.com" target="_blank" style="width: 140px; top: 1px;">
-    <img src="/images/deepstream.png" style="width: 140px;">
-  </a><a href="https://jsfiddle.net">
+  <a href="https://jsfiddle.net">
     <img src="/images/jsfiddle.png">
   </a><a href="https://laravel.com">
     <img src="/images/laravel.png">
@@ -64,16 +62,16 @@ Vue.js 是采用 MIT 许可的开源项目，使用完全免费。
     <img src="/images/vuejobs.svg">
   </a><a href="https://leanpub.com/vuejs2" target="_blank">
     <img src="/images/tmvuejs2.png">
-  </a><a href="https://component.io" target="_blank" style="width: 140px;">
-    <img src="/images/component_io.png" style="width: 140px;">
+  </a><a href="https://anymod.com" target="_blank" style="width: 140px;">
+    <img src="/images/anymod.png" style="width: 140px;">
   </a><a href="https://www.xfive.co/" target="_blank" style="width: 80px;">
     <img src="/images/xfive.png" style="width: 80px;">
-  </a><a href="http://www.frontenddevelopermeetups.com/" target="_blank" style="width: 120px;">
-    <img src="/images/frontend-meetups.png" style="width: 120px;">
+  </a><a href="https://www.frontenddeveloperlove.com/" target="_blank" style="width: 150px;">
+    <img src="/images/frontend-love.png" style="width: 150px;">
   </a><a href="https://onsen.io/vue/" target="_blank" style="width: 125px;">
     <img src="/images/onsen-ui.png" style="width: 125px;">
-  </a><a href="https://themeforest.net/item/clear-bootstrap-vuejs-admin-template/19339739?ref=jyostna&utm_source=vuejs.org&utm_campaign=vuejs_patreon" target="_blank" style="width: 120px;">
-    <img src="/images/vuejsadmin.png" style="width: 120px;">
+  </a><a href="https://vuetifyjs.com" target="_blank">
+    <img src="/images/vuetify.png">
   </a>
 </p>
 

src/support-vuejs/index.md

@@ -175,7 +175,7 @@ type: api
 
 ## 全局 API
 
-<h3 id="Vue-extend">Vue.extend( options )</h3>
+### Vue.extend( options )
 
 - **参数**：
   - `{Object} options`
@@ -214,7 +214,7 @@ type: api
 
 - **参考**：[组件](../guide/components.html)
 
-<h3 id="Vue-nextTick">Vue.nextTick( [callback, context] )</h3>
+### Vue.nextTick( [callback, context] )
 
 - **参数**：
   - `{Function} [callback]`
@@ -241,7 +241,7 @@ type: api
 
   > 2.1.0 起新增：如果没有提供回调且在支持 Promise 的环境中，则返回一个 Promise。请注意 Vue 不自带 Promise 的 polyfill，所以如果你的目标浏览器不原生支持 Promise (IE：你们都看我干嘛)，你得自己提供 polyfill。
 
-<h3 id="Vue-set">Vue.set( target, key, value )</h3>
+### Vue.set( target, key, value )
 
 - **参数**：
   - `{Object | Array} target`
@@ -256,7 +256,7 @@ type: api
 
   <p class="tip">注意对象不能是 Vue 实例，或者 Vue 实例的根数据对象。</p>
 
-<h3 id="Vue-delete">Vue.delete( target, key )</h3>
+### Vue.delete( target, key )
 
 - **参数**：
   - `{Object | Array} target`
@@ -272,7 +272,7 @@ type: api
 
   <p class="tip">目标对象不能是一个 Vue 实例或 Vue 实例的根数据对象。</p>
 
-<h3 id="Vue-directive">Vue.directive( id, [definition] )</h3>
+### Vue.directive( id, [definition] )
 
 - **参数**：
   - `{string} id`
@@ -303,7 +303,7 @@ type: api
 
 - **参考**：[自定义指令](../guide/custom-directive.html)
 
-<h3 id="Vue-filter">Vue.filter( id, [definition] )</h3>
+### Vue.filter( id, [definition] )
 
 - **参数**：
   - `{string} id`
@@ -323,7 +323,7 @@ type: api
   var myFilter = Vue.filter('my-filter')
   ```
 
-<h3 id="Vue-component">Vue.component( id, [definition] )</h3>
+### Vue.component( id, [definition] )
 
 - **参数**：
   - `{string} id`
@@ -346,7 +346,7 @@ type: api
 
 - **参考**：[组件](../guide/components.html)
 
-<h3 id="Vue-use">Vue.use( plugin )</h3>
+### Vue.use( plugin )
 
 - **参数**：
   - `{Object | Function} plugin`
@@ -359,7 +359,7 @@ type: api
 
 - **参考**：[插件](../guide/plugins.html)
 
-<h3 id="Vue-mixin">Vue.mixin( mixin )</h3>
+### Vue.mixin( mixin )
 
 - **参数**：
   - `{Object} mixin`
@@ -370,7 +370,7 @@ type: api
 
 - **参考**：[全局混合](../guide/mixins.html#全局混合)
 
-<h3 id="Vue-compile">Vue.compile( template )</h3>
+### Vue.compile( template )
 
 - **参数**：
   - `{string} template`
@@ -393,7 +393,7 @@ type: api
 
 - **参考**：[渲染函数](../guide/render-function.html)
 
-<h3 id="Vue-version">Vue.version</h3>
+### Vue.version
 
 - **细节**：提供字符串形式的 Vue 安装版本号。这对社区的插件和组件来说非常有用，你可以根据不同的版本号采取不同的策略。
 
@@ -1415,7 +1415,7 @@ type: api
 
 ## 实例方法 / 数据
 
-<h3 id="vm-watch">vm.$watch( expOrFn, callback, [options] )</h3>
+### vm.$watch( expOrFn, callback, [options] )
 
 - **参数**：
   - `{string | Function} expOrFn`
@@ -1482,7 +1482,7 @@ type: api
   // 立即以 `a` 的当前值触发回调
   ```
 
-<h3 id="vm-set">vm.$set( target, key, value )</h3>
+### vm.$set( target, key, value )
 
 - **参数**：
   - `{Object | Array} target`
@@ -1497,7 +1497,7 @@ type: api
 
 - **参考**：[Vue.set](#Vue-set)
 
-<h3 id="vm-delete">vm.$delete( target, key )</h3>
+### vm.$delete( target, key )
 
 - **参数**：
   - `{Object | Array} target`
@@ -1511,7 +1511,7 @@ type: api
 
 ## 实例方法 / 事件
 
-<h3 id="vm-on">vm.$on( event, callback )</h3>
+### vm.$on( event, callback )
 
 - **参数**：
   - `{string | Array<string>} event` (数组只在 2.2.0+ 中支持)
@@ -1531,7 +1531,7 @@ type: api
   // => "hi"
   ```
 
-<h3 id="vm-once">vm.$once( event, callback )</h3>
+### vm.$once( event, callback )
 
 - **参数**：
   - `{string} event`
@@ -1541,7 +1541,7 @@ type: api
 
   监听一个自定义事件，但是只触发一次，在第一次触发之后移除监听器。
 
-<h3 id="vm-off">vm.$off( [event, callback] )</h3>
+### vm.$off( [event, callback] )
 
 - **参数**：
   - `{string | Array<string>} event` (只在 2.2.2+ 支持数组)
@@ -1557,7 +1557,7 @@ type: api
 
   - 如果同时提供了事件与回调，则只移除这个回调的监听器。
 
-<h3 id="vm-emit">vm.$emit( event, [...args] )</h3>
+### vm.$emit( event, [...args] )
 
 - **参数**：
   - `{string} event`
@@ -1567,7 +1567,7 @@ type: api
 
 ## 实例方法 / 生命周期
 
-<h3 id="vm-mount">vm.$mount( [elementOrSelector] )</h3>
+### vm.$mount( [elementOrSelector] )
 
 - **参数**：
   - `{Element | string} [elementOrSelector]`
@@ -1605,13 +1605,13 @@ type: api
   - [生命周期图示](../guide/instance.html#生命周期图示)
   - [服务端渲染](../guide/ssr.html)
 
-<h3 id="vm-forceUpdate">vm.$forceUpdate()</h3>
+### vm.$forceUpdate()
 
 - **示例**：
 
   迫使 Vue 实例重新渲染。注意它仅仅影响实例本身和插入插槽内容的子组件，而不是所有子组件。
 
-<h3 id="vm-nextTick">vm.$nextTick( [callback] )</h3>
+### vm.$nextTick( [callback] )
 
 - **参数**：
   - `{Function} [callback]`
@@ -1645,7 +1645,7 @@ type: api
 
 - **参考**：[Vue.nextTick](#Vue-nextTick)
 
-<h3 id="vm-destroy">vm.$destroy()</h3>
+### vm.$destroy()
 
 - **用法**：
 

src/v2/api/index.md

@@ -188,7 +188,7 @@ methods: {
 <form v-on:submit.prevent></form>
 
 <!-- 添加事件监听器时使用事件捕获模式 -->
-<!-- 即内部元素触发的事件先在此处处理，然后才交由内部元素自身进行处理 -->
+<!-- 即元素自身触发的事件先在此处处理，然后才交由内部元素进行处理 -->
 <div v-on:click.capture="doThis">...</div>
 
 <!-- 只当在 event.target 是当前元素自身时触发处理函数 -->

src/v2/guide/events.md

@@ -2,8 +2,8 @@
 title: 安装
 type: guide
 order: 1
-vue_version: 2.5.9
-gz_size: "30.95"
+vue_version: 2.5.13
+gz_size: "30.67"
 ---
 
 ### 兼容性

src/v2/guide/installation.md

@@ -8,7 +8,7 @@ order: 3
 
 每个 Vue 应用都是通过 `Vue` 函数创建一个新的 **Vue 实例**开始的：
 
-``` js
+```js
 var vm = new Vue({
   // 选项
 })
@@ -37,7 +37,7 @@ Root Instance
 
 当一个 Vue 实例被创建时，它向 Vue 的**响应式系统**中加入了其 `data` 对象中能找到的所有的属性。当这些属性的值发生改变时，视图将会产生“响应”，即匹配更新为新的值。
 
-``` js
+```js
 // 我们的数据对象
 var data = { a: 1 }
 
@@ -60,13 +60,13 @@ vm.a // => 3
 
 当这些数据改变时，视图会进行重渲染。值得注意的是只有当实例被创建时 `data` 中存在的属性是**响应式**的。也就是说如果你添加一个新的属性，像：
 
-``` js
+```js
 vm.b = 'hi'
 ```
 
 那么对 `b` 的改动将不会触发任何视图的更新。如果你知道你会在晚些时候需要一个属性，但是一开始它为空或不存在，那么你仅需要设置一些初始值。比如：
 
-``` js
+```js
 data: {
   newTodoText: '',
   visitCount: 0,
@@ -76,9 +76,36 @@ data: {
 }
 ```
 
+这里唯一的例外是使用 `Object.freeze()` 防止修改现有的属性，这意味着响应系统无法_追踪_变化了。
+
+```js
+var obj = {
+  foo: 'bar'
+}
+
+Object.freeze(obj)
+
+new Vue({
+  el: '#app',
+  data () {
+    return {
+      obj
+    }
+  }
+})
+```
+
+```html
+<div id="app">
+  <p>{{ obj.foo }}</p>
+  <!-- 这里的 `obj.foo` 不会更新！ -->
+  <button @click="obj.foo = 'baz'">Change it</button>
+</div>
+```
+
 除了 data 属性，Vue 实例暴露了一些有用的实例属性与方法。它们都有前缀 `$`，以便与用户定义的属性区分开来。例如：
 
-``` js
+```js
 var data = { a: 1 }
 var vm = new Vue({
   el: '#example',
@@ -102,7 +129,7 @@ vm.$watch('a', function (newValue, oldValue) {
 
 比如 [`created`](../api/#created) 钩子可以用来在一个实例被创建之后执行代码：
 
-``` js
+```js
 new Vue({
   data: {
     a: 1

src/v2/guide/instance.md

@@ -198,6 +198,7 @@ order: 803
     'Annecy, France': [45.899247, 6.129384],
     'Alicante, Spain' : [38.346543, -0.483838],
     'Bangalore, India': [12.971599, 77.594563],
+    'Beijing, China': [39.913818, 116.363625],
     'Bordeaux, France': [44.837789, -0.579180],
     'Bucharest, Romania': [44.426767, 26.102538],
     'Chengdu, China': [30.572815, 104.066801],
@@ -591,12 +592,25 @@ order: 803
       github: 'shentao',
       twitter: 'DamianDulisz',
       work: {
-        role: 'Senior Frontend Developer',
-        org: 'Monterail',
-        orgUrl: 'https://www.monterail.com/'
+        role: 'Consultant'
       },
       reposPersonal: [
-        'monterail/vue-multiselect', 'monterail/vue-newsletter'
+        'shentao/vue-multiselect'
+      ]
+    },
+    {
+      name: 'kingwl',
+      title: 'New Bee',
+      city: 'Beijing, China',
+      languages: ['zh'],
+      work: {
+        role: 'Software Development Engineer',
+        org: 'Chaitin',
+        orgUrl: 'https://chaitin.cn/'
+      },
+      github: 'kingwl',
+      reposOfficial: [
+        'vue'
       ]
     }
   ]))

src/v2/guide/team.md

@@ -1714,7 +1714,10 @@ computed: {
 #### 好例子
 
 ``` html
-<div v-if="error" key="search-status">
+<div
+  v-if="error"
+  key="search-status"
+>
   错误：{{ error }}
 </div>
 <div v-else key="search-results">

src/v2/style-guide/index.md

@@ -1,4 +1,4 @@
 site_description: "Vue.js - The Progressive JavaScript Framework"
 google_analytics: UA-46852172-3
 root_domain: cn.vuejs.org
-vue_version: 2.5.9
+vue_version: 2.5.13