进阶 docs.nodebb.org 2026-10-13 15:07:09 · 33 阅读
第51章 NodeBB 帖子内容解析
解析帖子内容
NodeBB 不绑定特定编辑器,这意味着默认的编辑器与标记插件组合(即 composer-default 和 markdown)可以根据需求进行替换。
为此,NodeBB 触发了多个与内容解析相关的钩子。
本文讨论的是 filter:parse:post 钩子,该钩子由 posts.parsePost 调用。
函数签名
parsePosts(post, type)
post 是一个包含帖子数据的对象,通常通过调用 posts.getPostData(pid) 获取。
注意:无需传入完整的帖子对象,最低要求仅包含 pid 和 content 属性即可。
type 是一个可空字符串,用于向插件提示期望的输出格式。可选值如下:
null或假值,系统默认传递给插件。default,用于前端显示的 HTML。plaintext,纯文本,不包含 HTML 标记。activitypub.note,用于向远程实例同步(参见 Fediverse)的 HTML;通常仅使用有限的合法 HTML 标签,例如文本格式化相关标签。activitypub.article,用于向远程实例同步的 HTML;此类型预留给未来使用。markdown,用于向远程实例同步的 Markdown;在大多数情况下,这与原始内容相同。
开发建议
当你的插件监听 filter:parse.post 钩子时,应审视可用的类型,并判断插件是否需要对每种类型做出响应。虽然大多数类型与 HTML 相关,但 plaintext 和 markdown 需要特定的处理逻辑(或者选择忽略)。
示例
假设某插件将帖子正文中的链接展开为动态链接预览。将复杂的 HTML(包含 class、table 等)发送到其他服务器是不合理的,且 Markdown 中没有等价形式。
该插件应仅在 default 类型时执行操作,其他情况不做处理。
假设某插件查找 bbcode 并将其转换为 HTML。向其他服务器发送简单 HTML 是可以接受的。
该插件应针对 plaintext(移除 bbcode 标签)和 markdown(可选转换为 Markdown 等价形式)执行替代逻辑,其他情况下正常执行。