一. 翻译说明
Laravel 5.3 带来了很多非常棒的 新特性 ,文档翻译工作会是难得的学习 Laravel 5.3 的机会,也是大家认识朋友的一次机会。
后续维护计划
laravel.com 官方文档会持续更新,为了保证后续的修改能更新上,我们需要不定期检查更新,目前预计这个检查的周期会是一个月~三个月一次,到时候会从翻译团队中征集人手。
二. 开始翻译
1). 加入组织
想加入翻译团队的同学请加我微信,暗号: 翻译
,我会把你拉入翻译微信群,此群的作用为翻译情况实时通知,所有翻译团队的同学必须添加。
进群后请把用户名改为:真实姓名 - PHPHub ID,如:李桂龙 - 1
注意:我们准备在两周内翻译完 Laravel 5.3,所以你 必须 确定在最近两周内有足够的时间。
2). 领取任务
以下是任务列表,会实时更新,请在此话题下留言领取任务,留言内容如:
我要认领翻译「中间件(middleware)」
注意:
- 请仔细查看「任务列表」是否任务已被别人领走,还有此话题的最近评论(有时候管理员来不及更新),你只能领取未认领的任务;
- 认领时会有日期标示,超过 5 天的未完成任务将会被回收。
任务列表
- 前言
- 翻译说明(
about ) - 不需要翻译 - 发行说明(releases) - 已翻译
- 升级说明(upgrade)
- 贡献导引(contributions) - 已翻译
- 翻译说明(
- 入门指南
- 安装(installation) - 已翻译
- 配置信息(configuration) - 已翻译
- 文件夹结构(structure) - 已翻译
- 错误与日志(errors) - 已翻译
- 开发环境部署
- Homestead(homestead) - by @Summer at 2016-09-08
- Valet(valet) - by @YuxiangDong at 2016-09-08
Reviewing
- 核心概念
- HTTP 层
- 路由(routing) - by @kzh4435 at 2016-09-08 :white_check_mark:
- 中间件(middleware) - by @Aufree at 2016-09-08
- CSRF 保护(csrf) - by @nophp at 2016-09-08 :white_check_mark:
- 控制器(controllers) - by @nophp at 2016-09-08
- 请求(requests) - by @穆里尼奥 at 2016-09-08
- 响应(responses) - by @穆里尼奥 at 2016-09-08
- Session(session)
- 表单验证(validation)
- 视图和模板
-
JavaScript 与 CSS - 安全
- 用户认证(authentication) - by @czl1252409767 at 2016-09-08
- 用户授权(authorization) - by @czl1252409767 at 2016-09-08
- 重置密码(passwords) - by @kzh4435 at 2016-09-09 :white_check_mark:
- API 认证(passport)
- 加密解密(encryption)
- 哈希(hashing)
- 综合话题
- 广播系统(broadcasting)
- 缓存系统(cache)
- 事件系统(events)
- 文件存储(filesystem)
- 邮件发送(mail)
- 消息通知(notifications)
- 队列(queues) - by @cyjme at 2016-09-08
- 数据库
- 快速入门(database)
- 查询构造器(queries)
- 分页(pagination)
- 数据库迁移(migrations)
- 数据填充(seeding)
- Redis(redis)
- Eloquent ORM
- 快速入门(eloquent)
- 模型关联(eloquent-relationships)
- Eloquent 集合(eloquent-collections)
- Getter/Setter(eloquent-mutators)
- 序列化(eloquent-serialization)
- Artisan 控制台
- Artisan 命令行(artisan) - by @kzh4435 at 2016-09-10
- 任务调度(scheduling)
- 测试
- 快速入门(testing) - by @JobsLong at 2016-09-10
- 应用程序测试(application-testing)
- 数据库(database-testing)
- Mocking 取模(mocking)
- 官方扩展包
- 附录
- 集合(collections)
- 辅助函数(helpers)
- 扩展包开发(packages)
3). 翻译规范
规范
我们严格遵循 中文排版指南 规范,并在此之上遵守以下约定:
- 英文的左右 必须 保持一个空白,避免中英文字黏在一起;
- 必须 使用全角标点符号;
- 必须 严格遵循 Markdown 语法;
- 原文中的双引号(" ")请代换成中文的引号(「」符号怎么打出来见 这里 );
- 「
加亮
」和「 加粗 」和「[链接]()」都需要在左右保持一个空格。
翻译时请特别注意规范,如果你的翻译提交不遵循排版规范,我们会很痛心的拒绝你的提交。
对照表
请必须严格按照「专有名词翻译对照表」来翻译 - http://laravel-china.org/docs/5.3/
4). 基于 Laravel 5.2 翻译
Laravel 5.3 文档是在Laravel 5.2 文档 的基础上更新的,并且为了保持不版本的一致性,请一边参考 5.2 分支下的文档 来翻译。
5). 开始翻译
项目地址: https://github.com/laravel-china/laravel-docs
- Fork 项目;
- 基于 5.2 分支下的文档 的基础上进行翻译;
- 翻译完成后自己 Review 两遍;
- 然后提交 PR;
「Review 团队」在接收到 PR 后,开始直接对 PR 进行 Review,并把修改意见以评论方式写入。
如这个 Review: https://github.com/laravel-china/laravel-docs/pull/4/files#r77969204
译者在针对 Review 的修改意见进行修改,最后成功 Merge 提交。
注意:review 完成后,原作者不需要关闭 PR, 直接在你自己的仓库现有的状态修改,修改完正常 commit 并 push 到你的仓库即可, PR 会同步更新。
三. 翻译署名
翻译参与者对译文能行使署名权,就如画家在作品上签名。
以下 Markdown 代码会在每篇文档最底部出现:
## 译者署名 | 用户名 | 头像 | 职能 | 签名 | |---|---|---|---| | [@Aufree](https://phphub.org/users/5) | <img class="avatar-66 rm-style" src=http://www.tuicool.com/articles/"https://dn-phphub.qbox.me/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) | | Review | 大家可以 [加我微博](http://weibo.com/joychaocc) 保持联系 |
解析后会是:
用户名 | 头像 | 贡献 | 签名 |
---|---|---|---|
@Aufree | 翻译 | 专注 iOS 和 Laravel, @Aufree at Github | |
@overtrue | Review | 大家可以加我微博 保持联系 |
说明:
- 用户名:用户名和链接自由设定;
- 头像:自由设定,不过必须添加这两个类
avatar-66 rm-style
; - 贡献:二选一,
翻译
或者是Review
; - 签名:个人签名,可以是一些推广信息等,不限制。