WordPress在核心文件中使用@

时间:2013-08-06 作者:user31344

我正在学习二十一主题,有一些问题。

什么是

 * @package WordPress
 * @subpackage Twenty_Eleven
 * @since Twenty Eleven 1.0
 */
“mean”有什么用。又一次。

 * @uses load_theme_textdomain() For translation/localization support.
 * @uses add_editor_style() To style the visual editor.
 * @uses add_theme_support() To add support for post thumbnails, automatic feed links, custom headers
 *  and backgrounds, and post formats.
 * @uses register_nav_menus() To add support for navigation menus.
 * @uses register_default_headers() To register the default custom header images provided with the theme.
 * @uses set_post_thumbnail_size() To set a custom post thumbnail size.
 *
 * @since Twenty Eleven 1.0
 */

2 个回复
最合适的回答,由SO网友:shulard 整理而成

@in标题注释是PHP Documentor元数据样式。

此语法允许您指定不同类型的信息:

带有@package和@subpackage的package和subpackage允许您定义当前文件的上下文(用于PHP 5.3名称空间,如Java语法中的名称空间)

  • 使用@author编写,版权与@版权和许可证与@许可证指定如何使用给定的源代码描述与@描述和版本与@版本以遵循库详细信息http://www.phpdoc.org/docs/latest/for-users/phpdoc-reference.html

    wordpress也使用这些注释来提取和导入元数据,正如您在样式中看到的那样。所研究主题的css文件,但语法不同(仅标签和冒号,不带@)

  • SO网友:Ben Miller - Remember Monica

    您正在查看的行中的@符号是phpdoc标记。

    您正在查看的每一行都包含在PHP注释中,这意味着它们不是作为PHP代码执行的。然而,WordPress使用一个名为PHPDoc的文档系统,它是作为注释嵌入到PHP文件中的文档。PHPDoc使用这些@标记来提供函数之间的关系。

    例如,下面是TwentyEleven函数的文档。WordPress 3.6中的php文件:https://xref.wordpress.org/tags/3.6/WordPress/Twenty_Eleven/_wp-content---themes---twentyeleven---functions.php.html

    整个页面取自函数中的注释。php文件。如果向下滚动到twentyeleven\\u设置函数,您将看到每个@uses行都提供了指向另一个函数文档的链接。

    结束