← Back to branch summary

~ubuntu-branches/ubuntu/quantal/python-django/quantal-security

« back to all changes in this revision

Viewing changes to docs/ref/settings.txt

  • Committer: Bazaar Package Importer
  • Author(s): Jamie Strandboge
  • Date: 2010-10-12 11:34:35 UTC
  • mfrom: (1.1.12 upstream) (29.1.1 maverick-security)
  • Revision ID: james.westby@ubuntu.com-20101012113435-yy57c8tx6g9anf3e
Tags: 1.2.3-1ubuntu0.1
* SECURITY UPDATE: XSS in CSRF protections. New upstream release
  - CVE-2010-3082
* debian/patches/01_disable_url_verify_regression_tests.diff:
  - updated to disable another test that fails without internet connection
  - patch based on work by Kai Kasurinen and Krzysztof Klimonda
* debian/control: don't Build-Depends on locales-all, which doesn't exist
  in maverick

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/ref/settings.txt
1
 
.. _ref-settings:
2
 
 
3
1
========
4
2
Settings
5
3
========
74
72
    (('John', 'john@example.com'), ('Mary', 'mary@example.com'))
75
73
 
76
74
Note that Django will e-mail *all* of these people whenever an error happens.
77
 
See :ref:`howto-error-reporting` for more information.
 
75
See :doc:`/howto/error-reporting` for more information.
78
76
 
79
77
.. setting:: ALLOWED_INCLUDE_ROOTS
80
78
 
99
97
Default: ``True``
100
98
 
101
99
Whether to append trailing slashes to URLs. This is only used if
102
 
``CommonMiddleware`` is installed (see :ref:`topics-http-middleware`). See also
 
100
``CommonMiddleware`` is installed (see :doc:`/topics/http/middleware`). See also
103
101
``PREPEND_WWW``.
104
102
 
105
103
.. setting:: AUTHENTICATION_BACKENDS
110
108
Default: ``('django.contrib.auth.backends.ModelBackend',)``
111
109
 
112
110
A tuple of authentication backend classes (as strings) to use when attempting to
113
 
authenticate a user. See the :ref:`authentication backends documentation
114
 
<authentication-backends>` for details.
 
111
authenticate a user. See the :doc:`authentication backends documentation
 
112
</ref/authbackends>` for details.
115
113
 
116
114
.. setting:: AUTH_PROFILE_MODULE
117
115
 
130
128
 
131
129
Default: ``'locmem://'``
132
130
 
133
 
The cache backend to use. See :ref:`topics-cache`.
 
131
The cache backend to use. See :doc:`/topics/cache`.
 
132
 
 
133
.. setting:: CACHE_MIDDLEWARE_ANONYMOUS_ONLY
 
134
 
 
135
CACHE_MIDDLEWARE_ANONYMOUS_ONLY
 
136
-------------------------------
 
137
 
 
138
Default: ``False``
 
139
 
 
140
If the value of this setting is ``True``, only anonymous requests (i.e., not
 
141
those made by a logged-in user) will be cached.  Otherwise, the middleware
 
142
caches every page that doesn't have GET or POST parameters.
 
143
 
 
144
If you set the value of this setting to ``True``, you should make sure you've
 
145
activated ``AuthenticationMiddleware``.
 
146
 
 
147
See the :doc:`cache documentation </topics/cache>` for more information.
134
148
 
135
149
.. setting:: CACHE_MIDDLEWARE_KEY_PREFIX
136
150
 
140
154
Default: ``''`` (Empty string)
141
155
 
142
156
The cache key prefix that the cache middleware should use. See
143
 
:ref:`topics-cache`.
 
157
:doc:`/topics/cache`.
144
158
 
145
159
.. setting:: CACHE_MIDDLEWARE_SECONDS
146
160
 
152
166
The default number of seconds to cache a page when the caching middleware or
153
167
``cache_page()`` decorator is used.
154
168
 
155
 
.. setting:: CSRF_COOKIE_NAME
156
 
 
157
 
CSRF_COOKIE_NAME
158
 
----------------
159
 
 
160
 
.. versionadded:: 1.2
161
 
 
162
 
Default: ``'csrftoken'``
163
 
 
164
 
