Windows 10 - Django 框架 学习总结 3 - 总结 2 的补充 - 杂记 - 静态文件理解补充

目录

• 一、关于Django在settings.py文件中静态文件配置的理解
• • 1. 理解 `STATIC_ROOT` 根目录的作用
  • 2. 理解 `STATICFILES_DIRS` 的作用 - 公共静态文件目录 common_static
  • • 明白Django静态文件的引用：
  • 3. 理解 `STATIC_URL` 的静态文件访问映射配置的作用
• 参考链接

一、关于Django在settings.py文件中静态文件配置的理解

下面是settings.py文件中的静态文件的配置：

# ------------------------------------------------------------------------------
STATIC_URL = '/static/'   # 映射静态文件目录
# ------------------------------------------------------------------------------
# BASE_DIR 是项目的绝对地址
STATIC_ROOT = os.path.join(BASE_DIR, 'collect_static')   # 汇总所有的静态文件，到这个目录下，无论是公共的，还是所有的app下的静态文件
# ------------------------------------------------------------------------------
# 公共静态文件模板 优先查找 STATICFILES_DIRS 目录的静态文件，才会去查找 static 目录下的静态文件
# 以下不是必须的  各个app共用的文件可以放在这
STATICFILES_DIRS = [
	os.path.join(BASE_DIR,'common_static')
]

Html模板文件static 标签的使用：

# 这四个都可以定位到文件
{% 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" />

1. 理解 STATIC_ROOT 根目录的作用

STATIC_ROOT 是在部署的时候才发挥作用,执行 python managy.py collectstatic ，会在工程文件下生成(STATIC_ROOT )文件夹，把各个app下的static/静态目录下的静态文件收集到这个目录下。当然，需要配置Nginx。
比如这里配置为 collect_static 目录为根目录，那么就收集所有的app文件夹下的名字为static的子文件夹内的所有文件，统统复制一遍，粘贴到collect_static 目录下。

具体详情链接：Windows 10 - 理解 Django 的 collectstatic 命令、静态文件的访问

2. 理解 STATICFILES_DIRS 的作用 - 公共静态文件目录 common_static

静态文件的一般安放位置有两种:

1. 一种就是在每个app里面新建一个static文件夹，将静态文件放到里面，在加载静态文件时，比如要在模板中用到静态文件，django会自动在每个app里面搜索static文件夹(所以，不要把文件夹static的名字写错， 否则django就找不到你的static文件夹)。
2. 另一种,就是在所有的app文件外面，建立一个公共的文件夹，也就是我们的STATICFILES_DIRS。因为有些静态文件不是某个app独有的,那么就可以把它放到一个公共文件夹里面，方便管理(注意，建立一个公共的静态文件的文件夹只是一种易于管理的做法，但是不是必须的，app是可以跨app应用静态文件的，因为最后所有的静态文件都会在STATIC_ROOT里面存在)
   那现在的问题是如何让django知道你把一些静态文件放到app以外的公共文件夹中呢，那就需要配置STATICFILES_DIRS了

明白Django静态文件的引用：

在static标签中引用文件时有两个查找路径：
1、工程下的commen_static（STATICFILES_DIRS） 。
2、app下的static。

STATICFILES_DIRS告诉django,首先到STATICFILES_DIRS里面寻找静态文件,其次再到各个app的static文件夹里面找(注意，django查找静态文件是惰性查找，查找到第一个，就停止查找了)

Django 查找静态文件 
		   1 ——> 公共的静态文件目录 common_static 
		   2 ——> 各个注册好的app内的 static 目录

但是通常而言我们会将common_static 目录名改为 static ，不过随个人习惯吧，都可以。

STATICFILES_DIRS = [
	os.path.join(BASE_DIR,'static')
]

3. 理解 STATIC_URL 的静态文件访问映射配置的作用

STATIC_URL = '/static/'   # 映射静态文件目录

这个 STATIC_URL 是一个映射的客户端URL的作用，在客户端使用 服务端 ip 地址\static\ ，就可以访问服务端的静态文件，这个是通过映射URL来实现的，具体是，本地的路径不会被外部访问所知道，而且外部也没权限访问本机的静态文件路径，所以需要映射，实际的过程是比如我的一种图片的本地地址为

home/blogproject/common_static/img/1.png 那么别人不可能在浏览器上直接输入:
http://127.0.0.1:8000/home/blogproject/common_static/img/1.png
这样子，浏览器会报错，没有该页面

那么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

三、一般我们在模板中使用

<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" />

如果在模板中使用如下STATIC_URL模板变量 {{ }}

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

就需要在settings.py中添加些设置：

1. INSTALLED_APPS 中，加入 ‘django.contrib.staticfiles’ ，这个一般都有。
   

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

参考链接

Django STATIC_URL 的理解

Django中static（静态）文件详解以及{% static %}标签的使用