{"title":"정적 파일 관리하기(이미지, 자바스크립트, CSS 등)","version":"5.2","locale":"ko","docname":"howto/static-files/index","url":"/ko/5.2/howto/static-files/","canonical":"https://djangodocs.dev/ko/5.2/howto/static-files/","summary":"웹 사이트는 일반적으로 이미지, JavaScript 또는 CSS와 같은 추가 파일을 제공해야 합니다. Django에서는 이러한 파일을 “static files”라고 합니다. Django는 :mod:’django.contrib.static files’를 제공하여 파일 관리를 도와줍니다. 이…","html":"

정적 파일 관리하기(이미지, 자바스크립트, CSS 등)Link to this heading#

\n

웹 사이트는 일반적으로 이미지, JavaScript 또는 CSS와 같은 추가 파일을 제공해야 합니다. Django에서는 이러한 파일을 “static files”라고 합니다. Django는 :mod:’django.contrib.static files’를 제공하여 파일 관리를 도와줍니다.

\n

이 페이지에서는 이러한 정적 파일을 서비스하는 방법에 대해 설명합니다.

\n
\n

정적 파일을 구성하는 중입니다.Link to this heading#

\n
    \n

  1. “django.contrib.static files”가 다음 설정에 포함되도록 하십시오. INSTALLED_APPS.

    2. \n

  2. 설정 파일에서 다음을 정의합니다.:setting:STATIC_URL, 예를 들어:

    \n
    Code
    STATIC_URL = "static/"\n
    \n
    3. \n

  3. In your templates, use the static template tag to build the URL for\nthe given relative path using the configured staticfiles\nSTORAGES alias.

    \n
    Django template
    {% load static %}\n<img src="{% static 'my_app/example.jpg' %}" alt="My image">\n
    \n
    4. \n

  4. 정적 파일을 앱의 “static” 폴더에 저장합니다. 예를 들어 다음과 같습니다.``my_app/static/my_app/example.jpg``.

    5. \n
\n\n

프로젝트에 특정 앱에 연결되지 않은 정적 자산도 있을 수 있습니다. 앱 내에서 “static/” 디렉토리를 사용하는 것 외에도 디렉토리 목록(:seting:”)을 정의할 수 있습니다.Django가 정적 파일도 찾을 수 있는 설정 파일의 STATICFILES_DIRS)입니다. 예를 들어 다음과 같습니다.

\n
Code
STATICFILES_DIRS = [\n    BASE_DIR / "static",\n    "/var/www/static/",\n]\n
\n

:설정:’에 대한 설명서를 참조하십시오.정적 파일_입니다.”정적 파일”이 당신의 파일을 어떻게 찾는지에 대한 자세한 내용은 FINDER의 설정입니다.

\n\n
\n
\n

개발 중에 정적 파일을 제공합니다.Link to this heading#

\n

위에서 설명한 바와 같이 :mod:’django.contrib.static files’를 사용하는 경우 :설정: :djadmin:’runserver’는 자동으로 이 작업을 수행합니다.DEBUG는 “True”로 설정되어 있습니다. “django.contrib.static files”가 없는 경우 : setting:”으로 설정합니다.설치되었습니다.APPs’에서는 :func:’django’를 사용하여 정적 파일을 수동으로 제공할 수 있습니다.정적이죠.의견을 제시합니다.

\n

이것은 생산용으로 적합하지 않습니다! 일반적인 배포 전략은 :doc:’/how to/static-files/deploy’를 참조하십시오.

\n

예를 들어, :setting:`STATIC_URL`이 ``static/``로 정의된 경우, ``urls.py``에 다음 조각을 추가하여 이를 수행할 수 있습니다:

\n
Code
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)\n
\n\n
\n
\n

개발 중에 사용자가 업로드한 파일을 제공합니다.Link to this heading#

\n

개발 중에:설정:에서 사용자가 업로드한 미디어 파일을 제공할 수 있습니다.’MEDIA_ROOT’는 :func:’django’를 사용합니다.정적이죠.의견을 제시합니다.

\n

이것은 생산용으로 적합하지 않습니다! 일반적인 배포 전략은 :doc:’/how to/static-files/deploy’를 참조하십시오.

\n

