介绍 Discourse 文档分类的可视化索引编辑器

文档类别现在可以直接在管理后台界面中构建其侧边栏索引。索引编辑器是 Doc Categories 插件 即将推出的功能,它免去了维护单独索引主题的需要。

两种生成索引的方式

编辑类别时,现在有一个 文档索引 选项卡,其中包含模式选择器:

  • 编辑器 就地构建索引,由包含链接的各个部分组成。
  • 索引主题 是现有的行为,其中主题的标题和列表将作为索引。
  • 禁用 会关闭该类别的侧边栏索引。

已经指向索引主题的类别将继续像今天一样完全正常工作。

构建索引

一个部分包含链接,而一个链接可以指向一个主题或你输入的任何 URL。每个链接都可以带有自己的图标,当两个链接指向同一位置或两个部分共享同一标题时,编辑器会向你发出警告。

你还会看到类别中未出现在索引中的主题,并且可以批量添加这些主题:

自动索引 部分会自动从类别的主题中填充,因此你可以手动列出你关心的页面,并让所有内容在其他地方收集到一个位置。它可以在每次保存时重新同步。

通过拖动可以重新排序部分和链接。每个拖动手柄也是一个普通的 Tab 键焦点点,可以打开移动菜单,因此整个索引可以通过键盘重新排列。批量模式支持多选,例如一次删除多行或拖动整个选择。

在你的站点上启用

索引编辑器是一项实验性的即将推出的功能。请在 /admin/config/upcoming-changes 中启用 Doc categories index editor(文档类别索引编辑器)。它仅影响文档类别,且仅影响管理员在编辑这些类别时所看到的内容。

我们期待你的反馈

告诉我们它在处理真实索引时的表现如何:在此处构建索引是否优于维护主题,在将类别迁移过来之前还缺少什么,以及任何让你感觉粗糙的地方。

14 个赞

最初的 PR FEATURE: Add visual doc category index editor - Pull Request #87 - discourse/discourse-doc-categories - GitHub 刚刚被合并,作为一个实验性的待推出变更。在将其移至 Alpha 阶段之前,该功能在未来一两周内可能会经历进一步的完善。

1 个赞