vuejs / docs-next-zh-cn Goto Github PK
View Code? Open in Web Editor NEW:cn: Chinese translation for v3.vuejs.org
Home Page: https://v3.cn.vuejs.org
License: MIT License
:cn: Chinese translation for v3.vuejs.org
Home Page: https://v3.cn.vuejs.org
License: MIT License
校对 typescript-support
暂译为 效果冲刷时间 #45
是否有一个更合理的翻译结果
这是否需要呢?这似乎需要调用一个 bot,@github-actions 。
@Jinjiang ,我需要移除原先的 pr.yaml
才可以继续(暂时已移除),后续需要组织授权才可以使用调用这个脚本。
否则一直报错:Only actions in "vuejs" are allowed for this repository
下面有两个bug:
app.2e9ad43d.js:6 DOMException: Failed to execute 'querySelector' on 'Document': '#%E5%A4%84%E7%90%86%E7%94%A8%E6%88%B7%E8%BE%93%E5%85%A5' is not a valid selector.
相关issue:
该bug不影响功能,只是无法触发点击h标签,无法滚动
生产环境下,主页进入起步,两个无法展开迁移侧栏菜单:从Vue 2迁移、贡献文档。(影响使用)
控制台报错。
app.2e9ad43d.js:6 DOMException: Failed to execute 'appendChild' on 'Node': This node type does not support this method.
相关issue:
https://github.com/vuejs/docs-next-zh-cn/blob/master/src/guide/migration/global-api.md#提供注入-provide--inject
在provide/inject处
app.provide({
guide: 'Vue 3 Guide'
})
应为
app.provide('guide', 'Vue 3 Guide')
https://github.com/vuejs/docs-next/blob/master/src/guide/migration/global-api.md#provide--inject
帮忙校对高级指南里的响应式原理部分
翻译 src/guide/migration/array-refs.md
reactive 译为“响应式”的话,reactivity 是不是翻译为“响应性”更好?
我摘了英文版实际例子来对比下。
例子 | 代入翻译 |
---|---|
reactive proxy | 响应式prop |
reactive state | 响应式状态 |
reactive property | 响应式 property |
reactivity tracking | 响应性追踪 |
losing reactivity | 丢失响应性 |
reactivity system | 响应性系统 |
这个术语翻译,据我所知,改动可能比较广泛,现独立 issue ,做为专门的讨论。
有一个原仓库的特性:使用了 algolia,但仅支持英文现在。
我尝试注册了 algolia
,发现需要还需要特别做搜索的 json 文件。
如果是这样,官方库做 i18n 就很麻烦,需要各个 i18n 库都需要制作自己的 json 文件来支持搜索。
————————————————————————————————
2020年9月20日:
由于中文库移除了 algolia 特性,再加上原英文仓库 变量有问题,这导致了中文仓库丢失了搜索功能,已给英文 PR 修复该问题。
本地搜索框恢复后,将会给 algolia 提交 PR,以增加 algolia 特性。
该讨论来自#49 ,现独立出来发起 issue 讨论
标点符号写在星号里面似乎不影响解析和渲染,这种情况下我们是否需要刻意并统一把标点符号移到外部?
仅当加粗 **...**
右侧有汉字时候,需要迁移到加粗符号 **
外面,但如果加粗符号 **
外无汉字,也是可以渲染的。
demo:
- **你好,**世界 // 失败
- **你好,** 世界 // 成功
- **你好**,世界 // 成功
目前有三种方法可选:
**
最后一个符号,一律移到它的右侧,如:**你好,**世界
==> **你好**,世界
**你好,世界。**
==> **你好,世界**
。**
右侧如有汉字可空格,否则原样,如:**你好,**世界
==> **你好,** 世界
**你好,**世界
==> **你好,**世界
**
最后一个符号存在且右侧存在汉字时,符号迁移到右侧,否则可保留原版,否则,如:**该钩子在服务器端渲染期间不被调用。**
世界 ==>**该钩子在服务器端渲染期间不被调用**
。 世界**该钩子在服务器端渲染期间不被调用。**
==>**该钩子在服务器端渲染期间不被调用。**
欢迎参与
Vue 3
中文文档仓库协作,在开始之前建议您阅读以下内容,非常感谢您的参与:
阅读以下内容:
从“翻译进度” 认领章节发起新的 issue:
标题格式为(精确至文件定位),如:
当你完成翻译或校对后,发起 PR
,在 PR
的讨论中,附上 issue 地址,让我们知道你此 PR 的关联 issue ,并随时在上述 issue 中报告你的翻译进度。
发现有些段落翻译晦涩难懂?
如何发起 Pull Requests
?
如何查看“我的贡献”?
新发现一个新的特性,但没有被 “翻译进度” 收录?
发起 PR
的标题?
PR
的评论中追加特性说明如果想在赞助本仓库?
如果有一个章节很长,我只翻译了一半,后续不想翻译了?
.md
文件为单位来发起 PR,避免后续来回追踪。对于有原英文有自己的见解?
对于网站架构上有自己的见解?
对于 Vue
技术的讨论?
大家好,目前 Vue 3.0 的中文文档站处在刚刚起步的状态,有大量的文档有待集中翻译和校对,也希望可以得到社区的大力支持!
所以我们创建了这个 issue 来汇总这些工作。
首先介绍一下目前文档站的状态:
如何参与本次集中翻译和校对
目前的页面有两类状态,一类是英文版,尚未翻译,另一类是已经翻译但是并未有其他人校对。
对于尚未翻译的内容
对于已经翻译但尚未校对的内容
注意可以重复校对,但我们会尽量回避大家重复翻译和过度集中校对某一篇文档,所以建议大家参与之前来这里认领一下以避免其他人重复翻译或过度校对。
翻译相关的注意事项
详见 wiki
如果大家有兴趣参与翻译和校对,欢迎创建 issue 认领相关工作!
谢谢
新手准备尝试一下✋
拉了分支,帮忙校对高级指南里的响应式、组合API 部分
链接地址
如上链接,中的MyBook.vue示例代码中注释。
// Attribute (响应式 object)
和// Slots (响应式 object)
应该译为非响应式object
properties -> priperty
认领该文件,内容不多,先找一下感觉~
在src/api/global-api中关于resolveComponent、resolveDirective的返回值的翻译应该是有问题的。
个人觉得应该是:
返回一个 Component
或没有找到时返回 undefined
返回一个 Directive
或没有找到时返回 undefined
在Effect Flush Timing
这一章,
英文文档:
When count is mutated, the callback will be called before the component has updated.
但是中文文档是:
更改 count 时,将在组件 更新后 执行副作用。
当前文档里面翻译成了 功能组件, 是否需要纠正
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.