Static file development view¶
-
django.contrib.staticfiles.views.serve(
request,
path)
¶
This view function serves static files in development.
Warning
This view will only work if DEBUG is True.
That's because this view is grossly inefficient and probablyinsecure. This is only intended for local development, and shouldnever be used in production.
This view is automatically enabled by runserver (with aDEBUG setting set to True). To use the view with a different local development server, add the following snippet to the end of your primary URL configuration:
from django.conf import settings if settings.DEBUG:
urlpatterns += patterns('django.contrib.staticfiles.views', url(r'^static/(?P<path>.*)$', 'serve'), )
Note, the beginning of the pattern (r'^static/') should be yourSTATIC_URL setting.
Since this is a bit finicky, there's also a helper function that'll do this for you:
-
django.contrib.staticfiles.urls.staticfiles_urlpatterns()
¶
This will return the proper URL pattern for serving static files to your already defined pattern list. Use it like this:
from django.contrib.staticfiles.urls import staticfiles_urlpatterns # ... the rest of your URLconf here ...
urlpatterns += staticfiles_urlpatterns()
Warning
This helper function will only work if DEBUG is Trueand your STATIC_URL setting is neither empty nor a full URL such as http://static.example.com/.