Changes between Version 100 and Version 101 of RemovingTheMagic

Timestamp:

Apr 15, 2006, 11:45:11 AM (18 years ago)

Author:

Adrian Holovaty

Comment:

Added "Include template extension explicitly" section

RemovingTheMagic

@@ -186 +186 @@
 p.save()
 }}}
+
+=== Include template extension explicitly ===
+
+Now, whenever referencing templates by name, you now pass the template's *full name* -- including its extension -- instead of the file's name without an extension.
+
+Given a template {{{polls/poll_detail.html}}}...
+
+Old:
+{{{
+get_template('polls/poll_detail')
+select_template(['polls/poll_detail', 'polls/poll_detail2'])
+render_to_response('polls/poll_detail', {'poll': p})
+}}}
+
+New:
+
+{{{
+get_template('polls/poll_detail.html')
+select_template(['polls/poll_detail.html', 'polls/poll_detail2.html'])
+render_to_response('polls/poll_detail.html', {'poll': p})
+}}}
+
+This is changed in templates themselves, too -- notably in the {{{ {% extends %} }}} and {{{ {% include %} }}} template tags:
+
+Old:
+{{{
+{% extends "base" %}
+{% include "some_snippet" %}
+}}}
+
+New:
+{{{
+{% extends "base.html" %}
+{% include "some_snippet.html" %}
+}}}
+
+As a result of this change, the {{{TEMPLATE_FILE_EXTENSION}}} setting is gone, because there's no need for it.
+
+Clearly, this also means you can start putting whatever extension you want on templates. So if you'd like your templates to have a {{{.txt}}} extension, go for it. If you'd like to keep using {{{.html}}}, that's fine too. If you want to invent your own extension, or not even *use* an extension, be our guest.
+
+All the templates for the {{{django.contrib}}} apps -- most notably, the admin site -- still use {{{.html}}} extensions.
+
+Custom template tags created via {{{inclusion_tag()}}} should note the explicit template name (with the extension). For example, use {{{inclusion_tag('foo/bar.html')}}} instead of {{{inclusion_tag('foo/bar')}}}.
+
+Finally, note the syndication framework, which looks for templates with the name of the slug of each feed, now requires an '.html' extension on those templates. For example, if your feed has a slug {{{"hello"}}}, the syndication framework will look for the templates {{{feeds/hello_title.html}}} and {{{feeds/hello_description.html}}}. This is backwards-compatible.
 
 === Namespace simplification ===