Merge pull request #3 from yongbolv/master

Master

Author: yongbolv

README.md

@@ -1,40 +1,161 @@
-# vue.js 2.0 正式版 中文翻译文档（正在进行中...） http://vuefe.cn
+## vue.js 2.0 中文文档 http://vuefe.cn
 
-> 基于 hexo && vuejs.org
-> 求小伙伴共同翻译，有兴趣加qq 315129552
+>（即将完成 - 急需校对） 
 
-- 中文翻译分支 2.0-cn
+## 贡献要求
 
-## 开发
+### 参与：
 
-```
-$ npm install -g hexo-cli
-$ npm install
-$ hexo server
-```
+- 加群参与 `42744737` 
+- [发布网址：vuefe.cn](http://vuefe.cn/)
+- [翻译仓库](https://github.com/vuefe/vuejs.org)，中文翻译分支 2.0-cn
+- [基础指引](https://github.com/vuefe/vuejs.org/wiki/%E5%85%B3%E4%BA%8E%E7%BF%BB%E8%AF%91---%E5%9F%BA%E7%A1%80%E6%8C%87%E5%BC%95)
+- 参与API翻译：https://github.com/vuefe/vuejs.org/issues/44
+- 参与Guide校对：https://github.com/vuefe/vuejs.org/issues/77
+- 提出建议：https://github.com/vuefe/vuejs.org/issues/48
+- 如果你看到错别字、漏译、错译，请直接提交 pr
+    （[帮助](https://help.github.com/articles/using-pull-requests/)）。
+- 如果你看到网站问题，或者创建一个 issue，或者直接提交 pr。
+- 如果你对已有翻译有异议，建议创建一个 issue 讨论。
+- 如果你想修改英文内容，请去 [vuejs.org 项目][vuejs.org]。
+- 如果你想求教 Vue.js 使用问题，请去[论坛][forum]。
+- 如果你遇到 Vue.js 的问题，请去 [vue 项目][vue]，
+    创建 issue 并提供演示。可以在 JSBin, JSFiddle, Codepen 等网站创建演示。
+
+### 翻译要求
+
+- 保持一致，清晰
+-  汉字，字母，数字等之间以一个空格隔开。
+-  中文使用中文符号，英文使用英文符号。
+- 专有词注意大小写，如 HTML，CSS，JavaScript。
+- 术语与已有译文保持一致，如果有异议请先在 issue 中讨论。
+- 代码只翻译注释。
+- 标题会转化为链接，文档其它地方可能会用到，所以标题应尽量简短，
+    在修改标题时搜索一下它是否还用在其它地方。
+    同样的，在修改文档内链接时也应搜索一下。
+- 校对后对应修改提交合并请求
+
+### 统一固定词汇翻译
+
+- Type => 类型
+- See also => 另见
+- Details => 详细
+- Options => 选项
+- Example => 示例
+- Restriction => 限制
+- default => 默认值
+- prop => 特性（是指 一个 API 时候，不要翻译成中文）
+- attribute => 特性
+- transition => 过渡
+
+### 术语翻译对照
 
-Start a dev server at `localhost:4000`
+- attribute 特性
+- transition 过渡
 
-## merge
+### 不翻译的术语
 
-- 翻译完 pull request 到 2.0-cn 分支 合并
+- getter
+- setter
+- prop（指API时）
 
-## 发布
+### 认领说明
 
-> 预先添加git ssh
+- 参与前，请在对应issue认领
+- 认领格式 ：
+  - 未完成
+     - [ ] 我校对 + `文档序号 `
 
+- markdown语法 - 示例
+
+```markdown
+- [ ] 我xx `1`
 ```
-hexo g
-hexo d
+
+  - 完成后，打钩表示完成，并附带 发起的合并请求链接
+     - [x] 我校对 + `文档序号 ` +  https://github.com/vuefe/vuejs.org/pull/65  (发起的合并请求链接)
+
+- markdown语法 - 示例
+
+```markdown
+- [x] 我xx + `1 ` https://github.com/vuefe/vuejs.org/pull/65  (发起的合并请求链接)
 ```
 
-## 当前说明（2016.09.26）
+- 支持多人协作翻译，冲突可以解决，认领过的，如果你觉着他太慢，可以再次认领，加速翻译，知道大家都是牺牲业余时间来贡献，所以慢也是可以理解的，慢就需要大家一起帮帮忙了！谢谢。
+
+
+## Guide 翻译（已全部完成）贡献 
+
+### Essentials  基础
+
+序号 | 对应文档文件名 | 中文标题  | 翻译贡献者 | 校对贡献者
+----- | ------------- | --- | --- | --- | ---
+1 | installation.md | 安装 | [dingyiming](https://github.com/dingyiming) | 
+2 | index.md |  介绍 | [hijiangtao](https://github.com/hijiangtao) | 
+3 | instance.md | 实例 |  [dingyiming](https://github.com/dingyiming) |
+4 | syntax.md  | 模板语法 | [daix6](https://github.com/daix6) | 
+5 | computed.md | 计算属 性 |  [dingyiming](https://github.com/dingyiming) | 
+6 | class-and-style.md | Class 与 Style 绑定 | [595074187](https://github.com/595074187) | 
+7 | conditional.md  | 条件渲染 | [dingyiming](https://github.com/dingyiming) | 
+8 | list.md |  列表渲染 | [tingtien](https://github.com/tingtien) | 
+9 | events.md | 事件处理器 | [dingyiming](https://github.com/dingyiming) | 
+10 | forms.md  | 表单控件绑定 | [dingyiming](https://github.com/dingyiming) | 
+11 | components.md |  组件 | [ezreally](https://github.com/ezreally) | 
+
+### Advanced  进阶
+
+序号 | 对应文档文件名 | 中文标题 | 贡献者 | 校对贡献者
+----- | ------------- | --- | --- | --- 
+12 | transitions.md | 过渡: 进入, 离开, 和 列表 | [awe](https://github.com/hilongjw) | 
+13 | transitioning-state.md | 过渡状态 |  [awe](https://github.com/hilongjw) | 
+14 | render-function.md |  Render 函数 |  [awe](https://github.com/hilongjw) | 
+15 | reactivity.md |  深入响应式原理 | [veaba](https://github.com/veaba) | 
+16 | custom-directive.md |  自定义指令 | [harrytospring](https://github.com/harrytospring) | 
+17 | mixins.md |  混合 |  [harrytospring](https://github.com/harrytospring) | 
+18 | plugins.md |  插件 | [hgcoder](https://github.com/hgcoder) | 
+19 | single-file-components.md |  单文件组件 | [ATLgo](https://github.com/ATLgo) | 
+20 | routing.md | 路由 | [dingyiming](https://github.com/dingyiming) | 
+21 | state-management.md |  状态管理 | [dear-lizhihua](https://github.com/dear-lizhihua) | 
+22 | unit-testing.md | 单元测试 | [70data](https://github.com/70data) |
+23 | ssr.md |  服务端渲染 | [dingyiming](https://github.com/dingyiming) | 　
+
+### Migration  迁移
+
+序号 | 对应文档文件名 | 中文标题 | 贡献者 | 校对贡献者
+----- | ------- | ------------- | --- | --- 
+24 | migration.md | 1.x迁移 |  [harrytospring](https://github.com/harrytospring) | 
+27 | migration-vue-router.md | vue-router 0.7.x 迁移 | [forzajuve10](https://github.com/forzajuve10) | 
+
+### Meta  更多
+
+序号 | 对应文档文件名 | 中文标题 | 贡献者 | 校对贡献者
+----- | ------- | ------------- | --- | --- 
+25 |  comparison.md |   对比其他框架 |  [yongbolv](https://github.com/yongbolv) | 
+26 |  join.md |  加入Vue.js社区 | [daix6](https://github.com/daix6) | 
+
+## API翻译（已全部完成）贡献
+
+序号 | 对应小节名称 | 中文标题  | 贡献者  | 校对贡献者
+----- | ------------- | --- | --- | --- 
+1 |  Global Config | 全局配置 |  @dear-lizhihua |  
+2 | Global API | 全局API | @dear-lizhihua | 
+3 | Options / Data | 选项 / 数据 | @dear-lizhihua | 
+4 | Options / DOM | 选项 / DOM | @ATLgo | 
+5 | Options / Lifecycle Hooks | 选项 / 生命周期钩子 | @ATLgo | 
+6 | Options / Assets | 选项 / 资源 | @dingyiming | 
+7 | Options / Misc | 选项 / 杂项 | @dingyiming  |  
+8 | Instance Properties | 实例属性 | @coolzjy | 
+9 | Instance Methods / Data | 实例方法 / 数据 | @dingyiming | 
+10 | Instance Methods / Events | 实例方法 / 事件 | @mlyknown  | 
+11 |  Instance Methods / Lifecycle | 实例方法 / 生命周期 | @mlyknown | 
+12 | Directives | 指令|   @dingyiming  | 
+13 | Special Attributes | 特殊元素 | @70data |
+14 | Built-In Components | 内置的组件  | @dear-lizhihua | 
+15 | VNode Interface | VNode接口  | @70data |
+16 | Server-Side Rendering | 服务端渲染| @70data | 
+
+## 示例翻译
+
+贡献者 ： [lindazhang102](https://github.com/lindazhang102)
 
-*  基于hexo 和vuejs.org源码
-*  翻译有些滞后，刚刚更新，希望有兴趣的小伙伴直接找我，共勉
-*  文段中英文字母与中文用空一格做间隔，有助于阅读
-*  请尽量对照 vuejs 官方 1.0 中文文档进行翻译，也可以即时看出vue1和vue2直接的区别
-*  导航上 添加了 更新 模块，用于链接到github的 release信息，后面希望单独把changelog放到 /changelog中跟进翻译每次的版本更新内容
-*  (畅想:加入热点标记功能 - 点击热点新建github 对应 issue ,话题链接 / 增强文档交互即时纠错)
-* （畅想: 首页加入弹幕交互功能）
-*  (畅想: 添加hacknews-vue2案例解析 以及更多自定义案例解析)
+## 感谢所有参与翻译的朋友们！

_config.yml

@@ -8,7 +8,7 @@ subtitle:
 description: "Reactive Components for Modern Web Interfaces"
 author: Evan You
 email:
-language:
+language: zh-CN
 
 # URL
 ## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'

src/about/apidoc.md

@@ -1,58 +1,91 @@
 ---
-title: 参与教程翻译
+title: 参与指南
 type: about
 order: 1
 ---
 
-> 官方文档仓库：http://vuejs.org/guide/
-> 翻译文档仓库：https://github.com/vuefe/vuejs.org
-
-- 加QQ群参与翻译: `427447379`
-- [翻译Guide认领](https://github.com/vuefe/vuejs.org/issues/1)
-- [翻译API认领](https://github.com/vuefe/vuejs.org/issues/44)
-- [翻译指引](https://github.com/vuefe/vuejs.org/issues/25)
-
-## 教程（guide）文档翻译进度
-
-> 以下所有文档所在目录为 `src/guide/xxx.md`
-
-### Essentials  基础
-
-序号 | 是否完成  | 对应文档文件名 | 中文标题  | 贡献者 | 认领者
------ | ------- | ------------- | --- | --- | ---
-1 | 是 |  installation.md | 安装 | @dingyiming | @dingyiming
-2 | 是 | index.md |  介绍 | @hijiangtao   | @dingyiming @hijiangtao
-3 | 是 | instance.md | 实例 |  @dingyiming | @dingyiming
-4 | × | syntax.md  | 模板语法 |  | @tingtien
-5 | 是 | computed.md | 计算属性 |  @dingyiming | @dingyiming
-6 | × | class-and-style.md | Class 与 Style 绑定 |   | @595074187
-7 | 是 |  conditional.md  | 条件渲染 | @dingyiming | @dingyiming
-8 | 是 | list.md |  列表渲染 | @tingtien | @tingtien
-9 | 是 | events.md | 事件处理器 | @dingyiming | @dingyiming
-10 | 是 |  forms.md  | 表单控件绑定 | @dingyiming | @dingyiming
-11 | × | components.md |  组件 |  | @ezreally
-
-### Advanced  进阶
-
-序号 | 是否完成  | 对应文档文件名 | 中文标题 | 贡献者 | 认领者
------ | ------- | ------------- | --- | --- | ---
-12 | 是 | transitions.md | 过渡: 进入, 离开, 和 列表 | @awe | @awe
-13 | 是 | transitioning-state.md | 过渡状态 |  @awe | @awe
-14 | 是 | render-function.md |  Render 函数 |  @awe | @awe
-15 | x | reactivity.md |  深入响应式原理 |  | @veaba
-16 | 是 | custom-directive.md |  自定义指令 | @harrytospring | @harrytospring
-17 | 是 | mixins.md |  混合 |  @harrytospring | @harrytospring
-18 | x | plugins.md |  插件 |  | @hgcoder
-19 | x | single-file-components.md |  单文件组件 |  | @ATLgo 
-20 | 是 | routing.md | 路由 | @dingyiming | @dingyiming
-21 | 是 | state-management.md |  状态管理 | @dear-lizhihua | @dear-lizhihua
-22 | 是 | unit-testing.md | 单元测试 | @70data | @70data
-23 | 是 | ssr.md |  服务端渲染 | @dingyiming | @dingyiming
-24 | x  | migration.md | 1.x迁移 |   | @harrytospring 
-
-### Meta  更多
-
-序号 | 是否完成  | 对应文档文件名 | 中文标题 | 贡献者 | 认领者
------ | ------- | ------------- | --- | --- | ---
-25 | x |  comparison.md |   对比其他框架 |   | @yongbolv @daix6
-26 | 是 |  join.md |  加入Vue.js社区 | @daix6  | @daix6 
+> 目前急需校对
+
+
+## 参与要求
+
+### 参与：
+
+> 参与请阅读 [翻译规范](https://github.com/vuefe/vuejs.org/wiki/%E7%BF%BB%E8%AF%91%E8%A7%84%E8%8C%83)
+
+- 加群参与 `42744737` 
+- [发布网址：vuefe.cn](http://vuefe.cn/)
+- [翻译仓库](https://github.com/vuefe/vuejs.org) ，中文翻译分支 2.0-cn
+- [基础指引](https://github.com/vuefe/vuejs.org/wiki/%E5%85%B3%E4%BA%8E%E7%BF%BB%E8%AF%91---%E5%9F%BA%E7%A1%80%E6%8C%87%E5%BC%95)
+- 参与API翻译：https://github.com/vuefe/vuejs.org/issues/44
+- 参与Guide校对：https://github.com/vuefe/vuejs.org/issues/77
+- 提出建议：https://github.com/vuefe/vuejs.org/issues/48
+- 如果你看到错别字、漏译、错译，请直接提交 pr
+    （[帮助](https://help.github.com/articles/using-pull-requests/)）。
+- 如果你看到网站问题，或者创建一个 issue，或者直接提交 pr。
+- 如果你对已有翻译有异议，建议创建一个 issue 讨论。
+- 如果你想修改英文内容，请去 [vuejs.org 项目][vuejs.org]。
+- 如果你想求教 Vue.js 使用问题，请去[论坛][forum]。
+- 如果你遇到 Vue.js 的问题，请去 [vue 项目][vue]，
+    创建 issue 并提供演示。可以在 JSBin, JSFiddle, Codepen 等网站创建演示。
+
+### 翻译要求
+
+- 保持一致，清晰
+-  汉字，字母，数字等之间以一个空格隔开。
+-  中文使用中文符号，英文使用英文符号。
+- 专有词注意大小写，如 HTML，CSS，JavaScript。
+- 术语与已有译文保持一致，如果有异议请先在 issue 中讨论。
+- 代码只翻译注释。
+- 标题会转化为链接，文档其它地方可能会用到，所以标题应尽量简短，
+    在修改标题时搜索一下它是否还用在其它地方。
+    同样的，在修改文档内链接时也应搜索一下。
+- 校对后对应修改提交合并请求
+
+### 统一固定词汇翻译
+
+- Type => 类型
+- See also => 另见
+- Details => 详细
+- Options => 选项
+- Example => 示例
+- Restriction => 限制
+- default => 默认值
+- prop => 特性（是指 一个 API 时候，不要翻译成中文）
+- attribute => 特性
+- transition => 过渡
+
+### 术语翻译对照
+
+- attribute 特性
+- transition 过渡
+
+### 不翻译的术语
+
+- getter
+- setter
+- prop（指API时）
+
+### 认领说明
+
+- 参与前，请在对应issue认领
+- 认领格式 ：
+  - 未完成
+     - [ ] 我校对 + `文档序号 `
+
+- markdown语法 - 示例
+
+```markdown
+- [ ] 我xx `1`
+```
+
+  - 完成后，打钩表示完成，并附带 发起的合并请求链接
+     - [x] 我校对 + `文档序号 ` +  https://github.com/vuefe/vuejs.org/pull/65  (发起的合并请求链接)
+
+- markdown语法 - 示例
+
+```markdown
+- [x] 我xx + `1 ` https://github.com/vuefe/vuejs.org/pull/65  (发起的合并请求链接)
+```
+
+- 支持多人协作翻译，冲突可以解决，认领过的，如果你觉着他太慢，可以再次认领，加速翻译，知道大家都是牺牲业余时间来贡献，所以慢也是可以理解的，慢就需要大家一起帮帮忙了！谢谢。