{"title":"How to override templates","version":"4.0","locale":"ko","docname":"howto/overriding-templates","url":"/ko/4.0/howto/overriding-templates/","canonical":"https://djangodocs.dev/ko/4.0/howto/overriding-templates/","summary":"프로젝트에서 타사 애플리케이션이든 `` django.contrib.admin”과 같은 기여 애플리케이션이든 다른 Django 애플리케이션의 템플릿을 재정의하는 것이 좋습니다. 프로젝트의 템플릿 디렉토리 또는 응용프로그램의 템플리트 디렉토리에 템플리트 재정의를 넣을 수 있습니다. 앱 및 프로젝트…","html":"

How to override templatesLink to this heading#

\n

프로젝트에서 타사 애플리케이션이든 ``django.contrib.admin”과 같은 기여 애플리케이션이든 다른 Django 애플리케이션의 템플릿을 재정의하는 것이 좋습니다. 프로젝트의 템플릿 디렉토리 또는 응용프로그램의 템플리트 디렉토리에 템플리트 재정의를 넣을 수 있습니다.

\n

앱 및 프로젝트 템플릿 디렉터리에 모두 재정의가 포함된 경우 기본 Django 템플릿 로더가 먼저 프로젝트 수준 디렉터리에서 템플릿을 로드하려고 시도합니다. 즉, :설정:’입니다.DIRS’가 다음 설정 전에 검색됩니다.’APP_DIRS’입니다.

\n\n
\n

프로젝트의 템플릿 디렉터리에서 재정의합니다.Link to this heading#

\n

먼저 프로젝트의 템플릿 디렉터리에 교체 템플릿을 생성하여 템플릿을 재정의하는 방법에 대해 알아봅니다.

\n

당신이 ``blog/post.html”과 “blog/list.html”을 제공하는 “blog”라는 제3자 애플리케이션의 템플릿을 재정의하려고 한다고 가정해 보겠습니다. 프로젝트의 관련 설정은 다음과 같습니다.

\n
Code
from pathlib import Path\n\nBASE_DIR = Path(__file__).resolve().parent.parent\n\nINSTALLED_APPS = [\n    ...,\n    'blog',\n    ...,\n]\n\nTEMPLATES = [\n    {\n        'BACKEND': 'django.template.backends.django.DjangoTemplates',\n        'DIRS': [BASE_DIR / 'templates'],\n        'APP_DIRS': True,\n        ...\n    },\n]\n
\n

:설정:입니다.기본 프로젝트 템플릿을 사용하여 프로젝트를 생성했다면 템플릿 설정과 ``BASE_DIR”이 이미 존재하게 됩니다. 수정해야 할 설정은 : setting:’입니다.DIRS입니다.

\n

이러한 설정은 프로젝트의 루트에 “템플릿” 디렉토리를 가지고 있다고 가정합니다. “블로그” 앱의 템플릿을 재정의하려면 “템플릿” 디렉터리에 폴더를 생성한 다음 템플릿 파일을 해당 폴더에 추가하십시오.

\n
None
templates/\n    blog/\n        list.html\n        post.html\n
\n

템플릿 로더는 먼저 “DIRS” 디렉토리에서 템플릿을 찾습니다. “blog” 앱의 뷰가 “blog/post.html”과 “blog/list.html” 템플릿을 요청하면 로더는 방금 만든 파일을 반환합니다.

\n
\n
\n

앱의 템플릿 디렉토리에서 재정의합니다.Link to this heading#

\n

프로젝트의 앱 외부에 위치한 템플릿을 재정의하기 때문에 프로젝트의 템플릿 폴더에 템플릿 재정의를 넣고 첫 번째 방법을 사용하는 것이 더 일반적입니다. 그러나 원하는 경우 앱의 템플릿 디렉터리에 재정의를 넣을 수도 있습니다.

\n

먼저 템플릿 설정이 앱 디렉터리 내에서 확인 중인지 확인합니다.

\n
Code
TEMPLATES = [\n    {\n        ...,\n        'APP_DIRS': True,\n        ...\n    },\n]\n
\n

“myapp”이라는 앱에 템플릿 재정의를 넣고 재정의할 템플릿 이름을 “blog/list.html”과 “blog/post.html”로 지정하면 디렉터리 구조는 다음과 같습니다.

\n
None
myapp/\n    templates/\n        blog/\n            list.html\n            post.html\n
\n

설정:을(설정):APP_DIRS가 “참”으로 설정되면 템플릿 로더가 앱의 템플릿 디렉토리를 검색하여 템플릿을 찾습니다.

\n
\n
\n

재정의된 템플릿을 확장합니다.Link to this heading#

\n

템플릿 로더를 구성한 경우 :ttag:’{% extenses %}’ 템플릿 태그를 사용하여 템플릿을 확장하는 동시에 재정의할 수 있습니다. 이렇게 하면 전체 템플릿을 다시 구현할 필요 없이 소규모 사용자 지정을 수행할 수 있습니다.

\n

예를 들어 이 기술을 사용하여 ‘’admin/base_site.html’ 템플릿에 사용자 정의 로고를 추가할 수 있습니다.

\n
\n
templates/admin/base_site.html
\n
Django template
 {% extends "admin/base_site.html" %}\n\n {% block branding %}\n     <img src="link/to/logo.png" alt="logo">\n     {{ block.super }}\n {% endblock %}\n
\n
\n

주요 내용은 다음과 같습니다.

\n\n

이 기술은 템플릿 로더가 ``확장” 태그를 결정할 때 이미 로드된 오버라이드 템플릿(“templates/admin/base_site.html”)을 고려하지 않기 때문에 작동합니다. “블록”과 결합합니다.Superdown은 작은 커스터마이징을 만드는 강력한 기술입니다.

\n
","rootId":"how-to-override-templates","toc":[{"title":"프로젝트의 템플릿 디렉터리에서 재정의합니다.","anchor":"overriding-from-the-project-s-templates-directory","children":[]},{"title":"앱의 템플릿 디렉토리에서 재정의합니다.","anchor":"overriding-from-an-app-s-template-directory","children":[]},{"title":"재정의된 템플릿을 확장합니다.","anchor":"extending-an-overridden-template","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"“How-to” 가이드","url":"/ko/4.0/howto/"}],"prev":{"docname":"howto/outputting-pdf","title":"How to create PDF files","url":"/ko/4.0/howto/outputting-pdf/"},"next":{"docname":"howto/static-files/index","title":"How to manage static files (e.g. images, JavaScript, CSS)","url":"/ko/4.0/howto/static-files/"},"formats":{"html":"/ko/4.0/howto/overriding-templates/","markdown":"/ko/4.0/howto/overriding-templates.md","json":"/ko/4.0/howto/overriding-templates.json"},"source":"https://github.com/django/django/blob/stable/4.0.x/docs/howto/overriding-templates.txt","official":"https://docs.djangoproject.com/ko/4.0/howto/overriding-templates/","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","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}