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:06:44 +0200 |
| commit | 3ac0e43207b4a1b9327ba12612005c285fbff7ee (patch) | |
| tree | 6043aeec0c9c2f9b15c64e762303f4d11868cb25 /docs | |
| parent | f1705c8780c0a7587654fc736542d55fe4a7f29b (diff) | |
Fixed #35306 -- Documented fallback localization formats in templates when localization is disabled.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/settings.txt | 9 | ||||
| -rw-r--r-- | docs/topics/i18n/formatting.txt | 8 |
2 files changed, 12 insertions, 5 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. 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 <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: |