|
1 |
| -# vue.js 2.0 正式版 中文翻译文档(正在进行中...) http://vuefe.cn |
| 1 | +## vue.js 2.0 中文文档 http://vuefe.cn |
2 | 2 |
|
3 |
| -> 基于 hexo && vuejs.org |
4 |
| -> 求小伙伴共同翻译,有兴趣加qq 315129552 |
| 3 | +>(即将完成 - 急需校对) |
5 | 4 |
|
6 |
| -- 中文翻译分支 2.0-cn |
| 5 | +## 贡献要求 |
7 | 6 |
|
8 |
| -## 开发 |
| 7 | +### 参与: |
9 | 8 |
|
10 |
| -``` |
11 |
| -$ npm install -g hexo-cli |
12 |
| -$ npm install |
13 |
| -$ hexo server |
14 |
| -``` |
| 9 | +- 加群参与 `42744737` |
| 10 | +- [发布网址:vuefe.cn](http://vuefe.cn/) |
| 11 | +- [翻译仓库](https://github.com/vuefe/vuejs.org),中文翻译分支 2.0-cn |
| 12 | +- [基础指引](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) |
| 13 | +- 参与API翻译:https://github.com/vuefe/vuejs.org/issues/44 |
| 14 | +- 参与Guide校对:https://github.com/vuefe/vuejs.org/issues/77 |
| 15 | +- 提出建议:https://github.com/vuefe/vuejs.org/issues/48 |
| 16 | +- 如果你看到错别字、漏译、错译,请直接提交 pr |
| 17 | + ([帮助](https://help.github.com/articles/using-pull-requests/))。 |
| 18 | +- 如果你看到网站问题,或者创建一个 issue,或者直接提交 pr。 |
| 19 | +- 如果你对已有翻译有异议,建议创建一个 issue 讨论。 |
| 20 | +- 如果你想修改英文内容,请去 [vuejs.org 项目][vuejs.org]。 |
| 21 | +- 如果你想求教 Vue.js 使用问题,请去[论坛][forum]。 |
| 22 | +- 如果你遇到 Vue.js 的问题,请去 [vue 项目][vue], |
| 23 | + 创建 issue 并提供演示。可以在 JSBin, JSFiddle, Codepen 等网站创建演示。 |
| 24 | + |
| 25 | +### 翻译要求 |
| 26 | + |
| 27 | +- 保持一致,清晰 |
| 28 | +- 汉字,字母,数字等之间以一个空格隔开。 |
| 29 | +- 中文使用中文符号,英文使用英文符号。 |
| 30 | +- 专有词注意大小写,如 HTML,CSS,JavaScript。 |
| 31 | +- 术语与已有译文保持一致,如果有异议请先在 issue 中讨论。 |
| 32 | +- 代码只翻译注释。 |
| 33 | +- 标题会转化为链接,文档其它地方可能会用到,所以标题应尽量简短, |
| 34 | + 在修改标题时搜索一下它是否还用在其它地方。 |
| 35 | + 同样的,在修改文档内链接时也应搜索一下。 |
| 36 | +- 校对后对应修改提交合并请求 |
| 37 | + |
| 38 | +### 统一固定词汇翻译 |
| 39 | + |
| 40 | +- Type => 类型 |
| 41 | +- See also => 另见 |
| 42 | +- Details => 详细 |
| 43 | +- Options => 选项 |
| 44 | +- Example => 示例 |
| 45 | +- Restriction => 限制 |
| 46 | +- default => 默认值 |
| 47 | +- prop => 特性(是指 一个 API 时候,不要翻译成中文) |
| 48 | +- attribute => 特性 |
| 49 | +- transition => 过渡 |
| 50 | + |
| 51 | +### 术语翻译对照 |
15 | 52 |
|
16 |
| -Start a dev server at `localhost:4000` |
| 53 | +- attribute 特性 |
| 54 | +- transition 过渡 |
17 | 55 |
|
18 |
| -## merge |
| 56 | +### 不翻译的术语 |
19 | 57 |
|
20 |
| -- 翻译完 pull request 到 2.0-cn 分支 合并 |
| 58 | +- getter |
| 59 | +- setter |
| 60 | +- prop(指API时) |
21 | 61 |
|
22 |
| -## 发布 |
| 62 | +### 认领说明 |
23 | 63 |
|
24 |
| -> 预先添加git ssh |
| 64 | +- 参与前,请在对应issue认领 |
| 65 | +- 认领格式 : |
| 66 | + - 未完成 |
| 67 | + - [ ] 我校对 + `文档序号 ` |
25 | 68 |
|
| 69 | +- markdown语法 - 示例 |
| 70 | + |
| 71 | +```markdown |
| 72 | +- [ ] 我xx `1` |
26 | 73 | ```
|
27 |
| -hexo g |
28 |
| -hexo d |
| 74 | + |
| 75 | + - 完成后,打钩表示完成,并附带 发起的合并请求链接 |
| 76 | + - [x] 我校对 + `文档序号 ` + https://github.com/vuefe/vuejs.org/pull/65 (发起的合并请求链接) |
| 77 | + |
| 78 | +- markdown语法 - 示例 |
| 79 | + |
| 80 | +```markdown |
| 81 | +- [x] 我xx + `1 ` https://github.com/vuefe/vuejs.org/pull/65 (发起的合并请求链接) |
29 | 82 | ```
|
30 | 83 |
|
31 |
| -## 当前说明(2016.09.26) |
| 84 | +- 支持多人协作翻译,冲突可以解决,认领过的,如果你觉着他太慢,可以再次认领,加速翻译,知道大家都是牺牲业余时间来贡献,所以慢也是可以理解的,慢就需要大家一起帮帮忙了!谢谢。 |
| 85 | + |
| 86 | + |
| 87 | +## Guide 翻译贡献 |
| 88 | + |
| 89 | +### Essentials 基础 |
| 90 | + |
| 91 | +序号 | 是否完成 | 对应文档文件名 | 中文标题 | 翻译贡献者 | 校对贡献者 |
| 92 | +----- | ------- | ------------- | --- | --- | --- | --- |
| 93 | +1 | 是 | installation.md | 安装 | [dingyiming](https://github.com/dingyiming) | |
| 94 | +2 | 是 | index.md | 介绍 | [hijiangtao](https://github.com/hijiangtao) | |
| 95 | +3 | 是 | instance.md | 实例 | [dingyiming](https://github.com/dingyiming) | |
| 96 | +4 | 是 | syntax.md | 模板语法 | [daix6](https://github.com/daix6) | |
| 97 | +5 | 是 | computed.md | 计算属 性 | [dingyiming](https://github.com/dingyiming) | |
| 98 | +6 | 是 | class-and-style.md | Class 与 Style 绑定 | [595074187](https://github.com/595074187) | |
| 99 | +7 | 是 | conditional.md | 条件渲染 | [dingyiming](https://github.com/dingyiming) | |
| 100 | +8 | 是 | list.md | 列表渲染 | [tingtien](https://github.com/tingtien) | |
| 101 | +9 | 是 | events.md | 事件处理器 | [dingyiming](https://github.com/dingyiming) | |
| 102 | +10 | 是 | forms.md | 表单控件绑定 | [dingyiming](https://github.com/dingyiming) | |
| 103 | +11 | 是 | components.md | 组件 | [ezreally](https://github.com/ezreally) | |
| 104 | + |
| 105 | +### Advanced 进阶 |
| 106 | + |
| 107 | +序号 | 是否完成 | 对应文档文件名 | 中文标题 | 贡献者 | 校对贡献者 |
| 108 | +----- | ------- | ------------- | --- | --- | --- | --- |
| 109 | +12 | 是 | transitions.md | 过渡: 进入, 离开, 和 列表 | [awe](https://github.com/hilongjw) | |
| 110 | +13 | 是 | transitioning-state.md | 过渡状态 | [awe](https://github.com/hilongjw) | |
| 111 | +14 | 是 | render-function.md | Render 函数 | [awe](https://github.com/hilongjw) | |
| 112 | +15 | 是 | reactivity.md | 深入响应式原理 | [veaba](https://github.com/veaba) | |
| 113 | +16 | 是 | custom-directive.md | 自定义指令 | [harrytospring](https://github.com/harrytospring) | |
| 114 | +17 | 是 | mixins.md | 混合 | [harrytospring](https://github.com/harrytospring) | |
| 115 | +18 | 是 | plugins.md | 插件 | [hgcoder](https://github.com/hgcoder) | |
| 116 | +19 | 是 | single-file-components.md | 单文件组件 | [ATLgo](https://github.com/ATLgo) | |
| 117 | +20 | 是 | routing.md | 路由 | [dingyiming](https://github.com/dingyiming) | |
| 118 | +21 | 是 | state-management.md | 状态管理 | [dear-lizhihua](https://github.com/dear-lizhihua) | |
| 119 | +22 | 是 | unit-testing.md | 单元测试 | [70data](https://github.com/70data) | |
| 120 | +23 | 是 | ssr.md | 服务端渲染 | [dingyiming](https://github.com/dingyiming)| |
| 121 | + |
| 122 | +### Migration 迁移 |
| 123 | + |
| 124 | +序号 | 是否完成 | 对应文档文件名 | 中文标题 | 贡献者 | 校对贡献者 |
| 125 | +----- | ------- | ------------- | --- | --- | --- |
| 126 | +24 | 是 | migration.md | 1.x迁移 | [harrytospring](https://github.com/harrytospring) | |
| 127 | +27 | 是 | migration-vue-router.md | vue-router 0.7.x 迁移 | [forzajuve10](https://github.com/forzajuve10) | |
| 128 | + |
| 129 | +### Meta 更多 |
| 130 | + |
| 131 | +序号 | 是否完成 | 对应文档文件名 | 中文标题 | 贡献者 | 校对贡献者 |
| 132 | +----- | ------- | ------------- | --- | --- | --- |
| 133 | +25 | 是 | comparison.md | 对比其他框架 | [yongbolv](https://github.com/yongbolv) | |
| 134 | +26 | 是 | join.md | 加入Vue.js社区 | [daix6](https://github.com/daix6) | |
| 135 | + |
| 136 | + |
| 137 | +## API翻译贡献 |
| 138 | + |
| 139 | +序号 | 是否完成 | 对应小节名称 | 中文标题 | 贡献者 | 校对贡献者 |
| 140 | +----- | ------- | ------------- | --- | --- | --- |
| 141 | +1 | 是 | Global Config | 全局配置 | @dear-lizhihua | |
| 142 | +2 | 是 | Global API | 全局API | @dear-lizhihua | |
| 143 | +3 | 是 | Options / Data | 选项 / 数据 | @dear-lizhihua | |
| 144 | +4 | 是 | Options / DOM | 选项 / DOM | @ATLgo | |
| 145 | +5 | 是 | Options / Lifecycle Hooks | 选项 / 生命周期钩子 | @ATLgo | |
| 146 | +6 | 是 | Options / Assets | 选项 / 资源 | @dingyiming | |
| 147 | +7 | 是 | Options / Misc | 选项 / 杂项 | @dingyiming | |
| 148 | +8 | 是 | Instance Properties | 实例属性 | @coolzjy | |
| 149 | +9 | 是 | Instance Methods / Data | 实例方法 / 数据 | @dingyiming | |
| 150 | +10 | 是 | Instance Methods / Events | 实例方法 / 事件 | @mlyknown | |
| 151 | +11 | 是 | Instance Methods / Lifecycle | 实例方法 / 生命周期 | @mlyknown | |
| 152 | +12 | 是 | Directives | 指令| @dingyiming | |
| 153 | +13 | 是 | Special Attributes | 特殊元素 | @70data | |
| 154 | +14 | 是 | Built-In Components | 内置的组件 | @dear-lizhihua | |
| 155 | +15 | 是 | VNode Interface | VNode接口 | @70data | |
| 156 | +16 | 是 | Server-Side Rendering | 服务端渲染| @70data | |
| 157 | + |
| 158 | +## 示例翻译 |
| 159 | + |
| 160 | +贡献者 : [lindazhang102](https://github.com/lindazhang102) |
| 161 | + |
32 | 162 |
|
33 |
| -* 基于hexo 和vuejs.org源码 |
34 |
| -* 翻译有些滞后,刚刚更新,希望有兴趣的小伙伴直接找我,共勉 |
35 |
| -* 文段中英文字母与中文用空一格做间隔,有助于阅读 |
36 |
| -* 请尽量对照 vuejs 官方 1.0 中文文档进行翻译,也可以即时看出vue1和vue2直接的区别 |
37 |
| -* 导航上 添加了 更新 模块,用于链接到github的 release信息,后面希望单独把changelog放到 /changelog中跟进翻译每次的版本更新内容 |
38 |
| -* (畅想:加入热点标记功能 - 点击热点新建github 对应 issue ,话题链接 / 增强文档交互即时纠错) |
39 |
| -* (畅想: 首页加入弹幕交互功能) |
40 |
| -* (畅想: 添加hacknews-vue2案例解析 以及更多自定义案例解析) |
| 163 | +## 感谢所有参与翻译的朋友们! |
0 commit comments