root/djangoproject.com/django_website/templates/docs/index.html

{% extends "base_docs.html" %}

{% block content %}
<h1>Documentation</h1>

<h2 class="deck">
{% ifequal version "trunk" %}
  These docs are for Django's SVN release, which can be
  significantly different from previous releases. Get old docs here: 
  {% for r in all_versions %}
    <a href="{{ r.version }}/">{{ r.version }}</a>{% if forloop.last %}.{% else %},{% endif %}
  {% endfor %}
{% else %}
  These docs are for Django version {{ version }}. For current documentation, 
  <a href="/documentation/">go here</a>.
{% endifequal %}
</h2>

<h2>The Django Book</h2>

<p>The Django Book is finished. You can read it for free at <a href="http://www.djangobook.com/">djangobook.com</a> or buy the print version. We recommend reading the first few chapters as your first introduction to Django.</p>

<h2>The essential documentation</h2>

<p>Make sure to read the following documentation. The rest (in the "Reference" section below) can be read in any particular order, as you need the various functionality.</p>

<ul>
<li><a href="overview/">Django overview</a></li>
<li><a href="install/">Installation guide</a></li>
<li>Tutorial: Writing your first Django app
    <ul>
    <li><a href="tutorial01/">Part 1: Initialization, creating models, the database API</a></li>
    <li><a href="tutorial02/">Part 2: Exploring the automatically-generated admin site</a></li>
    <li><a href="tutorial03/">Part 3: Creating the public interface views</a></li>
    <li><a href="tutorial04/">Part 4: Simple form processing and generic views</a></li>
    </ul>
</li>
<li><a href="faq/">Frequently asked questions (FAQ)</a></li>
<li><a href="documentation/">How to read this documentation</a></li>
</ul>

<h2 id="reference">Reference</h2>

<ul>
<li><a href="django-admin/">The django-admin.py and manage.py utilities</a></li>
<li>Models: <a href="model-api/">Creating models</a> | <a href="models/">Examples</a> | <a href="db-api/">The database API</a> | <a href="transactions/">Transactions</a></li>

<li>Templates: <a href="templates/">Guide for HTML authors</a> | <a href="templates_python/">Guide for Python programmers</a></li>

<li><a href="newforms/">The newforms library</a> | <a href="forms/">The old forms and manipulators library</a></li>
<li><strong>New:</strong> <a href="testing/">Testing Django applications</a></li>
<li><a href="sessions/">Sessions</a></li>
<li><a href="cache/">Caching</a></li>
<li><a href="i18n/">Internationalization</a></li>
<li><a href="middleware/">Middleware</a></li>
<li><a href="settings/">Settings files</a></li>
<li><a href="url_dispatch/">URL configuration</a></li>
<li><a href="request_response/">Request and response objects</a></li>
<li><a href="generic_views/">Generic views</a></li>
<li><a href="authentication/">Authentication</a></li>
<li><a href="shortcuts/">Shortcut functions</a></li>
<li><strong>New:</strong> <a href="unicode/">Unicode data in Django</a></li>
<li><strong>New:</strong> <a href="pagination/">Pagination</a></li>

<li><a href="add_ons/">The django.contrib add-ons</a>
    <ul>
    <li><a href="contenttypes/">Contenttypes Framework</a> (<code>django.contrib.contenttypes</code>)</li>
    <li><a href="csrf/">Cross Site Request Forgery protection</a> (<code>django.contrib.csrf</code>)</li>
    <li><a href="databrowse/">Databrowse</a> (<code>django.contrib.databrowse</code>)</li>
    <li><a href="flatpages/">Flatpages</a> (<code>django.contrib.flatpages</code>)</li>
    <li><strong>New:</strong> <a href="form_preview/">Form preview</a> (<code>django.contrib.formtools</code>)</li>
    <li><strong>New:</strong> <a href="form_wizard/">Form wizard</a> (<code>django.contrib.formtools.wizard</code>)</li>
    <li><a href="redirects/">Redirects</a> (<code>django.contrib.redirects</code>)</li>
    <li><a href="sites/">Sites</a> (<code>django.contrib.sites</code>)</li>
    <li><a href="sitemaps/">Sitemaps</a> (<code>django.contrib.sitemaps</code>)</li>
    <li><a href="syndication_feeds/">Syndication feeds (RSS and Atom)</a> (<code>django.contrib.syndication</code>)</li>
    <li><strong>New:</strong> <a href="webdesign/">Web design helpers</a> (<code>django.contrib.webdesign</code>)</li>
    </ul>
</li>
</ul>

<h2>Deployment</h2>

<ul>
<li><a href="modpython/">Using Django with mod_python</a></li>
<li><a href="fastcgi/">How to use Django with FastCGI, SCGI or AJP</a></li>
</ul>

<h2>Solving specific problems</h2>

<ul>
<li><a href="apache_auth/">Authenticating against Django's user database from Apache</a></li>
<li><a href="static_files/">Serving static/media files</a></li>
<li><a href="email/">Sending e-mail</a></li>
<li><a href="legacy_databases/">Integrating with (introspecting) a legacy database</a></li>
<li><a href="outputting_pdf/">Outputting PDFs dynamically</a></li>
<li><a href="outputting_csv/">Outputting CSV dynamically</a></li>
</ul>

<h2>Et cetera</h2>
<ul>
<li><a href="design_philosophies/">Design philosophies</a></li>
<li><a href="contributing/">How to contribute to Django</a></li>
<li><a href="admin_css/">Django admin CSS guide</a></li>
<li><a href="api_stability/">API stability</a></li>
<li><a href="http://code.djangoproject.com/wiki/BackwardsIncompatibleChanges">Backwards-incompatible changes</a></li>
</ul>

<h2>Release notes</h2>
<ul>
<li><a href="release_notes_0.96/">Version 0.96</a></li>
<li><a href="release_notes_0.95/">Version 0.95</a></li>
</ul>
{% endblock %}

{% block content-related %}

<h2>Search docs via Google</h2>
<form action="http://www.google.com/search" method="get">
<p><input type="text" name="as_q" /> <input type="submit" value="Go" /></p>
<input type="hidden" name="as_sitesearch" value="www.djangoproject.com" />
</form>

<h2>Getting help</h2>
<ul class="toc">
    <li><a href="irc://irc.freenode.net/django">#django IRC channel</a></li>
    <li><a href="http://oebfare.com/logger/django/">#django IRC logs</a></li>
    <li><a href="http://groups-beta.google.com/group/django-users">Django-users mailing list</a></li>
    <li><a href="http://groups-beta.google.com/group/django-developers">Django-developers mailing list</a></li>
    <li><a href="http://code.djangoproject.com/simpleticket">Report a bug</a></li>
    <li><a href="/comments/">Recent comments posted to djangoproject.com</a></li>
</ul>

{% endblock %}