数式の追加

設定

extensions に MathJax を用いた拡張機能 sphinx.ext.mathjax を追加し、 mathjax3_config で MathJax 公式ドキュメント にて示されているような設定を追加する。

Hint

本サイトでは以下のような設定をしている。

# setting of MathJax
# Extension for MathJax is already enabled by myst_nb.
# MathJax URL working with Plotly was written in https://www.npmjs.com/package/plotly.js/v/2.16.4#mathjax.
mathjax_path = "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-svg.js"
mathjax3_config = {
    "tex": {
        "macros": {
            "bm": ["{\\boldsymbol{#1}}", 1],
        },
    },
}

Jupyter Notebook を表示できる myst_nb という拡張機能を導入すると自動で拡張機能 sphinx.ext.mathjax が有効化されるため、 MathJax の追加の設定のみ行っている。

また、Jupyter Notebook で数式込みの Plotly ライブラリのグラフを表示するために、使用する MathJax の URL を変更する必要があった。（グラフの追加の設定）

rst ファイル

.. math::

    \sum_{n=1}^\infty \frac{1}{n^2} = \frac{\pi^2}{6}

詳しい使い方はリファレンス を参照。

出力

\[ \begin{align}\begin{aligned}\sum_{n=1}^\infty \frac{1}{n^2} = \frac{\pi^2}{6}\\\begin{split}\bm{a} = \begin{pmatrix} a_1 \\ a_2 \\ a_3 \end{pmatrix}\end{split}\end{aligned}\end{align} \]