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
。