django staticfiles at url root

Question

I have a general question about the new Django 1.3 static file framework.

I really like the new Django staticfile functionality introduced in Django 1.3. Normally, I set STATIC_URL="/static/" and enter the {{ STATIC_URL }} template tag into my templates. It's great how the development server automatically serves up the static files and all of my content is served up as expected.

The {{ STATIC_URL }} would be substituted in the template and might serve up files like this...
example.com/static/css/master.css
example.com/static/images/logo.png
example.com/static/js/site.js

However, I'm working with a legacy site where the static media is mounted at the url root. For example, the path to the static urls might look something like this:

example.com/css/master.css
example.com/images/logo.png
example.com/js/site.js

It doesn't use the "static" url namespace.

I was wondering if there is a way to get the new staticfile functionality to not use the static namespace and serve the urls above, but still retain the benefits of the new staticfile framework (collectstatic, static files served by development server, etc). I tried setting STATIC_URL="" and STATIC_URL="/", but neither seemed to have the desired effect.

Is there a way to configure static files to serve static files without a namespace? Thanks for your consideration.

score 5 · Accepted Answer · edited Mar 08 '13 at 10:59

5

You can manually add extra locations that do not exist within the static directories within your project:

urls.py

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = patterns('',
    # ... the rest of your URLconf goes here ...
)

if settings.DEBUG:
    urlpatterns += static('/css/', document_root='app_root/path/to/css/')
    urlpatterns += static('/images/', document_root='app_root/path/to/images/')
    urlpatterns += static('/js/', document_root='app_root/path/to/js/')

This will map the media for the DEBUG dev server. And when you are running your production mode server, you will obviously be handling these static locations from the web server instead of sending the request through to django.

edited Mar 08 '13 at 10:59

Orlando Pozo

311
3
5

answered Jun 27 '12 at 18:53

jdi

90,542
19
167
203

Thanks jdi. In the templates, would I still {{ STATIC_ROOT }} or just leave it as /css/, /images/, /js/.... ? – Joe J Jun 27 '12 at 19:58
It would not longer be part of the static app, because it can't be collected via `python manage.py collectstatic`. You would just use plain urls like that: `/css/foo.css`. These are being served explicitly from individual locations. They can even exist outside the django project space. – jdi Jun 27 '12 at 20:21
document_root shouldn't start with '/', you have to specify the root directory of your django project, for example: `urlpatterns += static('/css/', document_root='app_root/path/to/css/')` – Orlando Pozo Mar 08 '13 at 10:47

score 2 · Answer 2 · answered Jun 27 '12 at 21:33

why not keep the staticfiles functionality and simply use rewrites at the web server level to serve up the content.

for instance:

rewrite /css /static permanent; (for nginx)

this would keep your project directory a lot cleaner and also make it easier to move your static directories around in the future, for instance to move to your STATIC_URL to a CDN.

score 1 · Answer 3 · edited May 23 '17 at 11:54

This is how you set up your urls.py to serve both index.html and your other static files on / in Django 1.10 (while still being able to serve other Django views):

from django.contrib.staticfiles.views import serve
from django.views.generic import RedirectView

urlpatterns = [

    # / routes to index.html
    url(r'^$', serve,
        kwargs={'path': 'index.html'}),

    # static files (*.css, *.js, *.jpg etc.) served on /
    url(r'^(?!/static/.*)(?P<path>.*\..*)$',
        RedirectView.as_view(url='/static/%(path)s')),
]

See this answer where I wrote a more complete explanation of such a configuration – especially if you want to use it for production.

django staticfiles at url root

3 Answers3

Linked