 |
概要 | Discourse Math は、MathJax（デフォルト）または KaTeX を使用して、Discourse フォーラム内の数式をレンダリングします。 |
 |
インストールガイド | このプラグインは Discourse コアにバンドルされています。別途プラグインをインストールする必要はありません。 |
数式の有効化
Math プラグインは、admin/plugins ページからアクセスできる設定で有効にできます。
機能
有効化後、単一の $ で囲むことでインライン数式をレンダリングできます。例：$E=mc^2$。
$$ で囲むことで数式のブロックをレンダリングできます。
$$
\sqrt{(-1)} \; 2^3 \; \sum \; \pi
$$
Discourse Math は、次のような文が誤って変換されないようにヒューリスティックを使用します。「20$ を使い、さらに 100$ を使った」など。
LaTeX 区切り文字
サイト設定で有効化した場合、標準的な LaTeX 区切り文字も使用できます。
- インライン:
\(...\)- 例：\(E=mc^2\) - ブロック:
\[...\]- 例：\[ \frac{1}{2} \]
AsciiMath（MathJax のみ）
MathJax を使用している場合、% を区切り文字として使用する asciimath 処理を有効にできます。例：%E=mc^2%
コンポーザー統合
コンポーザーには、ツールバーに 数式を挿入 ボタンがあり、キーボードショートカットは \u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eM\u003c/kbd\u003e です。これによりモーダルが開き、以下の操作が可能です。
- インラインモードとブロックモードの切り替え
- LaTeX 式の記述
- プレビューして投稿に挿入
リッチテキストエディターでは、数式は編集可能なノードとして表示され、式を修正するための編集ボタンがあります。
チャットサポート
数式は、同じ設定とレンダリングエンジンを使用して Discourse チャットメッセージでもレンダリングされます。
レンダリングエンジン
MathJax（デフォルト）
- バージョン: 4.1
- 出力形式: HTML（デフォルト）または SVG
- 機能:
- コンテキストメニュー（数式を右クリック）
- スクリーンリーダー向けのアクセシビリティ強化
- Alt キー押下時のズーム（175% ズーム）
- AsciiMath サポート
KaTeX（代替）
- 機能:
- 高速レンダリング
- 化学反応式用の Mhchem 拡張機能
- LaTeX ソースをクリップボードにコピーするための CopyTex 拡張機能 - 数式をクリックしてコピー
\\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