テーマ
テーマは、 サイトのコンテンツやデザインなどをまとめたPythonのパッケージです。テーマパッケージの contents ディレクトリ、files ディレクトリ、templates ディレクトリには、通常のプロジェクトと同じようにコンテンツやテンプレートを登録できます。
テーマは、通常のパッケージと同じようように、PyPIなどから事前にインストールする必要があります。
Install miyadaiku themes with pip
$ pip install miyadaiku.themes.bootstrap4
$ pip install miyadaiku.themes.fontawesome
プロジェクトで使用するテーマは、プロジェクト設定ファイル config.yml の themes に指定します。
config.yml: Using two themes in the project
themes:
- miyadaiku.themes.bootstrap4
- miyadaiku.themes.fontawesome
テーマが別のテーマを使用する場合、そのテーマは再帰的に読み込まれます。また、Miyadaikuの組み込みテーマ miyadaiku.themes.base は、themes に指定されなくとも常に読み込まれます。
テーマに含まれるテンプレートも、プロジェクトのテンプレートと同様に使用できます。
アーティクルのテンプレート名や、Jinja2の import 文などでテンプレート名を指定すると、プロジェクトの templates ディレクトリに続いて、使用中のテーマからテンプレートディレクトリを検索します。
テンプレート名の検索順序については、テンプレート名の解決 を参照してください。