| 1 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
|---|
| 2 |
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"> |
|---|
| 3 |
<head> |
|---|
| 4 |
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
|---|
| 5 |
<title>Django documentation — Django v1.0 documentation</title> |
|---|
| 6 |
<link rel="stylesheet" href="_static/default.css" type="text/css" /> |
|---|
| 7 |
<link rel="stylesheet" href="_static/pygments.css" type="text/css" /> |
|---|
| 8 |
<script type="text/javascript"> |
|---|
| 9 |
// docutils == 0.4 |
|---|
| 10 |
// sphinx == 0.4.3 |
|---|
| 11 |
var DOCUMENTATION_OPTIONS = { |
|---|
| 12 |
URL_ROOT: '', |
|---|
| 13 |
VERSION: '1.0', |
|---|
| 14 |
COLLAPSE_MODINDEX: false, |
|---|
| 15 |
FILE_SUFFIX: '.html' |
|---|
| 16 |
}; |
|---|
| 17 |
</script> |
|---|
| 18 |
<script type="text/javascript" src="_static/jquery.js"></script> |
|---|
| 19 |
<script type="text/javascript" src="_static/doctools.js"></script> |
|---|
| 20 |
<link rel="contents" title="Global table of contents" href="contents.html" /> |
|---|
| 21 |
<link rel="index" title="Global index" href="genindex.html" /> |
|---|
| 22 |
<link rel="search" title="Search" href="search.html" /> |
|---|
| 23 |
<link rel="top" title="Django v1.0 documentation" href="" /> |
|---|
| 24 |
</head> |
|---|
| 25 |
<body> |
|---|
| 26 |
<div id="custom-doc" class=""> |
|---|
| 27 |
<div id="hd"> |
|---|
| 28 |
<h1><a href="">Django v1.0 documentation</a></h1> |
|---|
| 29 |
<div id="global-nav"> |
|---|
| 30 |
<a title="Home page" href="">Home</a> | |
|---|
| 31 |
<a title="Table of contents" href="contents.html">Table of contents</a> | |
|---|
| 32 |
<a title="Global index" href="genindex.html">Index</a> | |
|---|
| 33 |
<a title="Search" href="modindex.html">Modules</a> |
|---|
| 34 |
</div> |
|---|
| 35 |
<div class="nav"> |
|---|
| 36 |
<a title="Django v1.0 documentation" href="" accesskey="U">up</a></div> |
|---|
| 37 |
</div> |
|---|
| 38 |
|
|---|
| 39 |
<div id="bd"> |
|---|
| 40 |
<div id="yui-main"> |
|---|
| 41 |
<div class="yui-b"> |
|---|
| 42 |
<div class="yui-g" id="index"> |
|---|
| 43 |
|
|---|
| 44 |
|
|---|
| 45 |
<div class="section" id="django-documentation"> |
|---|
| 46 |
<span id="index"></span><h1>Django documentation<a class="headerlink" href="#django-documentation" title="Permalink to this headline">¶</a></h1> |
|---|
| 47 |
<p class="rubric">Everything you need to know about Django (and then some).</p> |
|---|
| 48 |
<div class="section" id="getting-help"> |
|---|
| 49 |
<h2>Getting help<a class="headerlink" href="#getting-help" title="Permalink to this headline">¶</a></h2> |
|---|
| 50 |
<p>Having trouble? We’d like to help!</p> |
|---|
| 51 |
<ul class="simple"> |
|---|
| 52 |
<li>Try the <a class="reference" href="faq/index.html#faq-index"><em>FAQ</em></a> – it’s got answers to many common questions.</li> |
|---|
| 53 |
<li>Looking for specific information? Try the <a class="reference" href="genindex.html"><em>Index</em></a>, <a class="reference" href="modindex.html"><em>Module Index</em></a> or |
|---|
| 54 |
the <a class="reference" href="contents.html#contents"><em>detailed table of contents</em></a>.</li> |
|---|
| 55 |
<li>Search for information in the <a class="reference" href="http://groups.google.com/group/django-users/">archives of the django-users mailing list</a>, or |
|---|
| 56 |
<a class="reference" href="http://groups.google.com/group/django-users/">post a question</a>.</li> |
|---|
| 57 |
<li>Ask a question in the <a class="reference" href="irc://irc.freenode.net/django">#django IRC channel</a>, or search the <a class="reference" href="http://oebfare.com/logger/django/">IRC logs</a> to see |
|---|
| 58 |
if its been asked before.</li> |
|---|
| 59 |
<li>Report bugs with Django in our <a class="reference" href="http://code.djangoproject.com/">ticket tracker</a>.</li> |
|---|
| 60 |
</ul> |
|---|
| 61 |
</div> |
|---|
| 62 |
<div class="section" id="first-steps"> |
|---|
| 63 |
<h2>First steps<a class="headerlink" href="#first-steps" title="Permalink to this headline">¶</a></h2> |
|---|
| 64 |
<ul class="simple"> |
|---|
| 65 |
<li><strong>From scratch:</strong> <a class="reference" href="intro/overview.html#intro-overview"><em>Overview</em></a> | <a class="reference" href="intro/install.html#intro-install"><em>Installation</em></a></li> |
|---|
| 66 |
<li><strong>Tutorial:</strong> <a class="reference" href="intro/tutorial01.html#intro-tutorial01"><em>Part 1</em></a> | <a class="reference" href="intro/tutorial02.html#intro-tutorial02"><em>Part 2</em></a> | <a class="reference" href="intro/tutorial03.html#intro-tutorial03"><em>Part 3</em></a> | <a class="reference" href="intro/tutorial04.html#intro-tutorial04"><em>Part 4</em></a></li> |
|---|
| 67 |
</ul> |
|---|
| 68 |
</div> |
|---|
| 69 |
<div class="section" id="the-model-layer"> |
|---|
| 70 |
<h2>The model layer<a class="headerlink" href="#the-model-layer" title="Permalink to this headline">¶</a></h2> |
|---|
| 71 |
<ul class="simple"> |
|---|
| 72 |
<li><strong>Models:</strong> <a class="reference" href="topics/db/models.html#topics-db-models"><em>Model syntax</em></a> | <a class="reference" href="ref/models/fields.html#ref-models-fields"><em>Field types</em></a> | <a class="reference" href="ref/models/options.html#ref-models-options"><em>Meta options</em></a></li> |
|---|
| 73 |
<li><strong>QuerySets:</strong> <a class="reference" href="topics/db/queries.html#topics-db-queries"><em>Executing queries</em></a> | <a class="reference" href="ref/models/querysets.html#ref-models-querysets"><em>QuerySet method reference</em></a></li> |
|---|
| 74 |
<li><strong>Model instances:</strong> <a class="reference" href="ref/models/instances.html#ref-models-instances"><em>Instance methods</em></a> | <a class="reference" href="ref/models/relations.html#ref-models-relations"><em>Accessing related objects</em></a></li> |
|---|
| 75 |
<li><strong>Advanced:</strong> <a class="reference" href="topics/db/managers.html#topics-db-managers"><em>Managers</em></a> | <a class="reference" href="topics/db/sql.html#topics-db-sql"><em>Raw SQL</em></a> | <a class="reference" href="topics/db/transactions.html#topics-db-transactions"><em>Transactions</em></a> | <a class="reference" href="howto/custom-model-fields.html#howto-custom-model-fields"><em>Custom fields</em></a></li> |
|---|
| 76 |
<li><strong>Other:</strong> <a class="reference" href="ref/databases.html#ref-databases"><em>Supported databases</em></a> | <a class="reference" href="howto/legacy-databases.html#howto-legacy-databases"><em>Legacy databases</em></a> | <a class="reference" href="howto/initial-data.html#howto-initial-data"><em>Providing initial data</em></a></li> |
|---|
| 77 |
</ul> |
|---|
| 78 |
</div> |
|---|
| 79 |
<div class="section" id="the-template-layer"> |
|---|
| 80 |
<h2>The template layer<a class="headerlink" href="#the-template-layer" title="Permalink to this headline">¶</a></h2> |
|---|
| 81 |
<ul class="simple"> |
|---|
| 82 |
<li><strong>For designers:</strong> <a class="reference" href="topics/templates.html#topics-templates"><em>Syntax overview</em></a> | <a class="reference" href="ref/templates/builtins.html#ref-templates-builtins"><em>Built-in tags and filters</em></a></li> |
|---|
| 83 |
<li><strong>For programmers:</strong> <a class="reference" href="ref/templates/api.html#ref-templates-api"><em>Template API</em></a> | <a class="reference" href="howto/custom-template-tags.html#howto-custom-template-tags"><em>Custom tags and filters</em></a></li> |
|---|
| 84 |
</ul> |
|---|
| 85 |
</div> |
|---|
| 86 |
<div class="section" id="the-view-layer"> |
|---|
| 87 |
<h2>The view layer<a class="headerlink" href="#the-view-layer" title="Permalink to this headline">¶</a></h2> |
|---|
| 88 |
<ul class="simple"> |
|---|
| 89 |
<li><strong>The basics:</strong> <a class="reference" href="topics/http/urls.html#topics-http-urls"><em>URLconfs</em></a> | <a class="reference" href="topics/http/views.html#topics-http-views"><em>View functions</em></a> | <a class="reference" href="topics/http/shortcuts.html#topics-http-shortcuts"><em>Shortcuts</em></a></li> |
|---|
| 90 |
<li><strong>Reference:</strong> <a class="reference" href="ref/request-response.html#ref-request-response"><em>Request/response objects</em></a></li> |
|---|
| 91 |
<li><strong>File uploads:</strong> <a class="reference" href="topics/http/file-uploads.html#topics-http-file-uploads"><em>Overview</em></a> | <a class="reference" href="ref/files/file.html#ref-files-file"><em>File objects</em></a> | <a class="reference" href="ref/files/storage.html#ref-files-storage"><em>Storage API</em></a> | <a class="reference" href="topics/files.html#topics-files"><em>Managing files</em></a> | <a class="reference" href="howto/custom-file-storage.html#howto-custom-file-storage"><em>Custom storage</em></a></li> |
|---|
| 92 |
<li><strong>Advanced:</strong> <a class="reference" href="ref/generic-views.html#ref-generic-views"><em>Generic views</em></a> | <a class="reference" href="howto/outputting-csv.html#howto-outputting-csv"><em>Generating CSV</em></a> | <a class="reference" href="howto/outputting-pdf.html#howto-outputting-pdf"><em>Generating PDF</em></a></li> |
|---|
| 93 |
<li><strong>Middleware:</strong> <a class="reference" href="topics/http/middleware.html#topics-http-middleware"><em>Overview</em></a> | <a class="reference" href="ref/middleware.html#ref-middleware"><em>Built-in middleware classes</em></a></li> |
|---|
| 94 |
</ul> |
|---|
| 95 |
</div> |
|---|
| 96 |
<div class="section" id="forms"> |
|---|
| 97 |
<h2>Forms<a class="headerlink" href="#forms" title="Permalink to this headline">¶</a></h2> |
|---|
| 98 |
<ul class="simple"> |
|---|
| 99 |
<li><strong>The basics:</strong> <a class="reference" href="topics/forms/index.html#topics-forms-index"><em>Overview</em></a> | <a class="reference" href="ref/forms/api.html#ref-forms-api"><em>Form API</em></a> | <a class="reference" href="ref/forms/fields.html#ref-forms-fields"><em>Built-in fields</em></a> | <a class="reference" href="ref/forms/widgets.html#ref-forms-widgets"><em>Built-in widgets</em></a></li> |
|---|
| 100 |
<li><strong>Advanced:</strong> <a class="reference" href="topics/forms/modelforms.html#topics-forms-modelforms"><em>Forms for models</em></a> | <a class="reference" href="topics/forms/media.html#topics-forms-media"><em>Integrating media</em></a> | <a class="reference" href="topics/forms/formsets.html#topics-forms-formsets"><em>Formsets</em></a> | <a class="reference" href="ref/forms/validation.html#ref-forms-validation"><em>Customizing validation</em></a></li> |
|---|
| 101 |
<li><strong>Extras:</strong> <a class="reference" href="ref/contrib/formtools/form-preview.html#ref-contrib-formtools-form-preview"><em>Form preview</em></a> | <a class="reference" href="ref/contrib/formtools/form-wizard.html#ref-contrib-formtools-form-wizard"><em>Form wizard</em></a></li> |
|---|
| 102 |
</ul> |
|---|
| 103 |
</div> |
|---|
| 104 |
<div class="section" id="the-development-process"> |
|---|
| 105 |
<h2>The development process<a class="headerlink" href="#the-development-process" title="Permalink to this headline">¶</a></h2> |
|---|
| 106 |
<ul class="simple"> |
|---|
| 107 |
<li><strong>Settings:</strong> <a class="reference" href="topics/settings.html#topics-settings"><em>Overview</em></a> | <a class="reference" href="ref/settings.html#ref-settings"><em>Full list of settings</em></a></li> |
|---|
| 108 |
<li><strong>django-admin.py and manage.py:</strong> <a class="reference" href="ref/django-admin.html#ref-django-admin"><em>Overview</em></a> | <a class="reference" href="howto/custom-management-commands.html#howto-custom-management-commands"><em>Adding custom commands</em></a></li> |
|---|
| 109 |
<li><strong>Testing:</strong> <a class="reference" href="topics/testing.html#topics-testing"><em>Overview</em></a></li> |
|---|
| 110 |
<li><strong>Deployment:</strong> <a class="reference" href="howto/deployment/index.html#howto-deployment-index"><em>Overview</em></a> | <a class="reference" href="howto/deployment/modpython.html#howto-deployment-modpython"><em>Apache/mod_python</em></a> | <a class="reference" href="howto/deployment/fastcgi.html#howto-deployment-fastcgi"><em>FastCGI/SCGI/AJP</em></a> | <a class="reference" href="howto/apache-auth.html#howto-apache-auth"><em>Apache authentication</em></a> | <a class="reference" href="howto/static-files.html#howto-static-files"><em>Serving static files</em></a> | <a class="reference" href="howto/error-reporting.html#howto-error-reporting"><em>Tracking code errors by e-mail</em></a></li> |
|---|
| 111 |
</ul> |
|---|
| 112 |
</div> |
|---|
| 113 |
<div class="section" id="other-batteries-included"> |
|---|
| 114 |
<h2>Other batteries included<a class="headerlink" href="#other-batteries-included" title="Permalink to this headline">¶</a></h2> |
|---|
| 115 |
<ul class="simple"> |
|---|
| 116 |
<li><a class="reference" href="ref/contrib/admin.html#ref-contrib-admin"><em>Admin site</em></a></li> |
|---|
| 117 |
<li><a class="reference" href="topics/auth.html#topics-auth"><em>Authentication</em></a></li> |
|---|
| 118 |
<li><a class="reference" href="topics/cache.html#topics-cache"><em>Cache system</em></a></li> |
|---|
| 119 |
<li><a class="reference" href="ref/contrib/comments/index.html#ref-contrib-comments-index"><em>Comments</em></a></li> |
|---|
| 120 |
<li><a class="reference" href="ref/contrib/contenttypes.html#ref-contrib-contenttypes"><em>Content types</em></a></li> |
|---|
| 121 |
<li><a class="reference" href="ref/contrib/csrf.html#ref-contrib-csrf"><em>Cross Site Request Forgery protection</em></a></li> |
|---|
| 122 |
<li><a class="reference" href="ref/contrib/databrowse.html#ref-contrib-databrowse"><em>Databrowse</em></a></li> |
|---|
| 123 |
<li><a class="reference" href="topics/email.html#topics-email"><em>E-mail (sending)</em></a></li> |
|---|
| 124 |
<li><a class="reference" href="ref/contrib/flatpages.html#ref-contrib-flatpages"><em>Flatpages</em></a></li> |
|---|
| 125 |
<li><a class="reference" href="ref/contrib/humanize.html#ref-contrib-humanize"><em>Humanize</em></a></li> |
|---|
| 126 |
<li><a class="reference" href="topics/i18n.html#topics-i18n"><em>Internationalization</em></a></li> |
|---|
| 127 |
<li><a class="reference" href="howto/jython.html#howto-jython"><em>Jython support</em></a></li> |
|---|
| 128 |
<li><a class="reference" href="ref/contrib/localflavor.html#ref-contrib-localflavor"><em>“Local flavor”</em></a></li> |
|---|
| 129 |
<li><a class="reference" href="topics/pagination.html#topics-pagination"><em>Pagination</em></a></li> |
|---|
| 130 |
<li><a class="reference" href="ref/contrib/redirects.html#ref-contrib-redirects"><em>Redirects</em></a></li> |
|---|
| 131 |
<li><a class="reference" href="topics/serialization.html#topics-serialization"><em>Serialization</em></a></li> |
|---|
| 132 |
<li><a class="reference" href="topics/http/sessions.html#topics-http-sessions"><em>Sessions</em></a></li> |
|---|
| 133 |
<li><a class="reference" href="topics/signals.html#topics-signals"><em>Signals</em></a></li> |
|---|
| 134 |
<li><a class="reference" href="ref/contrib/sitemaps.html#ref-contrib-sitemaps"><em>Sitemaps</em></a></li> |
|---|
| 135 |
<li><a class="reference" href="ref/contrib/sites.html#ref-contrib-sites"><em>Sites</em></a></li> |
|---|
| 136 |
<li><a class="reference" href="ref/contrib/syndication.html#ref-contrib-syndication"><em>Syndication feeds (RSS/Atom)</em></a></li> |
|---|
| 137 |
<li><a class="reference" href="ref/unicode.html#ref-unicode"><em>Unicode in Django</em></a></li> |
|---|
| 138 |
<li><a class="reference" href="ref/contrib/webdesign.html#ref-contrib-webdesign"><em>Web design helpers</em></a></li> |
|---|
| 139 |
</ul> |
|---|
| 140 |
</div> |
|---|
| 141 |
<div class="section" id="the-django-open-source-project"> |
|---|
| 142 |
<h2>The Django open-source project<a class="headerlink" href="#the-django-open-source-project" title="Permalink to this headline">¶</a></h2> |
|---|
| 143 |
<ul class="simple"> |
|---|
| 144 |
<li><strong>Community:</strong> <a class="reference" href="internals/contributing.html#internals-contributing"><em>How to get involved</em></a> | <a class="reference" href="internals/release-process.html#internals-release-process"><em>The release process</em></a> | <a class="reference" href="internals/committers.html#internals-committers"><em>Team of committers</em></a></li> |
|---|
| 145 |
<li><strong>Design philosophies:</strong> <a class="reference" href="misc/design-philosophies.html#misc-design-philosophies"><em>Overview</em></a></li> |
|---|
| 146 |
<li><strong>Documentation:</strong> <a class="reference" href="internals/documentation.html#internals-documentation"><em>About this documentation</em></a></li> |
|---|
| 147 |
<li><strong>Third-party distributions:</strong> <a class="reference" href="misc/distributions.html#misc-distributions"><em>Overview</em></a></li> |
|---|
| 148 |
<li><strong>Django over time:</strong> <a class="reference" href="misc/api-stability.html#misc-api-stability"><em>API stability</em></a> | <a class="reference" href="releases/index.html#releases-index"><em>Archive of release notes</em></a> | <a class="reference" href="http://code.djangoproject.com/wiki/BackwardsIncompatibleChanges">Backwards-incompatible changes</a></li> |
|---|
| 149 |
</ul> |
|---|
| 150 |
</div> |
|---|
| 151 |
</div> |
|---|
| 152 |
|
|---|
| 153 |
|
|---|
| 154 |
</div> |
|---|
| 155 |
</div> |
|---|
| 156 |
</div> |
|---|
| 157 |
|
|---|
| 158 |
|
|---|
| 159 |
|
|---|
| 160 |
</div> |
|---|
| 161 |
|
|---|
| 162 |
<div id="ft"> |
|---|
| 163 |
<div class="nav"> |
|---|
| 164 |
<a title="Django v1.0 documentation" href="" accesskey="U">up</a></div> |
|---|
| 165 |
</div> |
|---|
| 166 |
</div> |
|---|
| 167 |
|
|---|
| 168 |
<div class="clearer"></div> |
|---|
| 169 |
</div> |
|---|
| 170 |
</body> |
|---|
| 171 |
</html> |
|---|