gutenbergdocs/contributors/code/back-merging-to-wp-core.md
2025-10-22 01:33:45 +08:00

38 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 将代码反向合并至WordPress核心
在WordPress软件的主要版本发布时需要将Gutenberg的功能合并到WordPress核心代码中。通常这涉及提取Gutenberg代码库中`.php`文件的变更并在WP核心代码库中进行相应更新。
## 合并标准
### 文件/目录范围
以下文件/目录内的变更通常需要反向合并至WP核心
- `lib/` 目录
- `phpunit/` 目录
### 排除目录/文件
以下目录/文件_无需_反向合并至WP核心
- `lib/load.php` - 插件专用代码
- `lib/experiments-page.php` - 实验性功能为插件专用
- `packages/block-library` - 将在程序包同步过程中自动处理
- `packages/e2e-tests/plugins` - 仅限端到端测试相关的PHP文件主要为测试数据生成器
- `phpunit/blocks` - 该代码由Gutenberg维护测试文件也应保留在此
请注意此列表并未涵盖所有情况。
### 拉取请求标准
通常来说,自[上一稳定版WP核心](https://developer.wordpress.org/block-editor/contributors/versions-in-wordpress/)所包含的最终版Gutenberg发布之日起所有提交至Gutenberg代码库的PHP代码都应考虑反向合并至WP核心。
但存在以下例外情况符合这些标准的PR_无需_反向合并至WP核心
- 未包含PHP代码变更
- 具有`Backport from WordPress Core`标签 - 该代码已存在于WP核心正在同步回Gutenberg
- 具有`Backported to WordPress Core`标签 - 该代码已完成向WP核心的同步
## 扩展阅读
另请参阅关于[Gutenberg PHP代码](/lib/README.md)的补充文档。