在文档发布过程中,还是遇到一些问题。
某些需要调整的地方,比如需要改变正则表达式来实现,但正则一时没有“想出来”(注:本文发布后,已经用负向预查解决了一个麻烦问题);或者,对于标题止方“千奇百怪”的breadcrumb小导航问题,还没有处理到位(注:本文发布后,bundle文档的小导航问题也已得到解决),就不在此处罗列。
但是发布关联文档时,遇到了比较严重的问题,其实之前就知道,现在决定处理一下,因此向各位通报一声。
上图,是标准的Symfony组件文档version列表,与我们现在使用的相比,前段时间官方为了提高体验而加入了“维护中”和“不再维护”的提示。这个效果我们没有急于添加,因为如之前所述,3.1以外的其他版本文档还不具备生成条件。
然而在bundle文档这里,如上图,版本部分则是完全独立的,并不与组件文档通用。每个bundle,不管是官方还是第三方的,全都是自己的版本号,这就需要进行特殊处理。因为我们的文档发布系统在开发时已经考虑到扩展性,因此很多地方也都用了“弹性架构”,现有的版本处理系统其实是可以实现的。
只是需要重新调整一番。
因此可能会影响翻译进度。我们会尽量抓紧。