翻译

Symfony文档用英语书写,许多人都加入到了翻译的进程中。

注解

Symfony Project officially discourages from starting new translations for the documentation. As a matter of fact, there is an ongoing discussion in the community about the benefits and drawbacks of community driven translations.

贡献

首先熟悉文档使用的 标记语言

然后加入到 Symfony docs mailing-list ,通过邮件合作。

最后,找到你想要参与贡献文档的 master 主文档库,下列是官方 master 主文档库:

注解

If you want to contribute translations for a new language, read the dedicated section.

加入翻译团队

如果你想贡献新语种的文档,请参考:

  • 通过 Symfony docs mailing-list 介绍自己

  • (可选) 询问你可以参与的文档

  • Fork master 主文档库

  • 翻译

  • 创建 pull request

  • 文档管理员接受你的提交并合并到主文档库

  • 文档网站自动从主文档库更新

添加新语言

这一小节简要介绍如何添加新的文档库语言

因为翻译工作需要大量精力,所以首先通过邮件组 Symfony docs mailing-list 谈谈你的计划,并且试着找到合作伙伴。

当团队人员就绪,选出一名团队管理员,他们将负责 master 主文档库。

创建库并复制 英语 文档库。

团队便可以开始翻译了

当团队认为文档库已经处于一致并且稳定的状态时(所有文档都被翻译,未翻译的文档从toctrees已经移除),

维护

文档全部被翻译并不代表所有的事情都已经完成。文档库是不断变更的(新文档被加入,bugs被修正,段落被重新组织)。翻译团队需要紧随官方英语文档库并且尽快实现翻译后的变更。

警告

不再被维护的文档库将从官方列表中移除,因为过期的文档对于开发可能会造成不可预料的后果