Twig 2.x 文档翻译工作征集

[slince]

Twig 作为一门优雅灵活的模板引擎诞生已久，但从国内的使用率来看并不容乐观；为了帮助更多的 twig 的爱好者，希望大家可以参与到文档的翻译中来；

翻译准备

Twig 的文档是采用 reStructuredText 所以你需要简单的了解下 reStructuredText 的语法；

语法参考：

• reStructuredText(rst)快速入门语法说明
• Sphinx 使用手册 - reStructuredText 简介

下载编辑器

理论上任意纯文本编辑器皆可，这里推荐 Visual Studio Code 搭配 reStructuredText 扩展进行翻译。

开始翻译

fork 翻译工程

项目地址 phpdish/twig-docs

认领翻译

由于翻译文件过于零碎，本次翻译时对文件进行了组合，具体的组合结果如下

| 名称 | 包含 | 认领 | | --- | --- | --- | | 介绍 /安装 | Introduction，Installation | Slince| |模板设计师篇|Twig for Template Designers| Slince| |开发者篇|Twig for Developers| - | |扩展 Twig|Extending Twig| - | |Twig 内部实现 /废弃功能|Twig Internals, Deprecated Features| - | |Twig 技巧 /代码规范|Twig Recipes， Coding Standards| - | |标签<一>|autoescape, block, do, embed| - | |标签<二>|extends, filter, flush, for| - | |标签<三>|from, if, import, include| - | |标签<四>|macro, sandbox, set, spaceless| - | |标签<五>|use, verbatim| - | |过滤器<一>|abs, batch, capitalize, convert_encoding, date, date_modify, default| - | |过滤器<二>|escape, first, format, join, json_encode, keys, last| - | |过滤器<三>|length, lower, merge, nl2br, number_format, raw, replace| - | |过滤器<四>|reverse, round, slice, sort, split, striptags, title, trim, upper, url_encode| - | |函数<一>|attribute, block, constant, cycle, date, dump, include| - | |函数<二>|max, min, parent, random, range, source, template_from_string| - | |测试|constant, defined, divisible by, empty, even, iterable, null, odd, same as| - |

由于标签与过滤器翻译内容过多故分开成多个部分；

参与者请到原帖下回复 Twig 2.x 文档翻译工作征集

我要认领“名称”

比如我要认领第一节则回复

我要认领“介绍 /安装”

每个人可以认领一个或者多个模块，由自己时间精力自行决定，但一旦认领完成请务必完成翻译工作。

认领模块翻译完成之后请 PR 到phpdish/twig-docs；人人都可以参与翻译的 review 工作； review 完成之后将会被合并到主库。

翻译要求

• 所有出现的函数名，标签名，过滤器，测试均不要翻译
• 双引号使用中文状态下的双引号
• 英文中的“.”翻译成句号
• 英文单词前后空一格
• 翻译完成之后请自行 review，不可有模棱两可的翻译。

感谢大家的参与，我们的愿景是将国外的优秀作品翻译过来，帮助国内的开发者更轻松的学习，Twig 只是第一步； 开源社区需要我们共同维护。

文档翻译之后将建立 Twig 中文站，与 https://twig.symfony.com/ 风格一致。

[slince]

格式错了，怎么修改 ..

[slince]

阅读困难的话，可以到 [原帖]( https://www.phpdish.com/topics/49) 或者 [Github]( https://github.com/phpdish/twig-docs)阅读

[bao3]

我差点以为这是越狱插件