summaryrefslogtreecommitdiff
path: root/docs/ref/settings.txt
diff options
context:
space:
mode:
authorlufafajoshua <77637648+lufafajoshua@users.noreply.github.com>2024-06-24 12:02:55 +0200
committerSarah Boyce <42296566+sarahboyce@users.noreply.github.com>2024-06-24 18:06:44 +0200
commit3ac0e43207b4a1b9327ba12612005c285fbff7ee (patch)
tree6043aeec0c9c2f9b15c64e762303f4d11868cb25 /docs/ref/settings.txt
parentf1705c8780c0a7587654fc736542d55fe4a7f29b (diff)
Fixed #35306 -- Documented fallback localization formats in templates when localization is disabled.
Diffstat (limited to 'docs/ref/settings.txt')
-rw-r--r--docs/ref/settings.txt9
1 files changed, 6 insertions, 3 deletions
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index 88ccf6106e..34c835fb82 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -1842,9 +1842,7 @@ standard :term:`language ID format <language code>`. For example, U.S. English
is ``"en-us"``. See also the `list of language identifiers`_ and
:doc:`/topics/i18n/index`.
-:setting:`USE_I18N` must be active for this setting to have any effect.
-
-It serves two purposes:
+It serves three purposes:
* If the locale middleware isn't in use, it decides which translation is served
to all users.
@@ -1852,6 +1850,11 @@ It serves two purposes:
user's preferred language can't be determined or is not supported by the
website. It also provides the fallback translation when a translation for a
given literal doesn't exist for the user's preferred language.
+* If localization is explicitly disabled via the :tfilter:`unlocalize` filter
+ or the :ttag:`{% localize off %}<localize>` tag, it provides fallback
+ localization formats which will be applied instead. See
+ :ref:`controlling localization in templates <topic-l10n-templates>` for
+ details.
See :ref:`how-django-discovers-language-preference` for more details.