Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

[1.5.x] Fixed some markup in docs/ref/templates/api.txt

Backport of 862a04a from master
  • Loading branch information...
1 parent d1a002a commit 1a4233eef1e61f32fa66a719d16c405f38f6f8ad @timgraham timgraham committed
Showing with 12 additions and 7 deletions.
  1. +12 −7 docs/ref/templates/api.txt
19 docs/ref/templates/api.txt
@@ -2,6 +2,9 @@
The Django template language: For Python programmers
+.. module:: django.template
+ :synopsis: Django's template system
This document explains the Django template system from a technical
perspective -- how it works and how to extend it. If you're just looking for
reference on the language syntax, see :doc:`/topics/templates`.
@@ -52,7 +55,7 @@ from the context and executing all block tags.
Using the template system
-.. class:: django.template.Template
+.. class:: Template
Using the template system in Python is a two-step process:
@@ -279,7 +282,7 @@ these variables resolve to the corresponding Python objects.
Playing with Context objects
-.. class:: django.template.Context
+.. class:: Context
Most of the time, you'll instantiate ``Context`` objects by passing in a
fully-populated dictionary to ``Context()``. But you can add and delete items
@@ -296,9 +299,9 @@ dictionary syntax::
>>> c['newvariable']
-.. method:: pop()
-.. method:: push()
-.. exception:: django.template.ContextPopException
+.. method:: Context.pop()
+.. method:: Context.push()
+.. exception:: ContextPopException
A ``Context`` object is a stack. That is, you can ``push()`` and ``pop()`` it.
If you ``pop()`` too much, it'll raise
@@ -347,7 +350,7 @@ you'll see below.
Subclassing Context: RequestContext
-.. class:: django.template.RequestContext
+.. class:: RequestContext
Django comes with a special ``Context`` class,
``django.template.RequestContext``, that acts slightly differently than the
@@ -443,6 +446,8 @@ If :setting:`TEMPLATE_CONTEXT_PROCESSORS` contains this processor, every
``django.contrib.auth.context_processors.PermWrapper``, representing the
permissions that the currently logged-in user has.
+.. currentmodule:: django.core.context_processors
@@ -479,7 +484,7 @@ value of the :setting:`MEDIA_URL` setting.
-.. function:: django.core.context_processors.static
+.. function:: static
If :setting:`TEMPLATE_CONTEXT_PROCESSORS` contains this processor, every
``RequestContext`` will contain a variable ``STATIC_URL``, providing the

0 comments on commit 1a4233e

Please sign in to comment.
Something went wrong with that request. Please try again.