mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-07-24 13:44:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Fixed #16096 -- Added origin attribute to template instances.

Browse source 
Thanks jdunck for the suggestion.
This commit is contained in:
Preston Timmons 2013-08-30 14:08:40 -05:00 • committed by Tim Graham
parent e1266e50b2
commit 8625c7aab3
4 changed files with 54 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

37
docs/ref/templates/api.txt
View file

@ -759,10 +759,45 @@ Django uses the template loaders in order according to the
:setting:`TEMPLATE_LOADERS` setting. It uses each loader until a loader finds a
match.
.. currentmodule:: django.template
Template origin
~~~~~~~~~~~~~~~
.. versionadded:: 1.7
When :setting:`TEMPLATE_DEBUG` is ``True`` template objects will have an
``origin`` attribute depending on the source they are loaded from.
.. class:: loader.LoaderOrigin
Templates created from a template loader will use the
``django.template.loader.LoaderOrigin`` class.
.. attribute:: name
The path to the template as returned by the template loader.
For loaders that read from the file system, this is the full
path to the template.
.. attribute:: loadname
The relative path to the template as passed into the
template loader.
.. class:: StringOrigin
Templates created from a ``Template`` class will use the
``django.template.StringOrigin`` class.
.. attribute:: source
The string used to create the template.
The ``render_to_string`` shortcut
===================================
.. function:: django.template.loader.render_to_string(template_name, dictionary=None, context_instance=None)
.. function:: loader.render_to_string(template_name, dictionary=None, context_instance=None)
To cut down on the repetitive nature of loading and rendering
templates, Django provides a shortcut function which largely