必备主题文件

必备主题文件

当您向WordPress.org主题目录提交主题时，需要包含一组必备文件。

让我们看看这些文件是什么以及它们的重要性。

区块主题

在主题结构课程中您了解到，一个有效区块主题仅需两个文件：style.css和index.html。

但向WordPress.org主题目录提交时，还需要额外文件。

您需要包含theme.json文件和readme.txt文件。

此外还需要一个截图文件。

让我们详细看看这些文件。

theme.json文件用于定义主题的全局样式和设置。

除非您没有任何特定的全局样式或设置，否则通常在主题开发过程中就会创建这个文件。

即使是Create Block Theme工具也会为您生成包含默认全局样式和设置的theme.json文件。

如果没有这个文件，可以使用以下模板在主题根目录创建：

{
  "$schema": "https://schemas.wp.org/wp/6.5/theme.json",
  "version": 2,
  "settings": {
  },
  "styles": {
  }
}

最初为插件设计的readme.txt文件，现在同时用于插件和主题提供更多信息。

对于主题，该文件内容会显示在WordPress.org主题目录的主题页面上。

应包含主题名称、描述、版本号、作者等信息。

WordPress的readme文件标准详细说明了可以包含的信息类型。

还可以使用readme验证器检查文件格式是否正确。

截图文件用于在WordPress.org主题目录和WordPress管理区域展示主题预览。

应为PNG或JPG格式，尺寸不超过1200×900像素。

使用Create Block Theme创建主题时会自动生成默认截图，但最好替换为展示主题特色的自定义截图。

提交经典主题时，所需文件略有不同。

如”经典主题介绍”课程所述，经典主题在WordPress中运行仅需style.css和index.php文件。

但向WordPress.org主题目录提交时，还需包含comments.php文件。

在经典主题中，该文件包含允许评论处的评论模板。

与区块主题相同，也需要readme.txt文件和截图文件。