The name of the cookie to use for the CSRF authentication token. This can be whatever you
165
 
want.  See :ref:`ref-contrib-csrf`.
166
 
 
167
169
.. setting:: CSRF_COOKIE_DOMAIN
168
170
 
169
171
CSRF_COOKIE_DOMAIN
179
181
``".lawrence.com"`` to allow a POST request from a form on one subdomain to be
180
182
accepted by accepted by a view served from another subdomain.
181
183
 
 
184
.. setting:: CSRF_COOKIE_NAME
 
185
 
 
186
CSRF_COOKIE_NAME
 
187
----------------
 
188
 
 
189
.. versionadded:: 1.2
 
190
 
 
191
Default: ``'csrftoken'``
 
192
 
 
193
The name of the cookie to use for the CSRF authentication token. This can be whatever you
 
194
want.  See :doc:`/ref/contrib/csrf`.
 
195
 
182
196
.. setting:: CSRF_FAILURE_VIEW
183
197
 
184
198
CSRF_FAILURE_VIEW
195
209
 
196
210
where ``reason`` is a short message (intended for developers or logging, not for
197
211
end users) indicating the reason the request was rejected.  See
198
 
:ref:`ref-contrib-csrf`.
 
212
:doc:`/ref/contrib/csrf`.
199
213
 
200
214
 
201
215
.. setting:: DATABASES
208
222
Default: ``{}`` (Empty dictionary)
209
223
 
210
224
A dictionary containing the settings for all databases to be used with
211
 
Django. It is a nested dictionary who's contents maps database aliases
 
225
Django. It is a nested dictionary whose contents maps database aliases
212
226
to a dictionary containing the options for an individual database.
213
227
 
214
228
The :setting:`DATABASES` setting must configure a ``default`` database;
385
399
tests will use a memory resident database. For all other database engines the
386
400
test database will use the name ``'test_' + DATABASE_NAME``.
387
401
 
388
 
See :ref:`topics-testing`.
389
 
 
 
402
See :doc:`/topics/testing`.
 
403
 
 
404
.. setting:: TEST_USER
 
405
 
 
406
TEST_USER
 
407
~~~~~~~~~
 
408
 
 
409
Default: ``None``
 
410
 
 
411
This is an Oracle-specific setting.
 
412
 
 
413
The username to use when connecting to the Oracle database that will be used
 
414
when running tests.
390
415
 
391
416
.. setting:: DATABASE_ROUTERS
392
417
 
441
466
 
442
467
See also ``DATETIME_INPUT_FORMATS`` and ``TIME_INPUT_FORMATS``.
443
468
 
444
 
.. _datetime: http://docs.python.org/library/datetime.html#strftime-behavior
 
469
.. _datetime: http://docs.python.org/library/datetime.html#strftime-strptime-behavior
445
470
 
446
471
.. setting:: DATETIME_FORMAT
447
472
 
481
506
 
482
507
See also ``DATE_INPUT_FORMATS`` and ``TIME_INPUT_FORMATS``.
483
508
 
484
 
.. _datetime: http://docs.python.org/library/datetime.html#strftime-behavior
 
509
.. _datetime: http://docs.python.org/library/datetime.html#strftime-strptime-behavior
485
510
 
486
511
.. setting:: DEBUG
487
512
 
494
519
 
495
520
If you define custom settings, `django/views/debug.py`_ has a ``HIDDEN_SETTINGS``
496
521
regular expression which will hide from the DEBUG view anything that contains
497
 
``'SECRET'``, ``'PASSWORD'``, or ``'PROFANITIES'``. This allows untrusted users to
498
 
be able to give backtraces without seeing sensitive (or offensive) settings.
 
522
``'SECRET'``, ``'PASSWORD'``, ``'PROFANITIES'``, or ``'SIGNATURE'``. This allows
 
523
untrusted users to be able to give backtraces without seeing sensitive (or
 
524
offensive) settings.
499
525
 
500
526
Still, note that there are always going to be sections of your debug output that
501
527
are inappropriate for public consumption. File paths, configuration options, and
554
580
isn't manually specified. Used with ``DEFAULT_CHARSET`` to construct the
555
581
``Content-Type`` header.
556
582
 
557
 
