[Python]PelicanにMarkdown Extensionsを入れて自分好みにカスタマイズする

Python製静的サイトジェネレータ Pelican の話。
記事は Markdown で書いているのだが、Markdown から生成される HTML の細かい挙動を変えたい、あるいは機能を追加したい場合にどうやってカスタマイズするのか調べてみた。

公式ドキュメントのここに書いてある。
http://docs.getpelican.com/en/3.6.3/content.html?highlight=md_extensions

該当箇所を引用すると、

Pelican also supports Markdown Extensions, which might have to be installed separately if they are not included in the default Markdown package and can be configured and loaded via the MD_EXTENSIONS setting.

設定手順

Python の Markdown パッケージの Extensions をここから探す。
http://pythonhosted.org/Markdown/extensions/
pelicanconf.py に MD_EXTENSIONS という変数を定義して、利用したいパッケージ名を記述する

(pelicanconf.py の例)

MD_EXTENSIONS = ['codehilite(css_class=highlight)', 'extra']

Officially Supported Extensions

Extensions のうち、Officially Supported Extensions （中央の表に載っている Extension）については
パッケージ名（markdown.extensions.***** の ***** の部分）を MD_EXTENSIONS に記載するだけで使えるようになる。

Third Party Extensions

それに対して、Third Party Extensions については
まずこちらの Wiki ページからインストールしたい Extension を探す。
https://github.com/waylan/Python-Markdown/wiki/Third-Party-Extensions

インストールしたい Extension を見つけたら、pip install でインストールしてから MD_EXTENSIONS に記載する必要がある。

例）http://~ や https://~ から始まる文字列を自動的にリンクにしてくれる mdx_linkify は

$ pip install mdx_linkify

pelicanconf.py

MD_EXTENSIONS = ['mdx_linkify', 'codehilite(css_class=highlight)', 'extra']

注意点

MD_EXTENSIONS について記載されている Settings のページを見てみる。

f:id:dackdive:20160109184416p:plain

重要なのは ( ) で書かれている部分。

Note that defining this in your settings file will override and replace the default values. If your goal is to add to the default values for this setting, you’ll need to include them explicitly and enumerate the full list of desired Markdown extensions.

なので、デフォルトでインストールされている Extension （codehilite(css_class=highlight), extra) に 追記する 形で記述する必要がある。