예를 들어, :setting:`MEDIA_URL`이 ``media/``로 정의된 경우, 다음 조각을 :setting:`ROOT_URLCONF`에 추가하여 이를 수행할 수 있습니다:

\n
Code
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)\n
\n\n
\n
\n

테스트중Link to this heading#

\n

내장된 테스트 클라이언트 대신 실제 HTTP 요청을 사용하는 테스트를 실행하는 경우(즉, 내장된 :class를 사용하는 경우):”LiveServerTestCase >django.test입니다.’라이브서버 테스트 사례’) 정적 자산은 콘텐츠의 나머지 부분에 제공되어야 테스트 환경이 가능한 한 충실하게 실제 데이터를 재현할 수 있지만 ``라이브서버 테스트 사례”는 매우 기본적인 정적 파일 서비스 기능만 갖추고 있습니다. 정적인 파일(static files) 애플리케이션의 파인더 기능에 대해서는 알지 못하며 정적인 내용은 이미 다음과 같은 설정으로 수집되었다고 가정합니다.STATIC_ROOT’입니다.

\n

이 때문에 “정적 파일”은 자체 클래스인 “django.contrib.static files.testing”을 제공합니다.StaticLiveServer TestCase’는 이러한 테스트를 실행하는 동안 모든 자산을 “DEBUG @ True”로 개발 시 얻은 것과 매우 유사한 방식으로 투명하게 처리할 수 있는 내장형 테스트 사례의 하위 클래스로서, 즉 “staticadmin:”collectstatic”을 먼저 사용할 필요가 없습니다.

\n
\n
\n

배치Link to this heading#

\n

:mod:’django.static files’는 정적 파일을 한 디렉토리로 수집하여 쉽게 제공할 수 있도록 편리한 관리 명령을 제공합니다.

\n
    \n

  1. : setting:’을 설정합니다.STATIC_ROOT’ 설정은 다음과 같이 이러한 파일을 제공할 디렉토리로 설정합니다.

    \n
    Code
    STATIC_ROOT = "/var/www/example.com/static/"\n
    \n
    2. \n

  2. Run the collectstatic management command:

    \n
    Shell
    $ python manage.py collectstatic\n
    \n

    그러면 정적 폴더의 모든 파일이 :seting:’로 복사됩니다.STATIC_ROOT’ 디렉토리입니다.

    \n
    3. \n

  3. 선택한 웹 서버를 사용하여 파일을 제공합니다. :doc:’/how to/static files/deployment’에서는 정적 파일에 대한 몇 가지 일반적인 배포 전략을 다룹니다.

    4. \n
\n
\n
\n

추가사항Link to this heading#

\n

이 문서에서는 기본 사항 및 몇 가지 일반적인 사용 패턴을 다룹니다. :mod:’django.contrib.static files’에 포함된 모든 설정, 명령, 템플릿 태그 및 기타 항목에 대한 자세한 내용은 :doc:’static files reference’를 참조하십시오.

\n
","rootId":"how-to-manage-static-files-e-g-images-javascript-css","toc":[{"title":"정적 파일을 구성하는 중입니다.","anchor":"configuring-static-files","children":[]},{"title":"개발 중에 정적 파일을 제공합니다.","anchor":"serving-static-files-during-development","children":[]},{"title":"개발 중에 사용자가 업로드한 파일을 제공합니다.","anchor":"serving-files-uploaded-by-a-user-during-development","children":[]},{"title":"테스트중","anchor":"testing","children":[]},{"title":"배치","anchor":"deployment","children":[]},{"title":"추가사항","anchor":"learn-more","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"How-to guides","url":"/ko/5.2/howto/"}],"prev":{"docname":"howto/custom-template-tags","title":"커스텀 템플릿 태그 및 필터를 만드는 방법","url":"/ko/5.2/howto/custom-template-tags/"},"next":{"docname":"howto/logging","title":"로깅 구성 및 사용 방법","url":"/ko/5.2/howto/logging/"},"formats":{"html":"/ko/5.2/howto/static-files/","markdown":"/ko/5.2/howto/static-files.md","json":"/ko/5.2/howto/static-files.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/howto/static-files/index.txt","official":"https://docs.djangoproject.com/ko/5.2/howto/static-files/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}