.. setting:: DEFAULT_FROM_EMAIL
 
583
.. setting:: DEFAULT_FILE_STORAGE
558
584
 
559
585
DEFAULT_FILE_STORAGE
560
586
--------------------
562
588
Default: ``'django.core.files.storage.FileSystemStorage'``
563
589
 
564
590
Default file storage class to be used for any file-related operations that don't
565
 
specify a particular storage system. See :ref:`topics-files`.
 
591
specify a particular storage system. See :doc:`/topics/files`.
 
592
 
 
593
.. setting:: DEFAULT_FROM_EMAIL
566
594
 
567
595
DEFAULT_FROM_EMAIL
568
596
------------------
572
600
Default e-mail address to use for various automated correspondence from the
573
601
site manager(s).
574
602
 
 
603
.. setting:: DEFAULT_INDEX_TABLESPACE
 
604
 
 
605
DEFAULT_INDEX_TABLESPACE
 
606
------------------------
 
607
 
 
608
.. versionadded:: 1.0
 
609
 
 
610
Default: ``''`` (Empty string)
 
611
 
 
612
Default tablespace to use for indexes on fields that don't specify
 
613
one, if the backend supports it.
 
614
 
575
615
.. setting:: DEFAULT_TABLESPACE
576
616
 
577
617
DEFAULT_TABLESPACE
584
624
Default tablespace to use for models that don't specify one, if the
585
625
backend supports it.
586
626
 
587
 
.. setting:: DEFAULT_INDEX_TABLESPACE
588
 
 
589
 
DEFAULT_INDEX_TABLESPACE
590
 
------------------------
591
 
 
592
 
.. versionadded:: 1.0
593
 
 
594
 
Default: ``''`` (Empty string)
595
 
 
596
 
Default tablespace to use for indexes on fields that don't specify
597
 
one, if the backend supports it.
598
 
 
599
627
.. setting:: DISALLOWED_USER_AGENTS
600
628
 
601
629
DISALLOWED_USER_AGENTS
606
634
List of compiled regular expression objects representing User-Agent strings that
607
635
are not allowed to visit any page, systemwide. Use this for bad robots/crawlers.
608
636
This is only used if ``CommonMiddleware`` is installed (see
609
 
:ref:`topics-http-middleware`).
 
637
:doc:`/topics/http/middleware`).
610
638
 
611
639
.. setting:: EMAIL_BACKEND
612
640
 
615
643
 
616
644
.. versionadded:: 1.2
617
645
 
618
 
Default: ``'django.core.mail.backends.smtp'``
 
646
Default: ``'django.core.mail.backends.smtp.EmailBackend'``
619
647
 
620
648
The backend to use for sending emails. For the list of available backends see
621
 
:ref:`topics-email`.
 
649
:doc:`/topics/email`.
622
650
 
623
651
.. setting:: EMAIL_FILE_PATH
624
652
 
723
751
    ("django.core.files.uploadhandler.MemoryFileUploadHandler",
724
752
     "django.core.files.uploadhandler.TemporaryFileUploadHandler",)
725
753
 
726
 
A tuple of handlers to use for uploading. See :ref:`topics-files` for details.
 
754
A tuple of handlers to use for uploading. See :doc:`/topics/files` for details.
727
755
 
728
756
.. setting:: FILE_UPLOAD_MAX_MEMORY_SIZE
729
757
 
735
763
Default: ``2621440`` (i.e. 2.5 MB).
736
764
 
737
765
The maximum size (in bytes) that an upload will be before it gets streamed to
738
 
the file system. See :ref:`topics-files` for details.
739
 
 
740
 
.. setting:: FILE_UPLOAD_TEMP_DIR
741
 
 
742
 
FILE_UPLOAD_TEMP_DIR
743
 
--------------------
744
 
 
745
 
.. versionadded:: 1.0
746
 
 
747
 
Default: ``None``
748
 
 
749
 
The directory to store data temporarily while uploading files. If ``None``,
750
 
Django will use the standard temporary directory for the operating system. For
751
 
example, this will default to '/tmp' on \*nix-style operating systems.
752
 
 
753
 
See :ref:`topics-files` for details.
 
766
the file system. See :doc:`/topics/files` for details.
754
767
 
