leopa
Python3で静的サイトジェネレータを作ってみました。その名は「leopa」leopaはヒョウモントカゲモドキの英名leopard geckoから命名し、ヒョウモントカゲモドキの愛称「レオパ」として使われています。
leopaのリポジトリはこちら
現在のところまだまだ荒削りなものですが、マークダウンでドキュメントを作成し、HTMLファイルに変換する機能があります。おおまかな使い方の流れは以下のようになります。
$ python3
>>> import leopa # 1
>>> # この時プロジェクト名をProjectクラスに渡さなければ
>>> # デフォルトのprojectが使われる
>>> p = leopa.Project() # 2
>>> p.create() # 2
>>> p.reload() # 3
>>> p.publish() # 4
- Python3のインタラクティブシェルを起動し、インポートする。作業は起動したまま行う。
Projectクラスを作成し、createでプロジェクトのディレクトリが作成されます。設定ファイルもその中に作成されます。- 設定ファイルで諸々設定します。この時
docsにドキュメントの構成をYAML形式で書きますと、reloadすることで自動でマークダウンファイルがその構成通り（ディレクトリも）に作成されます。 - 各ドキュメントを書き終えたら、
publishでpublicディレクトリにHTMLファイルが作成されます。
いつもぶち当たる壁としましては、CSSに関する部分です。どのように各HTMLファイルに反映するか。
現在のところ、設定ファイルで外部CSSのURLを書くようにするか、各マークダウンファイルのメタデータの部分で、CSSファイルへのリンクを書くようにするか、など色々悩んでおります。
デザインの好みは人それぞれなので、なかなか万人向けに作るのは難しいものです。改めて静的サイトジェネレータの難しさ・凄さを感じています。
markdownライブラリでメタデータを扱う
Pythonのmarkdownライブラリでは、デフォルトではメタデータを扱うことができません。したがって、スイッチオンにしなければなりません。やり方は簡単で通常は以下のように使うところ
>>> import markdown
>>> mk = markdown.Markdown()
>>> mk = markdown.Markdown(extensions=['meta'])
title: My title
autho: me
# Heading
brahbrahbrah...
>>> import markdown
>>> mk = markdown.Markdown(extensions=['meta'])
>>> with open('test.md', 'rt', encoding='utf-8') as f:
... text = f.read()
... content = mk.convert(text)
... metadata = mk.Meta
...
>>> print(metadata)
{'title': ['My title'], 'author': ['me']}
>>> print(content)
<h1>Heading</h1>
<p>brahbrahbrah...</p>