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