文档对主题很重要,因为它为用户提供了一种方法来了解一个主题支持什么和不支持什么。同样,记录主题的代码将使其他主题开发者更容易定制你的主题,很可能是用一个子主题。
这里有一份关于主题文档的要求和建议清单。
- 主题需要提供任何设计限制或特殊安装/设置说明的最终用户文档。
- 主题需要包含一个readme.txt file文件,使用插件目录的readme.txt标记格式。从2018年10月25日起,新主题需要遵循这一规则。旧主题从这个日期开始有6个月的宽限期。自从WordPress 5.8以来,主题的readme文件没有被解析为必要文件,因为这意味着需要依赖PHP页头或至少要从主题的style.css文件中解析。