755
768
.. setting:: FILE_UPLOAD_PERMISSIONS
756
769
 
780
793
 
781
794
.. _documentation for os.chmod: http://docs.python.org/library/os.html#os.chmod
782
795
 
 
796
.. setting:: FILE_UPLOAD_TEMP_DIR
 
797
 
 
798
FILE_UPLOAD_TEMP_DIR
 
799
--------------------
 
800
 
 
801
.. versionadded:: 1.0
 
802
 
 
803
Default: ``None``
 
804
 
 
805
The directory to store data temporarily while uploading files. If ``None``,
 
806
Django will use the standard temporary directory for the operating system. For
 
807
example, this will default to '/tmp' on \*nix-style operating systems.
 
808
 
 
809
See :doc:`/topics/files` for details.
 
810
 
783
811
.. setting:: FIRST_DAY_OF_WEEK
784
812
 
785
813
FIRST_DAY_OF_WEEK
806
834
 
807
835
List of locations of the fixture data files, in search order. Note that
808
836
these paths should use Unix-style forward slashes, even on Windows. See
809
 
:ref:`topics-testing`.
 
837
:doc:`/topics/testing`.
810
838
 
811
839
FORCE_SCRIPT_NAME
812
840
------------------
866
894
 
867
895
A tuple of strings that specify beginnings of URLs that should be ignored by
868
896
the 404 e-mailer. See ``SEND_BROKEN_LINK_EMAILS``, ``IGNORABLE_404_ENDS`` and
869
 
the :ref:`howto-error-reporting`.
 
897
the :doc:`/howto/error-reporting`.
870
898
 
871
899
.. setting:: INSTALLED_APPS
872
900
 
899
927
 
900
928
    * See debug comments, when ``DEBUG`` is ``True``
901
929
    * Receive X headers if the ``XViewMiddleware`` is installed (see
902
 
      :ref:`topics-http-middleware`)
 
930
      :doc:`/topics/http/middleware`)
903
931
 
904
932
.. setting:: LANGUAGE_CODE
905
933
 
910
938
 
911
939
A string representing the language code for this installation. This should be in
912
940
standard :term:`language format<language code>`. For example, U.S. English is
913
 
``"en-us"``. See :ref:`topics-i18n`.
 
941
``"en-us"``. See :doc:`/topics/i18n/index`.
914
942
 
915
943
.. setting:: LANGUAGE_COOKIE_NAME
916
944
 
923
951
 
924
952
The name of the cookie to use for the language cookie. This can be whatever you
925
953
want (but should be different from ``SESSION_COOKIE_NAME``). See
926
 
:ref:`topics-i18n`.
 
954
:doc:`/topics/i18n/index`.
927
955
 
928
956
.. setting:: LANGUAGES
929
957
 
941
969
name)``, the ``language code`` part should be a
942
970
:term:`language name<language code>` -- for example, ``('ja', 'Japanese')``.
943
971
This specifies which languages are available for language selection. See
944
 
:ref:`topics-i18n`.
 
972
:doc:`/topics/i18n/index`.
945
973
 
946
974
Generally, the default value should suffice. Only set this setting if you want
947
975
to restrict language selection to a subset of the Django-provided languages.
1061
1089
Default: `messages.INFO`
1062
1090
 
1063
1091
Sets the minimum message level that will be recorded by the messages
1064
 
framework. See the :ref:`messages documentation <ref-contrib-messages>` for
 
1092
framework. See the :doc:`messages documentation </ref/contrib/messages>` for
1065
1093
more details.
1066
1094
 
1067
1095
MESSAGE_STORAGE
1072
1100
Default: ``'django.contrib.messages.storage.user_messages.LegacyFallbackStorage'``
1073
1101
 
1074
1102
Controls where Django stores message data.  See the
1075
 
:ref:`messages documentation <ref-contrib-messages>` for more details.
 
1103
:doc:`messages documentation </ref/contrib/messages>` for more details.
1076
1104
 
1077
1105
MESSAGE_TAGS
1078
1106
------------
1088
1116
        messages.ERROR: 'error',}
1089
1117
 
1090
1118
Sets the mapping of message levels to message tags. See the
1091
 
