数式入りのmarkdownをSphinxを使ってhtml/pdfにする
Sphinxでmarkdown拡張を扱うためのrecommonmarkというライブラリがあります。 これを使うとreSTではなく、markdownを書いてhtmlやPDFが吐けるようになります。
詳細は以下のエントリにやり方がまとまっています。
tech.3rd-p-zombie.net実は、このrecommonmarkはconfigに設定を書くだけで、数式をmarkdownの中に埋め込めるのでした。
conf.pyの上の方に以下をimportし、
import recommonmark from recommonmark.parser import CommonMarkParser from recommonmark.transform import AutoStructify
source_suffix
の修正、source_parsers
の追加
source\_suffix = ['.rst', '.md'] #source\_suffix = '.rst' source\_parsers = { '.md' : 'recommonmark.parser.CommonMarkParser' }
最後尾に以下を追加します。
def setup(app): app.add\_config\_value('recommonmark\_config', { 'enable\_math': True, 'enable\_inline\_math': True, }, True) app.add\_transform(AutoStructify)
すると、
```math (a + b)^2 = a^2 + 2ab + b^2 ```
とかくと、以下の数式の部分のようになります。(document)
また、inlineの数式も以下のように書けます。 (document)
This formula `$ y=\sum_{i=1}^n g(x_i) $`
ただ、残念ながら式番号を出す方法はわかりませんでした。
[追記]
@chezou 数式番号ですが、conf.py に math_number_all = True を入れるとどうなりますか https://t.co/tH2ouf7Hk6
— shirou - しろう (@r_rudi) 2017年1月22日
conf.pyにmath_number_all = True
を足せば数式がでました。ですが、参照はできないと思うので参照が必要な場合はreSTで書く必要があると思います。
[/追記]
$ make latexpdfja
とすれば、PDFが、
$ make html
とすればhtmlが生成されます。
さくっと書くときにはmarkdownで行けるのはありがたいですね。
Sphinxとlatex環境を用意するのが面倒な人向けに、docker imageも作りましたので活用してみてください。
https://hub.docker.com/r/chezou/sphinx-recommonmark/