This document describes Django 1.0. For development docs, go here.
Django documentation¶
Everything you need to know about Django (and then some).
Getting help¶
Having trouble? We’d like to help!
- Try the FAQ – it’s got answers to many common questions.
- Looking for specific information? Try the Index, Module Index or the detailed table of 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.
First steps¶
- Overview
- See what writing a database-driven application with Django looks like.
- Installation
- Get Django installed on your computer.
Tutorial: Writing your first Django application¶
Using Django¶
- Models
- Design a single, definitive source of data about your data.
- Handling web requests
- Handle web requests, map them to views and return pages.
- Forms
- Build and handle HTML forms.
- Templates
- Develop the visual design of your site.
Add-on (“contrib”) applications¶
- Django’s automatic admin site
- Get a clean Web interface to your data with little effort.
- Form tools
- Easily handle complex form workflows.
- Syndication feeds
- Generate RSS and Atom feeds of your data.
- “Local flavor”
- Give your site that special local touch.
Solving specific problems¶
- Deployment
- Release your project to the world.
- Importing data from legacy databases
- Use Django with an existing database or alongside other web development toolkits.
- Custom template tags
- Add your own extensions to Django’s template language.
- Generating CSV & PDF
- Produce non-HTML content with Django.
Reference¶
- Settings
- See all of Django’s settings and what they do.
- Request & response objects
- Understand the classes Django uses to represent HTTP requests and responses.
- Model API reference
- Revel in the gory details of Django’s model system.
- Form API reference
- Learn the details of forms, fields and widgets.
And all the rest¶
- Internals
- Learn how Django works under the hood and how you can contribute to the project.
- Release notes
- See what is and was new in each release of Django.
- Deprecation Timeline
- See the APIs that have been marked for deprecation in future releases of Django.
- Miscellany
- Stuff we can’t find a more organized place for. Like that drawer in your kitchen with the scissors, batteries and duct tape.
Questions/Feedback
Having trouble? We'd like to help!
- Try the FAQ -— it's got answers to many common questions.
- 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.
- If you notice errors with this documentation, please open a ticket and let us know! Please only use the ticket tracker for criticisms and improvements on the docs. For tech support, use the resources above.

