django.contrib.webdesign
This document is for Django's SVN release, which can be significantly different from previous releases. Get old docs here: 0.96, 0.95.
The django.contrib.webdesign package, part of the “django.contrib” add-ons, provides various Django helpers that are particularly useful to Web designers (as opposed to developers).
At present, the package contains only a single template tag. If you have ideas for Web-designer-friendly functionality in Django, please suggest them.
Template tags
To use these template tags, add 'django.contrib.webdesign' to your INSTALLED_APPS setting. Once you’ve done that, use {% load webdesign %} in a template to give your template access to the tags.
lorem
Displays random “lorem ipsum” Latin text. This is useful for providing sample data in templates.
Usage:
{% lorem [count] [method] [random] %}
The {% lorem %} tag can be used with zero, one, two or three arguments. The arguments are:
| Argument | Description |
|---|---|
| count | A number (or variable) containing the number of paragraphs or words to generate (default is 1). |
| method | Either w for words, p for HTML paragraphs or b for plain-text paragraph blocks (default is b). |
| random | The word random, which if given, does not use the common paragraph (“Lorem ipsum dolor sit amet…”) when generating text. |
Examples:
- {% lorem %} will output the common “lorem ipsum” paragraph.
- {% lorem 3 p %} will output the common “lorem ipsum” paragraph and two random paragraphs each wrapped in HTML <p> tags.
- {% lorem 2 w random %} will output two random Latin words.
Questions/Feedback
If you notice errors with this documentation, please open a ticket and let us know!
Please only use the ticket tracker for criticisms and improvements on the docs. For tech support, ask in the IRC channel or post to the django-users list.
