Merge pull request #1 from kunth/kunth-patch-1

Update global-api.md

Author: kunth

source/api/global-api.md

@@ -6,59 +6,80 @@ order: 5
 ### Vue.config
 
 `Vue.config` is an object containing Vue's global settings. Here are the list of all the avaiable settings with their default values:
+`Vue.config` 是包含 Vue 全局设置的对象。下面列出了所有可设置变量及其默认值：
 
 ``` js
 {
   // print stack trace for warnings?
+  // 打印 warnings 的堆栈跟踪？
   debug: true,
   // attribute prefix for directives
+  // 指令的属性前缀
   prefix: 'v-',
   // interpolation delimiters
+  // 插入分隔符
   // for HTML interpolations, add
   // 1 extra outer-most character.
+  // 对于插入HTML，添加一个额外的最外层字符
   delimiters: ['{{', '}}'],
   // suppress warnings?
+  // 抑制 warnings？
   silent: false,
   // interpolate mustache bindings?
+  // 插入 mustache 绑定?
   interpolate: true,
   // use async updates (for directives & watchers)?
+  // (对 directives 和 watchers)使用异步更新？
   async: true,
   // allow altering observed Array's prototype chain?
+  // 允许改变所观察的Array的原型链？
   proto: true
 }
 ```
 
 You can modify them directly, for example:
+你可以直接对其修改，例如：
 
 ``` js
 Vue.config.debug = true // turn on debugging mode
+Vue.config.debug = true // 开启调试模式
 ```
 
 **Debug Mode**
+**调试模式**
 
 When `Vue.config.debug` is set to true, Vue will automatically use synchronous mode and throw a `debugger` statement when there is a warning. This enables the user to inspect the full stack trace in browser dev tools.
+当 `Vue.config.debug` 设置为 true 时，Vue 会自动启动同步模式，并在有警告时抛出一个 `debugger ` 语句。这使得用户能够在浏览器开发工具中检查完整的堆栈跟踪(full stack trace)
 
 <p class="tip">debug mode is not available in the minified production builds.</p>
+<p class="tip">调试模式在压缩的生产环境(minified production builds)下是不可用的</p>
 
 **Changing Delimiters**
+**改变分隔符(Delimiters)**
 
 When the delimiters are set for text interpolation, the delimiters for HTML interpolation will be generated by adding one outer-most symbol on both sides:
+当分隔符(delimiters)是设置为插入文本时，那么设置为插入HTML的分隔符可以通过在两边的最外层加上符号来生成。
 
 ``` js
 Vue.config.delimiters = ['(%', '%)']
 // tags now are (% %) for text
+// (% %)是文本的标签
 // and ((% %)) for HTML
+// 则((% %))是HTML的标签
 ```
 
 ### Vue.extend( options )
 
 - **options** `Object`
 
 Create a "subclass" of the base Vue constructor. All [instantiation options](../api/options.html) can be used here. The special cases to note here are `el` and `data`, which must be functions in this case.
+创建一个基类 Vue 构造函数的"子类"。所有的[实例化选项](../api/options.html)都可以在此用到。其中需要特殊提及的是 `el` 和 `data`，在这个类里他们必须作为函数使用。
 
 Internally, `Vue.extend()` is called on all component options before instantiating the components. For more details regarding components, see [Component System](../guide/components.html).
+在所有组件(components)被初始化之前，`Vue.extend()`被组件选项隐式地调用。关于组件更多的细节，可详见[组件系统](../guide/components.html)。
 
 **Example**
+**例子**
 
 ``` js
 var Profile = Vue.extend({
@@ -75,9 +96,11 @@ var profile = new Profile({
   }  
 })
 profile.$appendTo('body')
+
 ```
 
 Will result in:
