diff -r 5ff1fc726848 -r c6bca38c1cbf parts/django/docs/index.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/parts/django/docs/index.txt Sat Jan 08 11:20:57 2011 +0530 @@ -0,0 +1,213 @@ + +.. _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 :doc:`FAQ ` -- it's got answers to many common questions. + +* Looking for specific information? Try the :ref:`genindex`, :ref:`modindex` or + the :doc:`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 it's 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://botland.oebfare.com/logger/django/ +.. _ticket tracker: http://code.djangoproject.com/ + +First steps +=========== + + * **From scratch:** + :doc:`Overview ` | + :doc:`Installation ` + + * **Tutorial:** + :doc:`Part 1 ` | + :doc:`Part 2 ` | + :doc:`Part 3 ` | + :doc:`Part 4 ` + +The model layer +=============== + + * **Models:** + :doc:`Model syntax ` | + :doc:`Field types ` | + :doc:`Meta options ` + + * **QuerySets:** + :doc:`Executing queries ` | + :doc:`QuerySet method reference ` + + * **Model instances:** + :doc:`Instance methods ` | + :doc:`Accessing related objects ` + + * **Advanced:** + :doc:`Managers ` | + :doc:`Raw SQL ` | + :doc:`Transactions ` | + :doc:`Aggregation ` | + :doc:`Custom fields ` | + :doc:`Multiple databases ` + + * **Other:** + :doc:`Supported databases ` | + :doc:`Legacy databases ` | + :doc:`Providing initial data ` | + :doc:`Optimize database access ` + +The template layer +================== + + * **For designers:** + :doc:`Syntax overview ` | + :doc:`Built-in tags and filters ` + + * **For programmers:** + :doc:`Template API ` | + :doc:`Custom tags and filters ` + +The view layer +============== + + * **The basics:** + :doc:`URLconfs ` | + :doc:`View functions ` | + :doc:`Shortcuts ` + + * **Reference:** :doc:`Request/response objects ` + + * **File uploads:** + :doc:`Overview ` | + :doc:`File objects ` | + :doc:`Storage API ` | + :doc:`Managing files ` | + :doc:`Custom storage ` + + * **Generic views:** + :doc:`Overview` | + :doc:`Built-in generic views` + + * **Advanced:** + :doc:`Generating CSV ` | + :doc:`Generating PDF ` + + * **Middleware:** + :doc:`Overview ` | + :doc:`Built-in middleware classes ` + +Forms +===== + + * **The basics:** + :doc:`Overview ` | + :doc:`Form API ` | + :doc:`Built-in fields ` | + :doc:`Built-in widgets ` + + * **Advanced:** + :doc:`Forms for models ` | + :doc:`Integrating media ` | + :doc:`Formsets ` | + :doc:`Customizing validation ` + + * **Extras:** + :doc:`Form preview ` | + :doc:`Form wizard ` + +The development process +======================= + + * **Settings:** + :doc:`Overview ` | + :doc:`Full list of settings ` + + * **Exceptions:** + :doc:`Overview ` + + * **django-admin.py and manage.py:** + :doc:`Overview ` | + :doc:`Adding custom commands ` + + * **Testing:** :doc:`Overview ` + + * **Deployment:** + :doc:`Overview ` | + :doc:`Apache/mod_wsgi ` | + :doc:`Apache/mod_python ` | + :doc:`FastCGI/SCGI/AJP ` | + :doc:`Apache authentication ` | + :doc:`Serving static files ` | + :doc:`Tracking code errors by e-mail ` + +Other batteries included +======================== + + * :doc:`Admin site ` | :doc:`Admin actions ` | :doc:`Admin documentation generator` + * :doc:`Authentication ` + * :doc:`Cache system ` + * :doc:`Conditional content processing ` + * :doc:`Comments ` | :doc:`Moderation ` | :doc:`Custom comments ` + * :doc:`Content types ` + * :doc:`Cross Site Request Forgery protection ` + * :doc:`Databrowse ` + * :doc:`E-mail (sending) ` + * :doc:`Flatpages ` + * :doc:`GeoDjango ` + * :doc:`Humanize ` + * :doc:`Internationalization ` + * :doc:`Jython support ` + * :doc:`"Local flavor" ` + * :doc:`Messages ` + * :doc:`Pagination ` + * :doc:`Redirects ` + * :doc:`Serialization ` + * :doc:`Sessions ` + * :doc:`Signals ` + * :doc:`Sitemaps ` + * :doc:`Sites ` + * :doc:`Syndication feeds (RSS/Atom) ` + * :doc:`Unicode in Django ` + * :doc:`Web design helpers ` + * :doc:`Validators ` + +The Django open-source project +============================== + + * **Community:** + :doc:`How to get involved ` | + :doc:`The release process ` | + :doc:`Team of committers ` | + :doc:`The Django source code repository ` + + * **Design philosophies:** + :doc:`Overview ` + + * **Documentation:** + :doc:`About this documentation ` + + * **Third-party distributions:** + :doc:`Overview ` + + * **Django over time:** + :doc:`API stability ` | + :doc:`Release notes and upgrading instructions ` | + :doc:`Deprecation Timeline `