volksbright / document-standard-vue Goto Github PK

中文文档

英文文档

list.md文件里是有这一节的，就是不知道为什么中文文档里没有显示出来

注释里本意是输出对应的内容，原本内容是英文，注释输出却翻译成了中文，有点混淆感
Vue.component('example', { template: '<span>{{ message }}</span>', data: function () { return { message: '没有更新' } }, methods: { updateMessage: function () { this.message = '更新完成' console.log(this.$el.textContent) // => '没有更新' this.$nextTick(function () { console.log(this.$el.textContent) // => '更新完成' }) } } })

在此收集具体 建议与说明

• 希望大家看清楚需要合并的分支，为vuefe vuejs.org/2.0-cn 分支，不要向vuejs 官方分支发起合并请求，也不要向 vuefe vuejs.org/master 分支发起合并请求，谢谢。
• 两个汉字之间的英文，请加空格，中文文档标点用中文格式，英文文档用英文格式。

新版本默认就是webpack2.0的模板了
应该改成
"$ vue init webpack my-project"

建议汇总：#48
vuejs 1.x 中文翻译规范
请贡献者加群：543531677

说明

参与：

• 如果你看到错别字、漏译、错译，请直接提交 pr
  （帮助）。
• 如果你看到网站问题，或者创建一个 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时）

校对

认领说明

• 校对前，请在此回复认领
• 认领格式 ：
  • 未完成
    • 我校对 + 文档序号
• markdown语法 - 示例

- [ ] 我校对 `1`

• 完成后，打钩表示完成，并附带 发起的合并请求链接
  • 我校对 + 文档序号 + #65 (发起的合并请求链接)
• markdown语法 - 示例

- [x] 我校对 + `1 ` https://github.com/vuefe/vuejs.org/pull/65  (发起的合并请求链接)

• 支持多人协作翻译，冲突可以解决，认领过的，如果你觉着他太慢，可以再次认领，加速翻译，知道大家都是牺牲业余时间来贡献，所以慢也是可以理解的，慢就需要大家一起帮帮忙了！谢谢。

以下所有文档所在目录为 src/guide/xxx.md

校对进度

Essentials 基础

Advanced 进阶

Migration 迁移

Meta 更多

建议汇总：#48

说明

参与：

• 如果你看到错别字、漏译、错译，请直接提交 pr
  （帮助）。
• 如果你看到网站问题，或者创建一个 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时）

校对

• 校对 同时校对 格式， 标点符号 格式等，遵循翻译要求

认领说明

• 校对前，请在此回复认领
• 认领格式 ：
  • 未完成
    • 我校对 + 文档序号
• markdown语法 - 示例

- [ ] 我校对 `1`

• 完成后，打钩表示完成，并附带 发起的合并请求链接
  • 我校对 + 文档序号 + #65 (发起的合并请求链接)
• markdown语法 - 示例

- [x] 我校对 + `1 ` https://github.com/vuefe/vuejs.org/pull/65  (发起的合并请求链接)

• 支持多人协作翻译，冲突可以解决，认领过的，如果你觉着他太慢，可以再次认领，加速翻译，知道大家都是牺牲业余时间来贡献，所以慢也是可以理解的，慢就需要大家一起帮帮忙了！谢谢。

文档所为 src/api/index.md

API 校对进度

我看所有qq群都满了 所以还是在这里提个issue吧

应该把链接地址由
"http://vuefe.cn/router/api/route-object.md"
改成
"http://vuefe.cn/router/api/route-object.html"

在vue的github主页里下载了vue-router的软码 然后想在没有网或者网络不好是看本地的文档，npm install 等一系列的操作都是按照readme来的 其中也按照readme要求全局安装了gitbook-cli 然后运行npm run docs

结果是这个样子

我运行gitbook install 提示nothing to install

请问怎么解决这个问题呢，知道怎么解决的 麻烦指点一下

http://vuex.vuejs.org/en/actions.html
大家帮忙看看这两句怎么翻译。
1.Note we are performing a flow of asynchronous operations, and recording the side effects (state mutations) of the action by committing them.
2.It's possible for a store.dispatch to trigger multiple action handlers in different modules. In such a case the returned value will be a Promise that resolves when all triggered handlers have been resolved.

我是这么翻译的
1.注意，我们正在执行异步操作流程，并记录对 action 提交异步操作造成的副作用（状态变化）。
2.store.dispatch 可能会在多个模块中，触发多个 action 回调函数。在这种情况下，当所有触发的回调函数都处于 resolved 状态，返回值将是 resolve 状态的 Promise。（我有点搞不清这里的resolve是解决，还是指Promise的状态）

勾三股四大神的建议：

1. 注意我们执行的是一个异步操作的流程，并通过提交 action 来记录其副作用 (状态变化)。
2. store.dispatch 可能会在不同模块中触发多个 action 回调。在这种情况下，返回值是一个 Promise 对象，该对象在所有被触发的回调都 resolve 之后自己再 resolve。

line 94, 四句话结尾都是 [ 的 ]
line 109-130, 首行缩进不一致，会导致代码对齐不一致
line 135, [ 的 ] 过多
line 244, 不需要的换行
line 277, 不必要的结尾 [ 的 ]

文档的小标题z-index值大，覆盖了其上方的内容，使得每次点击其上方的内容时，都会点击到小标题上。
我的解决方法是打开页面后在该标题的class里面加入z-index:1; 请解决这个问题。

https://vuefe.cn/guide/migration.html#Vue-directive-39-on-39-keyCodes-弃用

$dispatch 和 $broadcast 弃用:

‘然后再组件中，可以使用 $emit, $on, $off 分别来分发、监听、取消监听事件：’

这个再字应该是在吧

• 目前文档内容，基本完善，保留了 Vue 官方风格以及阅读体验，当然还缺乏一个搜索插件的接入。
• 但我更希望我们能更进一步为文档贡献我们的代码能力。

我的一点想法

• 添加搜索插件支持静态站搜索 ，如 vue 官方所用搜索插件
• 添加全文热点功能，类似应用 - 白板 可以点击位置进行交互，或者段落热点交互功能，类似 leancloud文档有的每个段落都可以进行发言交互，
• 你们觉着呢？

Guide的进阶部分中，过渡的-CSS-类名，CSS过渡和CSS动画出现严重的翻译版本滞后问题，主要集中在2.1.8版本之后对于v-enter-to和v-leave-to两个类的支持。

RT common.js

文档地址：http://vuefe.cn/examples/grid-component.html
发布地址： http://vuefe.cn
官方文档仓库：http://vuejs.org/guide/
翻译文档仓库：https://github.com/vuefe/vuejs.org

• 加QQ群参与翻译: 427447379
• 翻译Guide认领
• 翻译API认领
• 翻译指引

说明

• 翻译前，请在此回复认领
• 认领格式 ：
  • 未完成
    • 我翻译 + 文档序号
• markdown语法 - 示例

- [ ] 我翻译 `1`

• 完成后，打钩表示完成，并附带 发起的合并请求链接
  • 我翻译 + 文档序号 + #65 (发起的合并请求链接)
• markdown语法 - 示例

- [x] 我翻译 + `1 ` https://github.com/vuefe/vuejs.org/pull/65  (发起的合并请求链接)

• 支持多人协作翻译，冲突可以解决，认领过的，如果你觉着他太慢，可以再次认领，加速翻译，知道大家都是牺牲业余时间来贡献，所以慢也是可以理解的，慢就需要大家一起帮帮忙了！谢谢。

认领

直接认领就可以了，内容不多

文档在 src/examples/xx.md 目录下

进度

• Markdown Editor
• GitHub Commits
• Firebase + Validation
• Grid Component
• Tree View
• SVG Graph
• Modal Component
• Elastic Header
• Wrapper Component
• TodoMVC
• HackerNews Clone

后续

• 我们可以自己做点示例放到这个位置来分享，有兴趣的回复下讨论看看。

如图：

因为：

HTTPS is not supported for GitHub Pages using custom domains.

Ref https://help.github.com/articles/securing-your-github-pages-site-with-https/

原文 ：vuejs/vue#2873

可以参考官方网站的样式。。。
现在这个字体看代码不太舒服。。。

最近团队讨论了一下，Ajax 本身跟 Vue 并没有什么需要特别整合的地方，使用 fetch polyfill 或是 axios、superagent 等等都可以起到同等的效果，vue-resource 提供的价值和其维护成本相比并不划算，所以决定在不久以后取消对 vue-resource 的官方推荐。已有的用户可以继续使用，但以后不再把 vue-resource 作为官方的 ajax 方案。

这里可以去掉 vue-resource，文档也不必翻译了。

这里汇聚了所有参与翻译&校对的人员名单（包括提过pull request被merge）。

此页面会持续更新。

Guide部分

Essentials 基础

Advanced 进阶

Migration 迁移

Meta 更多

API 部分

example 部分

贡献者 lindazhang102

vuex部分

所有参与校对人员名单：

再次感谢所有为 Vue2.0 翻译做出贡献的人。

如有遗漏或者问题请及时回复。

这样翻译比较好：
Vue.js（读音 /vjuː/, 类似于 view）是一个构建数据驱动的 web 界面的库。Vue.js 的目标是通过尽可能简单的 API 实现响应的数据绑定和组合的视图组件。

翻译：
computed: mapState([
// 映射 state.count 到 store.this.count
'count'
])
是不是应该是：
computed: mapState([
// 映射 store.state.count 到 this.count
'count'
])

https://vuefe.cn/v2/guide/components.html#Circular-References-Between-Components

https://vuefe.cn/v2/guide/migration.html#Two-Way-Filters-replaced

https://vuefe.cn/v2/api/#errorHandler

vue-router2相关文档都已经完成了，但是vuex怎么没有呢，是考虑vue不是必须升级所以才延缓翻译么

#184

网址： http://vuefe.cn
加QQ群贡献: 427447379

认领说明

• 翻译前，请在此回复认领
• 认领格式 ：
  • 未完成
    • 我翻译 + 文档序号
• markdown语法 - 示例

- [ ] 我翻译 `1`

• 完成后，打钩表示完成，并附带 发起的合并请求链接
  • 我翻译 + 文档序号 + #65 (发起的合并请求链接)
• markdown语法 - 示例

- [x] 我翻译 + `1 ` https://github.com/vuefe/vuejs.org/pull/65  (发起的合并请求链接)

• 支持多人协作翻译，冲突可以解决，认领过的，如果你觉着他太慢，可以再次认领，加速翻译，知道大家都是牺牲业余时间来贡献，所以慢也是可以理解的，慢就需要大家一起帮帮忙了！谢谢。

以下所有文档所在目录为 src/guide/xxx.md

翻译进度

Essentials 基础

Advanced 进阶

Migration 迁移

Meta 更多

网站上的倒是能搜索到，不过github上项目介绍的群号搜索不到。

303153139 -- 这个群已经满人了（2K）

现在开了个新群，也是两千人的；

希望可以吸引一群想学或者想折腾vue的人来；促进vue的普及

群号：426241817

发布地址： http://vuefe.cn
官方文档仓库：http://vuejs.org/guide/
翻译文档仓库：https://github.com/vuefe/vuejs.org

• 加QQ群参与翻译: 427447379
• 翻译Guide认领
• 翻译API认领
• 翻译指引

说明

• 翻译前，请在此回复认领
• 认领格式 ：
  • 未完成
    • 我翻译 + 文档序号
• markdown语法 - 示例

- [ ] 我翻译 `1`

• 完成后，打钩表示完成，并附带 发起的合并请求链接
  • 我翻译 + 文档序号 + #65 (发起的合并请求链接)
• markdown语法 - 示例

- [x] 我翻译 + `1 ` https://github.com/vuefe/vuejs.org/pull/65  (发起的合并请求链接)

• 支持多人协作翻译，冲突可以解决，认领过的，如果你觉着他太慢，可以再次认领，加速翻译，知道大家都是牺牲业余时间来贡献，所以慢也是可以理解的，慢就需要大家一起帮帮忙了！谢谢。

关于 API 翻译说明

• 文中多次使用的几个词，请大家保持一致的翻译，参考了 vue1.x 翻译
  • Type => 类型
  • See also => 另见
  • Details => 详细
  • Options => 选项
  • Example => 示例
  • Restriction => 限制
  • default => 默认值
  • Props => 特性
  • prop => 特性 （在 props 是指 一个 API 时候，不要翻译成中文）
    
• 冒号 使用中文输入法下的，之前如有问题的，可以修改下。

以下小节均在 src/api/index.md 一个文档中

API翻译进度

migration.html
migration-vue-router.html
migration-vuex

翻译迁移相关文档时，看到都有这几个词，建议规范：

• deprecated -> 废弃/弃用
• migration guide -> 迁移指南
• migration helper -> 迁移工具/迁移助手
• Upgrade Path -> 升级方式/升级路径

大家讨论下用哪个词比较好

• 担心可能有人推了修改，但未领取，落下了，在此罗列下，最好自己发个言并附上自己的贡献pr链接，谢谢

基础环境

• node lastest
• npm lastest
• npm i -g hexo
• git bash

主要步骤

• github fork 仓库代码到自己的账号下
• git clone fork 的仓库代码到本地
• 进入项目目录 ，npm install 安装依赖
• hexo s 启动项目，浏览器打开 localhost:4000 查看当前文档情况，已支持browsersync热加载 ，可边改边看
• 然后用自己喜欢的编辑器，比如sublime text 3 打开项目目录，找到 src/guide 目录 , 也就是当前文档翻译的目录，根据github 仓库中，认领issue中对照文件名.md ，认领自己打算翻译的内容，然后打开该文件就可以进行翻译了！
  
• 翻译完后，使用git 提交更新到自己的仓库，后，在https://github.com/vuefe/vuejs.org/pulls 提交合并请求
  
• • 希望大家看清楚需要合并的分支，为vuefe vuejs.org/2.0-cn 分支，不要向vuejs 官方分支发起合并请求，也不要向 vuefe vuejs.org/master 分支发起合并请求，谢谢。
• 在QQ群里呼叫群主，合并请求
• 群主合并内容，并记录贡献， 更新在线静态站内容

新增文档

认领方式

• 参考之前认领方式

https://github.com/vuejs/vuex/tree/dev

• 目前 vuex 2.0 只有英文版

http://vuefe.cn/guide/syntax.html

浏览器：Safari
浏览器版本：10.0.1
控制台提示：TypeError: null is not an object (evaluating 't.offsetParent')

目前问题

• 腾讯QQ、QQ浏览器、腾讯管家，会报网站危险，好像就是 /about 页面的事情，可能是获取github链接太多
• 微信中已经完成封掉了 vuefe.cn
• 是否需要把静态站放到 国内托管？ coding ? 七牛？LeanCloud?
• 出现问题的，请帮忙截图回复，我们一起来看看情况

vuex完事之后，预计还会翻译vue-resource、vue-loader、awesome-vue、ssr吧。

希望加入webpack官网翻译，以及前端相关书籍的翻译。

推荐优先翻译下面的热门书籍
https://leanpub.com/understandinges6
understanding es6
Nicholas C.Zakas著

https://leanpub.com/vuejs
The Majesty Of Vue.js
Alex Kyriakidis, Kostas Maniatis and Evan You

https://leanpub.com/exploring-es6
Exploring ES6
Axel Rauschmayer
这些书感觉都不错。感觉人多的话一本书一两个季度

嗨，想问问怎么做贵网站的赞助商
我的微信是shenjiadong920312，TEL 18221709804

建议汇总：#48
翻译规范

• 特别说明：
  • 如果遇到 xx.md 形式的链接，请改为 xx.html ，即可使链接生效
  • 参考Guide 最后添加原文链接的方法，添加原文链接到每篇文字最后

认领说明

• 翻译前，请先阅读翻译规范，后回复认领
• 认领格式 ：
  • 未完成
    • 我翻译 + 文档序号
• markdown语法 - 示例

- [ ] 我翻译 `1`

• 完成后，打钩表示完成，并附带 发起的合并请求链接
  • 我翻译+ 文档序号 + #65 (发起的合并请求链接)
• markdown语法 - 示例

- [x] 我翻译 + `1 ` https://github.com/vuefe/vuejs.org/pull/65  (发起的合并请求链接)

• 支持多人协作翻译，冲突可以解决，认领过的，如果你觉着他太慢，可以再次认领，加速翻译，知道大家都是牺牲业余时间来贡献，所以慢也是可以理解的，慢就需要大家一起帮帮忙了！谢谢。

以下所有文档所在目录为 src/vuex/xx.md

vuex 2.0 翻译进度

1：https://vuefe.cn/v2/guide/components.html#Scoped-Slots
2：https://vuefe.cn/v2/guide/components.html#Circular-References-Between-Components

vuefe.github.io 此仓库的 2.0-cn 分支，被推送为 Vue 官方中文翻译，官方 cn 仓库链接： cn.vuejs.org 。

小伙伴们有什么翻译问题，或者是新增翻译内容，还是希望能提交 pr 到本仓库，我们会每天merge并推送至官方仓库 cn.vuejs.org 。此事由 dingyiming 负责。

vuefe.github.io 此仓库会实时同步官方 en 站点内容，保持同步更新。

官方 cn 站点的内容会比这个仓库的略慢一点，而且内容会比这仓库少一点，但会更官方正式一点。

如果有任何翻译疑问，或者是不准确的地方，也可以直接 fork 官方仓库，并及提交 pr 。

看了一下官方使用的是'Roboto Mono', Monaco, courier, monospace;，感觉这个代码字体更自然一点。

链接：https://vuefe.cn/support-vuejs/
缺少：/images/weixinpay.png /images/qcode.png /js/money.js

when using Passing-Data-with-Props https://vuejs.org/v2/guide/components.html#Passing-Data-with-Props, I found that when I using <child-component :prop="symbol()" @add="count"> </child-component> in the parent component, I meet an error:[Vue warn]: Property or method "Symbol" is not defined

已经提交 pr #273

typescript.md有一句文字错误，Raw后第68行。