坦白地讲,小编xtt1341十分怀念旧有的文档体系,因为可以精确锁定每一篇how to文章——那是我们在开发过程中的宝典(即cookbook)。

但是,也不能说新版文档体系麻烦,主要还是使用习惯问题,很明显,新版更加照顾初学,减少了“同一个知识点”的文档入口数量。

由于SymfonyChina一时还难以全面收录所有汉化文档,因此给出以下文档阅读建议,希望能帮您加速掌握Symfony基本知识。

关于BOOK 

我们直接把Book给搬到“起步”里了,因为旧版Book很多内容是非常重要的——尽管BOOK被抛弃了,但实际上是被拆分成多篇文档,以“起步/指南+how to”来重新包装了一下。考虑到不重复造轮子,与其换汤不换药式的“追新”,不如把翻译重心放在我们之前没有照顾到的文档上,因此我们直接移植了旧版网站的book内容到6篇起步向导中。

移植Book的过程中,我们将持续对文章进行优化,直到与官网同步。

对于“起步”6篇文字的“了解更多/Learn More”部分,我们还需要一点时间来完善。

关于COOKBOOK 

也就是how to系列了,同样被官方抛弃了——没有一个集中的cookbook入口,全部归到6+23+33的入口文字下。也就是说,62篇入口级文档下面的“乱链”区域,是可以找到各种相关的how to文字的。

需要how to文章,就从文档左侧导航的6+23总计29篇引导文,以及大导航“组件”中的33个组件文档之中的页面底部寻找。可通过文档小目录中的“了解更多”(#learn-more)锚记查看。

6篇起步向导 

基本上可以是看作原Book中的“必备技巧”之翻版。

23个概念名词 

在原book基础上细分出一些门类(可以理解为原cookbook的关键索引大类),各自形成了独立的入口页。同样在每一篇文字下面有“乱链”区域,相关how to都在那里。但要注意的是,官方“乱链”全无规律,各种交叉混排,是真正意义的“乱链”——而一般提倡的却是“分门别类”式的检索,有利于学习效率的提高。

这23个概念名词就是大家检索how to的入口的主力了。

注意,还有两个入口,组件和起步。

33个组件 

Symfony组件因其核心地位而没有受到官网改版的任何影响,只是加载了“乱链”区域,放入了相关的how to文档。至于原有组件的“直系关联文档”,全部被发配到how to文字中,其归属变得不确定起来——官方经常把同一个文档链接,放在66篇入口文字中的多个“乱链区域”。

关于检索 

Symfony使用了Algolia分布式付费检索,达到了毫秒级的体验,而且是输入一个字母就有响应。这对于海量文档来说简直再适合不过,为此Symfony建立了巨大数组索引。

我们可以用angular2来模拟之,但是需要输入至少3个字母才发http。之所以选择angular2是因为可以用后台思维来操作DOM。

其实如果愿意付费,基于Symfony的程序使用Algolia搜索引擎是非常简单的。

待检索功能完成时,说明SymofnyChina基本成形了。(目前正苦于文档转移和重新校对等,还要添加新how to,甚为费时,心爱的ng2不能继续突击学习,真乃憾事也)


以上是我们对Symfony官方文档体系的理解,但这还远远不够。因为学习Symfony一个很重要的点就是google,包括stackoverflow.com和github等,也包括一些国外“领袖级高手”的博客这种地方——这些都需要从google进入,因此要掌握一定的检索关键字技巧,同时要收藏那些有用的页面(应开启浏览器的收藏夹云同步功能),以备不时之需。

掌握Symfony并非易事,我们会尽己所能地给大家提供帮助。

敬请期待。