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 `. 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 %}` tag, it provides fallback + localization formats which will be applied instead. See + :ref:`controlling localization in templates ` for + details. See :ref:`how-django-discovers-language-preference` for more details. diff --git a/docs/topics/i18n/formatting.txt b/docs/topics/i18n/formatting.txt index 1010ce2e84..e1b6213ca2 100644 --- a/docs/topics/i18n/formatting.txt +++ b/docs/topics/i18n/formatting.txt @@ -89,6 +89,9 @@ To activate or deactivate localization for a template block, use: {{ value }} {% endlocalize %} +When localization is disabled, the :ref:`localization settings ` +formats are applied. + See :tfilter:`localize` and :tfilter:`unlocalize` for template filters that will do the same job on a per-variable basis. @@ -133,8 +136,9 @@ To force localization of a single value, use :tfilter:`localize`. To control localization over a large section of a template, use the :ttag:`localize` template tag. -Returns a string representation for unlocalized numbers (``int``, ``float``, -or ``Decimal``). +Returns a string representation for numbers (``int``, ``float``, or +``Decimal``) with the :ref:`localization settings ` formats +applied. .. _custom-format-files: