Browse Source

Fixed #35306 -- Documented fallback localization formats in templates when localization is disabled.

lufafajoshua 9 months ago
parent
commit
3ac0e43207
2 changed files with 12 additions and 5 deletions
  1. 6 3
      docs/ref/settings.txt
  2. 6 2
      docs/topics/i18n/formatting.txt

+ 6 - 3
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.
 

+ 6 - 2
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 <settings-l10n>`
+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 <settings-l10n>` formats
+applied.
 
 .. _custom-format-files: