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 me gusta