163 lines
4.9 KiB
Plaintext
163 lines
4.9 KiB
Plaintext
.. _index:
|
|
|
|
====================
|
|
Django documentation
|
|
====================
|
|
|
|
.. rubric:: Everything you need to know about Django (and then some).
|
|
|
|
Getting help
|
|
============
|
|
|
|
Having trouble? We'd like to help!
|
|
|
|
* Try the :ref:`FAQ <faq-index>` -- it's got answers to many common questions.
|
|
|
|
* Looking for specific information? Try the :ref:`genindex`, :ref:`modindex` or
|
|
the :ref:`detailed table of contents <contents>`.
|
|
|
|
* Search for information in the `archives of the django-users mailing list`_, or
|
|
`post a question`_
|
|
|
|
* Ask a question in the `#django IRC channel`_, or search the `IRC logs`_ to see
|
|
if its been asked before
|
|
|
|
* Report bugs with Django in our `ticket tracker`_.
|
|
|
|
.. _archives of the django-users mailing list: http://groups.google.com/group/django-users/
|
|
.. _post a question: http://groups.google.com/group/django-users/
|
|
.. _#django IRC channel: irc://irc.freenode.net/django
|
|
.. _IRC logs: http://oebfare.com/logger/django/
|
|
.. _ticket tracker: http://code.djangoproject.com/
|
|
|
|
First steps
|
|
===========
|
|
|
|
:ref:`Overview <intro-overview>`
|
|
See what writing a database-driven application with Django looks like.
|
|
|
|
:ref:`Installation <intro-install>`
|
|
Get Django installed on your computer.
|
|
|
|
Tutorial: Writing your first Django application
|
|
===============================================
|
|
|
|
:ref:`Part 1 <intro-tutorial01>`
|
|
Get set up, create models, and play with the database API.
|
|
|
|
:ref:`Part 2 <intro-tutorial02>`
|
|
Explore the automatically-generated admin site.
|
|
|
|
:ref:`Part 3 <intro-tutorial03>`
|
|
Write the public interface views.
|
|
|
|
:ref:`Part 4 <intro-tutorial04>`
|
|
Learn how to process forms.
|
|
|
|
Using Django
|
|
============
|
|
|
|
:ref:`Models <topics-db-index>`
|
|
Design a single, definitive source of data about your data.
|
|
|
|
:ref:`Handling web requests <topics-http-index>`
|
|
Handle web requests, map them to views, and return pages.
|
|
|
|
:ref:`Forms <topics-forms-index>`
|
|
Build and handle HTML forms.
|
|
|
|
:ref:`Templates <topics-templates>`
|
|
Develop the visual design of your site.
|
|
|
|
And more:
|
|
---------
|
|
|
|
:ref:`topics-auth` ... :ref:`topics-cache` ... :ref:`topics-email` ...
|
|
:ref:`topics-files` ... :ref:`topics-i18n` ... :ref:`topics-install` ...
|
|
:ref:`topics-pagination` ... :ref:`topics-serialization` ...
|
|
:ref:`topics-settings` ... :ref:`topics-testing`
|
|
|
|
Add-on ("contrib") applications
|
|
===============================
|
|
|
|
:ref:`Django's automatic admin site <ref-contrib-admin>`
|
|
Get a clean interface to your data with no effort at all.
|
|
|
|
:ref:`Form tools <ref-contrib-formtools-index>`
|
|
Easily handle complex form workflows.
|
|
|
|
:ref:`Syndication feeds <ref-contrib-syndication>`
|
|
Generate RSS and Atom feeds of your data.
|
|
|
|
:ref:`"Local flavor" <ref-contrib-localflavor>`
|
|
Give your site that special local touch.
|
|
|
|
And more:
|
|
---------
|
|
|
|
:ref:`ref-contrib-contenttypes` ... :ref:`ref-contrib-csrf` ...
|
|
:ref:`ref-contrib-databrowse` ... :ref:`ref-contrib-flatpages` ...
|
|
:ref:`ref-contrib-humanize` ... :ref:`ref-contrib-redirects` ...
|
|
:ref:`ref-contrib-sitemaps` ... :ref:`ref-contrib-sites` ...
|
|
:ref:`ref-contrib-webdesign`
|
|
|
|
Solving specific problems
|
|
=========================
|
|
|
|
:ref:`Deployment <howto-deployment-index>`
|
|
Release your project to the world.
|
|
|
|
:ref:`Importing data from legacy databases <howto-legacy-databases>`
|
|
Use Django with an existing database or alongside other web development
|
|
toolkits.
|
|
|
|
:ref:`Custom template tags <howto-custom-template-tags>`
|
|
Add your own extensions to Django's template language.
|
|
|
|
:ref:`Generating CSV <howto-outputting-csv>` & :ref:`PDF <howto-outputting-PDF>`
|
|
Produce non-HTML content with Django.
|
|
|
|
And more:
|
|
---------
|
|
|
|
:ref:`Authenticating in Apache <howto-apache-auth>` ...
|
|
:ref:`howto-custom-file-storage` ... :ref:`howto-custom-management-commands` ...
|
|
:ref:`howto-custom-model-fields` ... :ref:`howto-error-reporting` ...
|
|
:ref:`howto-initial-data` ... :ref:`howto-static-files`
|
|
|
|
Reference
|
|
=========
|
|
|
|
:ref:`Settings <ref-settings>`
|
|
See all of Django's settings and what they do.
|
|
|
|
:ref:`Request & response objects <ref-request-response>`
|
|
Understand the classes Django uses to represent HTTP requests and responses.
|
|
|
|
:ref:`Model API reference <ref-models-index>`
|
|
Revel in the gory details of Django's model system.
|
|
|
|
:ref:`Form API reference <ref-forms-index>`
|
|
Learn the details of forms, fields, and widgets.
|
|
|
|
And more:
|
|
---------
|
|
|
|
:ref:`ref-databases` ... :ref:`ref-django-admin` ... :ref:`ref-files-index` ...
|
|
:ref:`ref-generic-views` ... :ref:`ref-middleware` ...
|
|
:ref:`ref-templates-index` ... :ref:`ref-unicode`
|
|
|
|
And all the rest
|
|
================
|
|
|
|
:ref:`Internals <internals-index>`
|
|
Learn how Django works under the hood, and how you can contribute to the
|
|
project.
|
|
|
|
:ref:`Release notes <releases-index>`
|
|
See what is and was new in each release of Django.
|
|
|
|
:ref:`Miscellany <misc-index>`
|
|
Stuff we can't find a more organized place for. Like that drawer in your
|
|
kitchen with the scissors, batteries, and duct tape.
|