与基础主题Wordpress下划线

Question

当我从GitHub下载Underscores主题时，有点困惑 https://github.com/ykhan8/Underscores-Theme-w--Foundation-5。从阅读文档我不理解 README.md 文件中的以下文档：

使用查找和替换将foundation5_s更改为所有模板文件中主题的名称。

使用@package foundation5_S

的主要原因是什么？

我已通过互联网查看，但仍不确定。

Answer 1

根本不需要。它主要用于documentation purposes：

  

包用于帮助您对相关元素进行逻辑分组。您编写类以将相关函数和数据组合在一起，并且phpDocumentor将文件（函数，定义和包含）的内容表示为＆＃34;过程页面。＆＃34;包用于将类和过程页面组合在一起，其方式与目录将相关文件组合在一起的方式相同。

     

如果在页面级DocBlock中找到，packagename指定php文件中所有函数，包含和定义所属的包。如果在类级DocBlock中找到，则packagename指定该类所属的包。

由于您正在使用WordPress，WordPress Documentation Standard包含一些其他信息：

  

@package packagename 指定文件中所有函数，包含和定义所属的包。在文件顶部的doc块中找到。对于核心（和捆绑的主题），这总是WordPress。

     

第三方插件和主题作者不得在其插件或主题中使用@package WordPress。插件的@package名称应该是插件名称;对于主题，它应该是主题名称，用下划线隔开。

同样，它不是必需的。