p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Fixed #3781 -- Improved docs/add_ons.txt to clarify use of contrib apps. Thanks, Simon G. 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@4833 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2007-03-27 22:18:52 +00:00
parent 932928a1e2
commit 9a2a9a9fe8
1 changed files with 19 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
docs/add_ons.txt
View File

@ -9,6 +9,13 @@ problems.
This code lives in ``django/contrib`` in the Django distribution. Here's a This code lives in ``django/contrib`` in the Django distribution. Here's a
rundown of the packages in ``contrib``: rundown of the packages in ``contrib``:
.. admonition:: Note
For most of these add-ons -- specifically, the add-ons that include either
models or template tags -- you'll need to add the package name (e.g.,
``'django.contrib.admin'``) to your ``INSTALLED_APPS`` setting and re-run
``manage.py syncdb``.
.. _"batteries included" philosophy: http://docs.python.org/tut/node12.html#batteries-included .. _"batteries included" philosophy: http://docs.python.org/tut/node12.html#batteries-included
admin admin
@ -147,13 +154,20 @@ contains a ``USZipCodeField`` that you can use to validate U.S. zip codes.
markup markup
====== ======
A collection of template filters that implement these common markup languages: A collection of template filters that implement common markup languages:
* `Textile`_ * ``textile`` -- implements `Textile`_
* `Markdown`_ * ``markdown`` -- implements `Markdown`_
* `ReST (ReStructured Text)`_ * ``restructuredtext`` -- implements `ReST (ReStructured Text)`_
For documentation, read the source code in django/contrib/markup/templatetags/markup.py. In each case, the filter expects formatted markup as a string and returns a
string representing the marked-up text. For example, the ``textile`` filter
converts text that is marked-up in Textile format to HTML.
To activate these filters, add ``'django.contrib.markup'`` to your
``INSTALLED_APPS`` setting. Once you've done that, use ``{% load markup %}`` in
a template, and you'll have access to these filters. For more documentation,
read the source code in django/contrib/markup/templatetags/markup.py.
.. _Textile: http://en.wikipedia.org/wiki/Textile_%28markup_language%29 .. _Textile: http://en.wikipedia.org/wiki/Textile_%28markup_language%29
.. _Markdown: http://en.wikipedia.org/wiki/Markdown .. _Markdown: http://en.wikipedia.org/wiki/Markdown