| .. | ||
| contributors | ||
| explanations | ||
| getting-started | ||
| how-to-guides | ||
| reference-guides | ||
| private-apis.md | ||
| README.md | ||
| title | post_status | comment_status | taxonomy | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 区块编辑器手册 | publish | open |
|
区块编辑器手册
欢迎阅读区块编辑器手册。
区块编辑器 是用于 WordPress 网站构建与发布的现代范式。它采用模块化的 区块 系统来组织和格式化内容，旨在为网站和数字产品创建丰富灵活的布局。
区块编辑器包含以下几个主要元素，如下图所示：
图中高亮显示的元素包括：
- 插入器： 用于将区块插入内容画布的面板
- 内容画布： 内容编辑器，承载使用区块创建的内容
- 设置面板： 用于配置所选区块设置或文章设置的面板
通过区块编辑器，您可以模块化地使用区块创建内容。WordPress 默认提供多种区块，您也可以创建自定义区块。
区块 是独立的内容元素，例如段落、标题、媒体或嵌入内容。每个区块都被视为具有独立编辑和格式控件的单独元素。当所有这些组件组合在一起时，就构成了页面或文章的内容，随后这些内容将存储到 WordPress 数据库中。
区块编辑器是 古腾堡项目 的工作成果，该项目旨在彻底革新 WordPress 的编辑体验。
除了通过可视化内容创建工具提供增强的编辑体验外，区块编辑器还是一个强大的开发平台，拥有丰富的 API 功能集，可通过无数种方式进行操作和扩展。
使用本手册
本手册专注于区块开发，分为五个主要部分。
-
入门指南: 对于刚刚开始区块开发的用户，您可以在此处设置开发环境并学习区块开发基础知识。其快速入门指南和教程：构建您的第一个区块是开始学习区块开发的绝佳起点。
-
操作指南: 在这里，您可以基于入门部分所学，学习如何解决特定问题。您还可以找到教程和示例代码，以便在您自己的项目中重用，例如处理 WordPress 数据或优化编辑器体验。
-
参考指南: 本部分是手册的核心，您可以在此深入细节，查找您正在使用或需要了解的特定 API 的详细信息。其中，区块 API 参考涵盖了您对区块的大部分操作，每个组件和包也在此处有文档记录。组件也通过 Storybook 进行了文档记录。
-
贡献者指南: Gutenberg 是开源软件，欢迎所有人为此项目做出贡献。本部分详细说明了如何贡献，无论是通过代码、设计、文档还是其他方式。
更多资源
本手册应被视为区块开发相关所有事项的权威资源。不过，还有其他资源可以帮助您。
- WordPress 开发者博客: 一个不断增长的技术文章资源库，涵盖区块开发的特定主题和多种用例。该博客也是了解 WordPress 最新动态的绝佳途径。
- Learn WordPress: WordPress 学习资源中心，您可以在此找到诸如区块开发入门：构建您的第一个自定义区块、将短代码转换为区块或使用 WordPress 数据层等课程。
- WordPress.tv: 由 WordPress 社区策划和管理的 WordPress 相关视频中心（从 WordCamp 演讲到在线研讨会录像）。您一定能在这里找到有助于学习区块开发或区块编辑器的内容。
- Gutenberg 仓库: 区块编辑器在 GitHub 上进行开发。该仓库包含有趣的软件包代码，例如
block-library（核心区块）或components（通用 UI 元素）。block-development-examples 仓库是另一个有用的参考。 - 最终用户文档: 该文档站点面向最终用户（而非开发者），您也可以在此找到关于区块编辑器和使用区块的文档。
Are you in the right place?
The Block Editor Handbook is designed for those looking to create and develop for the Block Editor. However, it's important to note that there are multiple other handbooks available within the Developer Resources that you may find beneficial:
