### 能否为我的站点停用古腾堡编辑器？

存在一种“经典”区块，其功能与当前编辑器几乎完全相同，只是以区块形式呈现。

另外还有[经典编辑器插件](https://wordpress.org/plugins/classic-editor/)，可恢复旧版编辑器，详情请参阅该插件说明。WordPress核心团队已承诺[在2021年12月之前](https://make.wordpress.org/core/2018/11/07/classic-editor-plugin-support-window/)持续支持经典编辑器插件。

### 自定义TinyMCE按钮在古腾堡中如何运作？

自定义TinyMCE按钮在“经典”区块中仍然有效，该区块是当前经典编辑器的区块化版本。

古腾堡配备了全新的通用插入工具，可让您访问所有可用区块，支持搜索功能，并按最近使用时间和分类排序。这一插入工具为每个向编辑器添加内容的插件提供了公平的竞争环境，并提供了统一的操作界面供用户学习使用。

### 短代码在古腾堡中如何运作？

短代码仍保持现有功能不变。

但我们认为区块是`[shortcode]`的进化形态。您无需手动输入代码，只需通过通用插入面板选择区块，即可获得更丰富的配置界面和预览效果。我们建议用户最终将短代码升级为区块。

### 是否应将短代码转换为内容区块？

我们认为基于以下多重因素（包括但不限于）应该转换：

- 区块内置可视化编辑功能，为网站建设提供更丰富、更动态的体验
- 区块本质上是HTML格式，不会在前端保留浏览器无法识别的内容。相比之下，如果您停用了支持短代码的插件，前端会显示异常视觉效果（通常以纯文本形式显示短代码）
- 随着区块目录的推出，区块将比短代码更易被发现，让更多用户获得更丰富的功能

最终，区块设计旨在直观呈现最终视觉效果，随着5.5版本区块目录的推出，这将成为用户在WordPress中发现和插入内容的预期标准方式。

## 其他事项

### 古腾堡是否充分考虑无障碍访问？

无障碍设计并非事后补充。目前古腾堡并非所有功能都实现完全无障碍。您可在此处查看已记录的问题。我们深知WordPress服务所有用户，无障碍设计关乎包容性，这是我们的核心价值。

如果您愿意为古腾堡的无障碍改进贡献力量，我们始终欢迎更多测试者和贡献者。

### 数据如何存储？我注意到HTML注释，其作用是什么？

如技术概述介绍中所述，我们的方法是在不破坏WordPress十五年来内容数据结构的前提下，对现有数据格式进行增强。换言之，这种格式优化优先考虑人类可读性（网页HTML文档）和跨平台渲染便利性，而非主要服务于编辑场景的机器便捷文件（文章元数据中的JSON格式）。

这种设计也赋予我们灵活性，可将那些本质上独立于内容流的区块（如可重用小组件或文章类型元素）存储在其他位置，仅保留其位置的标记引用。

建议您查阅古腾堡核心概念文档，深入了解该功能的运作机制。

### 如何通过PHP或JS将文章内容解析回区块？

JS方法：
```js
var blocks = wp.blocks.parse( postContent );
```

PHP方法：
```php
$blocks = parse_blocks( $post_content );
```

## 编辑体验

### 什么是“区块”？为何要使用它们？

经典WordPress编辑器是一个开放的文本窗口——它始终是绝佳的写作空白画布，但在构建包含图片、多媒体、社交媒体嵌入内容、投票及其他元素的文章与页面时，往往需要混合使用多种并不直观的操作方式：

-   通过媒体库/HTML处理图片、多媒体和授权文件
-   使用粘贴链接实现内容嵌入
-   通过短代码调用插件的特殊资源
-   使用特色图像设置文章/页面顶部图片
-   通过摘要字段设置副标题
-   通过小工具管理页面侧边内容

在思考这些使用场景并寻求直观统一的解决方案时，我们开始采用“区块”概念。上述所有元素均可转化为区块：易于检索理解，并能动态调整页面布局。区块概念极具潜力，经过精心设计后，能提供卓越的编辑发布体验。区块的终极目标是建立WordPress全新通用语言，构建连接用户与插件的新范式，取代短代码、小工具等传统内容类型——这些旧模式通常需要用户精通WordPress特性才能掌握。

### 写作体验如何？

Gutenberg的目标不仅是打造无缝的文章与页面构建体验，更致力于提供流畅的写作环境。欢迎访问[演示页面亲自体验](https://wordpress.org/gutenberg/)！

### Gutenberg基于TinyMCE开发吗？

并非如此。[TinyMCE](https://www.tinymce.com/)仅用于“经典”区块。

### Gutenberg支持键盘快捷键吗？

支持。快捷键非常丰富！可通过帮助模态窗查看所有可用快捷键。

具体操作：点击新编辑器右上角菜单中的“键盘快捷键”（或使用快捷键<kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>H</kbd>（Linux/Windows系统）/<kbd>⌃</kbd><kbd>⌥</kbd><kbd>H</kbd>（macOS系统））。

以下动画演示如何查找和使用键盘快捷键：

![展示如何访问键盘快捷键的GIF](https://make.wordpress.org/core/files/2020/07/keyboard-shortcuts.gif)

### Gutenberg支持分栏功能吗？

支持，Gutenberg提供分栏区块。

### Gutenberg支持嵌套区块吗？

支持多层嵌套——区块内可包含子区块。详见[嵌套区块教程](https://developer.wordpress.org/block-editor/tutorials/block-tutorial/nested-blocks-inner-blocks/)。

### 能否通过拖放调整区块顺序？

支持拖放区块进行重新排序。

## 开发体验

### 如何创建自定义区块？

建议从[创建区块教程](https://developer.wordpress.org/block-editor/getting-started/create-block/)开始学习。

### Gutenberg支持前端编辑文章/页面吗？

不支持。Gutenberg主要设计为替代传统文章/页面编辑界面。需注意的是，前端编辑常被误解为编辑器界面与前端完全一致。Gutenberg允许主题通过自定义区块并为编辑器提供对应样式来实现类似效果。由于内容需要适配多种场景（从桌面端、移动端到全文订阅和联合发布平台），我们认为仅基于单一前端体验进行内容创作并非理想方案。

### 鉴于Gutenberg基于JavaScript开发，传统元框（PHP）如何兼容？

请参阅[元框教程](https://developer.wordpress.org/block-editor/how-to-guides/metabox/)了解如何在新版区块编辑器中兼容元框。

# 常见问题解答

以下是古腾堡项目过去几年开发过程中积累的一系列问题。如果您有任何希望得到解答并纳入本文档的问题，[请直接在GitHub上提交问题](https://github.com/WordPress/gutenberg/issues)。我们非常乐意解答那些未曾考虑到的问题。如需回顾历史背景，请查阅Matt于2018年11月发布的文章[《WordPress 5.0：古腾堡常见问题解答》](https://ma.tt/2018/11/a-gutenberg-faq/)。

## 古腾堡项目

### 什么是古腾堡？

“古腾堡”是为WordPress创建全新编辑器体验的项目代号——贡献者自2017年1月启动该项目，这是WordPress近年来最具颠覆性的变革之一。其核心理念是采用“区块”模式来编写和设计文章与页面。这将成为WordPress未来升级的基石，包括将区块功能从内容设计延伸至全站设计。总体目标是简化WordPress新用户的操作体验——涵盖内容创作、编辑、发布及网页设计的全流程。该编辑器致力于让用户更直观地预览发布后的内容呈现效果。项目启动时的核心目标如下：

> 编辑器将致力于打造全新的页面构建体验，让富媒体内容创作变得轻松自如。通过“区块”功能，实现目前需要短代码、自定义HTML或“神秘拼盘”式嵌入操作才能完成的效果。

关键要点包括：

-   布局精美的内容创作是WordPress的核心优势
-   采用区块交互模式，可将多重操作界面统一整合。用户无需掌握短代码和自定义HTML的编写，也无需通过粘贴URL来嵌入媒体，通过统一可靠的操作流程即可插入各类内容
-   “神秘拼盘”指软件中需要用户自行探索的隐藏功能。WordPress已支持大量区块和30多种嵌入内容，现在要让这些功能浮出水面

古腾堡项目在WordPress组织下的[GitHub平台](https://github.com/WordPress/gutenberg)进行开发。自WordPress 5.0起，区块编辑器已集成至核心程序。若想体验古腾堡的新功能，可[在插件库获取测试版](https://wordpress.org/plugins/gutenberg/)。

### 长期发展规划是什么？

根据[官方路线图](https://wordpress.org/about/roadmap/)，古腾堡分为四个发展阶段（截至本文撰写时正处于第二阶段）：

1.  更便捷的编辑——自WordPress 5.0起已实现，持续优化中
2.  全面定制——全站编辑、区块模式、区块目录、区块主题
3.  协同创作——更直观的多用户协作体验
4.  多语言支持——原生多语言站点解决方案

### 项目启动于何时？

编辑器专项于2017年初启动，前三个月主要进行设计规划、原型构建与测试验证，为项目实施奠定基础。首个测试插件于2017年6月欧洲WordCamp大会期间发布。

### 何时并入WordPress核心？

古腾堡于2018年12月首次并入[WordPress 5.0](https://wordpress.org/news/2018/12/bebo/)。完整版本对应关系请参阅[WordPress中的版本记录](https://developer.wordpress.org/block-editor/principles/versions-in-wordpress/)。

### WordPress已是全球最流行的发布平台，为何还要改造编辑器？

编辑器是WordPress日常使用最频繁的核心模块，在封闭环境中打磨区块体验能获得最佳效果。作为开源项目，我们坚信WordPress必须持续创新，让核心体验始终直观易用。古腾堡作为社区项目正承载着这一使命，我们期待共同实现这个目标。如果您愿意参与测试、贡献代码或反馈建议，欢迎[在GitHub分享您的发现](https://github.com/WordPress/gutenberg/issues)。

### 插件如何扩展古腾堡界面？

我们想要强调的主要扩展点是创建新块。通过插件可以将区块添加到区块编辑器中，请参阅[构建你的第一个区块教程](https://developer.wordpress.org/block-editor/getting-started/tutorial/)开始学习。

### 自定义文章类型是否仍受支持？

是的。自定义文章类型可以通过多种方式利用古腾堡。计划允许它们指定支持的区块，并为文章类型定义默认区块。目前尚未实现，但如果文章类型禁用了内容字段，页面底部的“高级”部分将填充页面。

## 样式

### 主题能否为区块设置样式？

可以。区块可以提供自己的样式，主题可以在此基础上添加或覆盖样式，或者它们完全不提供样式，完全依赖主题提供的样式。

### 区块样式在前端和后端如何工作？

区块能够提供基础的结构性CSS样式，主题可以在此基础上添加样式。一些区块，如分隔符（`<hr/>`），可能不需要任何前端样式，而其他区块，如图库，则需要一些样式。

其他功能，如新的宽幅和全宽对齐选项，仅仅是应用于支持此对齐方式的区块的CSS类。我们正在研究主题如何选择加入此功能，例如使用`add_theme_support`。

这目前仍在开发中，我们建议查阅[基于区块的主题文档](https://developer.wordpress.org/themes/block-themes/)以了解更多信息。

### 什么是区块变体？它们与区块样式相同吗？

不，[区块变体](/docs/reference-guides/block-api/block-variations.md)是单个基础区块的不同版本，共享相似的功能，但在实现或设置（属性、内部区块等）上略有不同。区块变体对用户是透明的，一旦注册了区块变体，它将显示为一个新块。例如，`embed`区块注册了不同的区块变体，以嵌入来自特定提供商的内容。

同时，[区块样式](/docs/reference-guides/filters/block-filters.md#block-style-variations)允许您为现有区块提供替代样式，它们通过向区块包装器添加`className`来工作。一旦区块注册了区块样式，区块样式选择器将出现在其侧边栏中，用户可以在不同的注册样式之间进行选择。

### 编辑器样式如何工作？

常规的编辑器样式是选择加入的，在大多数情况下按原样工作。主题还可以通过以下钩子加载额外的样式表：

```php
function gutenbergtheme_editor_styles() {
    wp_enqueue_style( 'gutenbergtheme-blocks-style', get_template_directory_uri() . '/blocks.css');
}
add_action( 'enqueue_block_editor_assets', 'gutenbergtheme_editor_styles' );
```

_参见：_[编辑器样式](/docs/how-to-guides/themes/theme-support.md#editor-styles)

## 兼容性

### 古腾堡支持哪些浏览器？

古腾堡在现代浏览器中运行。

[支持的浏览器列表可以在Make WordPress手册中找到](https://make.wordpress.org/core/handbook/best-practices/browser-support/)。术语“现代浏览器”通常指的是每个主要浏览器的_当前版本及前两个版本_。

自WordPress 5.8起，古腾堡不再支持任何版本的Internet Explorer。

### 我需要担心古腾堡会让我的插件过时吗？

古腾堡的目标不是让任何人失业，而是推动WordPress的发展，以便未来为每个人带来更多的商业机会。

除了实现丰富的文章和页面构建体验外，一个元目标是_推动WordForward作为一个平台向前发展_，不仅通过现代化用户界面，还通过现代化基础架构。

我们意识到这是一个巨大的变化。我们也认为插件将会有许多新的机会。WordPress可能会附带一系列基础区块，但高度定制化的高级插件仍有充足的空间来增强现有区块或添加新块。