Changeset 5488 for django/branches/per-object-permissions/docs/add_ons.txt
- Timestamp:
- 06/17/07 17:18:54 (2 years ago)
- Files:
Legend:
- Unmodified
- Added
- Removed
- Modified
- Copied
- Moved
django/branches/per-object-permissions/docs/add_ons.txt
r4242 r5488 1 ===================== 2 The " contrib" add-ons3 ===================== 1 ============================ 2 The "django.contrib" add-ons 3 ============================ 4 4 5 5 Django aims to follow Python's `"batteries included" philosophy`_. It ships … … 7 7 problems. 8 8 9 This code lives in ``django/contrib`` in the Django distribution. Here's a 10 rundown of the packages in ``contrib``: 9 This code lives in ``django/contrib`` in the Django distribution. This document 10 gives a rundown of the packages in ``contrib``, along with any dependencies 11 those packages have. 12 13 .. admonition:: Note 14 15 For most of these add-ons -- specifically, the add-ons that include either 16 models or template tags -- you'll need to add the package name (e.g., 17 ``'django.contrib.admin'``) to your ``INSTALLED_APPS`` setting and re-run 18 ``manage.py syncdb``. 11 19 12 20 .. _"batteries included" philosophy: http://docs.python.org/tut/node12.html#batteries-included … … 18 26 `Tutorial 2`_. 19 27 20 .. _Tutorial 2: http://www.djangoproject.com/documentation/tutorial2/ 28 .. _Tutorial 2: ../tutorial02/ 29 30 Requires the auth_ and contenttypes_ contrib packages to be installed. 21 31 22 32 auth … … 27 37 See the `authentication documentation`_. 28 38 29 .. _authentication documentation: http://www.djangoproject.com/documentation/authentication/39 .. _authentication documentation: ../authentication/ 30 40 31 41 comments … … 47 57 See the `csrf documentation`_. 48 58 49 .. _csrf documentation: http://www.djangoproject.com/documentation/csrf/59 .. _csrf documentation: ../csrf/ 50 60 51 61 formtools 52 62 ========= 53 54 **New in Django development version**55 63 56 64 A set of high-level abstractions for Django forms (django.newforms). … … 138 146 See the `flatpages documentation`_. 139 147 140 .. _flatpages documentation: http://www.djangoproject.com/documentation/flatpages/ 148 .. _flatpages documentation: ../flatpages/ 149 150 Requires the sites_ contrib package to be installed as well. 151 152 localflavor 153 =========== 154 155 A collection of various Django snippets that are useful only for a particular 156 country or culture. For example, ``django.contrib.localflavor.usa.forms`` 157 contains a ``USZipCodeField`` that you can use to validate U.S. zip codes. 141 158 142 159 markup 143 160 ====== 144 161 145 A collection of template filters that implement these common markup languages: 146 147 * Textile 148 * Markdown 149 * ReST (ReStructured Text) 150 151 For documentation, read the source code in django/contrib/markup/templatetags/markup.py. 162 A collection of template filters that implement common markup languages: 163 164 * ``textile`` -- implements `Textile`_ 165 * ``markdown`` -- implements `Markdown`_ 166 * ``restructuredtext`` -- implements `ReST (ReStructured Text)`_ 167 168 In each case, the filter expects formatted markup as a string and returns a 169 string representing the marked-up text. For example, the ``textile`` filter 170 converts text that is marked-up in Textile format to HTML. 171 172 To activate these filters, add ``'django.contrib.markup'`` to your 173 ``INSTALLED_APPS`` setting. Once you've done that, use ``{% load markup %}`` in 174 a template, and you'll have access to these filters. For more documentation, 175 read the source code in django/contrib/markup/templatetags/markup.py. 176 177 .. _Textile: http://en.wikipedia.org/wiki/Textile_%28markup_language%29 178 .. _Markdown: http://en.wikipedia.org/wiki/Markdown 179 .. _ReST (ReStructured Text): http://en.wikipedia.org/wiki/ReStructuredText 152 180 153 181 redirects … … 158 186 See the `redirects documentation`_. 159 187 160 .. _redirects documentation: http://www.djangoproject.com/documentation/redirects/188 .. _redirects documentation: ../redirects/ 161 189 162 190 sites … … 169 197 See the `sites documentation`_. 170 198 171 .. _sites documentation: http://www.djangoproject.com/documentation/sites/199 .. _sites documentation: ../sites/ 172 200 173 201 sitemaps … … 178 206 See the `sitemaps documentation`_. 179 207 180 .. _sitemaps documentation: http://www.djangoproject.com/documentation/sitemaps/208 .. _sitemaps documentation: ../sitemaps/ 181 209 182 210 syndication … … 187 215 See the `syndication documentation`_. 188 216 189 .. _syndication documentation: http://www.djangoproject.com/documentation/syndication/217 .. _syndication documentation: ../syndication/ 190 218 191 219 Other add-ons
