django-settings(8) site

Sites¶

django.contrib.sites에 대한 설정입니다.

SITE_ID¶

기본값: 정의되지 않음

django_site 데이터베이스 테이블에서 현재 사이트의 ID(정수)입니다. 이것은 응용 프로그램 데이터가 특정 사이트에 통합될 수 있도록 하며 하나의 데이터베이스가 여러 사이트의 콘텐츠를 관리할 수 있도록 합니다.

정적 파일¶

django.contrib.staticfiles에 대한 설정입니다.

STATIC_ROOT¶

기본값: None

정적 파일을 배포하기 위해 collectstatic 명령이 정적 파일을 수집할 디렉토리의 절대 경로입니다.

예: "/var/www/example.com/static/"

staticfiles 기여 앱이 활성화된 경우(기본 프로젝트 템플릿과 같이), collectstatic 관리 명령은 정적 파일을 이 디렉토리로 수집합니다. 사용법에 대한 자세한 내용은 정적 파일 관리를 참조하세요.

경고

이것은 초기에 비어있는 대상 디렉토리여야 하며 영구적인 위치에서 정적 파일을 수집하기 위한 디렉토리가 아닙니다. 이를 위해서는 staticfiles의 finders에서 찾을 수 있는 디렉토리에 저장해야 합니다. 기본적으로 'static/' 앱 하위 디렉토리와 STATICFILES_DIRS에 포함된 디렉토리입니다.

STATIC_URL¶

기본값: None

STATIC_ROOT에 위치한 정적 파일을 참조할 때 사용할 URL입니다.

예: "static/" 또는 "http://static.example.com/"

None이 아닌 경우, 이것은 자산 정의(Media 클래스) 및 staticfiles 앱의 기본 경로로 사용됩니다.

비어 있지 않은 값으로 설정되면 반드시 슬래시로 끝나야 합니다.

개발 환경에서 이러한 파일을 제공하도록 설정하거나 운영 환경에서해야 할 수 있습니다.

참고

STATIC_URL이 상대 경로인 경우, 이것은 서버가 제공하는 SCRIPT_NAME 값(설정되지 않은 경우 /)으로 접두사가 붙습니다. 이렇게 하면 추가 구성 없이 하위 경로에서 Django 애플리케이션을 제공하는 것이 더 쉬워집니다.

STATICFILES_DIRS¶

기본값: [] (빈 목록)

이 설정은 FileSystemFinder 파인더가 활성화된 경우 staticfiles 앱이 추가로 탐색할 위치를 정의합니다. 예를 들어 collectstatic 또는 findstatic 관리 명령을 사용하거나 정적 파일 서빙 뷰를 사용하는 경우입니다.

이것은 추가 파일 디렉토리의 전체 경로를 포함하는 문자열 목록으로 설정해야 합니다. 예를 들어:

STATICFILES_DIRS = [
    "/home/special.polls.com/polls/static",
    "/home/polls.com/polls/static",
    "/opt/webfiles/common",
]

이 경로는 윈도우에서도 Unix 스타일의 슬래시를 사용해야 하며(예: "C:/Users/user/mysite/extra_static_content") 다음과 같습니다.

접두사 (선택 사항)¶

위치 중 하나에서 파일을 참조할 때 추가 네임스페이스로 참조하려는 경우, 접두사를 (prefix, path) 튜플로 선택적으로 제공할 수 있습니다. 예를 들어:

STATICFILES_DIRS = [
    # ...
    ("downloads", "/opt/webfiles/stats"),
]

예를 들어, STATIC_URL이 'static/'로 설정된 경우, collectstatic 관리 명령은 "stats" 파일을 STATIC_ROOT의 'downloads' 하위 디렉토리에 수집합니다.

이렇게 하면 템플릿에서 로컬 파일 '/opt/webfiles/stats/polls_20101022.tar.gz'를 '/static/downloads/polls_20101022.tar.gz'와 같이 참조할 수 있습니다.

<a href="{% static 'downloads/polls_20101022.tar.gz' %}">

STATICFILES_STORAGE¶

기본값: 'django.contrib.staticfiles.storage.StaticFilesStorage'

collectstatic 관리 명령을 사용하여 정적 파일을 수집할 때 사용할 파일 저장 엔진입니다.

이 설정에서 정의된 저장 백엔드의 사용 준비가 된 인스턴스는 django.core.files.storage.storages의 staticfiles 키 아래에서 찾을 수 있습니다.

예제는 클라우드 서비스 또는 CDN에서 정적 파일 제공를 참조하세요.

4.2 버전 이후에서는 더 이상 사용되지 않음: 이 설정은 폐기되었습니다. Django 4.2부터 정적 파일 저장 엔진은 staticfiles 키 아래의 STORAGES 설정으로 구성할 수 있습니다.

STATICFILES_FINDERS¶

기본값:

[
    "django.contrib.staticfiles.finders.FileSystemFinder",
    "django.contrib.staticfiles.finders.AppDirectoriesFinder",
]

여러 위치에서 정적 파일을 찾을 수 있는 파인더 백엔드의 목록입니다.

기본값은 STATICFILES_DIRS 설정( django.contrib.staticfiles.finders.FileSystemFinder를 사용함) 및 각 앱의 static 하위 디렉토리(django.contrib.staticfiles.finders.AppDirectoriesFinder를 사용함)에 저장된 파일을 찾습니다. 동일한 이름의 여러 파일이 있는 경우, 찾아진 첫 번째 파일이 사용됩니다.

기본적으로 하나의 파인더가 비활성화되어 있습니다: django.contrib.staticfiles.finders.DefaultStorageFinder. 이를 STATICFILES_FINDERS 설정에 추가하면 기본 파일 저장소에서 정적 파일을 찾습니다. 이는 STORAGES 설정의 default 키에 의해 정의된 기본 파일 저장소에서 정적 파일을 찾습니다.

참고

AppDirectoriesFinder 파인더를 사용할 때 앱이 staticfiles에서 찾을 수 있도록 하려면 앱을 사이트의 INSTALLED_APPS 설정에 추가하세요.

정적 파일 파인더는 현재 비공개 인터페이스로 간주되며, 이 인터페이스는 문서화되지 않았습니다.