STATICFILES и статический тег

Ваши CSS, JavaScript и изображения оформления не меняются для каждого запроса. Django называет их статическими файлами и обслуживает отдельно от представлений Python. 🎨

Django по умолчанию добавляет django.contrib.staticfiles в INSTALLED_APPS. Оно находит, собирает и обслуживает ресурсы, поэтому Вам не нужно настраивать это вручную.

По соглашению ресурсы приложения хранятся в папке static рядом с его представлениями и шаблонами. Django ищет эту папку в каждом приложении.

Помещайте ресурсы во вложенную папку с именем приложения, например static/blog/. Это не позволяет двум приложениям перезаписывать общий style.css.

Настройка STATIC_URL задаёт префикс общедоступного пути, по которому браузеры получают ресурсы. Запросы с этим префиксом направляются к статическим файлам.

Чтобы обратиться к ресурсу в шаблоне, сначала загрузите библиотеку тегов с помощью load static в самом начале файла.

Тег static превращает относительный путь к ресурсу в правильный полный URL, поэтому Вам не придётся вручную прописывать STATIC_URL в HTML.

Если Вы вручную записали /static/blog/style.css, последующее изменение STATIC_URL нарушит работу каждой страницы. Тег static сохраняет ссылки гибкими. ✅

Тот же тег static работает с любым типом ресурса. Укажите в теге script путь к файлу JS, и Django сам разрешит этот путь.

Для ресурсов всего проекта, не относящихся к одному приложению, добавьте их папки в STATICFILES_DIRS, и Django тоже будет искать их там.

Внутри системы средства поиска статических файлов обходят папку static каждого приложения и STATICFILES_DIRS, чтобы найти файл, запрошенный шаблоном.

Вы узнали, что статические файлы — это CSS и JS, что они хранятся в папках static с отдельными пространствами имён и что тег static корректно создаёт их URL. 🎉