{"title":"맞춤 템플릿 백엔드","version":"3.2","locale":"ko","docname":"howto/custom-template-backend","url":"/ko/3.2/howto/custom-template-backend/","canonical":"https://djangodocs.dev/ko/3.2/howto/custom-template-backend/","summary":"맞춤 백엔드 Link to this heading # 다른 템플릿 시스템을 사용하기 위해 사용자 지정 템플릿 백엔드를 구현하는 방법은 다음과 같습니다. 템플릿 백엔드는 `` django.template.backends.base”를 상속하는 클래스입니다.Base Engine’입니다.…","html":"

맞춤 템플릿 백엔드Link to this heading#

\n
\n

맞춤 백엔드Link to this heading#

\n

다른 템플릿 시스템을 사용하기 위해 사용자 지정 템플릿 백엔드를 구현하는 방법은 다음과 같습니다. 템플릿 백엔드는 ``django.template.backends.base”를 상속하는 클래스입니다.Base Engine’입니다. “get_template()”과 “from_string()”을 구현해야 한다. 가상의 ``푸바” 템플릿 라이브러리의 예는 다음과 같다.

\n
Code
from django.template import TemplateDoesNotExist, TemplateSyntaxError\nfrom django.template.backends.base import BaseEngine\nfrom django.template.backends.utils import csrf_input_lazy, csrf_token_lazy\n\nimport foobar\n\n\nclass FooBar(BaseEngine):\n\n    # Name of the subdirectory containing the templates for this engine\n    # inside an installed application.\n    app_dirname = 'foobar'\n\n    def __init__(self, params):\n        params = params.copy()\n        options = params.pop('OPTIONS').copy()\n        super().__init__(params)\n\n        self.engine = foobar.Engine(**options)\n\n    def from_string(self, template_code):\n        try:\n            return Template(self.engine.from_string(template_code))\n        except foobar.TemplateCompilationFailed as exc:\n            raise TemplateSyntaxError(exc.args)\n\n    def get_template(self, template_name):\n        try:\n            return Template(self.engine.get_template(template_name))\n        except foobar.TemplateNotFound as exc:\n            raise TemplateDoesNotExist(exc.args, backend=self)\n        except foobar.TemplateCompilationFailed as exc:\n            raise TemplateSyntaxError(exc.args)\n\n\nclass Template:\n\n    def __init__(self, template):\n        self.template = template\n\n    def render(self, context=None, request=None):\n        if context is None:\n            context = {}\n        if request is not None:\n            context['request'] = request\n            context['csrf_input'] = csrf_input_lazy(request)\n            context['csrf_token'] = csrf_token_lazy(request)\n        return self.template.render(context)\n
\n

자세한 내용은 ‘DEP 182’를 참조하십시오.

\n
\n
\n

사용자 지정 엔진을 위한 디버그 통합Link to this heading#

\n

Django 디버그 페이지에는 템플릿 오류가 발생할 때 자세한 정보를 제공하는 후크가 있습니다. 사용자 정의 템플릿 엔진은 이러한 후크를 사용하여 사용자에게 표시되는 추적 정보를 향상시킬 수 있습니다. 다음 후크를 사용할 수 있습니다.

\n
\n

템플릿 사후검토Link to this heading#

\n

다음 경우:exc:에 사후에:’~django.the’템플릿이 없습니다’가 발생합니다. 지정된 템플릿을 찾을 때 사용된 템플릿 엔진 및 로더가 나열됩니다. 예를 들어 두 개의 Django 엔진이 구성된 경우 사후에 다음과 같이 표시됩니다.

\n\"/ko/3.2/_images/postmortem.png\"\n

커스텀엔진은 다음과 같은 문제를 제기할 때 ``백엔드”와 “시도한” 주장을 통과시킴으로써 사후에 채워질 수 있다.’~django.the’템플릿이 없습니다. 사후 처리:ref:’를 사용하는 백엔드는 템플릿 개체에 원점을 지정해야 합니다.

\n
\n
\n

맥락선정보Link to this heading#

\n

If an error happens during template parsing or rendering, Django can display\nthe line the error happened on. For example:

\n\"/ko/3.2/_images/template-lines.png\"\n

사용자 지정 엔진은 구문 분석 및 렌더링 중에 발생하는 예외에 대해 “template_debug” 속성을 설정하여 이 정보를 채울 수 있다. 이 속성은 다음 값을 갖는 :class:’dict’입니다.

\n\n

위의 템플릿 오류로 인해 “template_debug”는 다음과 같이 표시됩니다.

\n
Code
{\n    'name': '/path/to/template.html',\n    'message': "Invalid block tag: 'syntax'",\n    'source_lines': [\n        (1, 'some\\n'),\n        (2, 'lines\\n'),\n        (3, 'before\\n'),\n        (4, 'Hello {% syntax error %} {{ world }}\\n'),\n        (5, 'some\\n'),\n        (6, 'lines\\n'),\n        (7, 'after\\n'),\n        (8, ''),\n    ],\n    'line': 4,\n    'before': 'Hello ',\n    'during': '{% syntax error %}',\n    'after': ' {{ world }}\\n',\n    'total': 9,\n    'bottom': 9,\n    'top': 1,\n}\n
\n
\n
\n

오리진 API 및 타사 통합Link to this heading#

\n

Django 템플릿의 :class:’~django.base.오리진 객체는 “template.origin” 속성을 통해 사용할 수 있다. 디버그 정보를 ef:’템플릿 사후에’는 물론, 제3자 도서관에서도 ‘장고 디버그 툴바’와 같은 디버그 정보를 표시할 수 있다.

\n

커스텀 엔진은 다음과 같은 속성을 지정하는 객체를 만들어 자체 ``템플릿.오리진” 정보를 제공할 수 있다.

\n\n
\n
","rootId":"custom-template-backend","toc":[{"title":"맞춤 백엔드","anchor":"custom-backends","children":[]},{"title":"사용자 지정 엔진을 위한 디버그 통합","anchor":"debug-integration-for-custom-engines","children":[{"title":"템플릿 사후검토","anchor":"template-postmortem","children":[]},{"title":"맥락선정보","anchor":"contextual-line-information","children":[]},{"title":"오리진 API 및 타사 통합","anchor":"origin-api-and-3rd-party-integration","children":[]}]}],"breadcrumbs":[{"docname":"howto/index","title":"“How-to” 가이드","url":"/ko/3.2/howto/"}],"prev":{"docname":"howto/custom-lookups","title":"커스텀 룩업","url":"/ko/3.2/howto/custom-lookups/"},"next":{"docname":"howto/custom-template-tags","title":"사용자 정의 템플릿 태그와 필터","url":"/ko/3.2/howto/custom-template-tags/"},"formats":{"html":"/ko/3.2/howto/custom-template-backend/","markdown":"/ko/3.2/howto/custom-template-backend.md","json":"/ko/3.2/howto/custom-template-backend.json"},"source":"https://github.com/django/django/blob/stable/3.2.x/docs/howto/custom-template-backend.txt","official":"https://docs.djangoproject.com/ko/3.2/howto/custom-template-backend/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}