Django 是如何查找静态文件和模板的?
Django 查找静态文件是在模板文件中,查找模板是在视图函数中,模板在加载时会渲染变量以及请求静态文件。
比如本博客的博文详情查询逻辑:
class PostDetailView(CommonViewMixin, DetailView):
"""
博文详情的查询逻辑
- 继承了 ``CommonViewMixin``,会返回侧边栏和导航栏数据
- 此外还要返回博文详情数据
- 最后渲染到 ``blog/detail.html`` 模板中
"""
# TODO 检索模型的配置项(~ 表示该类继承的父类),来自 DetailView ~ BaseDetailView ~ SingleObjectMixin
queryset = Post.get_all()
context_object_name = "post" # 这个名称是模板在解析数据时所使用的变量
pk_url_kwarg = "post_id"
# TODO 模板渲染的配置项,来自 DetailView ~ SingleObjectTemplateResponseMixin ~ TemplateResponseMixin
template_name = "blog/detail.html"
在视图函数中,将最终要渲染的模板文件配置为 blog/detail.html
,这是对应静态文件目录中的 blog
目录下的 detail.html
文件。
对应的文件目录为:
├── manage.py
└── typeidea
├── themes
│ ├── bootstrap
│ │ └── templates
│ │ ├── blog
│ │ │ ├── base.html
│ │ │ ├── detail.html <---- 这里
│ │ │ └── list.html
在这里,检索文件是从 typeidea/typeidea/themes/bootstrap/templates/
开始的。
以及博文详情的模板:
<!-- 代码高亮插件 -->
{% block extra_head %}
<link rel="stylesheet" type="text/css" href="{% static 'css/googlecode.min.css' %}"/>
<script src="{% static 'js/highlight.min.js' %}"></script>
<script>hljs.highlightAll();</script>
{% endblock %}
在模板中,将要读取的代码高亮插件 googlecode.min.css
路径配置为 {% static 'css/googlecode.min.css' %}
。
对应的文件目录为:
├── manage.py
└── typeidea
│ ├── bootstrap
│ │ ├── static
│ │ │ ├── css
│ │ │ │ ├── bootstrap.css
│ │ │ │ ├── default.min.css
│ │ │ │ ├── googlecode.min.css
│ │ │ │ └── prism.css
│ │ │ └── js
│ │ │ ├── highlight.min.js
│ │ │ ├── prism.js
│ │ │ └── run_prettify.js
在这里,检索文件是从 typeidea/typeidea/themes/bootstrap/
开始的。
在 Django 的配置文件中:
# manage.py 同级目录
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
BASE_DIR
是 manage.py
同级目录。
# 页面主题切换
THEME = 'bootstrap'
# 模板
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [os.path.join(BASE_DIR, 'themes', THEME, 'templates')], <---- 这里
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
},
},
]
模板的目录是 BASE_DIR/themes/bootstrap/templates
,即 typeidea/typeidea/themes/bootstrap/templates/
,所以可知,视图函数是从这个配置读取模板文件的目录的。
继续看静态文件配置:
STATIC_URL = '/static/'
STATICFILES_DIRS = [
os.path.join(BASE_DIR, "themes", THEME, "static")
]
其中 STATIC_URL
是说,页面请求静态文件要单独发起一个请求,这时候要指定一个路由名称,这里指定为 /static/
,访问时的链接为 http://127.0.0.1:8000/static/googlecode.min.css
。
STATICFILES_DIRS
则是服务接到请求后,要从哪个目录去找对应的文件,这里配置的是 BASE_DIR/themes/bootstrap/static
,即typeidea/typeidea/themes/bootstrap/static/
。
综上所述,Django 查找模板依赖于配置 TEMPLATES
,查找静态文件依赖于配置 STATIC_URL
和 STATICFILES_DIRS
。