From 2f0566fa61e13277364e3aef338fa5c143f5a704 Mon Sep 17 00:00:00 2001 From: Berker Peksag Date: Mon, 16 Sep 2013 00:51:24 +0300 Subject: Fixed #4278 -- Added a dirs parameter to a few functions to override TEMPLATE_DIRS. * django.template.loader.get_template() * django.template.loader.select_template() * django.shortcuts.render() * django.shortcuts.render_to_response() Thanks amcnabb for the suggestion. --- docs/ref/templates/api.txt | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) (limited to 'docs/ref') diff --git a/docs/ref/templates/api.txt b/docs/ref/templates/api.txt index b0fc94040a..b3e49b6773 100644 --- a/docs/ref/templates/api.txt +++ b/docs/ref/templates/api.txt @@ -594,17 +594,31 @@ The Python API ``django.template.loader`` has two functions to load templates from files: -.. function:: get_template(template_name) +.. function:: get_template(template_name[, dirs]) ``get_template`` returns the compiled template (a ``Template`` object) for the template with the given name. If the template doesn't exist, it raises ``django.template.TemplateDoesNotExist``. -.. function:: select_template(template_name_list) + To override the :setting:`TEMPLATE_DIRS` setting, use the ``dirs`` + parameter. The ``dirs`` parameter may be a tuple or list. + + .. versionchanged:: 1.7 + + The ``dirs`` parameter was added. + +.. function:: select_template(template_name_list[, dirs]) ``select_template`` is just like ``get_template``, except it takes a list of template names. Of the list, it returns the first template that exists. + To override the :setting:`TEMPLATE_DIRS` setting, use the ``dirs`` + parameter. The ``dirs`` parameter may be a tuple or list. + + .. versionchanged:: 1.7 + + The ``dirs`` parameter was added. + For example, if you call ``get_template('story_detail.html')`` and have the above :setting:`TEMPLATE_DIRS` setting, here are the files Django will look for, in order: -- cgit v1.3