你好 Meta，我们回来了。我们来谈谈 Markdown-it 和 BBcode

TheDarkWizard · 2022 年5 月 5 日 19:27

免责声明：我知道将 BBCode 塞回 Discourse 是不寻常的，但这是我们完全迁移到 Discourse 的少数障碍之一，而且我见过一些（数量不多但非常大的）网站在一定程度上使用了自定义 BBCode。任何帮助都将不胜感激。

大家好，

在暂停了一年的测试后，批量导入测试已经恢复。我们可以在几个小时内处理 3000 万条消息（包括私人消息）、用户、头像等。附件仍然需要一周时间，但没有什么事是完美的。

上次我们处理的最后几件事之一是我们的 BBCode 套件，它位于这里：Tutorial - RpNation - BBcode Guide | RpNation （该链接是我们在 XenForo 上的实时站点，所有这些代码都是我们为社区制作的）。

我们大部分已经让它们在 Discourse 上工作了：GitHub - RpNation/discourse-rpn-bbcode

但是我们在块代码内的行内 BBCode 上遇到了问题：

[block][inline]text[/inline]
text
[/block]

为了解决这个问题，我们有一个不优雅的分支 Refactor/TextPostProcss，它在 BBCode 解析后运行正则表达式替换。

我想知道是否有人对如何在 Markdown-it 和 Discourse 的限制内改进我们正在做的事情有什么想法。我们也曾考虑过在某个时候使用一个全新的 BBCode 解析器作为一种选择。

对于那些好奇的人来说，这是我们的一些用户在 XenForo 上使用 BBCode 制作的一些东西：Resource - 𝚌𝚊𝚗𝚍𝚢 𝚜𝚔𝚒𝚎𝚜: 𝚝𝚑𝚎 𝚜𝚠𝚎𝚎𝚝 𝚏𝚊𝚌𝚝𝚘𝚛𝚢! | RpNation

在我们的新分支之后，它现在大部分在 Discourse 上工作，但我们还没有为 BBCode 设置 Discourse 演示。（在我们将注意力重新集中到整个 BBCode 之前，我们将首先关注批量导入器和样式设置）。

感谢 @Alteras 去年在我们的 BBCode 项目中领先。也感谢 @Ghan，尽管他主要负责批量导入器的工作，我只是一个负责样式的技术人员，也是这个网站的所有者。

Canapin · 2022 年5 月 5 日 22:14

我无法理解你所说的一切，但也许这些信息会让你感兴趣？

TheDarkWizard · 2022 年5 月 5 日 23:24

还没有，但我们已经有一些线索了！

Falco · 2022 年5 月 6 日 15:03

我想知道从 bbcode 迁移到 html 自定义元素是否会更容易。这是否可行？

TheDarkWizard · 2022 年5 月 6 日 15:15

我们过去确实考虑过并希望实现这一点，我之前不知道我们可以扩展和列出已允许的 HTML 集合。我们已经有一个针对该问题的变通方法，但它是一个在客户端运行的正则表达式，用于修复任何剩余的标签问题。

您能否提供一些文档或示例给我们参考？

Falco · 2022 年5 月 6 日 18:54

github.com/discourse/discourse-footnote

assets/javascripts/lib/discourse-markdown/footnotes.js

683fb3fad

export function setup(helper) {
  helper.registerOptions((opts, siteSettings) => {
    opts.features["footnotes"] = !!siteSettings.enable_markdown_footnotes;
  });

  helper.allowList([
    "ol.footnotes-list",
    "hr.footnotes-sep",
    "li.footnote-item",
    "a.footnote-backref",
    "sup.footnote-ref",
  ]);

  helper.allowList({
    custom(tag, name, value) {
      if ((tag === "a" || tag === "li") && name === "id") {
        return !!value.match(/^fn(ref)?\d+$/);
      }
    },
  });

This file has been truncated. show original

github.com/discourse/discourse-brightcove

assets/javascripts/lib/discourse-markdown/discourse-brightcove.js.es6

2a601490a

function addVideo(buffer, matches, state) {
  const video_id = matches[1];

  let token = new state.Token("div_open", "div", 1);
  token.attrs = [
    ["class", "brightcove-container"],
    ["data-video-id", video_id],
  ];
  buffer.push(token);
  token = new state.Token("div_close", "div", -1);
  buffer.push(token);
}

export function setup(helper) {
  helper.allowList(["div.brightcove-container", "div[data-video-id]"]);

  helper.registerPlugin((md) => {
    const rule = {
      matcher: /\[video=([0-9]+)\]/,
      onMatch: addVideo,

This file has been truncated. show original

github.com/discourse/discourse-graphviz

assets/javascripts/discourse-markdown/discourse-graphviz.js

526a07b10

export function setup(helper) {
  if (!helper.markdownIt) {
    return;
  }

  helper.allowList([
    "div.graphviz",
    "div.graphviz.is-loading",
    "div.graphviz-svg",
  ]);

  helper.registerOptions((opts, siteSettings) => {
    opts.features.graphviz = siteSettings.discourse_graphviz_enabled;
  });

  helper.registerPlugin((md) => {
    if (md.options.discourse.features.graphviz) {
      md.block.bbcode.ruler.push("graphviz", {
        tag: "graphviz",

This file has been truncated. show original

话题		回复	浏览量
Remove BBCode and convert to Markdown Support	4	1954	2020 年7 月 13 日
BBCode formatting issue when migrating from Vanilla to Discourse Migration vanilla	11	741	2020 年12 月 11 日
Best Course of Action on Supporting Custom BBCode? Dev	10	2256	2020 年4 月 24 日
Formatting posts using markdown, BBCode, and HTML Using Discourse reference	14	15535	2025 年4 月 22 日
Discourse BBCode Plugin official , bbcode	11	25397	2025 年8 月 8 日

你好 Meta，我们回来了。我们来谈谈 Markdown-it 和 BBcode

相关话题