:ref:`messages documentation <ref-contrib-messages>` for more details.
 
1119
:doc:`messages documentation </ref/contrib/messages>` for more details.
1092
1120
 
1093
1121
MIDDLEWARE_CLASSES
1094
1122
------------------
1101
1129
     'django.contrib.auth.middleware.AuthenticationMiddleware',
1102
1130
     'django.contrib.messages.middleware.MessageMiddleware',)
1103
1131
 
1104
 
A tuple of middleware classes to use. See :ref:`topics-http-middleware`.
 
1132
A tuple of middleware classes to use. See :doc:`/topics/http/middleware`.
1105
1133
 
1106
1134
.. versionchanged:: 1.2
1107
1135
   ``'django.contrib.messages.middleware.MessageMiddleware'`` was added to the
1108
 
   default.  For more information, see the :ref:`messages documentation
1109
 
   <ref-contrib-messages>`.
 
1136
   default.  For more information, see the :doc:`messages documentation
 
1137
   </ref/contrib/messages>`.
1110
1138
 
1111
1139
.. setting:: MONTH_DAY_FORMAT
1112
1140
 
1152
1180
Default: ``False``
1153
1181
 
1154
1182
Whether to prepend the "www." subdomain to URLs that don't have it. This is only
1155
 
used if ``CommonMiddleware`` is installed (see :ref:`topics-http-middleware`).
 
1183
used if ``CommonMiddleware`` is installed (see :doc:`/topics/http/middleware`).
1156
1184
See also ``APPEND_SLASH``.
1157
1185
 
1158
1186
.. setting:: PROFANITIES_LIST
1167
1195
the default values, see the file `django/conf/global_settings.py`_.
1168
1196
 
1169
1197
.. _django/conf/global_settings.py: http://code.djangoproject.com/browser/django/trunk/django/conf/global_settings.py
 
1198
 
 
1199
.. setting:: RESTRUCTUREDTEXT_FILTER_SETTINGS
 
1200
 
 
1201
RESTRUCTUREDTEXT_FILTER_SETTINGS
 
1202
--------------------------------
 
1203
 
 
1204
Default: ``{}``
 
1205
 
 
1206
A dictionary containing settings for the ``restructuredtext`` markup filter from
 
1207
the :doc:`django.contrib.markup application </ref/contrib/markup>`. They override
 
1208
the default writer settings. See the Docutils restructuredtext `writer settings
 
1209
docs`_ for details.
 
1210
 
 
1211
.. _writer settings docs: http://docutils.sourceforge.net/docs/user/config.html#html4css1-writer
 
1212
 
1170
1213
.. setting:: ROOT_URLCONF
1171
1214
 
