From 16bb9c594cf7306f4b2fc3ba915be43b05dad5d2 Mon Sep 17 00:00:00 2001 From: Jannis Leidel Date: Thu, 8 Sep 2011 13:24:41 +0000 Subject: Fixed #16516 -- Relaxed the blocktrans rendering a little by falling back to the default language if resolving one of the arguments fails, raising a KeyError. Thanks, Claude Paroz and Aymeric Augustin. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16723 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/ref/utils.txt | 9 ++++++--- docs/topics/i18n/internationalization.txt | 7 +++++++ 2 files changed, 13 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt index 0b2e386268..1755ee77b3 100644 --- a/docs/ref/utils.txt +++ b/docs/ref/utils.txt @@ -532,15 +532,18 @@ For a complete discussion on the usage of the following see the useful when we want delayed translations to appear as the original string for some reason. -.. function:: override(language) +.. function:: override(language, deactivate=False) .. versionadded:: 1.4 A Python context manager that uses :func:`django.utils.translation.activate` to fetch the translation object for a given language, installing it as the translation object for the - current thread and deinstalls it again on exit with - :func:`django.utils.translation.deactivate`. + current thread and reinstall the previous active language on exit. + Optionally it can simply deinstall the temporary translation on exit with + :func:`django.utils.translation.deactivate` if the deactivate argument is + True. If you pass None as the language argument, a NullTranslations() + instance is installed while the context is active. .. function:: get_language() diff --git a/docs/topics/i18n/internationalization.txt b/docs/topics/i18n/internationalization.txt index 176ad7fb43..dbeb77c879 100644 --- a/docs/topics/i18n/internationalization.txt +++ b/docs/topics/i18n/internationalization.txt @@ -512,6 +512,13 @@ You can use multiple expressions inside a single ``blocktrans`` tag:: .. note:: The previous more verbose format is still supported: ``{% blocktrans with book|title as book_t and author|title as author_t %}`` +.. versionchanged:: 1.4 + +If resolving one of the block arguments fails, blocktrans will fall back to +the default language by deactivating the currently active language +temporarily with the :func:`~django.utils.translation.deactivate_all` +function. + This tag also provides for pluralization. To use it: * Designate and bind a counter value with the name ``count``. This value will -- cgit v1.3