引入目录块的古腾堡 WordPress 插件

技术教程 2021年11月6日

1083 0 6

曾经可能被视为插件领域的东西现在作为 Gutenberg 项目的一部分成为现实.昨天，该团队将目录 (TOC) 块的拉取请求合并到插件的代码库中.这是近一年前由开发者 Zebulan Stanphill 推动的一项贡献.

TOC 块可能感觉有点小众.但是，显然需要它.至少有两个独立的块插件来处理该功能，并且有几个块库插件涵盖了它.上周，一位读者询问了这样的解决方案.很快，Gutenberg 插件以及最终的 WordPress 将涵盖他和其他人.

该块目前在 WordPress.org 的插件中不可用.它尚未正式发货.要对其进行测试，用户需要克隆 Gutenberg GitHub 存储库或获取每晚测试版的 ZIP 文件.对于那些想要等待的人来说，它应该会在未来几周内登陆古腾堡 10.1.

包括这些更小众的块是项目的一个很好的方向—脚注块也是一种可能性.虽然感觉像是踩到了插件开发人员的脚趾，但 WordPress 需要扩展.第三方开发人员有足够的空间来构建其他块.当用户必须筛选大量插件以找到其编写过程的核心内容时，体验会下降.最终应包含在平台中的区块是有限制的.但是，WordPress 是发布软件.高级书写功能(例如目录和脚注)完全属于默认设置.

目录块

这个块与用户习惯的其他块有点不同.TOC 是文档中所有标题的列表.对于 WordPress 和一般网页，目录链接到这些标题.这允许用户在页面上跳转.块依赖于内容中的其他块，这是块编辑器的一个新概念.

当第一次将块添加到空白页面时，它会显示一条帮助消息.

用户必须开始在他们的帖子中添加标题块才能使用 TOC 块.添加后，每个标题都显示为一个列表项.该块还为子标题正确嵌套了列表项—例如，H3 进入 H2 下的子列表.

这是事情变得更加复杂的时刻.在网络上，TOC 需要链接到这些标题，以便读者可以跳转到他们想要查看的部分.目前，这不会自动发生.也许将来会这样做，但是用户必须手动添加 HTML 锚点才能使链接部分起作用.理想情况下，初始帮助消息将链接到有关如何为新用户执行此操作的文档页面.

添加 HTML 锚点很容易.但是，对于具有数十个标题的长帖子来说，这可能需要大量工作.

要添加锚点，用户必须单击每个标题并导航到块选项面板.在"高级"选项卡下，输入唯一 ID.最容易以文本本身命名.带有"新世界"的标题块获得 a-new-world 的锚点.当其他人深入链接到帖子、创建更漂亮的 URL(例如 yoursite.com/blog/post-name/#a-new-world)时，这也很有帮助.