删去已翻译的英文原文

Author: kunth

source/api/global-api.md

@@ -5,80 +5,58 @@ 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
@@ -99,7 +77,6 @@ profile.$appendTo('body')
 
 ```
 
-Will result in:
 将输出：
 
 ``` html
@@ -109,49 +86,38 @@ Will result in:
 ### Vue.directive( id, [definition] )
 
 - **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
 
@@ -174,7 +140,6 @@ new Vue({
 })
 ```
 
-Will result in:
 将输出:
 
 ``` html
@@ -187,19 +152,15 @@ 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.
 公开内部的 `util` 模块。该模块包含一些列实用方法(utility methods)。这是被为用来编写高级插件/指令，因此你必须查看源码来确定哪些是可操作的。