diff options
| author | lufafajoshua <77637648+lufafajoshua@users.noreply.github.com> | 2024-06-24 12:02:55 +0200 |
|---|---|---|
| committer | Sarah Boyce <42296566+sarahboyce@users.noreply.github.com> | 2024-06-24 18:08:50 +0200 |
| commit | 3d55f2966d6821fd1fd29d90d1d07c195ae8c2cc (patch) | |
| tree | 84265ce5320d81200ed8756ac3856c62f7284338 /docs/ref | |
| parent | 63178036b3384a97dd2547ecfe8349c4b195324a (diff) | |
[5.1.x] Fixed #35306 -- Documented fallback localization formats in templates when localization is disabled.
Backport of 3ac0e43207b4a1b9327ba12612005c285fbff7ee from main.
Diffstat (limited to 'docs/ref')
| -rw-r--r-- | docs/ref/settings.txt | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index ee25eab0dd..292adb3bac 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -1843,9 +1843,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. @@ -1853,6 +1851,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. |