1172
1215
ROOT_URLCONF
1200
1243
Whether to send an e-mail to the ``MANAGERS`` each time somebody visits a
1201
1244
Django-powered page that is 404ed with a non-empty referer (i.e., a broken
1202
1245
link). This is only used if ``CommonMiddleware`` is installed (see
1203
 
:ref:`topics-http-middleware`. See also ``IGNORABLE_404_STARTS``,
1204
 
``IGNORABLE_404_ENDS`` and :ref:`howto-error-reporting`.
 
1246
:doc:`/topics/http/middleware`. See also ``IGNORABLE_404_STARTS``,
 
1247
``IGNORABLE_404_ENDS`` and :doc:`/howto/error-reporting`.
1205
1248
 
1206
1249
.. setting:: SERIALIZATION_MODULES
1207
1250
 
1226
1269
The e-mail address that error messages come from, such as those sent to
1227
1270
``ADMINS`` and ``MANAGERS``.
1228
1271
 
1229
 
.. setting:: SESSION_ENGINE
1230
 
 
1231
 
SESSION_ENGINE
1232
 
--------------
1233
 
 
1234
 
.. versionadded:: 1.0
1235
 
 
1236
 
.. versionchanged:: 1.1
1237
 
   The ``cached_db`` backend was added
1238
 
 
1239
 
Default: ``django.contrib.sessions.backends.db``
1240
 
 
1241
 
Controls where Django stores session data. Valid values are:
1242
 
 
1243
 
    * ``'django.contrib.sessions.backends.db'``
1244
 
    * ``'django.contrib.sessions.backends.file'``
1245
 
    * ``'django.contrib.sessions.backends.cache'``
1246
 
    * ``'django.contrib.sessions.backends.cached_db'``
1247
 
 
1248
 
See :ref:`topics-http-sessions`.
1249
 
 
1250
1272
.. setting:: SESSION_COOKIE_AGE
1251
1273
 
1252
1274
SESSION_COOKIE_AGE
1254
1276
 
1255
1277
Default: ``1209600`` (2 weeks, in seconds)
1256
1278
 
1257
 
The age of session cookies, in seconds. See :ref:`topics-http-sessions`.
 
1279
The age of session cookies, in seconds. See :doc:`/topics/http/sessions`.
1258
1280
 
1259
1281
.. setting:: SESSION_COOKIE_DOMAIN
1260
1282
 
1265
1287
 
1266
1288
The domain to use for session cookies. Set this to a string such as
1267
1289
``".lawrence.com"`` for cross-domain cookies, or use ``None`` for a standard
1268
 
domain cookie. See the :ref:`topics-http-sessions`.
 
1290
domain cookie. See the :doc:`/topics/http/sessions`.
1269
1291
 
1270
1292
.. setting:: SESSION_COOKIE_NAME
1271
1293
 
1275
1297
Default: ``'sessionid'``
1276
1298
 
1277
1299
The name of the cookie to use for sessions. This can be whatever you want (but
1278
 
should be different from ``LANGUAGE_COOKIE_NAME``). See the :ref:`topics-http-sessions`.
 
1300
should be different from ``LANGUAGE_COOKIE_NAME``). See the :doc:`/topics/http/sessions`.
1279
1301
 
1280
1302
.. setting:: SESSION_COOKIE_PATH
1281
1303
 
1303
1325
Whether to use a secure cookie for the session cookie. If this is set to
1304
1326
``True``, the cookie will be marked as "secure," which means browsers may
1305
1327
ensure that the cookie is only sent under an HTTPS connection.
1306
 
See the :ref:`topics-http-sessions`.
 
1328
See the :doc:`/topics/http/sessions`.
 
1329
 
 
1330
.. setting:: SESSION_ENGINE
 
1331
 
 
1332
SESSION_ENGINE
 
1333
--------------
 
1334
 
 
1335
.. versionadded:: 1.0
 
1336
 
 
1337
.. versionchanged:: 1.1
 
1338
   The ``cached_db`` backend was added
 
1339
 
 
1340
Default: ``django.contrib.sessions.backends.db``
 
1341
 
 
1342
Controls where Django stores session data. Valid values are:
 
1343
 
 
1344
    * ``'django.contrib.sessions.backends.db'``
 
1345
    * ``'django.contrib.sessions.backends.file'``
 
1346
    * ``'django.contrib.sessions.backends.cache'``
 
1347
    * ``'django.contrib.sessions.backends.cached_db'``
 
1348
 
 
1349
See :doc:`/topics/http/sessions`.
1307
1350
 
1308
1351
.. setting:: SESSION_EXPIRE_AT_BROWSER_CLOSE
1309
1352
 
1313
1356
Default: ``False``
1314
1357
 
1315
1358
Whether to expire the session when the user closes his or her browser.
1316
 
See the :ref:`topics-http-sessions`.
 
1359
See the :doc:`/topics/http/sessions`.
1317
1360
 
1318
1361
.. setting:: SESSION_FILE_PATH
1319
1362
 
1325
1368
Default: ``None``
1326
1369
 
1327
1370
If you're using file-based session storage, this sets the directory in
1328
 
which Django will store session data. See :ref:`topics-http-sessions`. When
 
1371
which Django will store session data. See :doc:`/topics/http/sessions`. When
1329
1372
the default value (``None``) is used, Django will use the standard temporary
1330
1373
directory for the system.
1331
1374
 
1337
1380
Default: ``False``
1338
1381
 
1339
1382
Whether to save the session data on every request. See
1340
 
:ref:`topics-http-sessions`.
 
1383
:doc:`/topics/http/sessions`.
1341
1384
 
1342
1385
.. setting:: SHORT_DATE_FORMAT
1343
1386
 
