当我从GitHub下载Undercores主题时,我有点困惑https://github.com/ykhan8/Underscores-Theme-w--Foundation-5.通过阅读文档,我不理解README.md文件中的以下文档:
使用查找和替换将foundation5_s
更改为所有模板文件中主题的名称。
使用@package foundation5_S
的主要原因是什么
我在网上查过了,但还是不确定。
这根本不是必需的。它主要用于文档目的:
包用于帮助您对相关元素进行逻辑分组。您编写类来将相关函数和数据分组在一起,phpDocumentor将文件(函数、定义和包含)的内容表示为";程序页面"包用于将类和过程页分组在一起,其方式与目录将相关文件分组在一起的方式相同。
如果在页面级别的DocBlock中找到,packagename指定php文件中所有函数、包含和定义所属的包。如果在类级别的DocBlock中找到,packagename指定类所属的程序包。
由于您使用的是WordPress,WordPress文档标准包括一些附加信息:
@package packagename指定文件中所有函数、包含和定义所属的包。位于文件顶部的doc块中。对于核心(和捆绑主题),这始终是WordPress。
第三方插件和主题作者不得在其插件或主题中使用@package WordPress。插件的@package名称应该是插件名称;对于主题,它应该是主题名称,用下划线隔开。
同样,它不是必需的。