Míníonn an doiciméad seo córas teimpléid Django ó pheirspictíocht theicniúil - conas a oibríonn sé agus conas é a leathnú. Má tá tagairt á lorg agat maidir le comhréiteach na teanga, féach:doc: /ref/templates/language.
\nGlacann sé le tuiscint ar theimpléid, comhthéacsanna, athróga, clibeanna agus rindreáil. Tosaigh leis an: ref: `réamhrá don teanga teimpléid Django <template-language-intro>`mura bhfuil tú eolach ar na coincheapa seo.
\nIs próiseas trí chéim é an córas teimpléid a úsáid i Python:
\nCumraíonn tú an:class: Inneall.
Tiomsaíonn tú cód teimpléad isteach i a:class: Teimpléad.
Déanann tú an teimpléad a: class: Context.
De ghnáth braitheann tionscadail Django ar:ref: `ardleibhéal, APIs agnóstacha cúltaca <template-engines>`do gach ceann de na céimeanna seo in ionad APIs leibhéal níos ísle an chórais teimpléid:
\nMaidir le gach ceann: aicme: ~django.template.backends.django.djangoTemplates sa socrú: TEMPLATES, déanann Django ain:class: Engine. :class: ~django.template.backends.django.djangoTemplates fillteann:class: Engine agus cuireann sé in oiriúint don API cúltaca teimpléad coitianta.
Soláthraíonn an modúl: mod: django.template.loader feidhmeanna mar: func: ~django.template.loader.get_template chun teimpléid a luchtú. Filleann siad django.template.backends.django.template a fhilleann an fhíor:class: django.template.template.
Tá a: meth: ~django.template.backends.base.template.base.template.render modh a fuarthas sa chéim roimhe seo a mharsaíonn comhthéacs agus b'fhéidir iarratas isteach i a:class: Context agus a thosclaíonn an rindreáil chuig an bun:class: Template.
Má tá tú ag úsáid an backend: :class: ~django.template.backends.django.djangoTemplates, is dócha nach é seo an doiciméadú atá á lorg agat. Tá sampla den aicme Engine a thuairiscítear thíos inrochtana ag baint úsáide as tréith inneal den chúltaca sin agus cuirtear aon réamhshocraithe tréithe a luaitear thíos ag an méid a chuirtear trí:class: ~django.template.backends.django.djangoTemplates.
Agus “Inneall” á dtionscnamh, caithfear gach argóint a rith mar argóintí eochairfhocal:
\nIs liosta eolairí é dirs inar chóir don inneall comhaid foinse teimpléad a lorg. <django.template.loaders.filesystem.Loader>Úsáidtear é chun: class: `FileSystem.loader `a chumrú.
Tá sé réamhshocraithe go liosta folamh.
\nNí théann app_dirs` i bhfeidhm ach ar luach réamhshocraithe loaders. Féach thíos.
Tá sé réamhshocraithe go False.
Rialaíonn autoescape an bhfuil autoescaping HTML cumasaithe.
Tá sé réamhshocraithe go True.
Is é context_processors` liosta de chosáin poncaireacha Python chuig glaonna a úsáidtear chun an comhthéacs a líonadh nuair a dhéantar teimpléad a léiriú le hiarratas. Glacann na glaonna seo réad iarratais mar argóint agus filleann siad a: class: dict d'earraí atá le cumasc sa chomhthéacs.
\nTá sé réamhshocraithe go liosta folamh.
\nFéach: Class: ~django.template.requestContext le haghaidh tuilleadh faisnéise.
\nIs boolean é debug a chasann air/as modh dífhabhtaithe teimpléad. Más “True” é, stóráilfidh an t-inneall teimpléid faisnéis bhreise dífhabhtaithe is féidir a úsáid chun tuarascáil mhionsonraithe a thaispeáint d'aon eisceacht a ardaítear le linn rindreáil teimpléad.
Tá sé réamhshocraithe go False.
Is liosta d'aicmí lódóirí teimpléad é loaders`, a shonraítear mar teaghráin. Tá a fhios ag gach rang ``Loader` conas teimpléid a iompórtáil ó fhoinse áirithe. Go roghnach, is féidir tuple a úsáid in ionad sreang. Ba chóir gurb é an chéad mhír sa tuple ainm aicme ``Loader ``, cuirtear míreanna ina dhiaidh sin chuig an ``Loader le linn an tionscnaimh.
Tá sé réamhshocraithe ar liosta ina bhfuil:
\n'Django.Template.Loaders.FileSystem.Loader'
'Django.Template.Loaders.App_Directories.Loader' más rud é agus amháin má tá app_dirs True.
Ansin filtear na luchtóirí seo in:class: django.template.loaders.cached.loader.
\nFéach:ref: template-loaders le haghaidh sonraí.
\nIs é string_if_invalid an t-aschur, mar shreang, ar chóir don chóras teimpléid a úsáid le haghaidh athróga neamhbhailí (m.sh. mí-litrithe).
Déanann sé réamhshocraithe don teaghrán folamh.
\nFéach:ref: invalid-template-athraitheoir le haghaidh sonraí.
\nIs é file_charset` an charset a úsáidtear chun comhaid teimpléad a léamh ar dhiosca.
\nTá sé réamhshocraithe go 'utf-8'.
`leabharlanna: Foclóir lipéid agus cosáin poncanna Python de mhodúil clibeanna teimpléad le clárú leis an inneall teimpléad. Úsáidtear é seo chun leabharlanna nua a chur leis nó lipéid mhalartacha a sholáthar do na cinn atá ann Mar shampla:
Engine(\n libraries={\n "myapp_tags": "path.to.myapp.tags",\n "admin.urls": "django.contrib.admin.templatetags.admin_urls",\n },\n)\n<load>Is féidir leabharlanna a luchtú tríd an eochair chomhfhreagrach foclóra a rith chuig an gclibe:ttag: {% load%}.
\n`builtins': Liosta de na cosáin poncaí Python de mhodúil clibeanna teimpléad le cur la:doc: `builtin</ref/templates/builtins> s'. Mar shampla:
Engine(\n builtins=["myapp.builtins"],\n)\n<load>Is féidir clibeanna agus scagairí ó leabharlanna ionsuite a úsáid gan glaoch ar dtús ar an gclibe:ttag: {% load%}.
\nFilleann sé an bunlin:class: Engine ón gcéad inneall cumraithe:class: ~django.template.backends.django.djangoTemplates. Ardaithe:exc: ~Django.Core.Exceptions.ImProperlyConfigured mura bhfuil aon innill chumraithe.
\nTá sé ag teastáil chun APIs a chaomhnú atá ag brath ar inneall cumraithe go domhanda atá cumraithe go hinmheánach. Déantar aon úsáid eile a dhíspreagadh go láidir.
\nTiomsaíonn sé an cód teimpléad a thugtar agus cuireann sé ar ais a:class: Teimpléad réad.
\nLuchtaíonn teimpléad leis an ainm tugtha, tiomsaíonn sé é agus filleann sé a: class: Teimpléad réad.
\nCos:Meth: ~Engine.get_Template, ach amháin go dtógann sé liosta ainmneacha agus tugann sé an chéad teimpléad a fuarthas ar ais.
\nIs é an bealach a mholtar chun a:class: Template a chruthú ná modhanna monarchan an: class: Engine: :meth: ~Engine.get_Template, :meth: ~Engine.select_Template agus:meth: ~Engine.from_string.
\nI dtionscadal Django ina sainmhíníonn an socrú:setting: TEMPLATES a:class: ~django.template.backends.django.djangoTemplates, is féidir a:class: Template a chur isteach go díreach. Má shainmhínítear níos mó ná inneall amháin: class: ~django.template.backends.django.djangoTemplates, úsáidfear an chéad cheann.
\nTá an rang seo ina chónaí ag Django.Template.Template. Glacann an tógálaí argóint amháin - an cód teimpléad amh:
from django.template import Template\n\ntemplate = Template("My name is {{ my_name }}.")\nNuair a bheidh réad tiomsaithe:class: Template agat, is féidir leat comhthéacs a rinneadh leis. Is féidir leat an teimpléad céanna a athúsáid chun é a dhéanamh arís agus arís eile le comhthéacsanna éagsúla
\nTógann tógálaí Django.Template.Context argóint roghnach - foclóir a mhapáil ainmneacha athraitheacha chuig luachanna athraitheacha.
Is féidir trí argóint eochairfhocal roghnach a shonrú freisin:
\nRialaíonn autoescape an bhfuil autoescaping HTML cumasaithe.
Tá sé réamhshocraithe go True.
Sáraíonn use_l10n cibé an mbeidh luachanna logánaithe de réir réamhshocraithe. Má tá sé socraithe go True déanfar uimhreacha agus dátaí a fhormáidiú bunaithe ar an áitiúil.
Tá sé réamhshocraithe go None.
Féach:ref: topic-l10n-templates le haghaidh sonraí.
\nAthraíonn use_tz cibé an ndéantar dátaí a thiontú go dtí an am áitiúil nuair a dhéantar iad a rinneadh i dteimpléad. Má tá sé socraithe ar True déanfar gach dáta a léiriú ag baint úsáide as an crios ama áitiúil. Tá tosaíocht air seo thar: setting: USE_TZ.
Tá sé réamhshocraithe go None.
Féach:ref: criosanna ama-in-theimpléid le haghaidh sonraí.
\nMar shampla úsáid, féach:ref: playing-with-context thíos.
\nGlaoigh ar an modh render () ``réad: `Teimpléad le a:class: Context chun an teimpléad a “líonadh”:
\n>>> from django.template import Context, Template\n>>> template = Template("My name is {{ my_name }}.")\n\n>>> context = Context({"my_name": "Adrian"})\n>>> template.render(context)\n"My name is Adrian."\n\n>>> context = Context({"my_name": "Dolores"})\n>>> template.render(context)\n"My name is Dolores."\nNí mór go mbeadh aon litir (A-Z), aon dhigit (0-9), béim (ach níor chóir dóibh tosú le béim) nó ponc ar ainmneacha athróga.
\nTá brí speisialta ag poncanna i rindreáil teimpléad. Léiríonn ponc in ainm athraitheach**cuardach**. Go sonrach, nuair a bhíonn an córas teimpléid ag teacht le ponc in ainm athraitheach, déanann sé iarracht na cuardaigh seo a leanas, san ord seo:
\nCuardach foclóra. Sampla: ``foo ["bar"] ``
Cuardach tréithe. Sampla: foo.bar
Cuardach liosta-innéacs. Sampla: ``foo [bar] ``
Tabhair faoi deara go léirmhínítear “barra” i abairt teimpléid cosúil le {{foo.bar}} mar shreang litriúil agus gan úsáid luach an athróg “barra”, má tá ceann ann i gcomhthéacs an teimpléid.
Úsáideann an córas teimpléid an chéad chineál cuardaigh a oibríonn. Is loighic ghearrchiorcad é. Seo cúpla sampla:
\n>>> from django.template import Context, Template\n>>> t = Template("My name is {{ person.first_name }}.")\n>>> d = {"person": {"first_name": "Joe", "last_name": "Johnson"}}\n>>> t.render(Context(d))\n"My name is Joe."\n\n>>> class PersonClass:\n... pass\n...\n>>> p = PersonClass()\n>>> p.first_name = "Ron"\n>>> p.last_name = "Nasty"\n>>> t.render(Context({"person": p}))\n"My name is Ron."\n\n>>> t = Template("The first stooge in the list is {{ stooges.0 }}.")\n>>> c = Context({"stooges": ["Larry", "Curly", "Moe"]})\n>>> t.render(c)\n"The first stooge in the list is Larry."\nMá tá aon chuid den athróg inghlaoch, déanfaidh an córas teimpléid iarracht glaoch air. Sampla:
\n>>> class PersonClass2:\n... def name(self):\n... return "Samantha"\n...\n>>> t = Template("My name is {{ person.name }}.")\n>>> t.render(Context({"person": PersonClass2}))\n"My name is Samantha."\nTá athróga inghlaonta beagán níos casta ná athróga nach dteastaíonn ach cuardach díreach uathu. Seo roinnt rudaí le coinneáil i gcuimhne:
\nMá ardaíonn an t-athróg eisceacht nuair a thugtar air, iomadófar an eisceacht, mura bhfuil tréith silent_variable_failure ag an eisceacht a luach True. Má tá tréith silent_variable_failure ag an eisceacht **, a bhfuil a luach True, tabharfaidh an t-athróg mar luach rogha cumraíochta string_if_invalid an innill (teaghrán folamh, de réir réamhshocraithe). Sampla:
>>> t = Template("My name is {{ person.first_name }}.")\n>>> class PersonClass3:\n... def first_name(self):\n... raise AssertionError("foo")\n...\n>>> p = PersonClass3()\n>>> t.render(Context({"person": p}))\nTraceback (most recent call last):\n...\nAssertionError: foo\n\n>>> class SilentAssertionError(Exception):\n... silent_variable_failure = True\n...\n>>> class PersonClass4:\n... def first_name(self):\n... raise SilentAssertionError\n...\n>>> p = PersonClass4()\n>>> t.render(Context({"person": p}))\n"My name is ."\nTabhair faoi deara go bhfuil: exc: Django.Core.Exceptions.ObjectDoesNotExist, arb é an bunaicme do gach eisceacht API bunachar sonraí Django doesNotExist, ag silent_variable_fail = True`. Mar sin má tá teimpléid Django á úsáid agat le rudaí samhail Django, teipeann ar aon eisceacht DoesNotExist go ciúin.
Ní féidir athróg a ghlaoch ach mura bhfuil aon argóintí riachtanacha aige. Seachas sin, cuirfidh an córas luach rogha string_if_invalid` an innill ar ais.
D'fhéadfadh fo-iarsmaí a bheith ann agus tú ag glaoch ar roinnt athróga, agus bheadh sé amhnach nó poll slándála chun ligean don chóras teimpléid rochtain a fháil orthu.
\nSampla maith is ea an modh: meth: ~django.db.models.model.delete ar gach réad samhail Django. Níor chóir go mbeadh cead ag an gcóras teimpléid rud éigin mar seo a dhéanamh:
\nI will now delete this valuable data. {{ data.delete }}\nTo prevent this, set an alters_data attribute on the callable\nvariable. The template system won't call a variable if it has\nalters_data=True set, and will instead replace the variable with\nstring_if_invalid, unconditionally. The\ndynamically-generated delete() and\nsave() methods on Django model objects get\nalters_data=True automatically. Example:
def sensitive_function(self):\n self.database_record.delete()\n\n\nsensitive_function.alters_data = True\nOccasionally you may want to turn off this feature for other reasons,\nand tell the template system to leave a variable uncalled no matter\nwhat. To do so, set a do_not_call_in_templates attribute on the\ncallable with the value True. The template system then will act as\nif your variable is not callable (allowing you to access attributes of\nthe callable, for example).
Go ginearálta, mura bhfuil athróg ann, cuireann an córas teimpléid luach rogha cumraíochta string_if_invalid an innill isteach, atá socraithe go ````(an teaghrán folamh) de réir réamhshocraithe.
Ní chuirfear scagairí a chuirtear i bhfeidhm ar athróg neamhbhailí ach amháin má shocraítear string_if_invalid go ``(an teaghrán folamh). Má tá ``string_if_invalid socraithe ar aon luach eile, déanfar neamhaird ar scagairí athraitheacha.
Tá an t-iompar seo beagán difriúil do na clibeanna teimpléad if ``, `for agus athghrúpa. Má chuirtear athróg neamhbhailí ar fáil do cheann de na clibeanna teimpléad seo, léirmhínítear an t-athróg mar None. Cuirtear scagairí i bhfeidhm i gcónaí ar athróga neamhbhailí laisti
Má tá string_if_invalid %s', cuirfear ainm an athróg neamhbhailí in ionad an marcóra formáide.
I ngach comhthéacs tá True, Fréag` agus None. Mar a bheadh ag súil leat, réitíonn na hathróga seo ar na rudaí comhfhreagracha Python
Níl aon bhealach ag teanga teimpléad Django éalú ó na carachtair a úsáidtear dá chomhréir féin. Mar shampla, teastaíonn an clibe:ttag: templatetag más gá duit seicheamh carachtair mar {% agus %} a aschur.
Tá saincheist den chineál céanna ann más mian leat na seicheamh seo a chur san áireamh i scagaire teimpléid nó i gclibeanna Mar shampla, agus clib bloc á pháirseáil, féachann parser teimpléad Django ar an gcéad tarlú de %} ``tar éis {%``. Cuireann sé seo cosc ar "%} "``a úsáid mar shreang litriúil. Mar shampla, ardófar ``TemplateSyntaxError do na nathanna seo a leanas:
{% include "template.html" tvar="Some string literal with %} in it." %}\n\n{% with tvar="Some string literal with %} in it." %}{% endwith %}\nIs féidir an tsaincheist chéanna a spreagadh trí sheicheamh áirithe a úsáid in argóintí scagaire:
\n{{ some.variable|default:"}}" }}\nMás gá duit teaghráin a úsáid leis na seicheamh seo, stóráil iad in athróga teimpléad nó bain úsáid as clib nó scagaire teimpléad saincheaptha chun an teorannú a réiteach.
\nContextLink to this heading#An chuid is mó den am, cuirfidh tú rudaí:class: Context trí fhoclóir lán-dhaonra a chur isteach chuig Context () ``. Ach is féidir leat míreanna a chur leis agus a scriosadh ó réad ``Context nuair a bheidh sé curtha isteach freisin, ag baint úsáide as comhréir caighdeánach foclóra:
>>> from django.template import Context\n>>> c = Context({"foo": "bar"})\n>>> c["foo"]\n'bar'\n>>> del c["foo"]\n>>> c["foo"]\nTraceback (most recent call last):\n...\nKeyError: 'foo'\n>>> c["newvariable"] = "hello"\n>>> c["newvariable"]\n'hello'\nTugann sé an luach le haghaidh eochair má tá eochair sa chomhthéacs, arís eile filleann ````eile ``.
Má tá eochair sa chomhthéacs, filleann sé a luach ar ais. Seachas sin cuireann sé isteach eochair le luach default agus tugann sé default ar ais.
Is cruach é réad Context. Is é sin, is féidir leat bhrú () ``agus ``pop () é. Má tá tú pop () ``an iomarca, ardóidh sé ``django.template.contextPopException:
>>> c = Context()\n>>> c["foo"] = "first level"\n>>> c.push()\n{}\n>>> c["foo"] = "second level"\n>>> c["foo"]\n'second level'\n>>> c.pop()\n{'foo': 'second level'}\n>>> c["foo"]\n'first level'\n>>> c["foo"] = "overwritten"\n>>> c["foo"]\n'overwritten'\n>>> c.pop()\nTraceback (most recent call last):\n...\nContextPopException\nIs féidir leat push () ``a úsáid freisin mar bhainisteoir comhthéacs chun a chinntiú go dtugtar meaitseáil ``pop ().
>>> c = Context()\n>>> c["foo"] = "first level"\n>>> with c.push():\n... c["foo"] = "second level"\n... c["foo"]\n...\n'second level'\n>>> c["foo"]\n'first level'\nCuirfear gach argóint a chuirtear chuig push () ``chuig an tógálaí ``dict` a úsáidtear chun an leibhéal comhthéacs nua a thógáil.
\n>>> c = Context()\n>>> c["foo"] = "first level"\n>>> with c.push(foo="second level"):\n... c["foo"]\n...\n'second level'\n>>> c["foo"]\n'first level'\nChomh maith le push () ``agus `pop (), sainmhíníonn an réad Context modh ``update () ``freisin. Oibríonn sé seo cosúil le ``push () ``ach glacann sé foclóir mar argóint agus brúíonn sé an foclóir sin ar an gcruach in ionad ceann folamh.
>>> c = Context()\n>>> c["foo"] = "first level"\n>>> c.update({"foo": "updated"})\n{'foo': 'updated'}\n>>> c["foo"]\n'updated'\n>>> c.pop()\n{'foo': 'updated'}\n>>> c["foo"]\n'first level'\nCosúil le push () ``, is féidir leat ``update () a úsáid mar bhainisteoir comhthéacs chun a chinntiú go dtugtar meaitseáil ``pop () ``.
>>> c = Context()\n>>> c["foo"] = "first level"\n>>> with c.update({"foo": "second level"}):\n... c["foo"]\n...\n'second level'\n>>> c["foo"]\n'first level'\n<howto-writing-custom-template-tags>Tagann Context a úsáid mar chruac úsáideach in:ref: roinnt clibeanna teimpléad saincheapaithe.
Ag baint úsáide as modh flatten () ``is féidir leat cruach ``Context iomlán a fháil mar fhoclóir amháin lena n-áirítear athróga tógála.
>>> c = Context()\n>>> c["foo"] = "first level"\n>>> c.update({"bar": "second level"})\n{'bar': 'second level'}\n>>> c.flatten()\n{'True': True, 'None': None, 'foo': 'first level', 'False': False, 'bar': 'second level'}\nÚsáidtear modh flatten () ``go hinmheánach freisin chun rudaí ``Context` a dhéanamh inchomparáide.
\n>>> c1 = Context()\n>>> c1["foo"] = "first level"\n>>> c1["bar"] = "second level"\n>>> c2 = Context()\n>>> c2.update({"bar": "second level", "foo": "first level"})\n{'foo': 'first level', 'bar': 'second level'}\n>>> c1 == c2\nTrue\nIs féidir leis an toradh ó flatten () ``a bheith úsáideach i dtástálacha aonaid chun comparáid a dhéanamh idir ``Context` i gcoinne dict:
class ContextTest(unittest.TestCase):\n def test_against_dictionary(self):\n c1 = Context()\n c1["update"] = "value"\n self.assertEqual(\n c1.flatten(),\n {\n "True": True,\n "None": None,\n "False": False,\n "update": "value",\n },\n )\nrequestContextLink to this heading#Tagann Django le rang speisialt:class: ~django.template.context, Django.Template.requestContext, a ghníomhaíonn beagán difriúil ón ngnáth`django.template.context``. Is é an chéad difríocht ná go dtógann sé an:class: ~django.http.httpRequest mar a chéad argóint. Mar shampla:
c = RequestContext(\n request,\n {\n "foo": "bar",\n },\n)\nIs é an dara difríocht ná go ndéanann sé an comhthéacs a líonadh go huathoibríoch le cúpla athróg, de réir rogha cumraíochta ``context_processors' an innill.
\nIs é an rogha context_processors` liosta de ghlaonna -- ar a dtugtar próiseálaithe comhthéacsa -- a ghlacann réad iarratais mar argóint agus a thugann foclóir míreanna atá le cumasc sa chomhthéacs. Sa chomhad socruithe réamhshocraithe a ghintear, tá na próiseálaithe comhthéacs seo a leanas san inneall teimpléid réamh
\n[\n "django.template.context_processors.request",\n "django.contrib.auth.context_processors.auth",\n "django.contrib.messages.context_processors.messages",\n]\nIn addition to these, RequestContext always enables\n'django.template.context_processors.csrf'. This is a security related\ncontext processor required by the admin and other contrib apps, and, in case\nof accidental misconfiguration, it is deliberately hardcoded in and cannot be\nturned off in the context_processors option.
Cuirtear gach próiseálaí i bhfeidhm in ord. Ciallaíonn sé sin, má chuireann próiseálaí amháin athróg leis an gcomhthéacs agus má chuireann an dara próiseálaí athróg leis an ainm céanna, cuirfidh an dara ceann ar an gcéad cheann. Mínítear na próiseálaithe réamhshocraithe thíos
\n\nChomh maith leis sin, is féidir leat liosta de phróiseálaithe breise a thabhar:class: RequestContext, ag baint úsáide as an tríú argóint roghnach suímh, ``próiseálaithe ``. Sa sampla seo, faigheann an sampla:class: requestContext athróg ``ip_address ``:
\nfrom django.http import HttpResponse\nfrom django.template import RequestContext, Template\n\n\ndef ip_address_processor(request):\n return {"ip_address": request.META["REMOTE_ADDR"]}\n\n\ndef client_ip_view(request):\n template = Template("{{ title }}: {{ ip_address }}")\n context = RequestContext(\n request,\n {\n "title": "Your IP Address",\n },\n [ip_address_processor],\n )\n return HttpResponse(template.render(context))\nSeo a dhéanann gach ceann de na próiseálaithe ionsuite:
\ndjango.contrib.auth.context_processors.authLink to this heading#Má tá an próiseálaí seo cumasaithe, beidh na hathróga seo i ngach RequestContext:
user -- Sampla Auth.user a léiríonn an t-úsáideoir atá logáilte isteach faoi láthair (nó sampla ``AnonymousUser`, mura bhfuil an cliant logáilte isteach).
perms -- Sampla de django.contrib.auth.context_processors.permWrapper`, a léiríonn na ceadanna atá ag an úsáideoir logáilte isteach faoi láthair.
django.template.context_processors.debugLink to this heading#Má tá an próiseálaí seo cumasaithe, beidh an dá athróg seo i ngach RequestContext - ach amháin má tá do shuíomh: DEBUG socraithe go True` agus seoladh IP an iarratais (``Request.meta ['REMOTE_ADDR'] ``) sa socrú: INTERNAL_IPS:
debug -- Fíor-. Is féidir leat é seo a úsáid i dteimpléid chun a thástáil an bhfuil tú i mód: socrú: DEBUG.
sql_queries -- Liosta de {'sql':..., 'time':...} foclóirí, a léiríonn gach ceist SQL a tharla go dtí seo le linn an iarratais agus cé chomh fada a thóg sé. Tá an liosta in ord de réir alias bunachar sonraí agus ansin trí cheist. Gintear sé go leisciúil ar rochtain.
django.template.context_processors.i18nLink to this heading#Má tá an próiseálaí seo cumasaithe, beidh na hathróga seo i ngach RequestContext:
LANGUAGES - Luach an shocraithe:setting: LANGUAGES.
LANGUAGE_BIDI - True má tá teanga reatha ina theanga ar dheis go clé, m.sh. an Eabhrais, Araibis. Fréag más teanga de chlé go deis í, m.sh. Béarla, Fraincis, Gearmáinis.
LANGUAGE_COD -- REQUEST.LANGUAGE_COD, má tá sé ann. Seachas sin, luach an socrú: setting: LANGUAGE_CODE.
Féach: ref: clibeanna teimpléad `i18n <i18n-template-tags>`le haghaidh clibeanna teimpléad a ghineann na luachanna céanna.
\nMá tá an próiseálaí seo cumasaithe, beidh athróg MEDIA_URL` i ngach ``RequestContext, ag soláthar luach an socruithe: MEDIA_URL.
django.template.context_processors.staticLink to this heading#Má tá an próiseálaí seo cumasaithe, beidh athróg STATIC_URL` i ngach ``RequestContext, ag soláthar luach an socruithe: STATIC_URL.
django.template.context_processors.csrfLink to this heading#Cuireann an próiseálaí seo comhartha a theastaíonn ó chlib teimpléad:ttag: csrf_token le haghaidh cosanta in aghaidh: doc: Cross Site Request Forgeries </ref/csrf>.
\nThis is always enabled by RequestContext and cannot\nbe disabled. You do not need to include it within context_processors.
django.template.context_processors.cspLink to this heading#If this processor is enabled, every RequestContext will contain a variable\ncsp_nonce, providing a securely generated, request-specific nonce suitable\nfor use under a Content Security Policy. See CSP nonce usage\nfor details.
django.template.context_processors.requestLink to this heading#Má tá an próiseálaí seo cumasaithe, beidh athróg request i ngach requestContext`, arb é sin an reatha:class: ~django.http.httpRequest.
django.template.context_processors.tzLink to this heading#Má tá an próiseálaí seo cumasaithe, beidh athróg TIME_ZONE i ngach RequestContext`, ag soláthar ainm an chrios ama atá gníomhach faoi láthair.
Má tá an próiseálaí seo cumasaithe, beidh an dá athróg seo i ngach RequestContext:
Tá comhéadan simplí ag próiseálaí comhthéacs: Is feidhm Python é a thógann argóint amháin, an:class: ~django.http.httpRequest réad, agus a thugann foclóir ar ais a chuirtear le comhthéacs an teimpléid.
\nMar shampla, chun an socrú:setting: DEFAULT_FROM_EMAIL a chur le gach comhthéacs:
\nfrom django.conf import settings\n\n\ndef from_email(request):\n return {\n "DEFAULT_FROM_EMAIL": settings.DEFAULT_FROM_EMAIL,\n }\nIs féidir le próiseálaithe comhthéacs saincheaptha maireachtáil áit ar bith i do Is é an cúram le Django ná go ndéanann an rogha context_processors'` i do shocrú: `TEMPLATES` - nó an argóint ``context_processors de:class: ~django.template.ENGINE má tá tú ag úsáid go díreach é.
Go ginearálta, stóráilfidh tú teimpléid i gcomhaid ar do chóras comhaid seachas an API ísealleibhéil: class: ~django.template.template a úsáid tú féin. Sábháil teimpléid in eolaire a shonraítear mar eolaire teimpléad**.
\n<TEMPLATES-DIRS>Déanann Django cuardach ar eolairí teimpléid i roinnt áiteanna, ag brath ar do shocruithe luchtaithe teimpléad (féach “Cineálacha lódóra” thíos), ach is é an bealach is bunúsaí chun eolairí teimpléad a shonrú ná an rogha: socrú: `DIRS `a úsáid.
\nInis do Django cad iad d'eolair <TEMPLATES-DIRS>í teimpléad tríd an rogha: setting: DIRS `a úsáid sa socrú: `TEMPLATES i do chomhad socruithe - nó an argóint dirs` de:class: ~DJANGO.TEMPLATE.ENGINE. Ba chóir é seo a shocrú ar liosta teaghráin ina bhfuil cosáin iomlána chuig d'eolairí teimpléid:
\nTEMPLATES = [\n {\n "BACKEND": "django.template.backends.django.DjangoTemplates",\n "DIRS": [\n "/home/html/templates/lawrence.com",\n "/home/html/templates/default",\n ],\n },\n]\nIs féidir le do theimpléid dul áit ar bith is mian leat, fad is atá na heolairí agus na teimpléid inléite ag an bhfreastalaí gréasáin. Is féidir leo aon síneadh a theastaíonn uait a bheith acu, mar shampla .html nó .txt, nó ní féidir leo aon síneadh a bheith acu ar chor ar bith.
Tabhair faoi deara gur chóir go n-úsáidfeadh na cosáin seo slashes ar aghaidh i stíl Unix, fiú ar Windows.
\nDe réir réamhshocraithe, úsáideann Django lódóir teimpléad bunaithe ar chóras comhaid, ach tagann Django le cúpla luchtaire teimpléad eile, a bhfuil a fhios acu conas teimpléid a luchtú ó fhoinsí eile.
\nTá cuid de na luchtóirí eile seo díchumasaithe de réir réamhshocraithe, ach is féidir leat iad a ghníomhachtú trí rogha 'loaders'` a chur le do chúlcheann ``DjangoTemplates sa socrú:setting: TEMPLATES nó argóint loaders a chur chuig:class: ~django.template.ENGINE. Ba chóir go mbeadh “loaders” ina liosta de shreangáin nó tupáil, áit a léiríonn gach ceann acu rang lódóra teimpléid. Seo iad na lódálaithe teimpléad a thagann le Django:
Django.Template.Loaders.Filesystem.Loader
<TEMPLATES-DIRS>Luchtaíonn teimpléid ón gcóras comhaid, de réir: socrú: `DIRS `.
\nTá an lódóir seo cumasaithe de réir réamhshocraithe. Mar sin féin ní gheobhaidh sé aon teimpléid go dtí go socraíonn tú: socrú: `DIRS <TEMPLATES-DIRS>`ar liosta neamh-folamh:
\nTEMPLATES = [\n {\n "BACKEND": "django.template.backends.django.DjangoTemplates",\n "DIRS": [BASE_DIR / "templates"],\n }\n]\nIs féidir leat DIRS' a shárú freisin agus eolairí ar leith a shonrú le haghaidh lódóir córas comhaid áirithe:
TEMPLATES = [\n {\n "BACKEND": "django.template.backends.django.DjangoTemplates",\n "OPTIONS": {\n "loaders": [\n (\n "django.template.loaders.filesystem.Loader",\n [BASE_DIR / "templates"],\n ),\n ],\n },\n }\n]\nDjango.Template.Loaders.App_Directories.Loader
Luchtaíonn teimpléid ó aipeanna Django ar an gcóras comhaid. I gcás gach aip in:setting: INSTALLED_APPS, féachann an lódóir fo-eolaire ``teimpléid ``. Má tá an eolaire ann, féachann Django teimpléid ann.
\nCiallaíonn sé seo gur féidir leat teimpléid a stóráil le d'aipeanna aonair. Cuidíonn sé seo freisin le apps Django a dháileadh le teimpléid réamhshocraithe.
\nMar shampla, don socrú seo:
\nINSTALLED_APPS = ["myproject.polls", "myproject.music"]\n... ansin cuardóidh get_template ('foo.html') ```foo.html sna heolairí seo, san ord seo:
/cosáin/to/mo thionscad/truailleach/teimpléidí/
/cosáin/to/mo thionscad/ceol/teimpléidí/
... agus úsáidfidh sé an ceann a aimsíonn sé ar dtús.
\nTá an t-ordú de:setting: INSTALLED_APPS suntasach! Mar shampla, más mian leat riarachán Django a shaincheapadh, b'fhéidir go roghnaíonn tú an teimpléad caighdeánach admin/base_site.html` a shárú, ó ``django.contrib.admin ``, le do `admin/base_site.html féin i myproject.polls. Ní mór duit a chinntiú ansin go dtagann do myproject.polls roim django.contrib.admin in:setting: INSTALLED_APPS, ar shlí eile luchtálfar django.contrib.admin ar dtús agus déanfar neamhaird ar do chuid féin.
Tabhair faoi deara go ndéanann an lódóir barrfheabhsú nuair a ritheann sé ar dtús: cuireann sé liosta díobh a bhfuil fo-eolaire ``teimpléid ``ag pacáistí: 'SETTING: INSTALLED_APPS.
\n<TEMPLATES-APP_DIRS>Is féidir leat an lódóir seo a chumasú trí shocrú: socrú: APP_DIRS `go ``True`:
\nTEMPLATES = [\n {\n "BACKEND": "django.template.backends.django.DjangoTemplates",\n "APP_DIRS": True,\n }\n]\nDjango.Template.Loaders.Cached.Loader
Cé go bhfuil córas teimpléid Django tapa go leor, más gá dó do theimpléid a léamh agus a thiomsú gach uair a dhéantar iad a léiriú, is féidir leis an lasbhreas as sin cur suas.
\nCumraíonn tú an lódóir teimpléad taisceáilte le liosta de luchtóirí eile ar chóir dó fillteadh. Úsáidtear na lódálaithe fillte chun teimpléid anaithnid a aimsiú nuair a bhíonn siad ar dtús. Ansin stóráilíonn an lódóir taisceáilte an ``Teimpléad` tiomsaithe i gcuimhne. Cuirtear an cás “Teimpléad” a chosc ar ais le haghaidh iarratais ina dhiaidh sin chun an teimpléad céanna a luchtú.
\nCumasaítear an lódóir seo go huathoibríoch mura ndéantar: socrú: `OPTIONS ['loader'] <TEMPLATES-OPTIONS>`a shonrú.
\nIs féidir leat taiscáil teimpléad a shonrú de láimh le roinnt lódóirí teimpléad saincheaptha ag baint úsáide as socruithe
\nTEMPLATES = [\n {\n "BACKEND": "django.template.backends.django.DjangoTemplates",\n "DIRS": [BASE_DIR / "templates"],\n "OPTIONS": {\n "loaders": [\n (\n "django.template.loaders.cached.Loader",\n [\n "django.template.loaders.filesystem.Loader",\n "django.template.loaders.app_directories.Loader",\n "path.to.custom.Loader",\n ],\n ),\n ],\n },\n }\n]\nDjango.Template.Loaders.Locmem.Loader
Luchtaíonn teimpléid ó fhoclóir Python. Tá sé seo úsáideach le haghaidh tástála.
\nGlacann an lódóir seo foclóir teimpléid mar an chéad argóint:
\nTEMPLATES = [\n {\n "BACKEND": "django.template.backends.django.DjangoTemplates",\n "OPTIONS": {\n "loaders": [\n (\n "django.template.loaders.locmem.Loader",\n {\n "index.html": "content here",\n },\n ),\n ],\n },\n }\n]\nTá an lódóir seo díchumasaithe de réir réamhshocraithe
\nÚsáideann Django na lódálaithe teimpléad in ord de réir an rogha ```loaders'. Úsáideann sé gach lódóir go dtí go bhfaigheann lódóir cluiche.
\nIs féidir teimpléid a luchtú ó fhoinsí breise ag baint úsáide as luchtóirí teimpléad sain Ba chóir go n-oidhreodh ranganna saincheaptha Loader ó django.template.loaders.base.loader` agus na modhanna get_contents () ``agus ``get_template_sources () a shainiú.
Luchtaíonn teimpléid ó fhoinse ar leith, mar shampla an córas comhaid nó bunachar sonraí.
\nModh a thógann template_name agus a thugann torthaige:class: ~django.template.base.origin cásanna do gach foinse féideartha.
For example, the filesystem loader may receive 'index.html' as a\ntemplate_name argument. This method would yield origins for the\nfull path of index.html as it appears in each template directory\nthe loader looks at.
Ní gá don modh a fhíorú go bhfuil an teimpléad ann ag cosán ar leith, ach ba cheart dó a chinntiú go bhfuil an cosán bailí. Mar shampla, cinntíonn lódóir an chórais chomhaid go bhfuil an cosán faoi eolaire teimpléad bailí.
\nTugann sé an t-ábhar do theimpléad a thugtar a: class: ~django.template.base.origin sampla.
\nSeo an áit a léifeadh lódóir córas comhaid ábhar ón gcóras comhaid, nó go léifeadh lódóir bunachar sonraí ón mbunachar sonraí. Mura bhfuil teimpléad meaitseála ann, ba chóir dó seo earráid a:exc: ~django.template.templateDoesNotExist a ardú.
\nTugann sé réad Template ar ais do template_name ar leith trí lupáil trí thorthaí ó:meth: get_template_sources agus glaoch: meth: get_contents. Filleann sé seo an chéad teimpléad meaitseála. Mura bhfaightear aon teimpléad, ardaítear :exc: ~django.template.templateDoesNotExist.
Is é an argóint roghnach `skip ``ná liosta de bhunús le neamhaird a dhéanamh agus teimpléid á leathnú. Ligeann sé seo teimpléid teimpléid eile den ainm céanna a leathnú. D'úsáid sé freisin chun earráidí athshlánaithe a sheachaint.
\nGo ginearálta, is leor sainmhíniú: meth: get_template_sources agus:meth: get_contents le haghaidh lódóirí teimpléad saincheaptha. De ghnáth ní gá `get_template () ``a shárú.
\nTá “bunús” ag teimpléid ina bhfuil tréithe ag brath ar an bhfoinse as a luchtaítear iad.
\nAn cosán chuig an teimpléad mar a chuir an lódóir teimpléid ar ais. Maidir le luchtóirí a léann ón gcóras comhaid, is é seo an cosán iomlán chuig an teimpléad.
\n<unknown_source>Má dhéantar an teimpléad a thionscnamh go díreach seachas trí lódóir teimpléid, is luach teaghrán é seo de ```.
\nAn cosán coibhneasta chuig an teimpléad mar a rith isteach sa lódóir teimpléad
\nMá dhéantar an teimpléad a thionscnamh go díreach seachas trí lódóir teimpléid, is é seo None.
An tsampla lódóir teimpléad a thóg an ``Bunaid' seo.
\nMá dhéantar an teimpléad a thionscnamh go díreach seachas trí lódóir teimpléid, is é seo None.
django.template.loaders.cached.Loader requires all of its\nwrapped loaders to set this attribute, typically by instantiating\nthe Origin with loader=self.