pytask: parts/django/docs/howto/static-files.txt@a4fa11b2cb5c (annotated)

307 c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	1	=========================
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	2	How to serve static files
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	3	=========================
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	4
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	5	.. module:: django.views.static
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	6	:synopsis: Serving of static files during development.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	7
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	8	Django itself doesn't serve static (media) files, such as images, style sheets,
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	9	or video. It leaves that job to whichever Web server you choose.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	10
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	11	The reasoning here is that standard Web servers, such as Apache_, lighttpd_ and
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	12	Cherokee_, are much more fine-tuned at serving static files than a Web
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	13	application framework.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	14
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	15	With that said, Django does support static files during development. You can
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	16	use the :func:`django.views.static.serve` view to serve media files.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	17
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	18	.. _Apache: http://httpd.apache.org/
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	19	.. _lighttpd: http://www.lighttpd.net/
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	20	.. _Cherokee: http://www.cherokee-project.com/
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	21
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	22	.. seealso::
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	23
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	24	If you just need to serve the admin media from a nonstandard location, see
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	25	the :djadminopt:`--adminmedia` parameter to :djadmin:`runserver`.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	26
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	27	The big, fat disclaimer
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	28	=======================
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	29
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	30	Using this method is inefficient and insecure. Do not use this in a
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	31	production setting. Use this only for development.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	32
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	33	For information on serving static files in an Apache production environment,
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	34	see the :ref:`Django mod_python documentation <serving-media-files>`.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	35
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	36	How to do it
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	37	============
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	38
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	39	Here's the formal definition of the :func:`~django.views.static.serve` view:
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	40
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	41	.. function:: def serve(request, path, document_root, show_indexes=False)
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	42
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	43	To use it, just put this in your :doc:`URLconf </topics/http/urls>`::
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	44
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	45	(r'^site_media/(?P<path>.*)$', 'django.views.static.serve',
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	46	{'document_root': '/path/to/media'}),
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	47
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	48	...where ``site_media`` is the URL where your media will be rooted, and
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	49	``/path/to/media`` is the filesystem root for your media. This will call the
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	50	:func:`~django.views.static.serve` view, passing in the path from the URLconf
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	51	and the (required) ``document_root`` parameter.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	52
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	53	Given the above URLconf:
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	54
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	55	* The file ``/path/to/media/foo.jpg`` will be made available at the URL
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	56	``/site_media/foo.jpg``.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	57
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	58	* The file ``/path/to/media/css/mystyles.css`` will be made available
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	59	at the URL ``/site_media/css/mystyles.css``.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	60
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	61	* The file ``/path/bar.jpg`` will not be accessible, because it doesn't
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	62	fall under the document root.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	63
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	64	Of course, it's not compulsory to use a fixed string for the
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	65	``'document_root'`` value. You might wish to make that an entry in your
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	66	settings file and use the setting value there. That will allow you and
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	67	other developers working on the code to easily change the value as
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	68	required. For example, if we have a line in ``settings.py`` that says::
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	69
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	70	STATIC_DOC_ROOT = '/path/to/media'
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	71
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	72	...we could write the above :doc:`URLconf </topics/http/urls>` entry as::
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	73
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	74	from django.conf import settings
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	75	...
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	76	(r'^site_media/(?P<path>.*)$', 'django.views.static.serve',
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	77	{'document_root': settings.STATIC_DOC_ROOT}),
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	78
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	79	Be careful not to use the same path as your :setting:`ADMIN_MEDIA_PREFIX` (which defaults
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	80	to ``/media/``) as this will overwrite your URLconf entry.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	81
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	82	Directory listings
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	83	==================
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	84
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	85	Optionally, you can pass the ``show_indexes`` parameter to the
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	86	:func:`~django.views.static.serve` view. This is ``False`` by default. If it's
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	87	``True``, Django will display file listings for directories.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	88
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	89	For example::
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	90
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	91	(r'^site_media/(?P<path>.*)$', 'django.views.static.serve',
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	92	{'document_root': '/path/to/media', 'show_indexes': True}),
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	93
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	94	You can customize the index view by creating a template called
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	95	``static/directory_index.html``. That template gets two objects in its context:
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	96
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	97	* ``directory`` -- the directory name (a string)
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	98	* ``file_list`` -- a list of file names (as strings) in the directory
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	99
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	100	Here's the default ``static/directory_index.html`` template:
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	101
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	102	.. code-block:: html+django
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	103
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	104	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	105	<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	106	<head>
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	107	<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	108	<meta http-equiv="Content-Language" content="en-us" />
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	109	<meta name="robots" content="NONE,NOARCHIVE" />
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	110	<title>Index of {{ directory }}</title>
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	111	</head>
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	112	<body>
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	113	<h1>Index of {{ directory }}</h1>
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	114	<ul>
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	115	{% for f in file_list %}
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	116	<li><a href="{{ f }}">{{ f }}</a></li>
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	117	{% endfor %}
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	118	</ul>
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	119	</body>
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	120	</html>
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	121
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	122	.. versionchanged:: 1.0.3
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	123	Prior to Django 1.0.3, there was a bug in the view that provided directory
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	124	listings. The template that was loaded had to be called
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	125	``static/directory_listing`` (with no ``.html`` extension). For backwards
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	126	compatibility with earlier versions, Django will still load templates with
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	127	the older (no extension) name, but it will prefer the
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	128	``directory_index.html`` version.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	129
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	130	Limiting use to DEBUG=True
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	131	==========================
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	132
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	133	Because URLconfs are just plain Python modules, you can use Python logic to
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	134	make the static-media view available only in development mode. This is a handy
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	135	trick to make sure the static-serving view doesn't slip into a production
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	136	setting by mistake.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	137
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	138	Do this by wrapping an ``if DEBUG`` statement around the
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	139	:func:`django.views.static.serve` inclusion. Here's a full example URLconf::
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	140
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	141	from django.conf.urls.defaults import *
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	142	from django.conf import settings
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	143
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	144	urlpatterns = patterns('',
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	145	(r'^articles/2003/$', 'news.views.special_case_2003'),
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	146	(r'^articles/(?P<year>\d{4})/$', 'news.views.year_archive'),
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	147	(r'^articles/(?P<year>\d{4})/(?P<month>\d{2})/$', 'news.views.month_archive'),
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	148	(r'^articles/(?P<year>\d{4})/(?P<month>\d{2})/(?P<day>\d+)/$', 'news.views.article_detail'),
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	149	)
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	150
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	151	if settings.DEBUG:
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	152	urlpatterns += patterns('',
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	153	(r'^site_media/(?P<path>.*)$', 'django.views.static.serve', {'document_root': '/path/to/media'}),
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	154	)
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	155
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	156	This code is straightforward. It imports the settings and checks the value of
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	157	the :setting:`DEBUG` setting. If it evaluates to ``True``, then ``site_media``
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	158	will be associated with the ``django.views.static.serve`` view. If not, then the
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	159	view won't be made available.
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	160
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	161	Of course, the catch here is that you'll have to remember to set ``DEBUG=False``
c6bca38c1cbf Added buildout stuff and made changes accordingly Nishanth Amuluru <nishanth@fossee.in> parents: diff changeset	162	in your production settings file. But you should be doing that anyway.

author	Nishanth Amuluru <nishanth@fossee.in>
	Sun, 09 Jan 2011 20:26:11 +0530
changeset 368	a4fa11b2cb5c
parent 307	c6bca38c1cbf
permissions	-rw-r--r--