diff options
| author | Adrian Holovaty <adrian@holovaty.com> | 2006-07-01 03:09:14 +0000 |
|---|---|---|
| committer | Adrian Holovaty <adrian@holovaty.com> | 2006-07-01 03:09:14 +0000 |
| commit | 4a324ba7acd2660538a81b1fb423de89ff515665 (patch) | |
| tree | a0116f171b24951237f32396cda27c2d0cfabb88 /docs | |
| parent | c81d69354ab44e9b12807af9d544d77149b8ea73 (diff) | |
Added USE_I18N setting, which lets you turn off internationalization overhead with a single setting. Defaults to True. Currently only affects the admin i18n JavaScript, but I'll be adding other optimizations.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@3247 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/i18n.txt | 15 | ||||
| -rw-r--r-- | docs/settings.txt | 10 |
2 files changed, 24 insertions, 1 deletions
diff --git a/docs/i18n.txt b/docs/i18n.txt index 1220ea95b3..1382d6df0c 100644 --- a/docs/i18n.txt +++ b/docs/i18n.txt @@ -35,12 +35,25 @@ How to internationalize your app: in three steps support. 3. Activate the locale middleware in your Django settings. - .. admonition:: Behind the scenes Django's translation machinery uses the standard ``gettext`` module that comes with Python. +If you don't need internationalization +====================================== + +Django's internationalization hooks are on by default, and that means there's a +bit of i18n-related overhead in certain places of the framework. If you don't +use internationalization, you should take the two seconds to set +``USE_I18N = False`` in your settings file. If ``USE_I18N`` is set to +``False``, then Django will make some optimizations so as not to load the +internationalization machinery. + +See the `documentation for USE_I18N`_. + +.. _documentation for USE_I18N: http://www.djangoproject.com/documentation/settings/#use-i18n + How to specify translation strings ================================== diff --git a/docs/settings.txt b/docs/settings.txt index 553736b280..7832569455 100644 --- a/docs/settings.txt +++ b/docs/settings.txt @@ -738,6 +738,16 @@ A boolean that specifies whether to output the "Etag" header. This saves bandwidth but slows down performance. This is only used if ``CommonMiddleware`` is installed (see the `middleware docs`_). +USE_I18N +-------- + +Default: ``True`` + +A boolean that specifies whether Django's internationalization system should be +enabled. This provides an easy way to turn it off, for performance. If this is +set to ``False, Django will make some optimizations so as not to load the +internationalization machinery. + YEAR_MONTH_FORMAT ----------------- |