<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Django documentation — Django 1.4.13 documentation</title> <link rel="stylesheet" href="_static/default.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '', VERSION: '1.4.13', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true }; </script> <script type="text/javascript" src="_static/jquery.js"></script> <script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/doctools.js"></script> <link rel="top" title="Django 1.4.13 documentation" href="#" /> <link rel="next" title="Getting started" href="intro/index.html" /> <link rel="prev" title="Django documentation contents" href="contents.html" /> <script type="text/javascript" src="templatebuiltins.js"></script> <script type="text/javascript"> (function($) { if (!django_template_builtins) { // templatebuiltins.js missing, do nothing. return; } $(document).ready(function() { // Hyperlink Django template tags and filters var base = "ref/templates/builtins.html"; if (base == "#") { // Special case for builtins.html itself base = ""; } // Tags are keywords, class '.k' $("div.highlight\\-html\\+django span.k").each(function(i, elem) { var tagname = $(elem).text(); if ($.inArray(tagname, django_template_builtins.ttags) != -1) { var fragment = tagname.replace(/_/, '-'); $(elem).html("<a href='" + base + "#" + fragment + "'>" + tagname + "</a>"); } }); // Filters are functions, class '.nf' $("div.highlight\\-html\\+django span.nf").each(function(i, elem) { var filtername = $(elem).text(); if ($.inArray(filtername, django_template_builtins.tfilters) != -1) { var fragment = filtername.replace(/_/, '-'); $(elem).html("<a href='" + base + "#" + fragment + "'>" + filtername + "</a>"); } }); }); })(jQuery); </script> </head> <body> <div class="document"> <div id="custom-doc" class=""> <div id="hd"> <h1><a href="#">Django 1.4.13 documentation</a></h1> <div id="global-nav"> <a title="Home page" href="#">Home</a> | <a title="Table of contents" href="contents.html">Table of contents</a> | <a title="Global index" href="genindex.html">Index</a> | <a title="Module index" href="py-modindex.html">Modules</a> </div> <div class="nav"> « <a href="contents.html" title="Django documentation contents">previous</a> | <a title="Django 1.4.13 documentation" href="#" accesskey="U">up</a> | <a href="intro/index.html" title="Getting started">next</a> »</div> </div> <div id="bd"> <div id="yui-main"> <div class="yui-b"> <div class="yui-g" id="index"> <div class="section" id="s-django-documentation"> <span id="s-index"></span><span id="django-documentation"></span><span id="index"></span><h1>Django documentation<a class="headerlink" href="#django-documentation" title="Permalink to this headline">¶</a></h1> <p class="rubric">Everything you need to know about Django (and then some).</p> <div class="section" id="s-getting-help"> <span id="getting-help"></span><h2>Getting help<a class="headerlink" href="#getting-help" title="Permalink to this headline">¶</a></h2> <p>Having trouble? We’d like to help!</p> <ul class="simple"> <li>Try the <a class="reference internal" href="faq/index.html"><em>FAQ</em></a> – it’s got answers to many common questions.</li> <li>Looking for specific information? Try the <a class="reference internal" href="genindex.html"><em>Index</em></a>, <a class="reference internal" href="py-modindex.html"><em>Module Index</em></a> or the <a class="reference internal" href="contents.html"><em>detailed table of contents</em></a>.</li> <li>Search for information in the <a class="reference external" href="http://groups.google.com/group/django-users/">archives of the django-users mailing list</a>, or <a class="reference external" href="http://groups.google.com/group/django-users/">post a question</a>.</li> <li>Ask a question in the <a class="reference external" href="irc://irc.freenode.net/django">#django IRC channel</a>, or search the <a class="reference external" href="http://django-irc-logs.com/">IRC logs</a> to see if it’s been asked before.</li> <li>Report bugs with Django in our <a class="reference external" href="https://code.djangoproject.com/">ticket tracker</a>.</li> </ul> </div> <div class="section" id="s-first-steps"> <span id="first-steps"></span><h2>First steps<a class="headerlink" href="#first-steps" title="Permalink to this headline">¶</a></h2> <ul class="simple"> <li><strong>From scratch:</strong> <a class="reference internal" href="intro/overview.html"><em>Overview</em></a> | <a class="reference internal" href="intro/install.html"><em>Installation</em></a></li> <li><strong>Tutorial:</strong> <a class="reference internal" href="intro/tutorial01.html"><em>Part 1</em></a> | <a class="reference internal" href="intro/tutorial02.html"><em>Part 2</em></a> | <a class="reference internal" href="intro/tutorial03.html"><em>Part 3</em></a> | <a class="reference internal" href="intro/tutorial04.html"><em>Part 4</em></a></li> </ul> </div> <div class="section" id="s-the-model-layer"> <span id="the-model-layer"></span><h2>The model layer<a class="headerlink" href="#the-model-layer" title="Permalink to this headline">¶</a></h2> <ul class="simple"> <li><strong>Models:</strong> <a class="reference internal" href="topics/db/models.html"><em>Model syntax</em></a> | <a class="reference internal" href="ref/models/fields.html"><em>Field types</em></a> | <a class="reference internal" href="ref/models/options.html"><em>Meta options</em></a></li> <li><strong>QuerySets:</strong> <a class="reference internal" href="topics/db/queries.html"><em>Executing queries</em></a> | <a class="reference internal" href="ref/models/querysets.html"><em>QuerySet method reference</em></a></li> <li><strong>Model instances:</strong> <a class="reference internal" href="ref/models/instances.html"><em>Instance methods</em></a> | <a class="reference internal" href="ref/models/relations.html"><em>Accessing related objects</em></a></li> <li><strong>Advanced:</strong> <a class="reference internal" href="topics/db/managers.html"><em>Managers</em></a> | <a class="reference internal" href="topics/db/sql.html"><em>Raw SQL</em></a> | <a class="reference internal" href="topics/db/transactions.html"><em>Transactions</em></a> | <a class="reference internal" href="topics/db/aggregation.html"><em>Aggregation</em></a> | <a class="reference internal" href="howto/custom-model-fields.html"><em>Custom fields</em></a> | <a class="reference internal" href="topics/db/multi-db.html"><em>Multiple databases</em></a></li> <li><strong>Other:</strong> <a class="reference internal" href="ref/databases.html"><em>Supported databases</em></a> | <a class="reference internal" href="howto/legacy-databases.html"><em>Legacy databases</em></a> | <a class="reference internal" href="howto/initial-data.html"><em>Providing initial data</em></a> | <a class="reference internal" href="topics/db/optimization.html"><em>Optimize database access</em></a></li> </ul> </div> <div class="section" id="s-the-template-layer"> <span id="the-template-layer"></span><h2>The template layer<a class="headerlink" href="#the-template-layer" title="Permalink to this headline">¶</a></h2> <ul class="simple"> <li><strong>For designers:</strong> <a class="reference internal" href="topics/templates.html"><em>Syntax overview</em></a> | <a class="reference internal" href="ref/templates/builtins.html"><em>Built-in tags and filters</em></a></li> <li><strong>For programmers:</strong> <a class="reference internal" href="ref/templates/api.html"><em>Template API</em></a> | <a class="reference internal" href="howto/custom-template-tags.html"><em>Custom tags and filters</em></a></li> </ul> </div> <div class="section" id="s-the-view-layer"> <span id="the-view-layer"></span><h2>The view layer<a class="headerlink" href="#the-view-layer" title="Permalink to this headline">¶</a></h2> <ul class="simple"> <li><strong>The basics:</strong> <a class="reference internal" href="topics/http/urls.html"><em>URLconfs</em></a> | <a class="reference internal" href="topics/http/views.html"><em>View functions</em></a> | <a class="reference internal" href="topics/http/shortcuts.html"><em>Shortcuts</em></a> | <a class="reference internal" href="topics/http/decorators.html"><em>Decorators</em></a></li> <li><strong>Reference:</strong> <a class="reference internal" href="ref/request-response.html"><em>Request/response objects</em></a> | <a class="reference internal" href="ref/template-response.html"><em>TemplateResponse objects</em></a></li> <li><strong>File uploads:</strong> <a class="reference internal" href="topics/http/file-uploads.html"><em>Overview</em></a> | <a class="reference internal" href="ref/files/file.html"><em>File objects</em></a> | <a class="reference internal" href="ref/files/storage.html"><em>Storage API</em></a> | <a class="reference internal" href="topics/files.html"><em>Managing files</em></a> | <a class="reference internal" href="howto/custom-file-storage.html"><em>Custom storage</em></a></li> <li><strong>Generic views:</strong> <a class="reference internal" href="topics/class-based-views.html"><em>Overview</em></a> | <a class="reference internal" href="ref/class-based-views.html"><em>Built-in generic views</em></a></li> <li><strong>Advanced:</strong> <a class="reference internal" href="howto/outputting-csv.html"><em>Generating CSV</em></a> | <a class="reference internal" href="howto/outputting-pdf.html"><em>Generating PDF</em></a></li> <li><strong>Middleware:</strong> <a class="reference internal" href="topics/http/middleware.html"><em>Overview</em></a> | <a class="reference internal" href="ref/middleware.html"><em>Built-in middleware classes</em></a></li> </ul> </div> <div class="section" id="s-forms"> <span id="forms"></span><h2>Forms<a class="headerlink" href="#forms" title="Permalink to this headline">¶</a></h2> <ul class="simple"> <li><strong>The basics:</strong> <a class="reference internal" href="topics/forms/index.html"><em>Overview</em></a> | <a class="reference internal" href="ref/forms/api.html"><em>Form API</em></a> | <a class="reference internal" href="ref/forms/fields.html"><em>Built-in fields</em></a> | <a class="reference internal" href="ref/forms/widgets.html"><em>Built-in widgets</em></a></li> <li><strong>Advanced:</strong> <a class="reference internal" href="topics/forms/modelforms.html"><em>Forms for models</em></a> | <a class="reference internal" href="topics/forms/media.html"><em>Integrating media</em></a> | <a class="reference internal" href="topics/forms/formsets.html"><em>Formsets</em></a> | <a class="reference internal" href="ref/forms/validation.html"><em>Customizing validation</em></a></li> <li><strong>Extras:</strong> <a class="reference internal" href="ref/contrib/formtools/form-preview.html"><em>Form preview</em></a> | <a class="reference internal" href="ref/contrib/formtools/form-wizard.html"><em>Form wizard</em></a></li> </ul> </div> <div class="section" id="s-the-development-process"> <span id="the-development-process"></span><h2>The development process<a class="headerlink" href="#the-development-process" title="Permalink to this headline">¶</a></h2> <ul class="simple"> <li><strong>Settings:</strong> <a class="reference internal" href="topics/settings.html"><em>Overview</em></a> | <a class="reference internal" href="ref/settings.html"><em>Full list of settings</em></a></li> <li><strong>Exceptions:</strong> <a class="reference internal" href="ref/exceptions.html"><em>Overview</em></a></li> <li><strong>django-admin.py and manage.py:</strong> <a class="reference internal" href="ref/django-admin.html"><em>Overview</em></a> | <a class="reference internal" href="howto/custom-management-commands.html"><em>Adding custom commands</em></a></li> <li><strong>Testing:</strong> <a class="reference internal" href="topics/testing.html"><em>Overview</em></a></li> <li><strong>Deployment:</strong> <a class="reference internal" href="howto/deployment/index.html"><em>Overview</em></a> | <a class="reference internal" href="howto/deployment/wsgi/index.html"><em>WSGI servers</em></a> | <a class="reference internal" href="howto/deployment/fastcgi.html"><em>FastCGI/SCGI/AJP</em></a> | <a class="reference internal" href="howto/deployment/modpython.html"><em>Apache/mod_python (deprecated)</em></a> | <a class="reference internal" href="howto/apache-auth.html"><em>Apache authentication</em></a> | <a class="reference internal" href="howto/static-files.html"><em>Handling static files</em></a> | <a class="reference internal" href="howto/error-reporting.html"><em>Tracking code errors by email</em></a></li> </ul> </div> <div class="section" id="s-other-batteries-included"> <span id="other-batteries-included"></span><h2>Other batteries included<a class="headerlink" href="#other-batteries-included" title="Permalink to this headline">¶</a></h2> <ul class="simple"> <li><a class="reference internal" href="ref/contrib/admin/index.html"><em>Admin site</em></a> | <a class="reference internal" href="ref/contrib/admin/actions.html"><em>Admin actions</em></a> | <a class="reference internal" href="ref/contrib/admin/admindocs.html"><em>Admin documentation generator</em></a></li> <li><a class="reference internal" href="topics/auth.html"><em>Authentication</em></a></li> <li><a class="reference internal" href="topics/cache.html"><em>Cache system</em></a></li> <li><a class="reference internal" href="ref/clickjacking.html"><em>Clickjacking protection</em></a></li> <li><a class="reference internal" href="ref/contrib/comments/index.html"><em>Comments</em></a> | <a class="reference internal" href="ref/contrib/comments/moderation.html"><em>Moderation</em></a> | <a class="reference internal" href="ref/contrib/comments/custom.html"><em>Custom comments</em></a></li> <li><a class="reference internal" href="topics/conditional-view-processing.html"><em>Conditional content processing</em></a></li> <li><a class="reference internal" href="ref/contrib/contenttypes.html"><em>Content types and generic relations</em></a></li> <li><a class="reference internal" href="ref/contrib/csrf.html"><em>Cross Site Request Forgery protection</em></a></li> <li><a class="reference internal" href="topics/signing.html"><em>Cryptographic signing</em></a></li> <li><a class="reference internal" href="ref/contrib/databrowse.html"><em>Databrowse</em></a></li> <li><a class="reference internal" href="topics/email.html"><em>E-mail (sending)</em></a></li> <li><a class="reference internal" href="ref/contrib/flatpages.html"><em>Flatpages</em></a></li> <li><a class="reference internal" href="ref/contrib/gis/index.html"><em>GeoDjango</em></a></li> <li><a class="reference internal" href="ref/contrib/humanize.html"><em>Humanize</em></a></li> <li><a class="reference internal" href="topics/i18n/index.html"><em>Internationalization</em></a></li> <li><a class="reference internal" href="howto/jython.html"><em>Jython support</em></a></li> <li><a class="reference internal" href="ref/contrib/localflavor.html"><em>“Local flavor”</em></a></li> <li><a class="reference internal" href="topics/logging.html"><em>Logging</em></a></li> <li><a class="reference internal" href="ref/contrib/messages.html"><em>Messages</em></a></li> <li><a class="reference internal" href="topics/pagination.html"><em>Pagination</em></a></li> <li><a class="reference internal" href="ref/contrib/redirects.html"><em>Redirects</em></a></li> <li><a class="reference internal" href="topics/security.html"><em>Security</em></a></li> <li><a class="reference internal" href="topics/serialization.html"><em>Serialization</em></a></li> <li><a class="reference internal" href="topics/http/sessions.html"><em>Sessions</em></a></li> <li><a class="reference internal" href="topics/signals.html"><em>Signals</em></a></li> <li><a class="reference internal" href="ref/contrib/sitemaps.html"><em>Sitemaps</em></a></li> <li><a class="reference internal" href="ref/contrib/sites.html"><em>Sites</em></a></li> <li><a class="reference internal" href="ref/contrib/staticfiles.html"><em>Static Files</em></a></li> <li><a class="reference internal" href="ref/contrib/syndication.html"><em>Syndication feeds (RSS/Atom)</em></a></li> <li><a class="reference internal" href="ref/unicode.html"><em>Unicode in Django</em></a></li> <li><a class="reference internal" href="ref/contrib/webdesign.html"><em>Web design helpers</em></a></li> <li><a class="reference internal" href="ref/validators.html"><em>Validators</em></a></li> <li>Function-based generic views (Deprecated) <a class="reference internal" href="topics/generic-views.html"><em>Overview</em></a> | <a class="reference internal" href="ref/generic-views.html"><em>Built-in generic views</em></a> | <a class="reference internal" href="topics/generic-views-migration.html"><em>Migration guide</em></a></li> </ul> </div> <div class="section" id="s-the-django-open-source-project"> <span id="the-django-open-source-project"></span><h2>The Django open-source project<a class="headerlink" href="#the-django-open-source-project" title="Permalink to this headline">¶</a></h2> <ul class="simple"> <li><strong>Community:</strong> <a class="reference internal" href="internals/contributing/index.html"><em>How to get involved</em></a> | <a class="reference internal" href="internals/release-process.html"><em>The release process</em></a> | <a class="reference internal" href="internals/committers.html"><em>Team of committers</em></a> | <a class="reference internal" href="internals/svn.html"><em>The Django source code repository</em></a></li> <li><strong>Design philosophies:</strong> <a class="reference internal" href="misc/design-philosophies.html"><em>Overview</em></a></li> <li><strong>Documentation:</strong> <a class="reference internal" href="internals/contributing/writing-documentation.html"><em>About this documentation</em></a></li> <li><strong>Third-party distributions:</strong> <a class="reference internal" href="misc/distributions.html"><em>Overview</em></a></li> <li><strong>Django over time:</strong> <a class="reference internal" href="misc/api-stability.html"><em>API stability</em></a> | <a class="reference internal" href="releases/index.html"><em>Release notes and upgrading instructions</em></a> | <a class="reference internal" href="internals/deprecation.html"><em>Deprecation Timeline</em></a></li> </ul> </div> </div> </div> </div> </div> </div> <div id="ft"> <div class="nav"> « <a href="contents.html" title="Django documentation contents">previous</a> | <a title="Django 1.4.13 documentation" href="#" accesskey="U">up</a> | <a href="intro/index.html" title="Getting started">next</a> »</div> </div> </div> <div class="clearer"></div> </div> </body> </html>