id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
6351	Template documentation could do with a little more example code	atlithorn <atlithorn@…>	nobody	"A lot of the filters in http://www.djangoproject.com/documentation/templates/ could do with a simple example. Here are examples for most of those missing[[BR]]

|| '''value''' || '''template''' || '''output''' ||
|| 4 || {{value:add:2}} || 6||
|| String with spaces || {{value|cut:"" ""}} || Stringwithspaces ||
|| datetime.datetime.now() || {{value|date:""D d M Y""}} || Wed 09 Jan 2008 ||
|| Undefined || {{value|default:""nothing""}} || nothing ||
|| None || {{value|default_if_none:""nothing""}} || nothing ||
|| [{'n':'g','m':0},{'n':'a','m':2},{'n':'z','m':8}] || {{value|dictsort:""n""}} || [{'n':'a','m':2},{'n':'g','m':0},{'n':'z','m':8}] ||
|| [{'n':'g','m':0},{'n':'a','m':2},{'n':'z','m':8}] || {{value|dictsortreversed:""n""}} || [{'n':'z','m':8},{'n':'g','m':0},{'n':'a','m':2},] ||
|| 123456789 || {{value|divisibleby:3}} || True ||
|| 123456789 || {{value|filesizeformat}} || 117.7 MB ||
|| ['a','b','c'] || {{value|first}} || a ||
|| 123456789 || {{value|get_digit:2}} || 8 ||
|| ['a','b','c','d'] || {{value|join:"" or ""}} || a or b or c or d ||
|| ['a','b','c','d'] || {{value|last}} || d ||
|| ['a','b','c','d'] || {{value|length}} || 4 ||
|| ['a','b','c','d'] || {{value|length_is:4}} || True ||
|| Joel\nis a slug || {{value|linebreaks}} || <p>Joel<br>is a slug</p> ||
|| Joel is a slug || {{value|lower}} || joel is a slug ||
|| 123456789 || {{value|make_list}} || [u'1', u'2', u'3', u'4', u'5', u'6', u'7', u'8', u'9'] ||
|| Joel is a slug || {{value|make_list}} || [u'J', u'o', u'e', u'l', u' ', u'i', u's', u' ', u'a', u' ', u's', u'l', u'u', u'g'] ||
|| ['a','b','c','d'] || {{value|random}} || b ||
|| <b>Joel</b> <button>is</button> a <span>slug</span> || {{value|removetags: ""b span""|safe}} || Joel <button>is</button> a slug ||
|| ['a','b','c','d'] || {{value|slice:"":2""}} || ['a','b'] ||
|| Joel is a slug || {{value|slugify}} || joel-is-a-slug ||
|| Joel is a slug || {{value|stringformat:""s""}} || Joel is a slug ||
|| <b>Joel</b> <button>is</button> a <span>slug</span> || {{value|striptags}} || Joel is a slug ||
|| datetime.datetime.now() || {{value|time:""H:i""}} || 01:23 ||
|| Joel is a slug || {{value|truncatewords:2}} || Joel is ... ||
|| Joel is a slug || {{value|upper}} || JOEL IS A SLUG ||
|| Joel is a slug || {{value|wordcount}} || 4 ||

And some more:
{{{
Check out www.djangoproject.com -> {{value|urlize}} -> Check out <a href=""http://www.djangoproject.com"">www.djangoproject.com</a>
Check out www.djangoproject.com -> {{value|urlizetrunc:15}} -> Check out <a href=""http://www.djangoproject.com"">www.djangopr...</a> 
Joel is a slug -> {{value|wordwrap:5}} -> Joel 
is a 
slug
}}}

"		closed	Documentation	dev		fixed			Ready for checkin	1	0	0	0	0	0