diff options
Diffstat (limited to 'docs/ref')
| -rw-r--r-- | docs/ref/templates/api.txt | 18 |
1 files changed, 16 insertions, 2 deletions
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: |