django1/docs/index.txt

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.