diff --git a/docs/i18n.txt b/docs/i18n.txt index d7f5db6861451..7c220c22afe17 100644 --- a/docs/i18n.txt +++ b/docs/i18n.txt @@ -282,6 +282,16 @@ How to create language files Once you've tagged your strings for later translation, you need to write (or obtain) the language translations themselves. Here's how that works. +.. admonition:: Locale restrictions + + Django does support localising your application into a locale for which + Django itself has not been translated -- it will ignore your translation + files. If you were to try this and Django supported it, you would + inevitably see a mixture of translated strings (from your application) and + English strings (from Django itself). If you are wanting to support a + locale for your application that is not already part of Django, you will + need to make at least a minimal translation of the Django core. + Message files -------------