DjangoのTemplateローダ

ueblogのスクリーンキャストに対して、嘘の補足を行ってしまいました。
嘘というのは「settings.pyのTEMPLATE_DIRSに対して設定を行わなくても、プロジェクト直下とアプリケーション直下のtemplatesディレクトリに対してサーチパスが設定される」というものです。
正解は「自動でサーチパスが設定される場所は、settings.pyのINSTALLED_APPSに登録されている各アプリケーション直下のtemplatesディレクトリに対してのみ」です。

嘘を書いてそのままというものあれなので、動作パターンの確認を行いました。

パターン1

TEMPLATE_DIRS	INSTALLED_APPS
設定無し	sample.app1 sample.app2

各アプリの下にサーチパスが設定されるtemplatesディレクトリを作成した。

以下、'+'はディレクトリ、'-'はファイルを表すこととする。また、test.htmlはbase.htmlを継承したテンプレートとする。

+sample
       + app1
             + templates
                        + app1
                        - test.html
             - base.html
       + app2
             + templates
                        + app2
                        - test.html
             - base.html

・'app1/test.html'をレンダリングすると、sample/app1/templates/app1/test.htmlとsample/app1/templates/base.htmlが利用される

・'app2/test.html'をレンダリングすると、sample/app2/templates/app2/test.htmlとsample/app1/templates/base.htmlが利用される

パターン2

TEMPLATE_DIRS	INSTALLED_APPS
設定無し	sample.app1 sample.app2

+sample
       + app1
             + templates
                        + app1
                        - test.html
                        + app2
                        - test.html
             - base.html
       + app2
             + templates
                        + app2
                        - test.html
             - base.html

・'app1/test.html'をレンダリングすると、sample/app1/templates/app1/test.htmlとsample/app1/templates/base.htmlが利用される

・'app2/test.html'をレンダリングすると、sample/app1/templates/app2/test.htmlとsample/app1/templates/base.htmlが利用される

パターン3

TEMPLATE_DIRS	INSTALLED_APPS
設定無し	sample.app2 sample.app1

+sample
       + app1
             + templates
                        + app1
                        - test.html
                        + app2
                        - test.html
             - base.html
       + app2
             + templates
                        + app2
                        - test.html
             - base.html

・'app1/test.html'をレンダリングすると、sample/app1/templates/app1/test.htmlとsample/app2/templates/base.htmlが利用される

・'app2/test.html'をレンダリングすると、sample/app2/templates/app2/test.htmlとsample/app2/templates/base.htmlが利用される

パターン4

TEMPLATE_DIRS	INSTALLED_APPS
$PROJECT_HOME/templates	sample.app1 sample.app2

+sample
       + app1
             + templates
                        + app1
                        - test.html
             - base.html
       + app2
             + templates
                        + app2
                        - test.html
             - base.html
       + templates
       - base.html

・'app1/test.html'をレンダリングすると、sample/app1/templates/app1/test.htmlとsample/templates/base.htmlが利用される

'app2/test.html'をレンダリングすると、sample/app2/templates/app2/test.htmlとsample/templates/base.htmlが利用される

パターン5

TEMPLATE_DIRS	INSTALLED_APPS
$PROJECT_HOME/templates	sample.app1 sample.app2

+sample
       + app1
             + templates
                        + app1
                        - test.html
                        + app2
                        - test.html
             - base.html
       + app2
             + templates
                        + app2
                        - test.html
             - base.html
       + templates
             + app2
             - test.html
       - base.html

・'app1/test.html'をレンダリングすると、sample/app1/templates/app1/test.htmlとsample/templates/base.htmlが利用される

'app2/test.html'をレンダリングすると、sample/templates/app2/test.htmlとsample/templates/base.htmlが利用される

パターン6

TEMPLATE_DIRS	INSTALLED_APPS
$PROJECT_HOME/templates2 $PROJECT_HOME/templates	sample.app1 sample.app2

+sample
       + app1
             + templates
                        + app1
                        - test.html
                        + app2
                        - test.html
             - base.html
       + app2
             + templates
                        + app2
                        - test.html
             - base.html
       + templates
       - base.html
       + templates2
       - base.html

・'app1/test.html'をレンダリングすると、sample/app1/templates/app1/test.htmlとsample/templates2/base.htmlが利用される

'app2/test.html'をレンダリングすると、sample/templates/app2/test.htmlとsample/templates2/base.htmlが利用される

Templateローダの振る舞い

優先度は以下の通りと考えられる。

・TEMPLATE_DIRSの最初に指定されたディレクトリを機転として指示された全てのテンプレートを探す

・見つからなかったテンプレートをTEMPLATE_DIRSの次番・またその次という順序で探す

・次に、INSTALLED_APPSの最初に指定されたアプリケーション直下のtemplatesディレクトリを機転として、見つからなかったテンプレートを探す

・同様にINSTALLED_APPSを順に探す

どのようにテンプレートを格納すべきか

・INSTALLED_APPSやTEMPLATE_DIRSの設定次第で選択されるテンプレートが変わらないように検討する。

・アプリケーション固有のテンプレートAPP/xxx_xxx.xxxはAPP/templates/APPの下にのみ格納する。

・プロジェクト全体に関わるテンプレートはTEMPLATE_DIRSに指定したディレクトリの直下に格納する。

・アプリケーション固有のテンプレートをプロジェクトとして上書きしたい場合には、TEMPLATE_DIRSに指定したディレクトリの直下にAPP/xxx_xxx.xxxとして格納する。