一旦您的主题在 WordPress.org 主题目录上线，您可能需要不时更新它。这可能是为了修复漏洞、添加新功能或进行常规改进。

在 WordPress.org 上更新主题有两种方法：上传新的 zip 文件或使用 Subversion (SVN)。

让我们来看看这两种方法。

上传新的 zip 文件

更新主题最直接的方法是将新的 zip 文件上传到 WordPress.org 主题目录。

一旦您对主题文件进行了任何更改，就需要更新 style.css 文件中的版本号。

/*
 * Theme Name: Twenty Twenty-Four
 * Version: 1.2
 */

这很重要，因为它会告诉 WordPress 有新版本的主题可用。

然后，使用您首次提交时所用的方法，为您的主题目录创建一个新的 zip 文件。

最后，浏览到 https://wordpress.org/themes/upload/，并按照相同的流程上传 zip 文件。

使用 Subversion (SVN)

另一种替代 zip 上传的方法是使用 Subversion（也称为 SVN）来更新您的主题。

Subversion 是一种类似于 Git 的版本控制系统，允许您管理代码的更改。

当 WordPress 插件仓库首次创建时，使用 Subversion 允许开发者管理插件和主题的更新。

这主要是因为当时 Git 和 GitHub 还不存在，而 Subversion 是开源开发者使用的默认版本控制软件。

因此，在几年后 WordPress 主题目录推出时，使用相同的系统是合理的。

要使用 Subversion 更新主题，您需要在本地机器上安装 Subversion，然后使用它将更改提交到 WordPress.org 主题目录。

使用 Subversion 的好处之一是，它允许您跟踪主题随时间的变化，并在需要时轻松回滚到以前的版本。

您可以在主题目录中您的主题页面上，在“浏览代码”下找到 Subversion 仓库 URL。

例如，Twenty Twenty-Four 主题的 URL 是：

https://themes.svn.wordpress.org/twentytwentyfour/

macOS 和 Linux

对于 macOS 用户，您可以使用 Homebrew 安装 Subversion。

如果您还没有安装 Homebrew，需要先安装它。

安装 Homebrew 后，在终端中运行以下命令来安装 Subversion：

brew install subversion

Linux 用户可以使用包管理器安装 Subversion。例如，在 Ubuntu 上，您可以运行：

sudo apt install subversion

安装 Subversion 后，您可以使用它从 WordPress.org 检出主题仓库。

在终端中，导航到您要存储主题文件的目录，并运行 svn co（或 checkout）命令：

svn co https://themes.svn.wordpress.org/twentytwentyfour/

这会将主题文件从 Subversion 仓库下载到您的本地机器。

下一步是创建最新版本主题的副本，以生成更新版本。

首先，导航到您的主题目录

cd twentytwentyfour

然后，使用 svn cp（或 copy）命令创建最新版本主题的副本：

svn cp 1.1 1.2

现在，您可以在新目录中对主题文件进行更改。

确保更新 style.css 文件中的版本号以匹配新版本，并更新 readme.txt 中的更新日志。

准备好提交新版本的主题后，您可以运行 svn commit 命令：

svn commit -m "Fix typo on readme.txt"

在提交过程中，系统会要求您输入用户名和密码。这与您登录 WordPress.org 主题目录时使用的用户名和密码相同。

Windows

对于 Windows 用户，您可以下载并安装 TortoiseSVN，它提供了管理 Subversion 仓库的图形界面。

TortoiseSVN 与 Windows 资源管理器集成，因此您可以右键单击文件夹内部，选择 TortoiseSVN -> 检出 选项，将主题文件下载到本地机器。

建议为您的主题文件创建一个专门的文件夹，并将仓库检出到该文件夹中。

它会要求您提供 Subversion 仓库的 URL，您可以在主题目录中的主题页面上找到它。

检出完成后，您可以通过创建新文件夹并复制文件，或复制粘贴现有文件夹并重命名，来创建主题的新版本。

