食典不再有效维护吗?


9

我通常在Google上需要Wordpress函数的快速参考时,并且通常是第一个出现在Codex上的帖子(例如,在谷歌搜索“获取术语”时,https: //codex.wordpress.org/Function_Reference/get_term)。

我多年来一直依靠食典,并且隐约意识到有一个单独的守则参考(例如https://developer.wordpress.org/reference/functions/get_term/确实比食典提供了更多细节...但大多数似乎是重复的清单。有时,这会首先在Google搜索中返回。

但是最近我遇到了两者之间的差异……似乎食典在某些事情上可能已经过时了。例如,重新。上面的两个链接-我花了一些时间阅读火车票,之后我才意识到$taxonomy确实不再需要该参数get_term()。我在花园小径上,因为食典仍然列出了它要求。

尽管每页顶部都有指向“代码参考”的链接,但我在Codex上看不到任何提及它的地方。

有人知道食典是否已弃用吗?它仍然有目的吗?还是我应该完全忽略它,而只是使用developer.wordpress.org

Answers:


8

(嗯,这有点离题,但会让其他人决定)

更好的答案

尽管很难跟踪官方公告,但正如@darmb在评论中指出的那样,有迹象表明,官方文档的开发工作正朝着远离法典的方向发展,以支持开发人员站点和“ make”博客/站点。因此,在某种程度上,虽然尚未正式宣布(据可能所知),但应将编解码器视为已弃用。

参考文献:

  • “ ...的最终目标是最终关闭食品法典。” (链接
  • “该法典已弃用,并计划在某个时候消失。因此,该法典上的“主题审查”页面不再是官方的或维护的。” (链接

原始答案

该法典是一个Wiki风格的网站。它是最新的,需要一些志愿者实际去编辑它。通常,使用新代码可以得到一些好处,尽管质量可能不是最高的,但是在较旧的主题上进行细微的更改可能会遭受“麻烦”。

开发者站点是一个phpdoc样式站点,它是由phpdoc样式注释自动生成的,该注释带有函数声明和钩子用法,因此它与实际代码同步(您实际上可以在此处看到代码)。

Codex的痛点-如果没有人关心某些API,它可能与实际描述有所不同。优点是它是人为人产生的,理论上更容易编辑。

开发人员站点的痛点-仅适用于最新版本,并且取决于代码中注释的质量,因此,每4个月更改一次的情况可能会有所不同。要点-它向您展示了自己的代码,替代了使用文本编辑器搜索代码。

我认为误导性信息会更糟,然后再没有信息,因此,我尽量避免使用法典,但不,它不被弃用,如果您发现有空白,欢迎您予以补充:)


太好了,谢谢您的解释Mark。我没有意识到开发人员网站会被自动记录下来,这很有意义。关于离题的问题,我在发布之前就问自己,但是我已经用Google搜索并且找不到答案..它直接与Wordpress有关。我想如果我在这里看到它,我会认为是一个好问题,所以我还是决定将其发布。很高兴被告知否则!
蒂姆·马隆

2
实际上是在重新阅读wordpress.stackexchange.com/help/on-topic,我看不出它是如何偏离主题的……
Tim Malone

@ TimMalone,wordpress.org问题应直接针对wordpress.org。奥托(Otto)有时会在这里被发现,但是除此之外,没有人有权回答围绕这个问题。您基本上是在询问有关“书”的建议;)
马克·卡普伦

1
实际上,在创建新的开发人员文档时,不赞成使用Codex。现在,许多法典页面会自动重定向到新的开发人员文档。
darrinb '16

1
这里有一个不推荐使用的食典的参考:make.wordpress.org/themes/2015/05/27/…–
darrinb
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.