p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

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

This commit is contained in:
lufafajoshua 2024-06-24 12:02:55 +02:00 committed by Sarah Boyce
parent f1705c8780
commit 3ac0e43207
2 changed files with 12 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
docs/ref/settings.txt
View File

@ -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 is ``"en-us"``. See also the `list of language identifiers`_ and
:doc:`/topics/i18n/index`. :doc:`/topics/i18n/index`.
:setting:`USE_I18N` must be active for this setting to have any effect. It serves three purposes:
It serves two purposes:
* If the locale middleware isn't in use, it decides which translation is served * If the locale middleware isn't in use, it decides which translation is served
to all users. 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 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 website. It also provides the fallback translation when a translation for a
given literal doesn't exist for the user's preferred language. 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. See :ref:`how-django-discovers-language-preference` for more details.

8
docs/topics/i18n/formatting.txt
View File

@ -89,6 +89,9 @@ To activate or deactivate localization for a template block, use:
{{ value }} {{ value }}
{% endlocalize %} {% 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 See :tfilter:`localize` and :tfilter:`unlocalize` for template filters that will
do the same job on a per-variable basis. 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 control localization over a large section of a template, use the
:ttag:`localize` template tag. :ttag:`localize` template tag.
Returns a string representation for unlocalized numbers (``int``, ``float``, Returns a string representation for numbers (``int``, ``float``, or
or ``Decimal``). ``Decimal``) with the :ref:`localization settings <settings-l10n>` formats
applied.
.. _custom-format-files: .. _custom-format-files: