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 的工作量也挺大,主要工作是中文语病,错别字纠错等。
推荐文章: