Работа со STATIC_ROOT, STATICFILES_DIRS, MEDIA_ROOT, MEDIA_DIRS. Как работают и где следует размещать указанные в них директории?

Question

[Your_House]

Вот, спустя немалое количество времени, я прошёлся по всей оф. документации про статические файлы, посмотрел видео на ютубе по этой теме, и теперь начал понимать многое, ОДНАКО. Остались непонятки, связанные со STATIC_ROOT, STATICFILES_DIRS, MEDIA_ROOT, MEDIA_DIRS.

Объясните мне пожалуйста попроще где должны храниться директории, указанные в этих переменных. Вот есть, у меня, к примеру, сайт с несколькими приложениями. Где мне следует разместить папку "связанную со STATIC_ROOT", а где папку "связанную со STATICFILES_DIRS"?

Переменная STATIC_ROOT же может быть только одна, и указанная в ней директория тоже только одна? Просто в документации писалось, что папку "static" (связанную со STATIC_ROOT) следует создавать в директории ПРИЛОЖЕНИЯ, а не в корне проекта. Но ведь тогда будет же странно, если все файлы, связанные с кучей РАЗНЫХ приложений, будут храниться в директории ОДНОГО из них. Разве не логичнее будет создать эту папку static в директории ПРОЕКТА?

Блин, сложно сейчас полноценно сформулировать то, что именно мне не понятно и вызывает вопросы. Так что если что, дополню по ходу дела.

Answer 1

[Руслан]

Общая статическая папка для проекта должна быть в корне проекта, а в приложениях свои папки static, но там есть один нюанс.
Сначала в файле settings.py надо задать следующее, в месте где указывается static параметры:

STATIC_URL = '/static/'
STATIC_ROOT = os.path.normpath(os.path.join(BASE_DIR, 'staticfiles'))
STATICFILES_DIRS = (
    os.path.join(BASE_DIR, 'static'),
)

затем надо организовать такую структуру папок:

project/
    project/
        settings.py
        ...
    application1/
        static/
            application1/
                ... тут статические файлы для приложения 1
    application2/
        static/
            application2/
                ... тут статические файлы для приложения 2
    static/
        ...тут статические файлы для проекта
    manage.py
...

То есть, в корневой директории сразу размещаются статические файлы, а в каталогах приложений, в папке static надо создать папку с именем приложения и уже в ней размещать статические файлы.

Comments

[Your_House]

Хм. В вашем примере ведь нужно было создавать в корневой директории папку "staticfiles", а не "static"? Или я чего-то не понял.
ААААА. Или же в корневой папке, помимо "static", ещё присутствует папка "staticfiles"?

Блин, я полазал в своём проекте, и так и сяк стал пытаться настроить это, но что-то совсем запутался. Лучше предоставлю свою нынешнюю структуру:

• Overwatch
  • __pycache__
  • apps
    • News
      • static
        • News
          • css
            • newsStyles.css
          • img
            • news1.jpg
            • news2.jpg
            • ...
      • admin.py
      • apps.py
      • ...
  • media
  • static
    • css
      • mainStyles.css
    • img
      • header.jpg
      • footer.jpg
  • staticfiles
  • templates
    • main.html
    • News
      • News.html
  • settings.py
  • ...
• db.sqlite3
• manage.py
  

А в файле "settings.py" есть следующие строчки (предоставлю некоторые, которые, как мне кажется, могут пригодиться сейчас):

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

PROJECT_ROOT = os.path.dirname(__file__)
sys.path.insert(0, os.path.join(PROJECT_ROOT, 'apps'))


...


STATIC_URL = '/static/'

STATIC_ROOT = os.path.join(BASE_DIR, "Overwatch/apps/News/static ")

STATICFILES_DIRS = [ 
  os.path.join(BASE_DIR, "Overwatch/static"), 
]

В файле urls.py написано следующее:

from django.contrib import admin
from django.urls import path
from django.conf import settings
from django.conf.urls.static import static
from Overwatch.apps.News import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.mainS),
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) + static(settings.MEDIA_URL, document_root= settings.MEDIA_ROOT)

(Команду "collectstatic" я пока что не прописывал)

Сейчас почти всё работает. Не фурычат только картинки для новостей, которые я пытался добавлять в админке к каждой новости.
Но всё же наверняка у меня сейчас много чего не правильно сделано, так что надеюсь на вашу помощь)))))

[Руслан]

Your_House, ссылка на static в urls.py это вообще лишнее, и во views тоже не надо его прибавлять никуда.
Структура именно так, как я указал. У вас должна быть только папка static, путь к которой определяется в STATICFILES_DIRS.
Папки staticfiles у вас в структуре не должно быть.
STATIC_ROOT - это настройка для хостинга.
Например heroku.com.
Когда размещаете свой проект на данном сервисе - он кэширует все статические данные из ваших static директорий в свою staticfiles.
Эта папка на сервере создается, и этот параметр используется на сервере после кэширования.
У вас же только static и все.