Commit df5a8a07 authored by Tim Graham's avatar Tim Graham
Browse files

[1.5.x] Fixed #20335 - Documented the {% language %} template tag. 

Thanks bmispelon for the suggestion and djangsters for the patch.

Backport of 96cabba8 from master
parent a3c4c170

docs/topics/i18n/translation.txt

+26 −3
Original line number Diff line number Diff line
@@ -694,6 +694,31 @@ or with the ``{#`` ... ``#}`` :ref:`one-line comment constructs <template-commen 
        msgid "Ambiguous translatable block of text"

        msgstr ""



.. templatetag:: language



Switching language in templates

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



If you want to select a language within a template, you can use the

``language`` template tag:



.. code-block:: html+django



    {% load i18n %}



    {% get_current_language as LANGUAGE_CODE %}

    <!-- Current language: {{ LANGUAGE_CODE }} -->

    <p>{% trans "Welcome to our page" %}</p>



    {% language 'en' %}

        {% get_current_language as LANGUAGE_CODE %}

        <!-- Current language: {{ LANGUAGE_CODE }} -->

        <p>{% trans "Welcome to our page" %}</p>

    {% endlanguage %}



While the first occurrence of "Welcome to our page" uses the current language,

the second will always be in English.



.. _template-translation-vars:



Other tags
@@ -1098,13 +1123,11 @@ active language. Example:: 


.. _reversing_in_templates:



.. templatetag:: language



Reversing in templates

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



If localized URLs get reversed in templates they always use the current

language. To link to a URL in another language use the ``language``

language. To link to a URL in another language use the :ttag:`language`

template tag. It enables the given language in the enclosed template section:



.. code-block:: html+django