区块编辑器手册
目录
欢迎使用区块编辑器手册。
区块编辑器是 WordPress 网站构建和发布的现代范例。它使用模块化的块系统来组合和格式化内容,旨在为网站和数字产品创建丰富且灵活的布局。
区块编辑器由几个主要元素组成,如下图所示:
突出显示的元素是:
- 插入器:用于将区块插入内容画布的面板
- 内容画布:内容编辑器,保存使用区块创建的内容
- 设置面板用于配置选定区块时的设置或帖子设置的面板
通过区块编辑器,您可以使用块以模块化方式创建内容。默认情况下,WordPress 中提供了许多块,您也可以创建自己的.
块是离散元素,例如段落、标题、媒体或嵌入。每个块都被视为具有单独编辑和格式控件的单独元素。当所有这些组件拼凑在一起时,它们就构成了页面或帖子的内容,然后存储在 WordPress 数据库中。
块编辑器是古腾堡项目的工作成果,该项目旨在彻底改变 WordPress 编辑体验。
除了通过可视化内容创建工具提供增强的编辑体验之外,块编辑器还是一个强大的开发人员平台,具有丰富的 API 功能集,允许以无数种方式对其进行操作和扩展。
浏览本手册
本手册重点关注块开发,分为五个主要部分。
- 入门:对于那些刚刚开始进行块开发的人来说,您可以在这里设置开发环境并学习块开发的基础知识。它的快速入门指南和教程:构建您的第一个块是开始学习块开发的好地方。
- 操作指南:在这里,您可以在入门部分中学习的内容的基础上学习如何解决特定问题。您还可以找到可在自己的项目中重复使用的教程和示例代码,例如使用 WordPress 数据或策划编辑器体验。
- 参考指南:本部分是手册的核心部分,您可以在其中了解实际情况并查找您正在使用或需要相关信息的特定 API 的详细信息。除此之外,块 API 参考涵盖了您想要使用块执行的大部分操作,并且每个组件和包也都记录在此处。组件也通过Storybook进行记录。
- 说明:本节使您能够通过对块编辑器架构的理论理解来更深入地巩固您的实践知识
- 贡献者指南:古腾堡是开源软件,欢迎所有人为该项目做出贡献。本节详细介绍了如何做出贡献,无论是通过代码、设计、文档还是其他方式。
更多资源
本手册应被视为与块开发相关的所有事物的规范资源。但是,还有其他资源可以帮助您。
- WordPress 开发者博客:不断增长的技术文章资源,涵盖与块开发相关的特定主题和各种用例。该博客也是了解 WordPress 最新发展的绝佳方式。
- 学习 WordPress: WordPress 学习资源中心,您可以在其中找到诸如块开发简介:构建您的第一个自定义块、将短代码转换为块或使用 WordPress 数据层等课程
- WordPress.tv:由 WordPress 社区策划和主持的 WordPress 相关视频中心(从 WordCamps 的演讲到在线研讨会的录音)。您一定会在这里找到一些东西来帮助您学习块开发或块编辑器。
- 古腾堡存储库:块编辑器的开发在 GitHub 上进行。该存储库包含有趣的包的代码,例如
block-library
(核心块)或components
(通用 UI 元素)。block -development-examples存储库是另一个有用的参考。 - 最终用户文档:此文档站点面向最终用户(而不是开发人员),您还可以在其中找到有关块编辑器和使用块的文档。