Discourse Math

插件
, ,
242

@sam 以及所有对在 Discourse 中输入数学内容感兴趣的人。我已经更新了 discourse-math 插件，使其使用 MathJax V3，而不是速度慢得多且非常过时的 V2。正如预期的那样，结果是用户体验更加灵敏，同时与 KaTeX 相比仍保持功能丰富的环境。

如果结果看起来不错，我很乐意提交一个拉取请求（pull request）。

您可以在我的课堂 Discourse 网站上看到它的实际效果：

该网站上的大多数内容都是私密或未列出的。在顶部的 MathJax V3 类别中应该有几个主题来说明这些想法，不过

您可以在这个独立的 discourse-mathjax 插件仓库中检查插件的代码。修改最多的文件是初始化文件。

您也可以立即使用该仓库将其安装在独立站点上。只需确保在安装过程中删除旧的仓库。因此，您需要修改标准的插件安装技术使其如下所示：

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - rm -r discourse-math
          - git clone https://github.com/discourse/docker_manager.git
          - git clone https://github.com/mcmcclur/discourse-math.git

评论

MathJax 的最新版本实际上是 4.0.0。我选择使用 V3.2.2 是有几个原因：

  • 虽然 V4 比 V2 快得多，但它不如 V3 快。
  • V4 中的用户体验略有不同，特别是当用户点击输出时。
  • 4.0.0 的状态让我怀疑可能存在多少错误。

话虽如此，V4 的 API 与 V3 的 API 相同。稍后可以通过简单地放入最新的 MathJax 仓库来升级。

我不得不在 locales/server.en.yml 文件中进行了一个小的更改。当然，对于各种语言还有很多这样的文件。我的理解是，那些其他文件稍后会自动翻译？

我完全不使用聊天，也没有在那种情况下进行测试。

1 个赞