{"title":"Conas cúltaca teimpléad saincheaptha a chur i bhfeidhm","version":"6.0","locale":"ga","docname":"howto/custom-template-backend","url":"/ga/6.0/howto/custom-template-backend/","canonical":"https://djangodocs.dev/ga/6.0/howto/custom-template-backend/","summary":"Cúltaca saincheaptha Link to this heading # Seo conas cúltaca teimpléad saincheaptha a chur i bhfeidhm d'fhonn córas teimpléid eile a úsáid. Is aicme é cúltaca…","html":"

Conas cúltaca teimpléad saincheaptha a chur i bhfeidhmLink to this heading#

\n
\n

Cúltaca saincheapthaLink to this heading#

\n

Seo conas cúltaca teimpléad saincheaptha a chur i bhfeidhm d'fhonn córas teimpléid eile a úsáid. Is aicme é cúltaca teimpléad a fhaigheann Django.Template.Backends.Base.BaseEngine oidhreachta. Caithfidh sé get_template () ``a chur i bhfeidhm agus ``from_string () roghnach. Seo sampla do leabharlann teimpléad ficseanúil 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

Féach DEP 182 le haghaidh tuilleadh eolais.

\n
\n
\n

Comhtháthú dífhabhtaithe le haghaidh innillLink to this heading#

\n

Tá crúcaí ag an leathanach dífhabhtaithe Django chun faisnéis mhionsonraithe a sholáthar nuair a thagann earráid Is féidir le hinnill teimpléad saincheaptha na crúcaí seo a úsáid chun an fhaisnéis rianaithe a fheabhsaíonn d'úsáideoirí. Tá na crúcaí seo a leanas ar fáil:

\n
\n

Teimpléad iar-bháisLink to this heading#

\n

Feictear an post mortem nuair a ardaítear: exc: ~django.template.templateDoesNotExist. Liostaíonn sé na hinnill teimpléid agus na luchtóirí a úsáideadh agus iad ag iarraidh teimpléad ar leith a fháil. Mar shampla, má tá dhá innill Django cumraithe, beidh an post mortem le feiceáil mar:

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

Is féidir le hinnill saincheaptha an post mortem a líonadh trí na hargóintí backend agus tried a rith agus iad ag ardú: exc: ~django.template.templateDoesNotExist. <template-origin-api>Ba chóir go mbeadh cúltaca a úsáideann an postmortem:ref: `bunús 'a shonrú ar réad an teimpléid.

\n
\n
\n

Faisnéis líne comhthéacsúilLink to this heading#

\n

Má tharlaíonn earráid le linn parsála nó rindreála teimpléad, is féidir le Django an líne a tharla an earráid air a thaispeáint. Mar shampla:

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

Is féidir le hinnill saincheaptha an fhaisnéis seo a líonadh trí thréith template_debug a shocrú ar eisceachtaí a ardaítear le linn parsála agus rindreála. Is é an tréith seo a: class: dict leis na luachanna seo a leanas:

\n\n

Mar gheall ar an earráid teimpléid thuas, bheadh cuma template_debug mar:

\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 Origin agus comhtháthú 3ú páirtíLink to this heading#

\n

Tá réad: class: ~django.template.base.origin ag teimpléid Django ar fáil tríd an tréith template.origin. <django-debug-toolbar>Cuireann sé seo ar chumas faisnéis dífhabhtaithe a thaispeáint in:ref: template postmortem <template-postmortem>, chomh maith le leabharlanna 3ú páirtí, cosúil leis an: pypi: Django Debug Toolbar.

\n

Is féidir le hinnill saincheaptha a gcuid faisnéise ``template.origin` féin a sholáthar trí réad a chruthú a shonraíonn na tréithe seo a leanas:

\n\n
\n
","rootId":"how-to-implement-a-custom-template-backend","toc":[{"title":"Cúltaca saincheaptha","anchor":"custom-backends","children":[]},{"title":"Comhtháthú dífhabhtaithe le haghaidh innill","anchor":"debug-integration-for-custom-engines","children":[{"title":"Teimpléad iar-bháis","anchor":"template-postmortem","children":[]},{"title":"Faisnéis líne comhthéacsúil","anchor":"contextual-line-information","children":[]},{"title":"API Origin agus comhtháthú 3ú páirtí","anchor":"origin-api-and-3rd-party-integration","children":[]}]}],"breadcrumbs":[{"docname":"howto/index","title":"Treoracha conas","url":"/ga/6.0/howto/"}],"prev":{"docname":"howto/overriding-templates","title":"Conas teimpléid a shárú","url":"/ga/6.0/howto/overriding-templates/"},"next":{"docname":"howto/custom-template-tags","title":"Conas clibeanna agus scagairí teimpléad saincheaptha a ch","url":"/ga/6.0/howto/custom-template-tags/"},"formats":{"html":"/ga/6.0/howto/custom-template-backend/","markdown":"/ga/6.0/howto/custom-template-backend.md","json":"/ga/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/ga/6.0/howto/custom-template-backend/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}