Discourse Math

プラグイン
, ,
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