ウェブサイトではふつう、画像や JavaScript、CSS などの追加のファイルを配信する必要があります。Django では、こうしたファイルのことを「静的ファイル (static files)」と呼んでいます。静的ファイルの管理を簡単にするために、Django は django.contrib.staticfiles を提供しています。
このページでは、こうした静的ファイルの配信の仕方について説明します。
\ndjango.contrib.staticfiles が設定ファイルの INSTALLED_APPS に含まれていることを確認してください。
設定ファイルの中で、STATIC_URL を設定します。たとえば、次のようになります。
STATIC_URL = '/static/'\nテンプレート中で、静的ファイルへの URL を /static/my_app/myexample.jpg のようにハードコーディングするか、または、より望ましい方法として static テンプレートタグを記述して、設定した STATICFILES_STORAGE ストレージを使うことにより、指定した相対パスから URL を動的に構築します (この方法は特に、静的ファイルを配信する CDN を切り替えたくなった時に、作業を簡単にしてくれます)。
{% load static %}\n<img src="{% static "my_app/example.jpg" %}" alt="My image"/>\nアプリケーション内に static``というフォルダを作って静的ファイルを保存してください。例えば、``my_app/static/my_app/example.jpg となります。
プロジェクトには、特定のアプリケーションに紐付けられていない 静的な assets があることがあります。その場合には、アプリケーション内の static/ ディレクトリの他に、設定ファイルでディレクトリのリスト (STATICFILES_DIRS) を定義して、Django が静的ファイルを検索できるようにすることができます。たとえば、次のように設定します。
STATICFILES_DIRS = [\n os.path.join(BASE_DIR, "static"),\n '/var/www/static/',\n]\nstaticfiles がファイルを探索する方法について詳しくは、 STATICFILES_FINDERS のドキュメントを参照してください。
If you use django.contrib.staticfiles as explained above,\nrunserver will do this automatically when DEBUG is set\nto True. If you don't have django.contrib.staticfiles in\nINSTALLED_APPS, you can still manually serve static files using the\ndjango.contrib.staticfiles.views.serve() view.
This is not suitable for production use! For some common deployment\nstrategies, see 静的ファイルのデプロイ.
\nFor example, if your STATIC_URL is defined as /static/, you can do\nthis by adding the following snippet to your urls.py:
from django.conf import settings\nfrom django.conf.urls.static import static\n\nurlpatterns = [\n # ... the rest of your URLconf goes here ...\n] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)\nDuring development, you can serve user-uploaded media files from\nMEDIA_ROOT using the django.contrib.staticfiles.views.serve()\nview.
This is not suitable for production use! For some common deployment\nstrategies, see 静的ファイルのデプロイ.
\nFor example, if your MEDIA_URL is defined as /media/, you can do\nthis by adding the following snippet to your urls.py:
from django.conf import settings\nfrom django.conf.urls.static import static\n\nurlpatterns = [\n # ... the rest of your URLconf goes here ...\n] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)\nWhen running tests that use actual HTTP requests instead of the built-in\ntesting client (i.e. when using the built-in LiveServerTestCase) the static assets need to be served along\nthe rest of the content so the test environment reproduces the real one as\nfaithfully as possible, but LiveServerTestCase has only very basic static\nfile-serving functionality: It doesn't know about the finders feature of the\nstaticfiles application and assumes the static content has already been\ncollected under STATIC_ROOT.
Because of this, staticfiles ships its own\ndjango.contrib.staticfiles.testing.StaticLiveServerTestCase, a subclass\nof the built-in one that has the ability to transparently serve all the assets\nduring execution of these tests in a way very similar to what we get at\ndevelopment time with DEBUG = True, i.e. without having to collect them\nusing collectstatic first.
django.contrib.staticfiles provides a convenience management command\nfor gathering static files in a single directory so you can serve them easily.
Set the STATIC_ROOT setting to the directory from which you'd\nlike to serve these files, for example:
STATIC_ROOT = "/var/www/example.com/static/"\nRun the collectstatic management command:
$ python manage.py collectstatic\nThis will copy all files from your static folders into the\nSTATIC_ROOT directory.
Use a web server of your choice to serve the\nfiles. 静的ファイルのデプロイ covers some common deployment\nstrategies for static files.
This document has covered the basics and some common usage patterns. For\ncomplete details on all the settings, commands, template tags, and other pieces\nincluded in django.contrib.staticfiles, see the staticfiles\nreference.