该仓库包含ECMAScript®语言规范当前草案(包含stage 2 - stage 4)的中文翻译,你可以在一下网站进行浏览。
中文内容为校对过得翻译内容,如有疑问请在相应的 issue 中留言。
- LN 表示文档行号
- issues 表示github的issues菜单
- pull request 表示github的pull request功能
- 排版规范我们遵从 中文文案排版指北,不规范的翻译 reviewer 有义务让翻译者重译
欢迎小伙伴们参与 ECMAScript 规范的翻译,你可以选择参与翻译,校对,审校中自己喜欢的部分贡献自己的一份热情。让我们一起为 ECMAScript 社区贡献自己的一份力。
点击右上角 “fork” 按钮,fork 此仓库到你的 github 仓库,然后在本地 pull 远程仓库即可对项目中未翻译部分进行翻译工作了。
如果你不知道哪些内容还在等待着被翻译,那你可以在 issues 中找到 待翻译的章节然后 @realywithoutname 进行修改该 issue 的状态,并把你加入到我们的翻译团队中。
现在你已经确认了翻译的 issue,你需要在你的项目根目录基于远程 translated 分支创建一个新分支,然后在 translated 文件夹的 issues-[ISSUE ID].html 文件中进行对原文进行翻译。
$ git checkout -b translate/issues-[ISSUE ID] origin/translated翻译完成以后,你还需要用译文去替换 spec.html 文件中相应的英文原文,然后执行 npm run build。记得要在浏览器中打开 out/index.html 预览翻译后的效果和预期的效果一直哦。
一切都 OK 的话,请丢弃 spec.html 文件更改内容,并提交译文,建议 commit message 写为 translated:[LN - LN] issue #ISSUE ID (为了审校时方便替换)。
$ git checkout spec.html
$ git commit -am 'translated: [LN - LN] issue #ISSUE ID'然后你就可以 push 到你的远程仓库,提交 pull request 了。
$ git push origin translate/issues-[ISSUE ID]最后你还需要关注相应 pull request,校对者会在此 pull request 提交 review 意见,你需要根据大家的意见进行修改并提交你修改的内容(不需要再次发起 pull request),直到提交被合并,对于长时间(距离issue中最后的评论时间超过三天)未被接受的 pull request 如果在相应 issue 中没有找到拒绝理由,可以直接联系 @realywithoutname 问明原因。
在 Pull requests 中选择一个 pull request 进行 review,具体的操作可参考掘金的参与校对的正确姿势,提交 review 意见,并讨论他们。
你需要做的是指出新翻译内容中错译、漏译、标点符号错误、错别字、大小写、拼写错误、单复数、动词时态、数字错误等
请点击右上角 “fork” 按钮,fork 此仓库到你的 github 仓库,然后在本地 pull 远程仓库即可对项目中已翻译内容进行审校了。
你需要在 issues 中选择审校中的 issue,并 @realywithoutname 通知该章节由你来审校
在你的项目根目录基于 cn 分支对 translated 文件夹的 issues-[ISSUE ID].html 文件中内容你觉得需要修改的地方进行修改。
修改完成后使用 npm run build 检查是否符合预期,可以对照英文对应部分进行检查。
发起相应的 pull request(建议 title 使用 checking: issue #ISSUE ID),将有人对你的修改进行 review,在被 merge 前请你对该 pull request 保持关注。
对于审校完成并被 merge 的 pull request,相应的 issue 将关闭并处于已发布状态,相应已发布 issue 可以在 projects 已发布列中查看。
被 merge 的审校 pull request 内容将被合并到 cn 分支的 spec.html 中,并被发布。
以下是关于常用一些 label 的使用和含义。
issues:
待翻译表示该 issue id 对应在 translated 目录下的文件无人进行翻译,可以认领翻译中表示该 issue id 对应在 translated 目录下的文件有人正在翻译校对中表示该 issue id 对应在 translated 目录下的文件已提交 pull request审校中表示该 issue id 对应在 translated 目录下的文件已完成翻译工作已发布表示该 issue id 对应在 translated 目录下的文件已可以在网页中查看- 其他
Pull requests:
待校对表示该 pull request 目前无人进行校对,可认领校对校对中表示该 pull request 目前有人正在进行校,可就 reviewer 的意见进行讨论拒绝校对 + 原因表示该 pull request 由于某些原因不能进入校对流程,需要翻译者根据原因作出相应修改,这样的 pull request 在一定时间内不进行修改将被关闭
如果二维码过期,请加微信号:liu762022369