+将输出：
 
 ``` html
 <p>Walter White aka Heisenberg</p>
@@ -87,39 +110,49 @@ Will result in:
 
 - **id** `String`
 - **definition** `Function` or `Object` *optional*
+- **definition** `Function` or `Object` *可选的*
 
 Register or retrieve a global custom directive. For more details see [Writing Custom Directives](../guide/custom-directive.html).
+注册或取得一个全局自定义的指令。详情见[编写自定义指令](../guide/custom-directive.html)。
 
 ### Vue.filter( id, [definition] )
 
 - **id** `String`
 - **definition** `Function` *optional*
+- **definition** `Function` *可选的*
 
 Register or retrieve a global custom filter. For more details see [Writing Custom Filters](../guide/custom-filter.html).
+注册或取得一个全局自定义的过滤器。详情见[编写自定义过滤器](../guide/custom-filter.html)。
 
 ### Vue.component( id, [definition] )
 
 - **id** `String`
 - **definition** `Function Constructor` or `Object` *optional*
+- **definition** `Function Constructor` or `Object` *可选的*
 
 Register or retrieve a global component. For more details see [Component System](../guide/components.html).
+注册或取得一个全局自定义的组件。详情见[组件系统](../guide/components.html)。
 
 ### Vue.transition( id, [definition] )
 
 - **id** `String`
 - **definition** `Object` *optional*
+- **definition** `Object` *可选的*
 
 Register or retrieve a global JavaScript transition effect definition. For more details see the guide for [JavaScript Transitions](../guide/transitions.html#JavaScript_Functions).
+注册或取得一个全局 JavaScript 转换效应(transition effect)定义。详见[JavaScript转换](../guide/transitions.html#JavaScript_Functions)的指导。
 
 ### Vue.partial( id, [definition] )
 
 - **id** `String`
 - **definition** `String | Node` *optional*
+- **definition** `String | Node` *可选的*
 
 Register or retrieve a global partial. The definition can be a template string, a querySelector that starts with `#`, a DOM element (whose innerHTML will be used as the template string), or a DocumentFragment.
+注册或取得一个全局的partial。定义可以是一个string模板，一个以`#`开头的querySelector，一个DOM元素(其内嵌HTML作为string模板使用)或者一个DocumentFragment
 
 **Example**
-
+**例子**
 HTML
 
 ``` html
@@ -142,6 +175,7 @@ new Vue({
 ```
 
 Will result in:
+将输出:
 
 ``` html
 <div id="demo">
@@ -154,14 +188,18 @@ Will result in:
 - **callback** `Function`
 
 Vue.js batches view updates and executes them all asynchronously. It uses `requestAnimationFrame` if available and falls back to `setTimeout(fn, 0)`. This method calls the callback after the next view update, which can be useful when you want to wait until the view has been updated.
+Vue.js 批量处理视图更新并对其异步执行。如果可用的话它会使用 `requestAnimationFrame` 并返回到 `setTimeout(fn, 0)`。这个方法在下一个视图更新后调用回调，当你想一直等待到该视图被更新了，用这个方法会很好。
 
 ### Vue.use( plugin, [args...] )
 
 - **plugin** `Object` or `Function`
 - **args...** *optional*
+- **args...** *可选的*
 
 Mount a Vue.js plugin. If the plugin is an Object, it must have an `install` method. If it is a function itself, it will be treated as the install method. The install method will be called with Vue as the argument. For more details, see [Plugins](../guide/extending.html#Extend_with_Plugins).
+挂载一个 Vue.js 的插件。如果该插件是一个对象，它必须有一个 `install` 的方法。如果它本身就是一个方法，它必须被作为安装方法来对待。安装方法将会被 Vue 作为一个参数来调用。更多详情请阅[插件](../guide/extending.html#Extend_with_Plugins)。
 
 ### Vue.util
 
-Exposes the internal `util` module, which contains a number of utility methods. This is intended for advanced plugin/directive authoring, so you will need to look at the source code to see what's available.
+Exposes the internal `util` module, which contains a number of utility methods. This is intended for advanced plugin/directive authoring, so you will need to look at the source code to see what's available.
+公开内部的 `util` 模块。该模块包含一些列实用方法(utility methods)。这是被为用来编写高级插件/指令，因此你必须查看源码来确定哪些是可操作的。