Django --static 靜態文件的配置(static_url/STATIC_ROOT/STATICFILES_DIRS)


先上一個項目文件結構:

1、settings.py文件中:static相關內容

# the settings above
# STATIC SETTINGS STATIC_URL = '/static/'
# BASE_DIR 是項目的絕對地址 STATIC_ROOT = os.path.join(BASE_DIR, 'collect_static')
#以下不是必須的 各個app共用的文件可以放在這 STATICFILES_DIRS = ( os.path.join(BASE_DIR, 'common_static'), )

2、模板文件的使用:

# 這四個都可以定位到文件
{% load staticfiles %}  
    <img src="{% static 'img/1.png' %}" />
    <img src="{% static 'img/3.png' %}" />
 
    <img src="{{STATIC_URL}}img/1.png" />
    <img src="{{STATIC_URL}}img/3.png" />

3、各個文件夾的作用

  • STATIC_ROOT

 

 

    是在部署的時候才發揮作用,執行 python managy.py collectstatic ,會在工程文件下生成(STATIC_ROOT )文件夾,把各個app下的靜態文件收集到這個目錄下。當然,需要配置Nginx

 

  • STATICFILES_DIRS

    靜態文件的安放位置有兩種:

    • app/static:

      • 在每個app里面新建一個static文件夾,將靜態文件放到里面
      • 在加載靜態文件時,比如要在模板中用到靜態文件,django會自動在每個app里面搜索static文件夾
      • 所以,不要把文件夾的名字寫錯, 否則django就找不到你的文件夾
      • 因此,一般會這樣設計:app01/static/app01_static/css
    • STATICFILES_DIRS

      • 在所有的app文件外面,建立一個公共的文件夾,,也就是我們的STATICFILES_DIRS: common_static
      • 因為有些靜態文件不是某個app獨有的,那么就可以把它放到一個公共文件夾里面,方便管理
      • 注意,建立一個公共的靜態文件的文件夾只是一種易於管理的做法,但是不是必須的app是可以跨app應用靜態文件的,因為最后所有的靜態文件都會在STATIC_ROOT里面存在
      • 那現在的問題是:如何讓django知道你把一些靜態文件放到app以外的公共文件夾中呢,那就需要配置STATICFILES_DIRS了
    • STATIC_URL

      • 靜態路由映射
      • django利用STATIC_URL來讓瀏覽器可以直接訪問靜態文件

4、Django靜態文件的引用

  • 兩個查找路徑:

    在static標簽中引用文件時有兩個查找路徑:

      1、app下的static

      2、工程下的commen_static(STATICFILES_DIRS)

  • 查找機制:

    STATICFILES_DIRS告訴django:

    首先,到STATICFILES_DIRS里面尋找靜態文件,

    其次,再到各個app的static文件夾里面找

    ps:(注意,django查找靜態文件是惰性查找,查找到第一個,就停止查找了)

截止到目前為止,靜態文件的機制已經可以運作了

但是,有一個疑問,如何通過url來訪問項目中的靜態文件呢?可能會這么做:直接訪問項目的靜態文件的絕對路徑,eg:home/blogproject/common_static/img/1.png,那么,在瀏覽器端需要這樣:http://127.0.0.1:8000/home/blogproject/common_static/img/1.png

但是,很抱歉,如果這樣做的話,Django會報錯,那么,該如何做呢?下面給出答案:

5、static_url詳解

那么django是如何讓瀏覽器也可以訪問服務器上的靜態文件呢,前面已經說了,直接訪問服務器本地的地址是不行的,那就需要一個映射,django利用STATIC_URL來讓瀏覽器可以直接訪問靜態文件,比如:

STATIC_URL = '/static/'

那么可以在瀏覽器上輸入:

  http://127.0.0.1:8000/static/img/1.png
  http://127.0.0.1:8000/static/img/3.png

那么就相當與訪問:

/home/blogproject/common_static/img/1.png

/home/blogproject/mytest/static/img/3.png

 

也就是說STATIC_URL = '/static/' 可以定位到各個app下的staic/和工程下的commen_static/

所以在瀏覽器上,利用前綴 STATIC_URL的具體內容,來映射app下的static和STATICFILES_DIRS,
http://127.0.0.1:8000/static/  相當於 本地地址的app/static 和 STATICFILES_DIRS

6、static靜態文件->模板使用

{% load staticfiles %}
<img src="{% static 'img/1.png' %}" />
  • 我們在模板中添加一行 {% load staticfiles %},告訴django模板引擎我們要在模板中使用靜態文件;
  • 這樣,便可以使用static模板標簽引入靜態目錄中的文件;
  • static 'img/1.png' 告訴django,我們要顯示目錄名中img/1.png 的文件;
  • static標簽會在img/1.png前加上STATIC_URL的指定URL,得到/static/img/1.png ;

django模板引擎生成如下html:

<img src="/static/img/1.png" />

如果使用:

<img src="{{STATIC_URL}}img/3.png" />

需要在setting.py中添加些設置:

1. INSTALLED_APPS 中,加入 'django.contrib.staticfiles' ,這個一般都有。

2. TEMPLATES 中,context_processors中,加入django.template.context_processors.static

 

 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM