Sphinx

Sphinx内でmathを使用する方法

  • 下記のコードをsource/conf.pyに追記(参照)
# At top on conf.py (with other import statements)
import recommonmark
from recommonmark.transform import AutoStructify
github_doc_root = 'https://github.com/rtfd/recommonmark/tree/master/docs/'


# At the bottom of conf.py
# app setup hook
def setup(app):
    app.add_config_value('recommonmark_config', {
        'url_resolver': lambda url: github_doc_root + url,
        'auto_toc_tree_section': 'Contents',
        'enable_eval_rst': True,
        'enable_auto_doc_ref': True,
        'enable_math': True,
        'enable_inline_math': True,
    }, True)
    app.add_transform(AutoStructify)

  • 上記の変更に加えて、conf.py内のextensionのリストに1行追記
extensions = [
    'sphinx.ext.mathjax',
]