{"title":"Conas teimpléid a shárú","version":"6.0","locale":"ga","docname":"howto/overriding-templates","url":"/ga/6.0/howto/overriding-templates/","canonical":"https://djangodocs.dev/ga/6.0/howto/overriding-templates/","summary":"I do thionscadal, b'fhéidir gur mhaith leat teimpléad a shárú in iarratas Django eile, cibé acu is feidhmchlár tríú páirtí é nó feidhmchlár contrib mar ``…","html":"<h1>Conas teimpléid a shárú<a class=\"heading-anchor\" href=\"#how-to-override-templates\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>I do thionscadal, b'fhéidir gur mhaith leat teimpléad a shárú in iarratas Django eile, cibé acu is feidhmchlár tríú páirtí é nó feidhmchlár contrib mar <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>django.contrib.admin <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>. Is féidir leat athshlánú teimpléid a chur in eolaire teimpléid do thionscadail nó in eolaire teimpléid feidhmchláir.</p>\n<p>Má tá eolairí teimpléid aipeanna agus tionscadail agat ina bhfuil foriompaithe araon acu, déanfaidh an lódóir teimpléad réamhshocraithe Django iarracht an teimpléad a luchtú ón eolaire leibhéal tionscadail &lt;TEMPLATES-APP_DIRS&gt;Is é sin le rá, cuardaítear :setting: DIRS &lt;TEMPLATES-DIRS&gt;`roimhe sean:setting: `APP_DIRS.</p>\n<aside class=\"admonition admonition-seealso\">\n<p class=\"admonition-title\">See also</p>\n<p>Léitheo:ref: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>teimpléid overriding-built-in-giuirléid' má tá tú ag iarraidh é sin a dhéanamh.</p>\n</aside>\n<section id=\"overriding-from-the-project-s-templates-directory\">\n<h2>Sárú ó eolaire teimpléid an tionscadail<a class=\"heading-anchor\" href=\"#overriding-from-the-project-s-templates-directory\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Ar dtús, déanfaimid iniúchadh ar theimpléid sháraitheacha trí theimpléid athsholáthair a chruthú in eolaire teimpléad do thionscadail.</p>\n<p>Ligean le rá go bhfuil tú ag iarraidh na teimpléid d'fheidhmchlár tríú páirtí ar a dtugtar <code class=\"docutils literal notranslate\"><span class=\"pre\">blog</span> <span class=\"pre\">``a</span> <span class=\"pre\">sholáthraíonn</span> <span class=\"pre\">na</span> <span class=\"pre\">teimpléid</span> <span class=\"pre\">``blog/post.html</span></code> agus <code class=\"docutils literal notranslate\"><span class=\"pre\">blog/list.html</span></code>, a sholáthraíonn na teimpléid <code class=\"docutils literal notranslate\"><span class=\"pre\">blog/post.html</span></code>. Bheadh cuma na socruithe ábhartha do thionscadal seo a leanas:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">pathlib</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">Path</span>\n\n<span class=\"n\">BASE_DIR</span> <span class=\"o\">=</span> <span class=\"n\">Path</span><span class=\"p\">(</span><span class=\"vm\">__file__</span><span class=\"p\">)</span><span class=\"o\">.</span><span class=\"n\">resolve</span><span class=\"p\">()</span><span class=\"o\">.</span><span class=\"n\">parent</span><span class=\"o\">.</span><span class=\"n\">parent</span>\n\n<span class=\"n\">INSTALLED_APPS</span> <span class=\"o\">=</span> <span class=\"p\">[</span>\n    <span class=\"o\">...</span><span class=\"p\">,</span>\n    <span class=\"s2\">&quot;blog&quot;</span><span class=\"p\">,</span>\n    <span class=\"o\">...</span><span class=\"p\">,</span>\n<span class=\"p\">]</span>\n\n<span class=\"n\">TEMPLATES</span> <span class=\"o\">=</span> <span class=\"p\">[</span>\n    <span class=\"p\">{</span>\n        <span class=\"s2\">&quot;BACKEND&quot;</span><span class=\"p\">:</span> <span class=\"s2\">&quot;django.template.backends.django.DjangoTemplates&quot;</span><span class=\"p\">,</span>\n        <span class=\"s2\">&quot;DIRS&quot;</span><span class=\"p\">:</span> <span class=\"p\">[</span><span class=\"n\">BASE_DIR</span> <span class=\"o\">/</span> <span class=\"s2\">&quot;templates&quot;</span><span class=\"p\">],</span>\n        <span class=\"s2\">&quot;APP_DIRS&quot;</span><span class=\"p\">:</span> <span class=\"kc\">True</span><span class=\"p\">,</span>\n        <span class=\"c1\"># ...</span>\n    <span class=\"p\">},</span>\n<span class=\"p\">]</span>\n</code></pre></div>\n<p>Beidh an socrú: SETTING: TEMPLATES agus <code class=\"docutils literal notranslate\"><span class=\"pre\">BASE_DIR</span></code> ann cheana féin má chruthaigh tú do thionscadal ag baint úsáide as an teimpléad réamhshocraithe tionscadail. &lt;TEMPLATES-DIRS&gt;Is é an socrú is gá a mhodhnú ná: socrú: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>DIRS <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>.</p>\n<p>Glacann na socruithe seo leis go bhfuil eolaire <code class=\"docutils literal notranslate\"><span class=\"pre\">teimpléad</span></code> agat i bhfréamh do thionscadail. Chun na teimpléid don aip blog ``a shárú, cruthaigh fillteán san eolaire ``teimpléid`, agus cuir na comhaid teimpléad leis an bhfillteán sin:</p>\n<div class=\"code-block\" data-language=\"none\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">None</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"None code\"><code>templates/\n    blog/\n        list.html\n        post.html\n</code></pre></div>\n<p>Féachann an lódóir teimpléid ar dtús teimpléid san eolaire <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>DIRS`. Nuair a iarrann na tuairimí san aip blog ``na teimpléid `blog/post.html agus <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>blog/list.html`, cuirfidh an lódóir na comhaid a chruthaigh tú díreach ar ais.</p>\n</section>\n<section id=\"overriding-from-an-app-s-template-directory\">\n<h2>Sárú ó eolaire teimpléad aip<a class=\"heading-anchor\" href=\"#overriding-from-an-app-s-template-directory\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Ós rud é go bhfuil teimpléid thart agat atá suite taobh amuigh de cheann de na feidhmchláir do thionscadail, tá sé níos coitianta an chéad mhodh a úsáid agus forlíonta teimpléid a chur i bhfillteán teimpléid tionscadail. Más fearr leat, áfach, is féidir na foriomláin a chur in eolaire teimpléad aip freisin.</p>\n<p>Ar dtús, déan cinnte go bhfuil do shocruithe teimpléid á seiceáil taobh istigh de na heolairí aipeanna:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"n\">TEMPLATES</span> <span class=\"o\">=</span> <span class=\"p\">[</span>\n    <span class=\"p\">{</span>\n        <span class=\"c1\"># ...</span>\n        <span class=\"s2\">&quot;APP_DIRS&quot;</span><span class=\"p\">:</span> <span class=\"kc\">True</span><span class=\"p\">,</span>\n        <span class=\"c1\"># ...</span>\n    <span class=\"p\">},</span>\n<span class=\"p\">]</span>\n</code></pre></div>\n<p>Más mian leat na teimpléid a shárú in aip ar a dtugtar myapp` agus tugtar blog/list.html` agus <code class=\"docutils literal notranslate\"><span class=\"pre\">blog/post.html</span></code> ar na teimpléid atá le frithsheasmhú, ansin beidh cuma ar do struchtúr eolaire:</p>\n<div class=\"code-block\" data-language=\"none\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">None</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"None code\"><code>myapp/\n    templates/\n        blog/\n            list.html\n            post.html\n</code></pre></div>\n<p>Le: Socrú: APP_DIRS &lt;TEMPLATES-APP_DIRS&gt;`socraithe go ``True`, féachfaidh an lódóir teimpléid in eolaire teimpléid an aip agus gheobhaidh sé na teimpléid.</p>\n</section>\n<section id=\"extending-an-overridden-template\">\n<span id=\"id1\"></span><h2>Teimpléad athsháraithe a leathnú<a class=\"heading-anchor\" href=\"#extending-an-overridden-template\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Agus do luchtaitheoirí teimpléad cumraithe, is féidir leat teimpléad a leathnú ag baint úsáide as an gclib te &lt;extends&gt;impléad:ttag: {% extens%} agus é a shárú ag an am céanna. Féadann sé seo ligean duit saincheaptha beaga a dhéanamh gan gá duit an teimpléad iomlán a athchur i bhfeidhm.</p>\n<p>Mar shampla, is féidir leat an teicníc seo a úsáid chun lógó saincheaptha a chur leis an teimpléad <code class=\"docutils literal notranslate\"><span class=\"pre\">admin/base_site.html</span></code>:</p>\n<figure class=\"code-block code-block-captioned\" data-language=\"html+django\"><figcaption class=\"code-block-caption\"><code class=\"docutils literal notranslate\"><span class=\"pre\">teimpléid/admin/base_site.html</span></code></figcaption>\n<div class=\"code-block-toolbar\"><span class=\"code-block-language\">Django template</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Django template code\"><code> <span class=\"cp\">{%</span> <span class=\"k\">extends</span> <span class=\"s2\">&quot;admin/base_site.html&quot;</span> <span class=\"cp\">%}</span>\n\n <span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">branding</span> <span class=\"cp\">%}</span>\n   <span class=\"p\">&lt;</span><span class=\"nt\">img</span> <span class=\"na\">src</span><span class=\"o\">=</span><span class=\"s\">&quot;link/to/logo.png&quot;</span> <span class=\"na\">alt</span><span class=\"o\">=</span><span class=\"s\">&quot;logo&quot;</span><span class=\"p\">&gt;</span>\n   <span class=\"cp\">{{</span> <span class=\"nb\">block</span><span class=\"nv\">.super</span> <span class=\"cp\">}}</span>\n <span class=\"cp\">{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span>\n</code></pre></figure>\n<p>Príomhphointí le tabhairt faoi deara:</p>\n<ul class=\"simple\">\n<li><p>Cruthaíonn an sampla comhad ag <code class=\"docutils literal notranslate\"><span class=\"pre\">templates/admin/base_site.html</span></code> a úsáideann an eolaire <code class=\"docutils literal notranslate\"><span class=\"pre\">teimpléid</span> <span class=\"pre\">``leibhéal</span> <span class=\"pre\">tionscadail</span> <span class=\"pre\">cumraithe</span> <span class=\"pre\">chun</span> <span class=\"pre\">`admin/base_site.html</span></code> a shárú.</p></li>\n<li><p>Leathnaíonn an teimpléad nua <code class=\"docutils literal notranslate\"><span class=\"pre\">admin/base_site.html</span></code>, arb é an teimpléad céanna atá á athshealbhú.</p></li>\n<li><p>Cuireann an teimpléad in ionad an bhloc branding, ag cur lógó saincheaptha leis, agus block.super` á úsáid chun an t-ábhar roimhe seo a choinneáil.</p></li>\n<li><p>Tá an chuid eile den teimpléad gan athrú ó admin/base_site.html`.</p></li>\n</ul>\n<p>Oibríonn an teicníc seo toisc nach ndéanann an lódóir teimpléad a mheas ar an teimpléad athshlánaithe atá luchtaithe cheana féin (ag templates/admin/base_site.html`) agus an chlib <code class=\"docutils literal notranslate\"><span class=\"pre\">extenses</span> <span class=\"pre\">``á</span> <span class=\"pre\">réiteach.</span> <span class=\"pre\">In</span> <span class=\"pre\">éineacht</span> <span class=\"pre\">le</span> <span class=\"pre\">`block.super</span></code> is teicníc cumhachtach é chun saincheaptha beaga a dhéanamh.</p>\n</section>","rootId":"how-to-override-templates","toc":[{"title":"Sárú ó eolaire teimpléid an tionscadail","anchor":"overriding-from-the-project-s-templates-directory","children":[]},{"title":"Sárú ó eolaire teimpléad aip","anchor":"overriding-from-an-app-s-template-directory","children":[]},{"title":"Teimpléad athsháraithe a leathnú","anchor":"extending-an-overridden-template","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Treoracha conas","url":"/ga/6.0/howto/"}],"prev":{"docname":"howto/outputting-pdf","title":"Conas comhaid PDF a chruthú","url":"/ga/6.0/howto/outputting-pdf/"},"next":{"docname":"howto/custom-template-backend","title":"Conas cúltaca teimpléad saincheaptha a chur i bhfeidhm","url":"/ga/6.0/howto/custom-template-backend/"},"formats":{"html":"/ga/6.0/howto/overriding-templates/","markdown":"/ga/6.0/howto/overriding-templates.md","json":"/ga/6.0/howto/overriding-templates.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/howto/overriding-templates.txt","official":"https://docs.djangoproject.com/ga/6.0/howto/overriding-templates/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}