doc.html

{% extends "base_docs.html" %}
{% load i18n %}

{% block title %}{{ doc.title|striptags|safe }} | {% trans "Django documentation" %}{% endblock %}

{% block extrahead %}
  {{ block.super }}
  <link rel="stylesheet" href="{{ STATIC_URL }}css/docs/docs.css" type="text/css" />
  <link rel="stylesheet" href="{{ STATIC_URL }}css/pygments.css" type="text/css" />
{% endblock %}

{% block billboard %}
  <h2><a href="{% url 'document-index' lang=lang version=version %}">{% trans "Django documentation" %}</a></h2>
{% endblock %}

{% block content %}

{% block body %}
  {% load docs %}
  {% get_all_doc_versions docurl as versions %}
  <ul id="doc-versions">
      {% for v in versions %}
        {% if version != v %}
          <li class="other">
          {% if docurl %}
            <a href="{% url 'document-detail' lang=lang version=v url=docurl %}">{{ v }}</a>
          {% else %}
            <a href="{% url 'document-index' lang=lang version=v %}">{{ v }}</a>
          {% endif %}
          </li>
        {% endif %}
      {% endfor %}
      <li class="current"
          title="{% if version == 'dev' %}{% trans "This document is for Django's development version, which can be significantly different from previous releases." %}{% else %}{% blocktrans %}This document describes Django {{ version }}.{% endblocktrans %}{% endif %} {% trans "Click on the links on the left to see other versions." %}">
        <span>{% trans "Documentation version:" %}
          <strong>{{ version }}</strong>
        </span>
      </li>
  </ul>
  {{ doc.body|safe }}
{% endblock %}
<div class="browse-horizontal">
  {% if doc.prev %}
    <div class="left"><a href="{{ doc.prev.link }}">&laquo; {{ doc.prev.title|safe }}</a></div>
  {% endif %}
  {% if doc.next %}
    <div class="right"><a href="{{ doc.next.link }}">{{ doc.next.title|safe }} &raquo;</a></div>
  {% endif %}
</div>
<div id="content-secondary">
  <h2 id="comments">{% trans "Questions/Feedback" %}</h2>
  <p>{% trans "Having trouble? We'd like to help!" %}</p>
  <ul>
    <li>
      {% url 'document-detail' lang=lang version=version url="faq" as faq_url %}
      {% blocktrans %}Try the <a href="{{ faq_url }}">FAQ</a> — it's got answers to many common questions.{% endblocktrans %}
    </li>
    <li>
      {% blocktrans %}Search for information in the <a
      href="http://groups.google.com/group/django-users/">archives of the
      django-users mailing list</a>, or <a
      href="http://groups.google.com/group/django-users/">post a question</a>.{% endblocktrans %}
    </li>
    <li>
      {% blocktrans %}Ask a question in the <a href="irc://irc.freenode.net/">#django IRC
      channel</a>, or search the <a href="http://django-irc-logs.com/">IRC
      logs</a> to see if it has been asked before.{% endblocktrans %}
    </li>
    <li>
      {% blocktrans %}If you notice errors with this documentation, please <a
      href="https://code.djangoproject.com/newticket?component=Documentation">
      open a ticket</a> and let us know! Please only use the ticket tracker for
      criticisms and improvements on the docs. For tech support, use the
      resources above.{% endblocktrans %}
    </li>
  </ul>
</div>
{% endblock %}

{% block content-related %}
  {% block search %}
    <h2>{% trans "Search" %}</h2>
    {% load docs %}
    {% search_form %}
  {% endblock %}

  {% block toc-wrapper %}
    <h2>{% trans "Contents" %}</h2>
    {% block toc %}
      {{ doc.toc|safe }}
    {% endblock %}
  {% endblock %}
  {% block browse-wrapper %}
    <h2>{% trans "Browse" %}</h2>
    <ul>
      {% block browse %}
        {% if doc.prev %}
          <li>{% trans "Prev:" %} <a href="{{ doc.prev.link }}">{{ doc.prev.title|safe }}</a></li>
        {% endif %}
        {% if doc.next %}
          <li>{% trans "Next:" %} <a href="{{ doc.next.link }}">{{ doc.next.title|safe }}</a></li>
        {% endif %}
        <li><a href="{% url 'document-detail' lang=lang version=version url="contents" %}">{% trans "Table of contents" %}</a></li>
        {% for doc, title, accesskey, shorttitle in env.rellinks %}
          <li><a href="{% url 'document-detail' lang=lang version=version url=doc %}">{{ title }}</a></li>
        {% endfor %}
      {% endblock %}
    </ul>
  {% endblock %}

  {% block breadcrumbs-wrapper %}
    <h2>{% trans "You are here:" %}</h2>
    <ul>
      {% block breadcrumbs %}
        <li>
          <a href="{% url 'document-index' lang=lang version=version %}">{% blocktrans %}Django {{ version }} documentation{% endblocktrans %}</a>
          {% for p in doc.parents %}
            <ul><li><a href="{{ p.link }}">{{ p.title|safe }}</a>
          {% endfor %}
          <ul><li>{% block current-page-title %}{{ doc.title|safe }}{% endblock %}</li></ul>
          {% for p in doc.parents %}</li></ul>{% endfor %}
        </li>
      {% endblock %}
    </ul>

    {% if version != "1.1" and version != "1.0" %}
      <h2>{% trans "Download:" %}</h2>
      <p>
        {% if version == "dev" %}{% trans "Offline (development version):" %}
        {% else %}{% blocktrans %}Offline (Django {{ version }}):{% endblocktrans %}{% endif %}
        <a href="{{ STATIC_URL }}docs/django-docs-{{ version }}-{{ lang }}.zip">HTML</a> |
        <a href="http://media.readthedocs.org/pdf/django/{{ rtd_version }}/django.pdf">PDF</a> |
        <a href="http://media.readthedocs.org/epub/django/{{ rtd_version }}/django.epub">ePub</a>
      <br>
      <span class="quiet">
        {% blocktrans %}Provided by <a href="http://readthedocs.org/">Read the Docs</a>.{% endblocktrans %}
      </span>
      </p>
    {% endif %}
  {% endblock %}
{% endblock %}