现在，您可以在新目录中对主题文件进行更改。

确保更新 style.css 文件中的版本号以匹配新版本，并更新 readme.txt 中的更新日志。

当你准备好提交主题的新版本时，可以在主文件夹内右键点击，然后选择 TortoiseSVN -> 提交 选项。

这会打开一个对话框，你可以在其中输入提交信息，选择所有要提交的文件，然后点击“确定”来提交更改。

与 macOS 和 Linux 系统一样，在提交过程中系统会要求你输入用户名和密码。这与登录 WordPress.org 主题目录时使用的用户名和密码相同。

成功提交之后

成功提交后，你会收到一封来自 WordPress.org 的电子邮件，确认你的主题新版本已上传。

在 WordPress.org 目录中显示可能需要一些时间，但更新后的版本通常会在几小时内可用。

完成主题开发后，你需要将其准备好提交到 WordPress.org 主题仓库。

在本课中，你将学习如何准备主题提交，包括如何测试主题、检查并遵循主题审查指南，以及为主题准备文档。

测试你的主题

在将主题提交到 WordPress.org 主题目录之前，你应该彻底测试它，确保其按预期工作。

这包括测试是否存在任何错误或警告、如何处理不同类型的内容，以及在可访问性和性能方面的表现。

高级主题开发模块中的“测试你的主题”课程详细涵盖了所有这些方面，请务必复习该课程。

针对 WordPress 的下一个版本测试你的主题也很有帮助，以确保其保持兼容性。

为此，你可以安装 WordPress Beta Tester 插件，该插件允许你将网站切换到 WordPress 的最新测试版或候选发布版。

一旦你确信已彻底测试了主题，就可以进入下一步。

主题审查指南

WordPress 主题审查指南是一套要求，在将主题提交到 WordPress.org 主题目录时需要遵守。

这些指南涵盖了广泛的主题，包括：

1. 许可与版权
2. 隐私
3. 可访问性
4. 代码要求
5. 功能与特性
6. 插件
7. 命名、拼写和商标
8. 语言与国际化
9. 文件要求
10. 经典主题要求
11. 块主题要求
12. 主题设置页面和引导
13. 升级销售、信用、链接和垃圾信息
14. 主题作者和主题上传限制

你的下一步是审查主题审查指南中的每一项，并确保你的主题满足所有要求。

如果你已经使用“测试你的主题”课程中提到的工具彻底测试了主题，那么你应该已经解决了主题审查指南涵盖的许多问题。

不过，仍然建议你逐一检查所有项目，并在提交前确认每项都符合要求。

在提交过程中，如果主题根据这些指南包含 3 个或更多不同的问题，可能会被关闭并标记为未批准。

修复问题后可以重新提交主题，但这会延迟流程。

准备文档

准备主题提交的最后一步是创建文档，详细说明主题的功能、自定义选项以及任何独特方面。

主题需要提供最终用户文档，说明任何设计限制或特殊的安装/设置说明。

根据文档的详细程度，将决定你在何处添加这些信息。

虽然你可以将这些信息添加到主题的 readme.txt 文件中，但通常更容易的做法是在专门的主题主页上提供这些信息。

许多主题开发者会在其网站上创建一个页面，提供关于主题的详细信息，包括安装说明、自定义选项以及任何其他相关信息。

然后，他们会使用 style.css 文件中的主题 Theme URI 字段链接到该页面。

此链接将显示在 WordPress.org 主题目录中的主题页面以及 WordPress 管理后台中，用户可以点击它访问主题文档。

结论

一旦你测试了主题、对照主题审查指南进行了检查并准备了文档，你就可以将主题提交到 WordPress.org 主题目录了。

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

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

区块主题

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

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

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

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

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

theme.json

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

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

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

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

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

readme.txt

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 主题开发者手册中“主题结构”章节的“必需文件”和“可选文件”部分。