Fixed some markup in docs/ref/templates/api.txt

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`.

Using the template system

=========================

.. class:: django.template.Template

.. class:: Template

Using the template system in Python is a two-step process:

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

    >>> c['newvariable']

    'hello'

.. 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

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

  ``django.contrib.auth.context_processors.PermWrapper``, representing the

  permissions that the currently logged-in user has.

.. currentmodule:: django.core.context_processors

django.core.context_processors.debug

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

django.core.context_processors.static

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. 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