Fixed #14744 - Add cross-links to docs/topics/http/views.txt. Thanks adamv for the patch.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@14720 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Timo Graham 2010-11-26 16:53:38 +00:00
parent 5dd1276cb8
commit 5fc9cbc15b
1 changed files with 17 additions and 15 deletions

View File

@ -29,22 +29,22 @@ Here's a view that returns the current date and time, as an HTML document:
Let's step through this code one line at a time:
* First, we import the class ``HttpResponse``, which lives in the
``django.http`` module, along with Python's ``datetime`` library.
* First, we import the class :class:`~django.http.HttpResponse` from the
:mod:`django.http` module, along with Python's ``datetime`` library.
* Next, we define a function called ``current_datetime``. This is the view
function. Each view function takes an ``HttpRequest`` object as its first
parameter, which is typically named ``request``.
function. Each view function takes an :class:`~django.http.HttpRequest`
object as its first parameter, which is typically named ``request``.
Note that the name of the view function doesn't matter; it doesn't have to
be named in a certain way in order for Django to recognize it. We're
calling it ``current_datetime`` here, because that name clearly indicates
what it does.
* The view returns an ``HttpResponse`` object that contains the
generated response. Each view function is responsible for returning an
``HttpResponse`` object. (There are exceptions, but we'll get to those
later.)
* The view returns an :class:`~django.http.HttpResponse` object that
contains the generated response. Each view function is responsible for
returning an :class:`~django.http.HttpResponse` object. (There are
exceptions, but we'll get to those later.)
.. admonition:: Django's Time Zone
@ -97,8 +97,8 @@ The Http404 exception
.. class:: django.http.Http404()
When you return an error such as ``HttpResponseNotFound``, you're responsible
for defining the HTML of the resulting error page::
When you return an error such as :class:`~django.http.HttpResponseNotFound`,
you're responsible for defining the HTML of the resulting error page::
return HttpResponseNotFound('<h1>Page not found</h1>')
@ -164,12 +164,14 @@ Three things to note about 404 views:
to the template: ``request_path``, which is the URL that resulted
in the 404.
* The 404 view is passed a ``RequestContext`` and will have access to
variables supplied by your ``TEMPLATE_CONTEXT_PROCESSORS`` setting (e.g.,
``MEDIA_URL``).
* The 404 view is passed a :class:`~django.template.RequestContext` and
will have access to variables supplied by your
:setting:`TEMPLATE_CONTEXT_PROCESSORS` setting (e.g.,
:setting:`MEDIA_URL`).
* If ``DEBUG`` is set to ``True`` (in your settings module), then your 404
view will never be used, and the traceback will be displayed instead.
* If :setting:`DEBUG` is set to ``True`` (in your settings module), then
your 404 view will never be used, and the traceback will be displayed
instead.
The 500 (server error) view
----------------------------