Laravel 5.4 文档翻译召集,快来加入翻译吧
已经正式发布 公告:Laravel 5.4 正式发布
一. 翻译说明
Laravel 5.4 带来了很多非常棒的 新特性,文档翻译工作会是难得的学习 Laravel 5.4 的机会,也是大家认识朋友的一次机会。
这里是 Laravel 5.3 的翻译召集情况: 公告:Laravel 5.3 文档翻译召集 - 已完成
后续维护计划
laravel.com 官方文档会持续更新,为了保证后续的修改能更新上,我们需要不定期检查更新,目前预计这个检查的周期会是一个月~三个月一次,到时候会从翻译团队中征集人手。
二. 开始翻译
加入翻译,领取任务
--- 直接在帖子底下留言进行任务领取即可。---
以下是任务列表,会实时更新,请在此话题下留言领取任务,留言内容如:
我要认领翻译「中间件(middleware)」
注意:
- 请仔细查看「任务列表」是否任务已被别人领走,还有此话题的最近评论(有时候管理员来不及更新),为了防止多余的劳动力浪费,只能领取未认领的任务;
- 认领时会有日期标示,超过 5 天的未完成任务将会被回收。
任务列表
done.
为了更加直观,上面只显示还未翻译和正在翻译状态的任务。
三、翻译规范
规范
我们严格遵循 中文排版指南 规范,并在此之上遵守以下约定:
- 英文的左右 必须 保持一个空白,避免中英文字黏在一起;
- 必须 使用全角标点符号;
- 必须 严格遵循 Markdown 语法;
- 原文中的双引号(" ")请代换成中文的引号(「」符号怎么打出来见 这里);
- 「
加亮
」和「加粗」和「[链接]()」都需要在左右保持一个空格; - 代码注释统一要求翻译;
翻译时请特别注意规范,如果你的翻译提交不遵循排版规范,我们会很痛心的拒绝你的提交。
对照表
请必须严格按照「专有名词翻译对照表」来翻译 - https://learnku.com/docs/laravel/5.4/about#翻译对照列表 。
自定义 Markdown 语法
Laravel 5.4 文档中,有一些自定义的 Markdown 语法,请不要翻译。
这个:
> {tip}
还有这个:
> {note}
四、请基于 Laravel 5.3 翻译
Laravel 5.4 文档是在 Laravel 5.3 文档 的基础上更新的,并且为了保持不同版本的一致性,请一边参考 5.3 分支下的文档 来翻译。
五、开始翻译
项目地址:https://github.com/laravel-china/laravel-d...
- Fork 项目;
- 在 5.3 分支下 找到对应的文件,请必须基于 5.3 版本的同一个文件进行翻译;
- 翻译完成后自己 Review 两遍;
- 然后提交 PR。
「Review 团队」在接收到 PR 后,开始直接对 PR 进行 Review,并把修改意见以评论方式写入。
如这个 Review:https://github.com/laravel-china/laravel-d...
译者在针对 Review 的修改意见进行修改,最后成功 Merge 提交。
注意:review 完成后,原作者不需要关闭 PR, 直接在你自己的仓库现有的状态修改,修改完正常 commit 并 push 到你的仓库即可。 PR 会同步更新。
六、翻译署名
翻译参与者对译文能行使署名权,就如画家在作品上签名。
以下 Markdown 代码会在每篇文档最底部出现:
## 译者署名
| 用户名 | 头像 | 职能 | 签名 |
|---|---|---|---|
| [@Aufree](https://learnku.com/users/5) | <img class="avatar-66 rm-style" src="https://cdn.learnku.com/uploads/avatars/5_1471144144.png?imageView2/1/w/100/h/100"> | 翻译 | 专注于 iOS 和 Laravel,[@Aufree](https://github.com/Aufree/) at Github |
| [@overtrue](https://github.com/overtrue) | <img class="avatar-66 rm-style" src="https://cdn.learnku.com/uploads/avatars/76_1451276555.png?imageView2/1/w/100/h/100"> | Review | 大家可以 [加我微博](http://weibo.com/joychaocc) 保持联系 |
解析后会是:
用户名 | 头像 | 贡献 | 签名 |
---|---|---|---|
@Aufree | ![]() |
翻译 | 专注 iOS 和 Laravel,@Aufree at Github |
@overtrue | ![]() |
Review | 大家可以 加我微博 保持联系 |
说明:
- 用户名:用户名和链接自由设定;
- 头像:自由设定,不过必须添加这两个类
avatar-66 rm-style
; - 贡献:二选一,
翻译
或者是Review
; - 签名:个人签名,可以是一些推广信息等,不限制。
我要认领翻译「服务容器」
我要认领翻译「控制器」
我要认领 「用户认证」
我要认领翻译「用户认证」
@刘紫阳 我要重新认领翻译「前端指南」
@刘紫阳 冲突咯冲突咯 @kzh4435 已经领走了,@刘紫阳 你得换一个
我要认领翻译「编辑资源 Mix」
@Summer 好的,几秒钟哈哈
我要认领「编辑资源 Mix」
@cjjian :joy: 已被领走,你慢了
@Summer 挖槽,这么神速。
我要重新认领「分页」
按照字母表
artisan
到container
都认领了,已经翻译完成我要认领 「API 认证」
@daydaygo
@kzh4435 两位翻译的怎样了, @milkmeowo 同学已经提了以下 PR ,他是在前几天就开始翻译的
两位要是还没翻译,就请重新认领咯 :smile_cat:
@Summer 我先等等看,先给我取消吧
@kzh4435 好的,抱歉混乱了啊
@Summer 我要重新认领 「redis」,这回可以成功了吧
@daydaygo 保证成功 :metal:
我要认领翻译「路由」
我要认领翻译「文件夹结构」
:punch: 我加入 检查团队
我要认领翻译「HTTP 层 中间件」
先翻译一个试试
我要认领翻译「错误与日志」
我要认领翻译「请求」
我要认领翻译「加密解密」
我要认领翻译「哈希」
我要认领翻译「快速入门」「模型关联」「Eloquent 集合」「修改器」「序列化」
我要认领翻译「CSRF 保护」「响应」「Session」「表单验证」
我要认领翻译 「查询构造器」
最近比较忙,但还是希望能够参与,先领个短的吧
我要认领「发行说明」
我要认领 「请求周期」
我要认领翻译「重置密码」
我要认领翻译「Homestead」
我要认领翻译「数据填充」
Summer 还没来。。更新一下状态:已经翻译完了「数据填充」提了 PR。
@Summer 我的「快速入门」「模型关联」「Eloquent 集合」「修改器」「序列化」翻译完啦,已经发PR了
@Summer Homestead翻完了提了PR
我要认领翻译「数据库迁移」
@Summer API 认证翻译完了提交了PR
我要认领翻译「服务提供者」
我要认领翻译「valet」
@Summer 数据库迁移 翻译完成 提PR了
我要认领翻译「队列」
我要认领翻译「邮件发送」
我要认领:Facades、事件系统。
我要认领翻译「Contracts」
再认领2个吧
我要认领翻译「升级说明」和「安装」
@skyverd 升级说明应该能翻译到吐血
今天收到“Laravel资讯”订阅邮件 特来认领一个 文件存储
@Summer 看了下5.3的感觉还好啊,有坑吗 :anguished:
@skyverd 就是好长 :smile_cat: ,并且貌似没有参考
我要认领翻译「providers.md」
@leon0204 「服务提供者」 已经被 @牛玉富 兄弟领了哈
@Summer 。好吧,没看见,已经pr了。那再认领其他的把。我要认领翻译「contributing.md」。
我要认领翻译「Envoy 部署工具」
我要认领翻译「Scout 全文搜索」
我要认领翻译「消息通知」
@leon0204
「contributing.md」 https://learnku.com/docs/laravel/5.4/contr... 已经翻译完成咯。
以下三个是你的啦 :smile:
我要认领翻译「扩展包开发」
我要认领翻译「任务调度」 @Summer 第一次参加翻译工作。遵循翻译标准,多多指教
@诺墨 :smile: 欢迎加入,仔细按照此文章里的来就绝对可以 :+1:
@Summer,邮件发送部分翻译完成,已经 PR .
@Summer Socialite 社会化登录章节在 laravel.com 官网的 Document 里,是连接到 https://github.com/laravel/socialite 的。没有正经的文档,要不我把 https://github.com/laravel/socialite/blob/... 给翻译了算了。
@qufo 靠谱
@Summer
漏了这两个没有安排!
@milkmeowo 没有漏,他们在翻译中:
@Summer 原文是英文双引号的。 比如: "hack" ,需要改成 「hack」 吗 ,看5.3 里面是没有改的
@leon0204 要的,有一些是不小心漏掉了 :smile_cat:
文件系统 PR已提交
队列已提PR.
@Summer 还有哪个没人认领么
@Rambone 好像没有了
@Summer 好嘞 有社区志愿工作 请艾特我~
@Summer
Envoy 部署工具」
「Scout 全文搜索」
「消息通知」
三个 PR了 处理进度好像卡住了,安排下呗。:simple_smile:
@skyverd
@Yangjing
@牛玉富
@诺墨
几位就差你们的翻译啦,我们计划下周一翻译完成。
不知道你们的时间是否能赶上,如果忙不过来的话,可回复我,我邀请多几个兄弟来帮忙。
@Summer 这个 PR 已经同步上游官方文档到今天,小改动的已经顺手翻译,mix.md 有大改变,所以重新 assign 人员去翻译吧。
@Summer 我的周六完成
@Summer 我周六完成,这几天工作比较忙 :)
@Summer 这几天工作比较忙。我争取周六日完成 :)