Django中静态文件设置方法

静态文件如CSS， javascript， 图片等文件在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中加上如下配置：

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一项配置，那么自己加上这一项配置也可以生效，代码如下：

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',
)

         配置完成后，在模板中引用静态文件如下：

<img src="{{ STATIC_URL }}images/hi.jpg" />

          如果你是手写的views部分方法，那么目前访问还不能生效，还需要在views.py中使用RequestContext来处理request请求后才能生效，如果你使用的generic view(通用视图),那么可以忽略一下配置，因为其中已使用RequestContext自动处理了：

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中可以直接使用，示例代码如下：

#直接使用
{% load staticfiles %}
<img src="{% static "images/hi.jpg" %}" />

#变量方式使用
{% load staticfiles %}
<link rel="stylesheet" href="{% static user_stylesheet %}" type="text/css" media="screen"/>

    上面代码第一种方式是直接硬编码静态文件地址，第二种方式是使用变量方式使用静态文件，使用第二种方式时可以如下代码所示：

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. 官方静态文件设置文档