Django

Code

Ticket #6351 (closed: fixed)

Opened 8 months ago

Last modified 6 months ago

Template documentation could do with a little more example code

Reported by: atlithorn <atlithorn@gmail.com> Assigned to: nobody
Milestone: Component: Documentation
Version: SVN Keywords:
Cc: Triage Stage: Ready for checkin
Has patch: 1 Needs documentation: 0
Needs tests: 0 Patch needs improvement: 0

Description

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

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

Attachments

filter_doc.diff (8.2 kB) - added by dtulig on 01/10/08 12:43:51.
Turned ticket description into a patch

Change History

01/10/08 03:09:07 changed by atlithorn <atlithorn@gmail.com>

  • needs_better_patch changed.
  • component changed from Uncategorized to Documentation.
  • needs_tests changed.
  • needs_docs changed.

01/10/08 12:43:51 changed by dtulig

  • attachment filter_doc.diff added.

Turned ticket description into a patch

01/10/08 12:50:02 changed by dtulig

  • has_patch set to 1.

01/13/08 06:31:56 changed by Simon Greenhill <dev@simon.net.nz>

  • stage changed from Unreviewed to Ready for checkin.

Joel is a slug?

01/15/08 16:18:25 changed by atlithorn <atlithorn@gmail.com>

:) 'String with spaces' was just too boring. Joel's sluggish nature was the first output of the random string generator in my head. Feel free to ctrl-h.

03/17/08 19:14:41 changed by jacob

  • status changed from new to closed.
  • resolution set to fixed.

(In [7276]) Fixed #6351: added more examples to template filters. Thanks, David Tulig and atlithorn.


Add/Change #6351 (Template documentation could do with a little more example code)




Change Properties
Action