Discourse Math

Plugin
, ,
242

@sam および、Discourse で数式を入力することに関心のあるすべての方へ。discourse-math プラグインを更新し、はるかに遅く時代遅れの V2 ではなく MathJax V3 を使用するようにしました。ご想像の通り、その結果、KaTeX と比較して機能豊富な環境を維持しながら、はるかに軽快なユーザーエクスペリエンスが得られました。

もし結果が良ければ、プルリクエストを発行したいと思います。

私のクラスの Discourse サイトで実際に動作しているのを見ることができます。

そのサイトのコンテンツのほとんどは非公開または限定公開です。アイデアを示すために、MathJax V3 カテゴリの先頭にいくつかのトピックがあるはずですが、

プラグインのコードはこのスタンドアロンの discourse-mathjax プラグインリポジトリで確認できます。最も多くの変更が加えられているファイルはinitializerです。

また、そのリポジトリを使用して、すぐにスタンドアロンサイトにインストールすることもできます。インストール時には、古いリポジトリを削除するようにしてください。したがって、標準のプラグインインストール手順を次のように変更する必要があります。

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 と同一です。後で最新の MathJax リポジトリをドロップインするだけでアップグレードできるはずです。

locales/server.en.yml ファイルで 1 つの小さな変更を加える必要がありました。もちろん、さまざまな言語に対応するファイルは他にもたくさんあります。私の理解では、これらの他のファイルは後で自動的に翻訳されるということでしょうか？

チャットはまったく利用しておらず、そのコンテキストではテストしていません。

1 Mi Piace