diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index 236cf8c05b..152c6e339c 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -1577,8 +1577,8 @@ render API `. Default: ``None`` -A full Python path to a Python package that contains format definitions for -project locales. If not ``None``, Django will check for a ``formats.py`` +A full Python path to a Python package that contains custom format definitions +for project locales. If not ``None``, Django will check for a ``formats.py`` file, under the directory named as the current locale, and will use the formats defined in this file. @@ -1605,12 +1605,22 @@ paths until it finds a module that actually defines the given format. This means that formats defined in packages farther up in the list will take precedence over the same formats in packages farther down. -Available formats are :setting:`DATE_FORMAT`, :setting:`TIME_FORMAT`, -:setting:`DATETIME_FORMAT`, :setting:`YEAR_MONTH_FORMAT`, -:setting:`MONTH_DAY_FORMAT`, :setting:`SHORT_DATE_FORMAT`, -:setting:`SHORT_DATETIME_FORMAT`, :setting:`FIRST_DAY_OF_WEEK`, -:setting:`DECIMAL_SEPARATOR`, :setting:`THOUSAND_SEPARATOR` and -:setting:`NUMBER_GROUPING`. +Available formats are: + +* :setting:`DATE_FORMAT` +* :setting:`DATE_INPUT_FORMATS` +* :setting:`DATETIME_FORMAT`, +* :setting:`DATETIME_INPUT_FORMATS` +* :setting:`DECIMAL_SEPARATOR` +* :setting:`FIRST_DAY_OF_WEEK` +* :setting:`MONTH_DAY_FORMAT` +* :setting:`NUMBER_GROUPING` +* :setting:`SHORT_DATE_FORMAT` +* :setting:`SHORT_DATETIME_FORMAT` +* :setting:`THOUSAND_SEPARATOR` +* :setting:`TIME_FORMAT` +* :setting:`TIME_INPUT_FORMATS` +* :setting:`YEAR_MONTH_FORMAT` .. setting:: IGNORABLE_404_URLS diff --git a/docs/topics/i18n/translation.txt b/docs/topics/i18n/translation.txt index 5003bfb997..6f890dbbaa 100644 --- a/docs/topics/i18n/translation.txt +++ b/docs/topics/i18n/translation.txt @@ -2076,6 +2076,10 @@ translations for the same literal: following a similar but not identical algorithm. See :class:`.JavaScriptCatalog` for more details. + You can also put :ref:`custom format files ` in the + :setting:`LOCALE_PATHS` directories if you also set + :setting:`FORMAT_MODULE_PATH`. + In all cases the name of the directory containing the translation is expected to be named using :term:`locale name` notation. E.g. ``de``, ``pt_BR``, ``es_AR``, etc.