{"title":"커스텀 템플릿 백엔드를 구현하는 방법","version":"5.2","locale":"ko","docname":"howto/custom-template-backend","url":"/ko/5.2/howto/custom-template-backend/","canonical":"https://djangodocs.dev/ko/5.2/howto/custom-template-backend/","summary":"다른 템플릿 시스템을 사용하기 위해 사용자 지정 템플릿 백엔드를 구현하는 방법은 다음과 같습니다.","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    # 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    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/5.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/5.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 templates have an Origin object available\nthrough the template.origin attribute. This enables debug information to be\ndisplayed in the template postmortem, as well as\nin 3rd-party libraries, like the Django Debug Toolbar.

\n

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

\n\n
\n
","rootId":"how-to-implement-a-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 guides","url":"/ko/5.2/howto/"}],"prev":{"docname":"howto/overriding-templates","title":"템플릿 재정의 방법","url":"/ko/5.2/howto/overriding-templates/"},"next":{"docname":"howto/custom-template-tags","title":"커스텀 템플릿 태그 및 필터를 만드는 방법","url":"/ko/5.2/howto/custom-template-tags/"},"formats":{"html":"/ko/5.2/howto/custom-template-backend/","markdown":"/ko/5.2/howto/custom-template-backend.md","json":"/ko/5.2/howto/custom-template-backend.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/howto/custom-template-backend.txt","official":"https://docs.djangoproject.com/ko/5.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","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}