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

.. highlightlang:: python

Note on performance

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

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)

Explicitly setting the active language

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

.. highlightlang:: python

You may want to set the active language for the current session explicitly. Perhaps

a user's language preference is retrieved from another system, for example.

You've already been introduced to :func:`django.utils.translation.activate()`. That

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>