1382
1425
table. This is used so that application data can hook into specific site(s)
1383
1426
and a single database can manage content for multiple sites.
1384
1427
 
1385
 
See :ref:`ref-contrib-sites`.
 
1428
See :doc:`/ref/contrib/sites`.
1386
1429
 
1387
1430
.. _site framework docs: ../sites/
1388
1431
 
1405
1448
 
1406
1449
.. versionchanged:: 1.2
1407
1450
   ``"django.contrib.messages.context_processors.messages"`` was added to the
1408
 
   default.  For more information, see the :ref:`messages documentation
1409
 
   <ref-contrib-messages>`.
 
1451
   default.  For more information, see the :doc:`messages documentation
 
1452
   </ref/contrib/messages>`.
1410
1453
 
1411
1454
.. versionchanged:: 1.2
1412
1455
    The auth context processor was moved in this release from its old location
1440
1483
List of locations of the template source files, in search order. Note that
1441
1484
these paths should use Unix-style forward slashes, even on Windows.
1442
1485
 
1443
 
See :ref:`topics-templates`..
 
1486
See :doc:`/topics/templates`.
1444
1487
 
1445
1488
.. setting:: TEMPLATE_LOADERS
1446
1489
 
1456
1499
knows how to import templates from a particular source. Optionally, a tuple can be
1457
1500
used instead of a string. The first item in the tuple should be the ``Loader``'s
1458
1501
module, subsequent items are passed to the ``Loader`` during initialization. See
1459
 
:ref:`ref-templates-api`.
 
1502
:doc:`/ref/templates/api`.
1460
1503
 
1461
1504
.. setting:: TEMPLATE_STRING_IF_INVALID
1462
1505
 
1479
1522
   Prior to 1.2, test runners were a function, not a class.
1480
1523
 
1481
1524
The name of the class to use for starting the test suite. See
1482
 
:ref:`topics-testing`.
 
1525
:doc:`/topics/testing`.
1483
1526
 
1484
1527
.. _Testing Django Applications: ../testing/
1485
1528
 
1531
1574
 
1532
1575
See also ``DATE_INPUT_FORMATS`` and ``DATETIME_INPUT_FORMATS``.
1533
1576
 
1534
 
.. _datetime: http://docs.python.org/library/datetime.html#strftime-behavior
 
1577
.. _datetime: http://docs.python.org/library/datetime.html#strftime-strptime-behavior
1535
1578
 
1536
1579
.. setting:: TIME_ZONE
1537
1580
 
1598
1641
 
1599
1642
A boolean that specifies whether to output the "Etag" header. This saves
1600
1643
bandwidth but slows down performance. This is only used if ``CommonMiddleware``
1601
 
is installed (see :ref:`topics-http-middleware`).
1602
 
 
1603
 
.. setting:: USE_L10N
1604
 
 
1605
 
USE_L10N
1606
 
--------
1607
 
 
1608
 
.. versionadded:: 1.2
1609
 
 
1610
 
Default ``False``
1611
 
 
1612
 
A boolean that specifies if data will be localized by default or not. If this
1613
 
is set to ``True``, e.g. Django will display numbers and dates using the
1614
 
format of the current locale.
1615
 
 
1616
 
See also ``USE_I18N`` and ``LANGUAGE_CODE``
 
1644
is installed (see :doc:`/topics/http/middleware`).
1617
1645
 
1618
1646
.. setting:: USE_I18N
1619
1647
 
1629
1657
 
1630
1658
See also ``USE_L10N``
1631
1659
 
 
1660
.. setting:: USE_L10N
 
1661
 
 
1662
USE_L10N
 
1663
--------
 
1664
 
 
1665
.. versionadded:: 1.2
 
1666
 
 
1667
Default ``False``
 
1668
 
 
1669
A boolean that specifies if data will be localized by default or not. If this
 
1670
is set to ``True``, e.g. Django will display numbers and dates using the
 
1671
format of the current locale.
 
1672
 
 
1673
See also ``USE_I18N`` and ``LANGUAGE_CODE``
 
1674
 
1632
1675
.. setting:: USE_THOUSAND_SEPARATOR
1633
1676
 
1634
1677
USE_THOUSAND_SEPARATOR