Laravel 5.3 文档翻译召集 - 已完成
已经正式发布 公告:Laravel 5.3 中文文档翻译完成
一. 翻译说明
Laravel 5.3 带来了很多非常棒的 新特性,文档翻译工作会是难得的学习 Laravel 5.3 的机会,也是大家认识朋友的一次机会。
后续维护计划
laravel.com 官方文档会持续更新,为了保证后续的修改能更新上,我们需要不定期检查更新,目前预计这个检查的周期会是一个月~三个月一次,到时候会从翻译团队中征集人手。
二. 开始翻译
1). 加入组织
--- 直接在帖子底下留言即可。---
2). 领取任务
以下是任务列表,会实时更新,请在此话题下留言领取任务,留言内容如:
我要认领翻译「中间件(middleware)」
注意:
- 请仔细查看「任务列表」是否任务已被别人领走,还有此话题的最近评论(有时候管理员来不及更新),你只能领取未认领的任务;
- 认领时会有日期标示,超过 5 天的未完成任务将会被回收。
任务列表
- 前言
- 翻译说明(about) - 不需要翻译
- 发行说明(releases) - 已翻译
- 升级说明(upgrade) - by @uicosp :white_check_mark:
- 贡献导引(contributions) - 已翻译
- 入门指南
- 安装(installation) - 已翻译
- 配置信息(configuration) - 已翻译
- 文件夹结构(structure) - 已翻译
- 错误与日志(errors) - by @YuxiangDong :white_check_mark:
- 开发环境部署
- Homestead(homestead) - by @Summer :white_check_mark:
- Valet(valet) - by @YuxiangDong :white_check_mark:
- 核心概念
- HTTP 层
- 路由(routing) - by @kzh4435 :white_check_mark:
- 中间件(middleware) - by @Aufree :white_check_mark:
- CSRF 保护(csrf) - by @Macken :white_check_mark:
- 控制器(controllers) - by @Macken :white_check_mark:
- 请求(requests) - by @刘紫阳 :white_check_mark:
- 响应(responses) - by @刘紫阳 :white_check_mark:
- Session(session) - by @wangyan :white_check_mark:
- 表单验证(validation) - by @cloes :white_check_mark:
- 视图和模板
- JavaScript 与 CSS
- 安全
- 用户认证(authentication) - by @czl1252409767 :white_check_mark:
- 用户授权(authorization) - by @czl1252409767 :white_check_mark:
- 重置密码(passwords) - by @kzh4435 :white_check_mark:
- API 认证(passport) - by @zhwei :white_check_mark:
- 加密解密(encryption) - by @ SILVERCELL :white_check_mark:
- 哈希(hashing) - by @ SILVERCELL :white_check_mark:
- 综合话题
- 广播系统(broadcasting) - by @uicosp :white_check_mark:
- 缓存系统(cache) - by @ fdoth :white_check_mark:
- 事件系统(events) - by @骑驴上天 :white_check_mark:
- 文件存储(filesystem) - by @LXY :white_check_mark:
- 邮件发送(mail) - by @YuxiangDong :white_check_mark:
- 消息通知(notifications) - by @骑驴上天 :white_check_mark:
- 队列(queues) - by @骑驴上天 :white_check_mark:
- 数据库
- Eloquent ORM
- Artisan 控制台
- Artisan 命令行(artisan) - by @kzh4435 :white_check_mark:
- 任务调度(scheduling) - by @kzh4435 :white_check_mark:
- 快速入门(testing) - by @JobsLong :white_check_mark:
- 应用程序测试(application-testing) - by @JobsLong :white_check_mark:
- 数据库(database-testing) - by @JobsLong :white_check_mark:
- Mocking 取模(mocking) - by @zhwei :white_check_mark:
- 官方扩展包
- 附录
3). 翻译规范
规范
我们严格遵循 中文排版指南 规范,并在此之上遵守以下约定:
- 英文的左右 必须 保持一个空白,避免中英文字黏在一起;
- 必须 使用全角标点符号;
- 必须 严格遵循 Markdown 语法;
- 原文中的双引号(" ")请代换成中文的引号(「」符号怎么打出来见 这里);
- 「
加亮
」和「加粗」和「[链接]()」都需要在左右保持一个空格; - 代码注释统一要求翻译;
翻译时请特别注意规范,如果你的翻译提交不遵循排版规范,我们会很痛心的拒绝你的提交。
对照表
请必须严格按照「专有名词翻译对照表」来翻译 - https://learnku.com/docs/laravel/5.3/about#翻译对照列表 。
自定义 Markdown 语法
Laravel 5.3 文档中,有一些自定义的 Markdown 语法,请不要翻译。
这个:
> {tip}
还有这个:
> {note}
4). 基于 Laravel 5.2 翻译
Laravel 5.3 文档是在 Laravel 5.2 文档 的基础上更新的,并且为了保持不同版本的一致性,请一边参考 5.2 分支下的文档 来翻译。
5). 开始翻译
项目地址:https://github.com/laravel-china/laravel-d...
- Fork 项目;
- 基于 5.2 分支下的文档 的基础上进行翻译;
- 翻译完成后自己 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
; - 签名:个人签名,可以是一些推广信息等,不限制。
「项目管理者」
想帮忙,但是不方便翻译的同学,可以加入 Review 团队,我们会在一个星期内对文档做密集型 Review。Review 的工作量也挺大,主要工作是中文语病,错别字纠错等。
:facepunch: YES,有我
@穆里尼奥
@YuxiangDong
@江边望海 几位看这里
虽然能力有限帮不上什么忙,但是严重支持!
另外建议维护更新时,跟上官方的节奏。每次的任务量很小,也更容易更新翻译和审校。自动同步官方git,有实质的文档更新就发到 list ,任何人可以 PR , 审核团队合并。只是建议。
@ElfSundae 好建议
@Summer 好想加入, :sob:, 不过算了, 帮不了什么忙!
@luo975974740 加入 Review 团队,Review 团队是纠中文错误的。
Review 没问题,虽然我中文不咋地 :smile: 我github账号 elfsundae
@Summer 嗯嗯, 嗯, 我愿意! :relaxed: 哈哈
@Summer 好激动,已加微信了。
非常支持 ! 虽然英文不怎么样 !
好想加入,可惜时间上估计有点挤,感觉掉队了
:facepunch:
@Summer 尼玛,作为一个 mac 搜狗五笔用户,硬是在 「」 浪费了一小时,你还我时间 !!!!
@overtrue :flushed: 五笔。。 @NauxLiu 也是用着五笔?高手都用五笔?
@Summer 你就这么理解吧,虽然拼音我也是高手
@Summer 我是用的双拼.....
@NauxLiu 好久不见你了。以为你...
:+1:
5.3 版本的文档我已经翻译到数据库起步了 :smile:
如果需要的话可以作为初版参考一下,应该可以省去大量的时间
Github: Dearmadman/laravel-docs-zh
临时线上地址:docs.larastars.win
希望能对你们有所帮助 :smile:
@Summer
我要加入
@JobsLong 你当然要加入哈。
@DearMadMan 速度很快呀你,谢谢你的慷慨 :smile_cat: ,第一次听说有个 win 域名
@Summer 我也是作为学习用的 :smile: Laravel 确实非常棒 :+1: 我也只是想为 Laravel 在国内的推广做一些贡献
@DearMadMan 你也超棒 :beers:
@DearMadMan http://dearmadman.com/ 用英文写博客,要坚持下去 :+1:
@Summer 谢谢,正在补英文知识 :smile:
领取 Passport OAuth 认证(passport)
@zhwei 收到
再领一个
Elixir
, 这个是我比较薄弱的。好想加入.可惜自己的英语不行.只能供给自己,不能共翻译:anger:
@dinghua 收到
@dinghua 换头像了
领取 Artisan 命令行(artisan)
@kzh4435 收到
我要认领翻译「升级说明(upgrade)」
@uicosp 收到
我要认领翻译「Envoy 部署工具(envoy)」
我要认领翻译「事件系统(events)」
@骑驴上天 收到
我要认领翻译「广播系统(broadcasting)」
我要认领翻译「消息通知(notifications)」
@Slim 收到
我要认领翻译「Session」
@dinghua 收到
要领翻译 Eloquent ORM 下的 --》 序列化(eloquent-serialization) 这一节
@SILVERCELL 哈哈,不允许领一节
@SILVERCELL 加我微信聊
要领翻译 安全下的 | 加密解密(encryption) | 哈希(hashing)
领取数据库下的redis
@不二 加下我微信
我要认领翻译「Cache」
@fdoth
@不二
@SILVERCELL 已记录
领 --- 数据填充(seeding)
@SILVERCELL 收到
我要认领翻译「快速入门(eloquent)」
@LXY 加我微信
我要认领翻译「模型关联(eloquent-relationships)」「Eloquent 集合(eloquent-collections) 」「Getter/Setter(eloquent-mutators)」「序列化(eloquent-serialization)」(Eloquent ORM的剩余章节)
认领 数据库的 快速入门 database.md
@LXY
@DaveX
@kzh4435 已记录
领取 mail ,valet 无问题后着手翻译 mail
@YuxiangDong 已记录
认领
requests.md
接下来会是谁?
我要认领翻译 「文件存储(filesystem) 」
@LXY 收到
认领
响应(responses)
@刘紫阳 好的
领取 错误与日志(errors)
@YuxiangDong 收到
认领 Mocking 取模(mocking)
@zhwei 收到
认领 Queues 队列 + Collections 集合
@骑驴上天 收到
认领分页 pagination
@kzh4435 收到
我要认领翻译「表单验证(validation)」
@Vlongen copy
大家用心翻译,哪怕一人一个页面,也早玩意完了啊!
我要认领翻译「广播系统(broadcasting)」
认领 session
@wangyan
@uicosp 收到
@Summer 不好意思,把 Session 的翻译忙忘了
@dinghua 哈哈,没事
我要认领数据库迁移(migrations)
@lijinma 收到
第一次翻译文档,来认领个 辅助函数 helpers吧
@zjien :+1: 已记录 可以加入翻译群和大家认识一下 :smile:
认领任务调度 scheduling
译完啦,等待review中
更新了翻译规范:代码注释统一要求翻译;
认领 notifications
好像都领完了
@weelion 加我微信「jobslong」,我拉你进群啦 我们还有一大堆翻译需要新鲜劳动力,哈哈 :smile: , 最近在筹划大新闻
5.3 文档翻译进度基本完成,整体 Review 中,择时发布 ~~
好顶赞
laravel 学院都翻译完了的工作,为什么再做一遍
@ADKi 学院君很厉害啊 ~~ 这个是因为也是 Laravel China 也一直以开源协作的方式在维护中文社区的一些资料,和学院君并没什么冲突 :)只不过 5.3 在社区进行了翻译进度的管理,和学院君时间上可能有些重叠 :smile:
@JobsLong 支持你们这些中文翻译者,为国内技术人员带来方便