Discourse Math

Greffon
, ,
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 « J'aime »