diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index 0105b2ccf5c..2f531803bcd 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -1291,18 +1291,18 @@ LANGUAGE_CODE Default: ``'en-us'`` A string representing the language code for this installation. This should be in -standard :term:`language ID format `. For example, U.S. English +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 to this setting to have any effect. +:setting:`USE_I18N` must be active for this setting to have any effect. -it serves two purposes: +It serves two purposes: * If the locale middleware isn't in use, it decides which translation is served to all users. * If the locale middleware is active, it provides the fallback translation when - no translation exist for a given literal to the user preferred language. + no translation exist for a given literal to the user's preferred language. See :ref:`how-django-discovers-language-preference` for more details. diff --git a/docs/topics/i18n/translation.txt b/docs/topics/i18n/translation.txt index 86f6637d778..120db8e5b0d 100644 --- a/docs/topics/i18n/translation.txt +++ b/docs/topics/i18n/translation.txt @@ -1550,15 +1550,15 @@ should be used -- installation-wide, for a particular user, or both. To set an installation-wide language preference, set :setting:`LANGUAGE_CODE`. Django uses this language as the default translation -- the final attempt if no -better matching translation is found by one of the methods employed by the +better matching translation is found through one of the methods employed by the locale middleware (see below). -If all you want to do is run Django with your native language all you need to do +If all you want is to run Django with your native language all you need to do is set :setting:`LANGUAGE_CODE` and make sure the corresponding :term:`message files ` and their compiled versions (``.mo``) exist. If you want to let each individual user specify which language he or she -prefers, the you also need to use use the ``LocaleMiddleware``. +prefers, then you also need to use use the ``LocaleMiddleware``. ``LocaleMiddleware`` enables language selection based on data from the request. It customizes content for each user.