{"title":"Bagaimana menerapkan backend cetakan disesuaikan","version":"6.0","locale":"id","docname":"howto/custom-template-backend","url":"/id/6.0/howto/custom-template-backend/","canonical":"https://djangodocs.dev/id/6.0/howto/custom-template-backend/","summary":"Backend penyesuaian Link to this heading # Ini adalah bagaimana menerapkan backend cetakan penyesuaian untuk menggunakan sistem cetakan lain. Sebuah backend cetakan…","html":"

Bagaimana menerapkan backend cetakan disesuaikanLink to this heading#

\n
\n

Backend penyesuaianLink to this heading#

\n

Ini adalah bagaimana menerapkan backend cetakan penyesuaian untuk menggunakan sistem cetakan lain. Sebuah backend cetakan adalah sebuah kelas yang mewarisi django.template.backends.base.BaseEngine. Itu harus diterapkan get_template() dan pilihan from_string(). Ini adalah sebuah contoh untuk pustaka cetakan khayal foobar:

\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

Lihat DEP 182 untuk informasi lebih.

\n
\n
\n

Penyatuan mencari kesalahan untuk mesin disesuaikanLink to this heading#

\n

Halaman mencari kesalahan Django memiliki kait untuk menyediakan informasi rinci ketika cetakan kesalahan muncul. Mesin penyesuaian cetakan dapat menggunakan kait ini untuk meningkatkan lacak kembali informasi yang muncul ke pengguna. Kait berikut tersedia:

\n
\n

Cetakan postmortemLink to this heading#

\n

Postmortem muncul ketika TemplateDoesNotExist dimunculkan. Dia mendaftarkan mesin cetakan dan pemuat yang digunakan ketika mencoba menemukan cetakan yang diberikan. Sebagai contoh, jika dua mesin Django dikonfigurasi, postmortem akan muncul seperti:

\n\"/id/6.0/_images/postmortem.png\"\n

Mesin penyesuaian dapat mengumpulkan postmortem dengan melewatkan argumen backend dan tried ketika memunculkan TemplateDoesNotExist. Backend yang menggunakan postmortem should specify an origin pada objek cetakan.

\n
\n
\n

Informasi baris kontekstualLink to this heading#

\n

Jika sebuah kesalahan terjadi selama mengurai cetakan atau sedang membangun, Django dapat menampilkan baris dari kesalahan yang terjadi. Sebagai contoh:

\n\"/id/6.0/_images/template-lines.png\"\n

Mesin penyesuaian dapat mengumpulkan informasi ini dengan mengatur atribut template_debug pada pengecualian dimunculkan selama mengurai dan membangun. Atribut ini adalah dict dengan nilai berikut:

\n\n

Diberikan cetakan kesalahan diatas, template_debug akan berupa seperti:

\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 asli dan penggabungan pihak-ketigaLink to this heading#

\n

Cetakan Django mempunyai objek Origin tersedia melalui atribut template.origin. Ini mengadakan informasi pencarian kesalahan untuk ditampilkan dalam template postmortem, sama halnyadi pustaka pihak-3, seperti Django Debug Toolbar.

\n

Mesin disesuaikan dapat menyediakan informasi template.origin milik mereka sendiri dengan membuat sebuah obyek yang menentukan atribut berikut:

\n\n
\n
","rootId":"how-to-implement-a-custom-template-backend","toc":[{"title":"Backend penyesuaian","anchor":"custom-backends","children":[]},{"title":"Penyatuan mencari kesalahan untuk mesin disesuaikan","anchor":"debug-integration-for-custom-engines","children":[{"title":"Cetakan postmortem","anchor":"template-postmortem","children":[]},{"title":"Informasi baris kontekstual","anchor":"contextual-line-information","children":[]},{"title":"API asli dan penggabungan pihak-ketiga","anchor":"origin-api-and-3rd-party-integration","children":[]}]}],"breadcrumbs":[{"docname":"howto/index","title":"Panduan Cara-cara","url":"/id/6.0/howto/"}],"prev":{"docname":"howto/overriding-templates","title":"Bagaimana mengesampingkan cetakan","url":"/id/6.0/howto/overriding-templates/"},"next":{"docname":"howto/custom-template-tags","title":"Bagaimana membuat cetakan etiket dan saringan disesuaikan","url":"/id/6.0/howto/custom-template-tags/"},"formats":{"html":"/id/6.0/howto/custom-template-backend/","markdown":"/id/6.0/howto/custom-template-backend.md","json":"/id/6.0/howto/custom-template-backend.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/howto/custom-template-backend.txt","official":"https://docs.djangoproject.com/id/6.0/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"]}