[1.9.x] Fixed Sphinx highlight warnings in docs.

       global ``_()`` function causes interference. Explicitly importing

       ``ugettext()`` as ``_()`` avoids this problem.

.. highlightlang:: python

In this example, the text ``"Welcome to my site."`` is marked as a translation

string::

will render a conditional expression. This will evaluate to either a ``true``

(should pluralize) or ``false`` (should **not** pluralize) value.

.. highlight:: python

The ``json_catalog`` view

-------------------------

The response format is as follows:

.. code-block:: json

.. code-block:: text

..   JSON doesn't allow comments so highlighting as JSON won't work here.

    {

        "catalog": {

:func:`~django.views.decorators.cache.cache_page` decorator. To trigger cache

invalidation when your translations change, provide a version-dependent key

prefix, as shown in the example below, or map the view at a version-dependent

URL.

.. code-block:: python

URL::

    from django.views.decorators.cache import cache_page

    from django.views.i18n import javascript_catalog

you're using ETags (:setting:`USE_ETAGS = True <USE_ETAGS>`), you're already

covered. Otherwise, you can apply :ref:`conditional decorators

<conditional-decorators>`. In the following example, the cache is invalidated

whenever you restart your application server.

.. code-block:: python

whenever you restart your application server::

    from django.utils import timezone

    from django.views.decorators.http import last_modified

language prefix to the URL patterns that were added by the ``i18n_patterns``

function. Example::

    from django.core.urlresolvers import reverse

    from django.utils.translation import activate

    >>> from django.core.urlresolvers import reverse

    >>> from django.utils.translation import activate

    >>> activate('en')

    >>> reverse('sitemap-xml')

:func:`~django.core.urlresolvers.reverse` function will return the URL in the

active language. Example::

    from django.core.urlresolvers import reverse

    from django.utils.translation import activate

    >>> from django.core.urlresolvers import reverse

    >>> from django.utils.translation import activate

    >>> activate('en')

    >>> reverse('news:category', kwargs={'slug': 'recent'})

Customizing the ``makemessages`` command

----------------------------------------

.. highlightlang:: python

If you want to pass additional parameters to ``xgettext``, you need to create a

custom :djadmin:`makemessages` command and override its ``xgettext_options``

attribute::

The ``set_language`` redirect view

----------------------------------

.. highlightlang:: python

.. currentmodule:: django.views.i18n

.. function:: set_language(request)

malicious input, it is not entirely foolproof. For example, it will not

protect the following:

.. code-block:: html+django

.. code-block:: text

..   highlighting as html+django fails due to intentionally missing quotes.

    <style class={{ var }}>...</style>