| .. | ||
| assets | ||
| contributors | ||
| explanations | ||
| getting-started | ||
| how-to-guides | ||
| reference-guides | ||
| tool | ||
| manifest.json | ||
| private-apis.md | ||
| README.md | ||
| toc.json | ||
扩展资源
本手册应被视为区块开发相关领域的权威资源,但以下其他资源也能为您提供帮助:
- WordPress 开发者博客: 持续更新的技术文章库,涵盖区块开发专题及各类应用场景。该博客也是跟进WordPress最新动态的理想渠道。
- Learn WordPress: WordPress官方学习中心,提供《区块开发入门:创建你的第一个自定义区块》、《将简码转换为区块》、《使用WordPress数据层》等系列课程。
- WordPress.tv: 由WordPress社区维护的视频资源库,收录WordCamp演讲实录及在线研讨会录像。您一定能在此找到关于区块开发或区块编辑器的学习资料。
- Gutenberg代码库: 区块编辑器的开发在GitHub上进行。该仓库包含
block-library(核心区块)与components(通用UI组件)等重要代码包。block-development-examples代码库也是极佳的参考资源。 - 终端用户文档: 该文档站点面向终端用户(非开发者),同样收录了区块编辑器与区块操作指南相关内容。
确认您的需求场景
《区块编辑器手册》专为基于区块编辑器进行创作和开发的用户设计。请注意,开发者资源中心还提供了多本可能对您有益的手册:
区块编辑器手册
欢迎使用区块编辑器手册。
区块编辑器 是用于构建和发布 WordPress 网站的现代范式。它采用模块化的区块系统来创作和格式化内容,旨在为网站和数字产品创建丰富灵活的布局。
区块编辑器包含以下几个主要元素,如下图所示:
图中高亮显示的元素包括:
- 插入器: 用于将区块插入内容画布的面板
- 内容画布: 内容编辑器,承载使用区块创建的内容
- 设置面板: 配置选定区块设置或文章设置的面板
通过区块编辑器,您可以使用区块以模块化方式创建内容。WordPress 默认提供多种区块,您也可以创建自己的区块。
区块是一个独立元素,例如段落、标题、媒体或嵌入内容。每个区块都被视为具有独立编辑和格式控件的单独元素。当所有这些组件组合在一起时,就构成了页面或文章的内容,随后这些内容将存储到 WordPress 数据库中。
区块编辑器是 Gutenberg 项目的工作成果,该项目旨在彻底改变 WordPress 的编辑体验。
除了通过可视化内容创建工具提供增强的编辑体验外,区块编辑器还是一个强大的开发平台,拥有丰富的 API 功能集,可通过无数种方式进行操作和扩展。
手册使用指南
本手册主要关注区块开发,分为五个主要部分:
-
入门指南: 适合刚接触区块开发的用户,您可以在此设置开发环境并学习区块开发基础知识。其中的快速入门指南和教程:构建您的第一个区块是开始学习区块开发的理想起点。
-
操作指南: 在此部分,您可以基于入门指南所学知识,进一步学习如何解决特定问题。您还可以找到教程和示例代码,以便在自己的项目中重复使用,例如处理 WordPress 数据或优化编辑器体验。
-
参考指南: 这是手册的核心部分,您可以在此深入了解细节,查找正在使用或需要了解的特定 API 的详细信息。区块 API 参考涵盖了您可能需要对区块执行的大部分操作,每个组件和包也在此处记录。组件还通过 Storybook 进行文档记录。
-
贡献者指南: Gutenberg 是开源软件,欢迎所有人为此项目做出贡献。此部分详细说明了如何贡献,无论是通过代码、设计、文档还是其他方式。
