You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@weex.apache.org by ha...@apache.org on 2018/03/16 07:35:39 UTC

incubator-weex-site git commit: add categories for documents

Repository: incubator-weex-site
Updated Branches:
  refs/heads/master 0fb618db9 -> 1e3bd403f


add categories for documents


Project: http://git-wip-us.apache.org/repos/asf/incubator-weex-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-weex-site/commit/1e3bd403
Tree: http://git-wip-us.apache.org/repos/asf/incubator-weex-site/tree/1e3bd403
Diff: http://git-wip-us.apache.org/repos/asf/incubator-weex-site/diff/1e3bd403

Branch: refs/heads/master
Commit: 1e3bd403f2ccba884fbeedce7ead919c9bf0f8dc
Parents: 0fb618d
Author: Hanks <zh...@gmail.com>
Authored: Fri Mar 16 15:34:57 2018 +0800
Committer: Hanks <zh...@gmail.com>
Committed: Fri Mar 16 15:34:57 2018 +0800

----------------------------------------------------------------------
 source/cn/guide/advanced/app-architecture.md    |  2 +-
 source/cn/guide/advanced/downgrade.md           |  2 +-
 source/cn/guide/advanced/page-architecture.md   |  4 +-
 source/cn/guide/advanced/path.md                |  2 +-
 .../guide/advanced/use-vuex-and-vue-router.md   |  2 +-
 source/cn/guide/extend-android.md               |  4 +-
 source/cn/guide/extend-ios.md                   | 10 ++---
 source/cn/guide/extend-js-framework.md          |  4 +-
 source/cn/guide/extend-web-render.md            |  4 +-
 source/cn/guide/integrate-devtool-to-android.md |  2 +-
 source/cn/guide/integrate-devtool-to-ios.md     |  2 +-
 source/cn/guide/integrate-to-your-app.md        | 42 ++++++++++----------
 source/cn/guide/set-up-env.md                   |  2 +-
 source/cn/wiki/color-names.md                   |  4 +-
 source/cn/wiki/common-events.md                 |  2 +-
 source/cn/wiki/common-styles.md                 |  2 +-
 source/cn/wiki/css-units.md                     |  2 +-
 source/cn/wiki/design-principles.md             |  2 +
 source/cn/wiki/event-bubble.md                  |  4 +-
 source/cn/wiki/faq.md                           |  3 +-
 source/cn/wiki/gestures.md                      |  2 +-
 source/cn/wiki/index.md                         |  2 +-
 source/cn/wiki/text-styles.md                   |  2 +-
 source/guide/advanced/app-architecture.md       |  2 +-
 source/guide/advanced/downgrade.md              |  2 +-
 source/guide/advanced/page-architecture.md      |  2 +-
 source/guide/advanced/path.md                   |  2 +-
 .../guide/advanced/use-vuex-and-vue-router.md   |  2 +-
 source/guide/create-a-plugin.md                 |  2 +
 source/guide/extend-android.md                  | 20 +++++-----
 source/guide/extend-ios.md                      |  8 ++--
 source/guide/extend-js-framework.md             |  2 +
 source/guide/extend-web-render.md               |  2 +
 source/guide/integrate-devtool-to-android.md    |  2 +
 source/guide/integrate-devtool-to-ios.md        |  2 +
 source/guide/integrate-to-your-app.md           | 34 ++++++++--------
 source/guide/set-up-env.md                      |  8 ++--
 source/wiki/color-names.md                      |  2 +-
 source/wiki/common-events.md                    |  2 +-
 source/wiki/common-styles.md                    |  4 +-
 source/wiki/css-units.md                        |  2 +-
 source/wiki/design-principles.md                |  2 +
 source/wiki/event-bubble.md                     |  2 +
 source/wiki/faq.md                              |  2 +-
 source/wiki/gestures.md                         |  2 +-
 source/wiki/index.md                            |  2 +-
 source/wiki/text-styles.md                      |  2 +
 47 files changed, 122 insertions(+), 97 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/advanced/app-architecture.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/advanced/app-architecture.md b/source/cn/guide/advanced/app-architecture.md
index d68d568..b3ed1dc 100644
--- a/source/cn/guide/advanced/app-architecture.md
+++ b/source/cn/guide/advanced/app-architecture.md
@@ -6,7 +6,7 @@ order: 8.5
 version: 2.1
 ---
 
-# 用 Weex 构建移动应用
+<!-- toc -->
 
 ## 今天的移动应用
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/advanced/downgrade.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/advanced/downgrade.md b/source/cn/guide/advanced/downgrade.md
index 99149c6..afbbb34 100644
--- a/source/cn/guide/advanced/downgrade.md
+++ b/source/cn/guide/advanced/downgrade.md
@@ -6,7 +6,7 @@ order: 8.2
 version: 2.1
 ---
 
-# 降级方案
+<!-- toc -->
 
 Weex 2.0 降级方案改成模块的形式支持，具体请参考[downgrade](https://www.npmjs.com/package/@weex-project/downgrade)
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/advanced/page-architecture.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/advanced/page-architecture.md b/source/cn/guide/advanced/page-architecture.md
index 2842488..ad94ef0 100644
--- a/source/cn/guide/advanced/page-architecture.md
+++ b/source/cn/guide/advanced/page-architecture.md
@@ -6,7 +6,7 @@ order: 8.6
 version: 2.2
 ---
 
-# Weex 页面结构
+<!-- toc -->
 
 对于一个 Weex 页面来说，在移动设备上它就是一个相对独立解耦的移动应用界面，它不仅包括了界面展示，也包含了应用逻辑、设备能力、生命周期管理等部分。
 
@@ -50,4 +50,4 @@ Weex 提供了非常丰富的系统功能 API，包括弹出存储、网络、
 
 每个 Weex 页面都有其自身的生命周期，页面从开始被创建到最后被销毁，会经历到整个过程。这是通过对 Weex 页面的创建和销毁，在路由中通过 SDK 自行定义并实现的。
 
-由于 Weex 内置 Vue，对于 Vue 实例的生命周期回调 Weex 提供原生支持，具体可参照 Vue 生命周期相关文档。
\ No newline at end of file
+由于 Weex 内置 Vue，对于 Vue 实例的生命周期回调 Weex 提供原生支持，具体可参照 Vue 生命周期相关文档。

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/advanced/path.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/advanced/path.md b/source/cn/guide/advanced/path.md
index f3963ef..550adfc 100644
--- a/source/cn/guide/advanced/path.md
+++ b/source/cn/guide/advanced/path.md
@@ -7,7 +7,7 @@ version: 2.1
 has_chapter_content: true
 ---
 
-# Path
+<!-- toc -->
 
 <span class="weex-version">v0.9+</span>
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/advanced/use-vuex-and-vue-router.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/advanced/use-vuex-and-vue-router.md b/source/cn/guide/advanced/use-vuex-and-vue-router.md
index ac3ce8e..f76a0b0 100644
--- a/source/cn/guide/advanced/use-vuex-and-vue-router.md
+++ b/source/cn/guide/advanced/use-vuex-and-vue-router.md
@@ -6,7 +6,7 @@ order: 8.4
 version: 2.1
 ---
 
-# 使用 Vuex 和 vue-router
+<!-- toc -->
 
 Vue.js 也有较多周边技术产品，如 [Vuex](https://github.com/vuejs/vuex) 和 [vue-router](https://github.com/vuejs/vue-router) 等，这些库也可以在 Weex 中很好的工作。
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/extend-android.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/extend-android.md b/source/cn/guide/extend-android.md
index ff98da9..84d311d 100644
--- a/source/cn/guide/extend-android.md
+++ b/source/cn/guide/extend-android.md
@@ -1,12 +1,12 @@
 ---
-title: Android 扩展
+title: 扩展 Android 的功能
 type: guide
 group: 扩展
 order: 6.2
 version: 2.1
 ---
 
-# Android 扩展
+<!-- toc -->
 
 Weex 提供了扩展机制，可以根据自己的业务进行定制自己的功能。
 主要分为两类扩展：

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/extend-ios.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/extend-ios.md b/source/cn/guide/extend-ios.md
index 3b9ba70..992336a 100644
--- a/source/cn/guide/extend-ios.md
+++ b/source/cn/guide/extend-ios.md
@@ -1,16 +1,16 @@
 ---
-title: iOS 扩展
+title: 扩展 iOS 的功能
 type: guide
 group: 扩展
 order: 6.3
 version: 2.1
 ---
 
-## 注意
+<!-- toc -->
 
-**Weex 所有暴露给  JS 的内置 module 或 component API 都是安全和可控的， 它们不会去访问系统的私有 API ，也不会去做任何 runtime 上的 hack 更不会去改变应用原有的功能定位。**
-
-**如果需要扩展自定义的 module 或者 component ，一定注意不要将 OC 的 runtime 暴露给 JS ， 不要将一些诸如 `dlopen()`， `dlsym()`， `respondsToSelector:`，`performSelector:`，`method_exchangeImplementations()` 的动态和不可控的方法暴露给JS， 也不要将系统的私有API暴露给JS**
+> **注意**：**Weex 所有暴露给  JS 的内置 module 或 component API 都是安全和可控的， 它们不会去访问系统的私有 API ，也不会去做任何 runtime 上的 hack 更不会去改变应用原有的功能定位。**
+>
+> **如果需要扩展自定义的 module 或者 component ，一定注意不要将 OC 的 runtime 暴露给 JS ， 不要将一些诸如 `dlopen()`， `dlsym()`， `respondsToSelector:`，`performSelector:`，`method_exchangeImplementations()` 的动态和不可控的方法暴露给JS， 也不要将系统的私有API暴露给JS**
 
 ## Module 扩展
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/extend-js-framework.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/extend-js-framework.md b/source/cn/guide/extend-js-framework.md
index 1e9db01..6bdd5ab 100644
--- a/source/cn/guide/extend-js-framework.md
+++ b/source/cn/guide/extend-js-framework.md
@@ -1,12 +1,12 @@
 ---
-title: 拓展 JS framework
+title: 扩展前端框架
 type: guide
 group: 扩展
 order: 6.4
 version: 2.1
 ---
 
-# 定制自己的 JS Framework
+<!-- toc -->
 
 *这部分扩展能力还在讨论尝试中，可能随时会有调整，请留意。*
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/extend-web-render.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/extend-web-render.md b/source/cn/guide/extend-web-render.md
index db5a088..c6f1384 100644
--- a/source/cn/guide/extend-web-render.md
+++ b/source/cn/guide/extend-web-render.md
@@ -1,12 +1,12 @@
 ---
-title: HTML5 扩展
+title: 扩展 HTML5 的功能
 type: guide
 group: 扩展
 order: 6.1
 version: 2.1
 ---
 
-# 横向扩展 weex 组件
+<!-- toc -->
 
 Vue.js 本身就是一个独立的前端框架，在浏览器中完全能够不基于 Weex 容器渲染。因此，针对 Weex 平台扩展 Vue.js 的 Web 端组件，和直接使用 Vue.js 开发一个 Web 组件是一样的。具体的组件编写方法可以参考其官方文档：[组件](https://cn.vuejs.org/v2/guide/components.html) ，另外建议使用 `.vue` 格式的文件编写组件，使用方法参考：[单文件组件](https://cn.vuejs.org/v2/guide/single-file-components.html)。
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/integrate-devtool-to-android.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/integrate-devtool-to-android.md b/source/cn/guide/integrate-devtool-to-android.md
index 2db1a05..76a6a28 100644
--- a/source/cn/guide/integrate-devtool-to-android.md
+++ b/source/cn/guide/integrate-devtool-to-android.md
@@ -6,7 +6,7 @@ order: 5.4
 version: 2.1
 ---
 
-# 集成 Devtools 到 Android
+<!-- toc -->
 
 Weex Devtools 能够方便调试 Weex 页面，但此功能离不开 Native 的支持。如何让你的 App 也集成 Devtools，在本章将会详细说明 Android 端如何接入 Weex Devtools。
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/integrate-devtool-to-ios.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/integrate-devtool-to-ios.md b/source/cn/guide/integrate-devtool-to-ios.md
index 7cc6193..29aa9ed 100644
--- a/source/cn/guide/integrate-devtool-to-ios.md
+++ b/source/cn/guide/integrate-devtool-to-ios.md
@@ -6,7 +6,7 @@ order: 5.5
 version: 2.1
 ---
 
-# 集成 Devtools 到 iOS
+<!-- toc -->
 
 Weex Devtools 能够方便调试 Weex 页面，但此功能离不开 Native 的支持。如何让你的 App 也集成 Devtools，在本章将会详细说明 iOS 端如何接入 Weex Devtools。
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/integrate-to-your-app.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/integrate-to-your-app.md b/source/cn/guide/integrate-to-your-app.md
index 5c37bac..6044001 100644
--- a/source/cn/guide/integrate-to-your-app.md
+++ b/source/cn/guide/integrate-to-your-app.md
@@ -7,7 +7,7 @@ version: 2.1
 has_chapter_content: true
 ---
 
-# 集成 Weex 到已有应用
+<!-- toc -->
 
 ## 集成到 Android
 
@@ -219,26 +219,26 @@ WXSample地址
 
 - 添加依赖
 
- - 使用[CocoaPods](https://cocoapods.org/)  
+ - 使用[CocoaPods](https://cocoapods.org/)
   WeexSDK 在 cocoaPods 上最新版本 可以在[这](https://cocoapods.org/pods/WeexSDK)获取
 
   在 `Podfile` 文件中添加如下内容
-  
+
 	  ```
 	  source 'git@github.com:CocoaPods/Specs.git'
 	  target 'YourTarget' do
 	      platform :ios, '7.0'
 	      pod 'WeexSDK', '0.17.0'   ## 建议使用WeexSDK新版本
 	  end
-	  ```   
+	  ```
   打开命令行，切换到你已有项目 `Podfile` 这个文件存在的目录，执行 `pod install`，没有出现任何错误表示已经完成环境配置。
-  
+
  - 使用 [Carthage](https://github.com/Carthage/Carthage)
-    
-  可以在[这](https://github.com/apache/incubator-weex/tags)查询到当前最新的版本。  
-  在 [`Cartfile`](https://github.com/Carthage/Carthage/blob/master/Documentation/Artifacts.md#cartfile) 中添加如下内容   
-  `github "apache/incubator-weex"`  
-  在包含 `Cartfile` 文件目录的终端中执行 `carthage update`。 
+
+  可以在[这](https://github.com/apache/incubator-weex/tags)查询到当前最新的版本。
+  在 [`Cartfile`](https://github.com/Carthage/Carthage/blob/master/Documentation/Artifacts.md#cartfile) 中添加如下内容
+  `github "apache/incubator-weex"`
+  在包含 `Cartfile` 文件目录的终端中执行 `carthage update`。
   [添加 framework 到你的工程](https://github.com/Carthage/Carthage#adding-frameworks-to-an-application)
 
 #### 第二步：初始化 Weex 环境
@@ -314,23 +314,23 @@ WXSDKInstance 是很重要的一个类，提供了基础的方法和一些回调
 ### 导入 Weex SDK framework 到工程
 
   可以通过源码编译出 Weex SDK，可以在新的 feature 或者 bugfix 分支，尝试最新的 feature。
-  - 使用 git clone [Weex](https://github.com/apache/incubator-weex.git)  
-  SSH  
-	   ``` 
+  - 使用 git clone [Weex](https://github.com/apache/incubator-weex.git)
+  SSH
+	   ```
 	   git clone git@github.com:apache/incubator-weex.git
-	   ```   
-	  或者 https   
-	   ``` 
+	   ```
+	  或者 https
+	   ```
 		  git clone https://github.com/apache/incubator-weex.git
 	   ```
-    
-- 打开 WeexSDK.xcodeproj in `weex/ios/sdk`  
-  切换到如下图所示 target 
+
+- 打开 WeexSDK.xcodeproj in `weex/ios/sdk`
+  切换到如下图所示 target
   ![img](http://img1.tbcdn.cn/L1/461/1/4fe050b36e7fea52f121e73790b1fdb7ea934e97)
-  
+
 - 编译当前target，可以直接用快捷键 `⌘ + b`
 
-- 最后找到产物在 `weex/ios/sdk/Products` 目录  
+- 最后找到产物在 `weex/ios/sdk/Products` 目录
   ![img](http://img4.tbcdn.cn/L1/461/1/52594fea03ee1154845d0f897558b81b4b5bef2e)
 
 - 导入 framework 到自己工程

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/guide/set-up-env.md
----------------------------------------------------------------------
diff --git a/source/cn/guide/set-up-env.md b/source/cn/guide/set-up-env.md
index 9631079..5ca8731 100644
--- a/source/cn/guide/set-up-env.md
+++ b/source/cn/guide/set-up-env.md
@@ -7,7 +7,7 @@ version: 2.1
 has_chapter_content: true
 ---
 
-# 搭建开发环境
+<!-- toc -->
 
 使用 [dotWe](http://dotwe.org/vue) 对 Weex 尝鲜是一个不错的选择，但如果你想更专业的开发 Weex， dotWe 就不怎么够用了。本节会教你如何搭建本地开发环境进行 Weex 开发。
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/wiki/color-names.md
----------------------------------------------------------------------
diff --git a/source/cn/wiki/color-names.md b/source/cn/wiki/color-names.md
index 5298e5d..2575bb3 100644
--- a/source/cn/wiki/color-names.md
+++ b/source/cn/wiki/color-names.md
@@ -1,12 +1,12 @@
 ---
-title: 颜色名称列表
+title: 支持的颜色名称列表
 type: wiki
 group: 样式
 order: 3.4
 version: 2.1
 ---
 
-# Weex 支持的所有颜色名称
+<!-- toc -->
 
 ### 基础颜色关键词:
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/wiki/common-events.md
----------------------------------------------------------------------
diff --git a/source/cn/wiki/common-events.md b/source/cn/wiki/common-events.md
index 279b581..19a7aa2 100644
--- a/source/cn/wiki/common-events.md
+++ b/source/cn/wiki/common-events.md
@@ -6,7 +6,7 @@ order: 4.1
 version: 2.1
 ---
 
-# 通用事件
+<!-- toc -->
 
 Weex 提供了通过事件触发动作的能力，例如在用户点击组件时执行 JavaScript。下面列出了可被添加到 Weex 组件上以定义事件动作的属性：
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/wiki/common-styles.md
----------------------------------------------------------------------
diff --git a/source/cn/wiki/common-styles.md b/source/cn/wiki/common-styles.md
index 002a20c..594bdb2 100644
--- a/source/cn/wiki/common-styles.md
+++ b/source/cn/wiki/common-styles.md
@@ -6,7 +6,7 @@ order: 3.1
 version: 2.1
 ---
 
-# 通用样式
+<!-- toc -->
 
 所有 Weex 组件都支持以下通用样式规则。
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/wiki/css-units.md
----------------------------------------------------------------------
diff --git a/source/cn/wiki/css-units.md b/source/cn/wiki/css-units.md
index 4bed920..4b67ca0 100644
--- a/source/cn/wiki/css-units.md
+++ b/source/cn/wiki/css-units.md
@@ -6,7 +6,7 @@ order: 3.3
 version: 2.1
 ---
 
-# CSS 单位
+<!-- toc -->
 
 ## CSS `color` 单位
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/wiki/design-principles.md
----------------------------------------------------------------------
diff --git a/source/cn/wiki/design-principles.md b/source/cn/wiki/design-principles.md
index 8e338b4..387986c 100644
--- a/source/cn/wiki/design-principles.md
+++ b/source/cn/wiki/design-principles.md
@@ -5,3 +5,5 @@ group: Design
 order: 1.4
 version: 2.1
 ---
+
+<!-- toc -->

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/wiki/event-bubble.md
----------------------------------------------------------------------
diff --git a/source/cn/wiki/event-bubble.md b/source/cn/wiki/event-bubble.md
index b6bd083..964eab5 100644
--- a/source/cn/wiki/event-bubble.md
+++ b/source/cn/wiki/event-bubble.md
@@ -6,7 +6,9 @@ order: 4.2
 version: 2.1
 ---
 
-# 事件冒泡 <span class="api-version">v0.13+</span>
+<!-- toc -->
+
+> 仅在 <span class="api-version">v0.13</span> 及以上版本中支持。
 
 Weex 2.0 实现了 W3C 标准的事件冒泡机制。
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/wiki/faq.md
----------------------------------------------------------------------
diff --git a/source/cn/wiki/faq.md b/source/cn/wiki/faq.md
index 12c64d4..592d95f 100644
--- a/source/cn/wiki/faq.md
+++ b/source/cn/wiki/faq.md
@@ -4,10 +4,9 @@ type: wiki
 group: FAQ
 order: 8
 version: 2.1
-layout: post
 ---
 
-# 常见问题解答
+<!-- toc -->
 
 ## 如何查阅旧文档？
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/wiki/gestures.md
----------------------------------------------------------------------
diff --git a/source/cn/wiki/gestures.md b/source/cn/wiki/gestures.md
index c3f551d..f54e90c 100644
--- a/source/cn/wiki/gestures.md
+++ b/source/cn/wiki/gestures.md
@@ -6,7 +6,7 @@ order: 4.3
 version: 2.1
 ---
 
-# 手势
+<!-- toc -->
 
 *注：该功能属于实验性功能*
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/wiki/index.md
----------------------------------------------------------------------
diff --git a/source/cn/wiki/index.md b/source/cn/wiki/index.md
index b893e98..14d3372 100644
--- a/source/cn/wiki/index.md
+++ b/source/cn/wiki/index.md
@@ -7,7 +7,7 @@ chapter_title: 优势介绍
 version: 2.1
 ---
 
-# 工作原理
+<!-- toc -->
 
 ## 整体架构
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/cn/wiki/text-styles.md
----------------------------------------------------------------------
diff --git a/source/cn/wiki/text-styles.md b/source/cn/wiki/text-styles.md
index b2c6865..7b1850e 100644
--- a/source/cn/wiki/text-styles.md
+++ b/source/cn/wiki/text-styles.md
@@ -6,7 +6,7 @@ order: 3.2
 version: 2.1
 ---
 
-# 文本样式
+<!-- toc -->
 
 <span class="weex-version">v0.5+</span>
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/advanced/app-architecture.md
----------------------------------------------------------------------
diff --git a/source/guide/advanced/app-architecture.md b/source/guide/advanced/app-architecture.md
index dc0f80f..d800974 100644
--- a/source/guide/advanced/app-architecture.md
+++ b/source/guide/advanced/app-architecture.md
@@ -6,7 +6,7 @@ order: 8.5
 version: 2.1
 ---
 
-# Mobile App Architecture
+<!-- toc -->
 
 ## Today's Mobile App
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/advanced/downgrade.md
----------------------------------------------------------------------
diff --git a/source/guide/advanced/downgrade.md b/source/guide/advanced/downgrade.md
index 753fcff..b1cb3ca 100644
--- a/source/guide/advanced/downgrade.md
+++ b/source/guide/advanced/downgrade.md
@@ -6,7 +6,7 @@ order: 8.2
 version: 2.1
 ---
 
-# downgrade
+<!-- toc -->
 
 Weex 2.0 downgrade change to module，please refer to [downgrade](https://www.npmjs.com/package/@weex-project/downgrade)
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/advanced/page-architecture.md
----------------------------------------------------------------------
diff --git a/source/guide/advanced/page-architecture.md b/source/guide/advanced/page-architecture.md
index 8117536..8e408fe 100644
--- a/source/guide/advanced/page-architecture.md
+++ b/source/guide/advanced/page-architecture.md
@@ -6,7 +6,7 @@ order: 8.6
 version: 2.1
 ---
 
-# Weex Page Architecture
+<!-- toc -->
 
 A Weex page is a independent mobile page which includes UI, interaction logic, device power, lifecycle management etc.
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/advanced/path.md
----------------------------------------------------------------------
diff --git a/source/guide/advanced/path.md b/source/guide/advanced/path.md
index 898881f..a66ef99 100644
--- a/source/guide/advanced/path.md
+++ b/source/guide/advanced/path.md
@@ -7,7 +7,7 @@ version: 2.1
 has_chapter_content: true
 ---
 
-# Path
+<!-- toc -->
 
 <span class="weex-version">0.9</span>
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/advanced/use-vuex-and-vue-router.md
----------------------------------------------------------------------
diff --git a/source/guide/advanced/use-vuex-and-vue-router.md b/source/guide/advanced/use-vuex-and-vue-router.md
index 0851e18..8c1289d 100644
--- a/source/guide/advanced/use-vuex-and-vue-router.md
+++ b/source/guide/advanced/use-vuex-and-vue-router.md
@@ -6,7 +6,7 @@ order: 8.4
 version: 2.1
 ---
 
-# Using Vuex and vue-router
+<!-- toc -->
 
 Vue.js has many peripheral technology products such as [Vuex](https://github.com/vuejs/vuex) and [vue-router](https://github.com/vuejs/vue-router), those libraries can also work well on Weex.
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/create-a-plugin.md
----------------------------------------------------------------------
diff --git a/source/guide/create-a-plugin.md b/source/guide/create-a-plugin.md
index 8f57ab9..fe3753a 100644
--- a/source/guide/create-a-plugin.md
+++ b/source/guide/create-a-plugin.md
@@ -6,6 +6,8 @@ order: 6.1
 version: 2.1
 ---
 
+<!-- toc -->
+
 The weex plugin development kit is designed to help developers build weex plugins quickly and easily, allowing them to integrate native functionality without changing business code.
 
 The plugin abstracts a functionality and/or component to the rest of the app by including the specific implementation for each target platform ([Web](#web), [Android](#android) and [iOS](#ios)) and exposing it through a common API.

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/extend-android.md
----------------------------------------------------------------------
diff --git a/source/guide/extend-android.md b/source/guide/extend-android.md
index 49ce76d..b8e04ea 100644
--- a/source/guide/extend-android.md
+++ b/source/guide/extend-android.md
@@ -5,12 +5,14 @@ group: Extend
 order: 6.3
 version: 2.1
 ---
-# Android extend
-  Weex supports module-extend、component-extend and adapter-extend.
+
+<!-- toc -->
+
+Weex supports module-extend、component-extend and adapter-extend.
 
 ## Module extend
 
-1. Customize modules class must extend from WXModule. 
+1. Customize modules class must extend from WXModule.
 2. Extended method must add @JSMethod (uiThread = false or true) annotation, which determines whether the method is run on UI thread.
 3. The access level of method must be `public`.
 4. Do not obfuscate code using tools like ProGuard.
@@ -22,13 +24,13 @@ Refer to the following example:
 ```java
 public class MyModule extends WXModule{
 
-  //run ui thread 
+  //run ui thread
   @JSMethod (uiThread = true)
   public void printLog(String msg) {
     Toast.makeText(mWXSDKInstance.getContext(),msg,Toast.LENGTH_SHORT).show();
   }
 
-  //run JS thread 
+  //run JS thread
   @JSMethod (uiThread = false)
   public void fireEventSyncCall(){
    //implement your module logic here
@@ -87,7 +89,7 @@ event.openURL("http://www.github.com",function(resp){ console.log(resp.result);
 2. Use the `@WXComponentProp(name = value(value is attr or style))` annotation to let the update of attribute or style be recognized automatically.
 3. The access levels of method must be **public**
 4. Customize can not be obfuscated by tools like ProGuard
-5. Component method with the annotation of `@JSMethod` can 
+5. Component method with the annotation of `@JSMethod` can
 7. Weex params can be int, double, float, String, Map, List, Array
 8. Register your Component by `WXSDKEngine.registerComponent`
 
@@ -132,9 +134,9 @@ Use this component in weex DSL：
 
 
 ### Extend Component Method
- WeexSDK `(0.9.5+)` support the component method that can be invoked  
+ WeexSDK `(0.9.5+)` support the component method that can be invoked
  for example：
- 
+
  ```java
  @JSMethod
  public void focus(){
@@ -161,7 +163,7 @@ Use this component in weex DSL：
 
 ## ImagedownloadAdapter
 
-Weex SDK has no image download capability, you need to implement `IWXImgLoaderAdapter`. 
+Weex SDK has no image download capability, you need to implement `IWXImgLoaderAdapter`.
 
 Refer to the following example
 ```java

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/extend-ios.md
----------------------------------------------------------------------
diff --git a/source/guide/extend-ios.md b/source/guide/extend-ios.md
index 50a3223..b897ee5 100644
--- a/source/guide/extend-ios.md
+++ b/source/guide/extend-ios.md
@@ -6,11 +6,11 @@ order: 6.4
 version: 2.1
 ---
 
-#### Notice
+<!-- toc -->
 
-**All of the exported APIs in Weex are controllable and safe, they can not access private APIs or do any system hacks at runtime,  neither can they change the primary purpose of the Application**.
-
-**If you are extending your custom modules/components,  be sure NOT to export the ability of Objective-C runtime, be sure NOT to export  dynamic and uncontrolled methods such as `dlopen()`, `dlsym()`, `respondsToSelector:`, `performSelector:`, `method_exchangeImplementations()`, be sure NOT to export any private methods. **
+> **NOTICE**: **All of the exported APIs in Weex are controllable and safe, they can not access private APIs or do any system hacks at runtime,  neither can they change the primary purpose of the Application**.
+>
+> **If you are extending your custom modules/components,  be sure NOT to export the ability of Objective-C runtime, be sure NOT to export  dynamic and uncontrolled methods such as `dlopen()`, `dlsym()`, `respondsToSelector:`, `performSelector:`, `method_exchangeImplementations()`, be sure NOT to export any private methods. **
 
 ### Module extend
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/extend-js-framework.md
----------------------------------------------------------------------
diff --git a/source/guide/extend-js-framework.md b/source/guide/extend-js-framework.md
index eebf325..4e75a0a 100644
--- a/source/guide/extend-js-framework.md
+++ b/source/guide/extend-js-framework.md
@@ -6,6 +6,8 @@ order: 6.5
 version: 2.1
 ---
 
+<!-- toc -->
+
 # Extend JS framework
 
 This part of the extension of JS framework is still in the discussion, may be adjusted at any time, please pay attention.

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/extend-web-render.md
----------------------------------------------------------------------
diff --git a/source/guide/extend-web-render.md b/source/guide/extend-web-render.md
index 8a0d627..33899ce 100644
--- a/source/guide/extend-web-render.md
+++ b/source/guide/extend-web-render.md
@@ -6,6 +6,8 @@ order: 6.2
 version: 2.1
 ---
 
+<!-- toc -->
+
 # Extend Web components
 
 Vue.js is an independent front-end framework. In the browser, you can not use the Weex container for page rendering. So, the two things are the same: (1) for the Weex platform to expand Vue.js Web components. (2) directly using Vue.js to develop a Web component. The development of components can refer to its documentation: [component](https://vuejs.org/v2/guide/components.html). It is also recommended to use the `.vue` file to write components. How to use it: [Single file component](https://vuejs.org/v2/guide/single-file-components.html).

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/integrate-devtool-to-android.md
----------------------------------------------------------------------
diff --git a/source/guide/integrate-devtool-to-android.md b/source/guide/integrate-devtool-to-android.md
index a7096fa..7138b6e 100644
--- a/source/guide/integrate-devtool-to-android.md
+++ b/source/guide/integrate-devtool-to-android.md
@@ -6,6 +6,8 @@ order: 5.4
 version: 2.1
 ---
 
+<!-- toc -->
+
 # Integrate Devtool to Android
 
 Weex devtools is a custom devtools for weex that implements Chrome Debugging Protocol inspired by Stetho, it is designed to help you quickly inspect your app and debug your JS bundle source in a Chrome web page. To make it work, at first you must integrate devtool to your App. This page will help you integrate devtool to your Android App.

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/integrate-devtool-to-ios.md
----------------------------------------------------------------------
diff --git a/source/guide/integrate-devtool-to-ios.md b/source/guide/integrate-devtool-to-ios.md
index 1899092..e47f14f 100644
--- a/source/guide/integrate-devtool-to-ios.md
+++ b/source/guide/integrate-devtool-to-ios.md
@@ -6,6 +6,8 @@ order: 5.5
 version: 2.1
 ---
 
+<!-- toc -->
+
 # Integrate Devtool to iOS
 
 Weex devtools is a custom devtools for weex that implements Chrome Debugging Protocol inspired by Stetho, it is designed to help you quickly inspect your app and debug your JS bundle source in a Chrome web page. To make it work, at first you must integrate devtool to your App. This page will help you integrate devtool to your iOS App.

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/integrate-to-your-app.md
----------------------------------------------------------------------
diff --git a/source/guide/integrate-to-your-app.md b/source/guide/integrate-to-your-app.md
index 40b347f..87c35bc 100644
--- a/source/guide/integrate-to-your-app.md
+++ b/source/guide/integrate-to-your-app.md
@@ -6,6 +6,8 @@ order: 1.3
 version: 2.1
 ---
 
+<!-- toc -->
+
 # Integrate to Your App
 
 ## Integrate to Android Platform
@@ -23,7 +25,7 @@ The keys to intergrating Weex into your Android application are the following fi
 dependencies {
     ...
     // weex sdk and fastjson
-    compile 'com.taobao.android:weex_sdk:0.5.1@aar'   
+    compile 'com.taobao.android:weex_sdk:0.5.1@aar'
     compile 'com.alibaba:fastjson:1.1.46.android'
 
     //support library dependencies
@@ -55,7 +57,7 @@ public class WXApplication extends Application {
 }
 ```
 
-[Fresco  ImageAdapter](https://github.com/apache/incubator-weex/blob/master/android/commons/src/main/java/com/alibaba/weex/commons/adapter/FrescoImageAdapter.java) [Picasso ImageAdapter](https://github.com/apache/incubator-weex/blob/master/android/commons/src/main/java/com/alibaba/weex/commons/adapter/ImageAdapter.java)  
+[Fresco  ImageAdapter](https://github.com/apache/incubator-weex/blob/master/android/commons/src/main/java/com/alibaba/weex/commons/adapter/FrescoImageAdapter.java) [Picasso ImageAdapter](https://github.com/apache/incubator-weex/blob/master/android/commons/src/main/java/com/alibaba/weex/commons/adapter/ImageAdapter.java)
 
 4. Create an WXSDKInstance,  add IWXRenderListener and activity lifecycle on it. load weex bundle url. when  page load success; target view will be send for you on  onViewCreated callback, set target view to activity contentView.
 
@@ -138,7 +140,7 @@ Before proceeding, make sure that the Podfile file is under the project file. If
 - using [CocoaPods](https://cocoapods.org/)
 	WeexSDK The latest version on cocoaPods can be obtained [here](https://cocoapods.org/pods/WeexSDK) .
 	Add the following to the Podfile file:
-	
+
 	```object-c
 	source 'git@github.com:CocoaPods/Specs.git'
 	target 'YourTarget' do
@@ -147,10 +149,10 @@ Before proceeding, make sure that the Podfile file is under the project file. If
 	end
 	```
 	Open the command line, switch to the directory of the Podfile file, and run the pod install command. If there are no errors, it means that the environment has been configured.
-- using [Carthage](https://github.com/Carthage/Carthage)  
-  [here](https://github.com/apache/incubator-weex/tags) you can get the latest version of WeexSDK. 
+- using [Carthage](https://github.com/Carthage/Carthage)
+  [here](https://github.com/apache/incubator-weex/tags) you can get the latest version of WeexSDK.
   Add `github "apache/incubator-weex"` to [`Cartfile`](https://github.com/Carthage/Carthage/blob/master/Documentation/Artifacts.md#cartfile)
-  Open the command line, switch to the directory of the Cartfile, and run `carthage update`.  
+  Open the command line, switch to the directory of the Cartfile, and run `carthage update`.
   [Add Carthage build framework to your project](https://github.com/Carthage/Carthage#adding-frameworks-to-an-application)
 
 
@@ -220,30 +222,30 @@ In the dealloc phase of the viewController destroyed Weex instance, can play a r
 
 The Weex SDK can be compiled from the source code. You can try the latest feature in the new feature or bugfix branch.
 
-- clone [Weex](https://github.com/apache/incubator-weex.git) project  
+- clone [Weex](https://github.com/apache/incubator-weex.git) project
   you can use SSH
-  
+
 	```
 	git clone git@github.com:apache/incubator-weex.git
 	```
-  or use https   
-  
+  or use https
+
 	```
 	git clone https://github.com/apache/incubator-weex.git
 	```
-  	    
-- open WeexSDK.xcodeproj in `weex/ios/sdk`  
-  switch target just below  
+
+- open WeexSDK.xcodeproj in `weex/ios/sdk`
+  switch target just below
   ![img](http://img1.tbcdn.cn/L1/461/1/4fe050b36e7fea52f121e73790b1fdb7ea934e97)
-  
+
 - Build this project or just use the xcode default hot key `⌘ + b`
 
 - Finally you can find `Products` directory in `weex/ios/sdk`, `WeexSDK.framework` was here
   ![img](http://img4.tbcdn.cn/L1/461/1/52594fea03ee1154845d0f897558b81b4b5bef2e)
-  
+
 - Add `js-framework`(which is in the `WeexSDK.framework` and renamed to `native-bundle-main.js`) to your main bundle
   ![img](http://img1.tbcdn.cn/L1/461/1/bb3998595bafe9c9336411160c0b6bd3eeb843ef)
 - Import the framework you get above and import system framework
-  ![img](http://img1.tbcdn.cn/L1/461/1/ce309c54c7b3dd3607d7a3d07c44bfd0e0e10f86) 
+  ![img](http://img1.tbcdn.cn/L1/461/1/ce309c54c7b3dd3607d7a3d07c44bfd0e0e10f86)
 - add `-ObjC` to your project settings,just like this
 ![img](http://img3.tbcdn.cn/L1/461/1/430ae522f5031ff728c95efea49219a11e6852b3)

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/guide/set-up-env.md
----------------------------------------------------------------------
diff --git a/source/guide/set-up-env.md b/source/guide/set-up-env.md
index 498541b..755edd2 100644
--- a/source/guide/set-up-env.md
+++ b/source/guide/set-up-env.md
@@ -6,6 +6,8 @@ order: 5.1
 version: 2.1
 ---
 
+<!-- toc -->
+
 # Setup Develop Environment
 
 Using [dotWe](http://dotwe.org/vue) is a good choice, but if you want to develop locally on your own machine, you will need to set up your develop environment.
@@ -71,7 +73,7 @@ It will open the preview server automaticly, if you just want to see the web sit
 | —— configs
   | —— config.js                  global config of webpack
   | —— helper.js                  helper functions
-  | —— logo.png                   
+  | —— logo.png
   | —— plugin.js                  script for compile plugins
   | —— utils.js                   tool functions
   | —— vue-loader.conf.js         loader config of weex
@@ -96,8 +98,8 @@ It will open the preview server automaticly, if you just want to see the web sit
 | —— android.config.json          configuration for packing android project
 | —— ios.config.json              configuration for packing ios project
 | —— npm-shrinkwrap.json          npm dependence lock file
-| —— package.json                 
-| —— README.md                    
+| —— package.json
+| —— README.md
 | —— webpack.config.js            entry file of the webpack command
 
 ```

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/wiki/color-names.md
----------------------------------------------------------------------
diff --git a/source/wiki/color-names.md b/source/wiki/color-names.md
index 9e246bc..d46d490 100644
--- a/source/wiki/color-names.md
+++ b/source/wiki/color-names.md
@@ -6,7 +6,7 @@ order: 3.4
 version: 2.1
 ---
 
-# List of the names of colors
+<!-- toc -->
 
 ### Basic color keywords:
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/wiki/common-events.md
----------------------------------------------------------------------
diff --git a/source/wiki/common-events.md b/source/wiki/common-events.md
index f07c7a8..0753e8a 100644
--- a/source/wiki/common-events.md
+++ b/source/wiki/common-events.md
@@ -6,7 +6,7 @@ order: 4.1
 version: 2.1
 ---
 
-# Common Events
+<!-- toc -->
 
 Weex provide the ability to let events trigger action, like starting a JavaScript when a user click on a component. Bellow are the common event attributes that can be added to weex components to define event actions.
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/wiki/common-styles.md
----------------------------------------------------------------------
diff --git a/source/wiki/common-styles.md b/source/wiki/common-styles.md
index 0c77d8d..077c851 100644
--- a/source/wiki/common-styles.md
+++ b/source/wiki/common-styles.md
@@ -1,12 +1,12 @@
 ---
-title: Common Style
+title: Common Styles
 type: wiki
 group: Style
 order: 3.1
 version: 2.1
 ---
 
-# Common Style
+<!-- toc -->
 
 All of weex tags share some common style rules
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/wiki/css-units.md
----------------------------------------------------------------------
diff --git a/source/wiki/css-units.md b/source/wiki/css-units.md
index b087e32..ff35300 100644
--- a/source/wiki/css-units.md
+++ b/source/wiki/css-units.md
@@ -6,6 +6,6 @@ order: 3.3
 version: 2.1
 ---
 
-# CSS Units
+<!-- toc -->
 
 Work in progresss.

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/wiki/design-principles.md
----------------------------------------------------------------------
diff --git a/source/wiki/design-principles.md b/source/wiki/design-principles.md
index b223c34..72ac347 100644
--- a/source/wiki/design-principles.md
+++ b/source/wiki/design-principles.md
@@ -5,3 +5,5 @@ group: Design
 order: 1.4
 version: 2.1
 ---
+
+<!-- toc -->

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/wiki/event-bubble.md
----------------------------------------------------------------------
diff --git a/source/wiki/event-bubble.md b/source/wiki/event-bubble.md
index b8aefa4..261266a 100644
--- a/source/wiki/event-bubble.md
+++ b/source/wiki/event-bubble.md
@@ -6,6 +6,8 @@ order: 4.2
 version: 2.1
 ---
 
+<!-- toc -->
+
 # Event Bubble <span class="api-version">v0.13+</span>
 
 Weex 2.0 implements the W3C standard event bubbling mechanism.

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/wiki/faq.md
----------------------------------------------------------------------
diff --git a/source/wiki/faq.md b/source/wiki/faq.md
index 1d71661..bdaf2b2 100644
--- a/source/wiki/faq.md
+++ b/source/wiki/faq.md
@@ -6,7 +6,7 @@ order: 8
 version: 2.1
 ---
 
-# FAQ
+<!-- toc -->
 
 ## Where are legacy docs?
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/wiki/gestures.md
----------------------------------------------------------------------
diff --git a/source/wiki/gestures.md b/source/wiki/gestures.md
index 9e0f7b3..6a4574e 100644
--- a/source/wiki/gestures.md
+++ b/source/wiki/gestures.md
@@ -6,7 +6,7 @@ order: 4.3
 version: 2.1
 ---
 
-# Gesture
+<!-- toc -->
 
 > Experiment Feature
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/wiki/index.md
----------------------------------------------------------------------
diff --git a/source/wiki/index.md b/source/wiki/index.md
index 274e195..6157d04 100644
--- a/source/wiki/index.md
+++ b/source/wiki/index.md
@@ -6,7 +6,7 @@ order: 1.1
 version: 2.1
 ---
 
-# How it works
+<!-- toc -->
 
 ## Overall Structure
 

http://git-wip-us.apache.org/repos/asf/incubator-weex-site/blob/1e3bd403/source/wiki/text-styles.md
----------------------------------------------------------------------
diff --git a/source/wiki/text-styles.md b/source/wiki/text-styles.md
index 740f5f6..e1b7d90 100644
--- a/source/wiki/text-styles.md
+++ b/source/wiki/text-styles.md
@@ -6,6 +6,8 @@ order: 3.2
 version: 2.1
 ---
 
+<!-- toc -->
+
 Text alike components share some common style rules. The text alike components currently includes [`text`](./components/text.html) and [`input`](./components/input.html).
 
 ## Properties