必需的主题文件 – WordPress建站指南

当你将主题提交到 WordPress.org 主题目录时，需要包含一组必需的主题文件。

让我们来看看这些文件是什么以及它们为何重要。

区块主题

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

然而，当你将主题提交到 WordPress.org 主题目录时，还需要额外的文件。

你还需要包含一个 theme.json 文件和一个 readme.txt 文件。

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

让我们更详细地了解这些文件。

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

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

即使是“创建区块主题”功能也会为你生成一个 theme.json 文件，其中包含一些默认的全局样式和设置。

如果你没有 theme.json 文件，可以使用此模板在主题根目录中创建一个。

{
    "version": 2,
    "settings": {},
    "styles": {}
}

readme.txt 文件最初是插件必需的，现在插件和主题都使用它来提供更多相关信息。

对于主题而言，readme.txt 中的信息会显示在 WordPress.org 主题目录的主题页面上。

该文件应包含主题的相关信息，例如主题名称、描述、版本号、作者以及其他详细信息。

WordPress 的 readme 文件标准包含了你在 readme.txt 文件中可以使用的信息类型详情。

还有一个 readme 验证器，你可以用它来检查 readme.txt 文件的格式是否正确。

截图文件用于在 WordPress.org 主题目录以及 WordPress 管理区域的主题目录页面中显示主题的预览。

该文件应为 PNG 或 JPG 格式的图片，尺寸不应超过 1200 x 900 像素。

如果你使用“创建区块主题”功能来创建主题，系统会自动生成一个默认的截图文件，但最好将其替换为展示你主题特色的自定义截图。

如果你提交的是经典主题，所需的文件略有不同。

正如“经典主题简介”课程中所述，经典主题在 WordPress 网站中运行所需的唯一文件是 style.css 和 index.php 文件。

然而，当将经典主题提交到 WordPress.org 主题目录时，你还需要包含一个 comments.php 文件。

在经典主题中，这个文件包含评论模板，用于在允许评论的地方显示。

与区块主题一样，你还需要包含 readme.txt 文件和截图文件。

有关必需主题文件的更多信息，你可以参考 WordPress 主题开发者手册中“主题结构”章节的“必需文件”和“可选文件”部分。