 |
概要 | Discourse Math は、Discourse フォーラムで数式をレンダリングするために MathJax (デフォルト) または KaTeX を使用します。 |
 |
インストールガイド | このプラグインは Discourse コアにバンドルされています。プラグインを個別にインストールする必要はありません。 |
数式の有効化
Math プラグインは、admin/plugins ページからアクセスできる設定から有効にできます。
機能
有効化すると、$ で囲むことでインライン数式をレンダリングできます。例: $E=mc^2$。
$$ で囲むことで、数式のブロックをレンダリングできます。
$$
\sqrt{(-1)} \; 2^3 \; \sum \; \pi
$$
Discourse Math は、“I spent 20$ and another 100$” のような文が変換されないようにするためのヒューリスティックを使用しています。
LaTeX デリミタ
サイト設定から有効化すると、標準的な LaTeX デリミタも使用できます。
- インライン:
\(...\)- 例:\(E=mc^2\) - ブロック:
\[...\]- 例:\[ \frac{1}{2} \]
AsciiMath (MathJax のみ)
MathJax を使用している場合、区切り文字として % を使用する asciimath の処理を有効にできます: %E=mc^2%
コンポーザー統合
コンポーザーには、ツールバーに数式の挿入ボタンがあり、キーボードショートカットは Shift+M です。これにより、次の操作ができるモーダルが開きます。
- インラインモードとブロックモードの切り替え
- LaTeX 式の入力
- プレビューと投稿への挿入
リッチテキストエディタでは、数式は編集可能なノードとして表示され、式を変更するための編集ボタンがあります。
チャットサポート
数式は、Discourse Chat のメッセージでも、同じ設定とレンダリングエンジンを使用してレンダリングされます。
レンダリングエンジン
MathJax (デフォルト)
- バージョン: 4.1
- 出力形式: HTML (デフォルト) または SVG
- 機能:
- コンテキストメニュー (数式を右クリック)
- スクリーンリーダー向けのアクセシビリティ強化
- Alt+クリックでズーム (175% ズーム)
- AsciiMath サポート
KaTeX (代替案)
- 機能:
- 高速レンダリング
- 化学式用の Mhchem 拡張機能
- CopyTex 拡張機能 - 数式をクリックして LaTeX ソースをクリップボードにコピー
\label、\ref、\eqrefマクロによる相互参照サポート
サイト設定
“math” で管理画面の設定を検索すると、関連するすべてのサイト設定が表示されます。
| 名前 | 説明 |
|---|---|
| discourse math enabled | Discourse Math プラグインを有効にする ($ と $$ ブロックに特別な処理を追加) |
| discourse math provider | 数式レンダリングプロバイダー: mathjax (デフォルト) または katex |
| discourse math enable latex delimiters | LaTeX 形式のデリミタを有効にする: インライン用 \(...\)、ブロック用 \[...\] |
| discourse math mathjax output | MathJax の出力形式: html (デフォルト) または svg (MathJax のみ) |
| discourse math enable menu | 数式用のコンテキストメニューを有効にする (MathJax のみ) |
| discourse math enable accessibility | テキスト強化などのアクセシビリティ機能を有効にする (メニュー付き MathJax のみ) |
| discourse math zoom on click | Alt+クリック操作で 175% ズーム (メニュー付き MathJax のみ) |
| discourse math enable asciimath | % デリミタによる asciimath 処理を有効にする (MathJax のみ) |
当社でホストしていますか？このプラグインは、すべてのホスティングティアで利用可能です Math | Discourse - Civilized Discussion