静态文件如CSS, javascript(如bootstrap), 图片等文件在django中的配置官方文档写的比较模糊,自己通过实验验证后并整理如下,以防遗忘,目前只整理了关于本地开发中的设置方式,实际发布的配置方式稍后整理。
——————————————————————经测试使用第一种方法—————————————————————————————————
【第一部分:配置】
步骤一:配置STATICFILES_DIRS
两种情况:
1. 默认情况,静态文件放在app目录下的static目录中,这种情况不用进行特别配置。
2. 静态文件与特定app无关或是多个app共用同一份静态文件,这种情况下将静态文件文件放在任意目录中,那么在settings.py文件中找到STATICFILES_DIRS部分,在其中添加放置静态文件的目录路径,在该部分的注释中说到,需要使用绝对路径,不要使用相对路径,并且无论在任何系统中都使用“/”作为路径分隔符。
步骤二:配置contrib.staticfiles
在settings.py文件中找到INSTALLED_APPS,确保其中包含有’django.contrib.staticfiles‘,本人使用的是1.4.3版本,该配置以默认加入了,因此也不用特别配置,如果你开发的时候使用的是runserver方式启动服务器,那么你就完成了所有配置,如果你使用其他服务器来开发,则还需要在项目的urls.py中加上如下配置:
Python代码
-
from django.contrib.staticfiles.urls import staticfiles_urlpatterns # ... the rest of your URLconf goes here ... urlpatterns += staticfiles_urlpatterns()
需要注意的是,上面代码的第一行必须放在整个urls文件的第一行,上面代码的最后一行必须放在urls文件的最后一行。
【第二部分:在template中使用静态文件】
两种使用方式:
方法1: 使用context processor:
采用这种方式需要有一些额外配置,打开settings.py,确认TEMPLATE_CONTEXT_PROCESSORS中包含有‘django.core.context_processors.static‘,本人使用的是1.4.3版本,打开后没有找到TEMPLATE_CONTEXT_PROCESSORS一项配置,那么自己加上这一项配置也可以生效,代码如下:
Python代码
TEMPLATE_CONTEXT_PROCESSORS = ( ‘django.core.context_processors.debug‘, ‘django.core.context_processors.i18n‘, ‘django.core.context_processors.media‘, ‘django.core.context_processors.static‘, ‘django.contrib.auth.context_processors.auth‘, ‘django.contrib.messages.context_processors.messages‘, )
配置完成后,在模板中引用静态文件如下:
Html代码
<img src="{{ STATIC_URL }}images/hi.jpg" />
如果你是手写的views部分方法,那么目前访问还不能生效,还需要在views.py中使用RequestContext来处理request请求后才能生效,如果你使用的generic view(通用视图),那么可以忽略一下配置,因为其中已使用RequestContext自动处理了:
Python代码
from django.template import RequestContext from django.shortcuts import render_to_response def index(request): return render_to_response(‘index.html‘, RequestContext(request))
附注: 本人亲自试验过这种配置方式,但最终请求url地址有点诡异,暂时未找到原因和解决方法,因此这种方法需继续测试,慎用!
方法2: 使用template标签的方式:
这种方式比较简便,在本人开发过程中也比较易用,不用额外配置,也不用在每个view中添加RequestContext,在template中可以直接使用,示例代码如下:
Python代码
#直接使用 {% load staticfiles %} <img src="{% static "images/hi.jpg" %}" /> #变量方式使用 {% load staticfiles %} <link rel="stylesheet" href="{% static user_stylesheet %}" type="text/css" media="screen"/>
上面代码第一种方式是直接硬编码静态文件地址,第二种方式是使用变量方式使用静态文件,使用第二种方式时可以如下代码所示:
Python代码
from django.shortcuts import render_to_response def index(request): return render_to_response(‘index.html‘, {‘user_stylesheet‘: ‘css/user.css‘}) #将user_stylesheet加入context传入template进行渲染
实际开发的静态文件部署及访问方式待补充
参考:
1. 官方静态文件设置文档