{"title":"Teanga teimpléad Django","version":"5.2","locale":"ga","docname":"ref/templates/language","url":"/ga/5.2/ref/templates/language/","canonical":"https://djangodocs.dev/ga/5.2/ref/templates/language/","summary":"Míníonn an doiciméad seo comhréir teanga an chórais teimpléid Django. Má tá tú ag lorg peirspictíochta níos teicniúla ar an gcaoi a n-oibríonn sé agus conas é a…","html":"<h1>Teanga teimpléad Django<a class=\"heading-anchor\" href=\"#the-django-template-language\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Míníonn an doiciméad seo comhréir teanga an chórais teimpléid Django. Má tá tú ag lorg peirspictíochta níos teicniúla ar an gcaoi a n-oibríonn sé agus conas é a leathnú, féach:doc: /ref/templates/api.</p>\n<p>Tá teanga teimpléad Django deartha chun cothromaíocht a bhaint amach idir cumhacht agus éascaíocht. Tá sé deartha chun mothú compordach dóibh siúd a úsáidtear ag obair le HTML. Má tá aon nochtadh agat do theangacha teimpléad téacs-bhunaithe eile, mar shampla <a class=\"reference external\" href=\"https://www.smarty.net/\">Smarty</a> nó <a class=\"reference external\" href=\"https://palletsprojects.com/p/jinja/\">Jinja2</a>, ba chóir go mbraitheann tú i gceart sa bhaile le teimpléid Django.</p>\n<aside class=\"admonition-philosophy admonition\">\n<p class=\"admonition-title\">Fealsúnacht</p>\n<p>Má tá cúlra agat sa chlárú, nó má tá tú cleachtaithe le teangacha a mheascann cód cláir go díreach i HTML, beidh tú ag iarraidh a chur i gcuimhne nach Python leabaithe i HTML amháin atá córas teimpléad Django. Tá sé seo de réir dearaidh: tá sé i gceist ag an gcóras teimpléid cur i láthair a chur in iúl, ní loighic</p>\n<p>Soláthraíonn córas teimpléad Django clibeanna a fheidhmíonn ar an gcosúil le roinnt tógáil cláraithe -- an:ttag: if `tag le haghaidh tástálacha boolean, a:ttag: `for tag le haghaidh lúpa, srl. - ach ní fhorghníomhtar iad seo go simplí mar an cód Python comhfhreagrach, agus ní fhorghníomhaíonn an córas teimpléid abairtí treallach Python. Ní thacaítear ach leis na clibeanna, na scagairí agus na comhréiteach atá liostaithe thíos de réir réamhshocraithe (cé gur féidir leat: doc: do chuid síntí féin a chur leis an teanga &lt;/howto/custom-template-tags&gt; teimpléid de réir mar is gá).</p>\n</aside>\n<section id=\"templates\">\n<h2>Teimpléid<a class=\"heading-anchor\" href=\"#templates\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Is comhad téacs é teimpléad. Féadann sé aon fhormáid téacs-bhunaithe a ghiniúint (HTML, XML, CSV, srl.).</p>\n<p>Tá <strong>athróga</strong> i dteimpléad, a gcuirtear luachanna in ionad nuair a dhéantar an teimpléad a mheas, agus <strong>clibe</strong>, a rialaíonn loighic an teimpléid.</p>\n<p>Seo thíos teimpléad íosta a léiríonn cúpla buneilimintí. Déanfar gach eilimint a mhíniú níos déanaí sa doiciméad seo.</p>\n<div class=\"code-block\" data-language=\"html+django\"><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;base_generic.html&quot;</span> <span class=\"cp\">%}</span>\n\n<span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">title</span> <span class=\"cp\">%}{{</span> <span class=\"nv\">section.title</span> <span class=\"cp\">}}{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span>\n\n<span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">content</span> <span class=\"cp\">%}</span>\n<span class=\"p\">&lt;</span><span class=\"nt\">h1</span><span class=\"p\">&gt;</span><span class=\"cp\">{{</span> <span class=\"nv\">section.title</span> <span class=\"cp\">}}</span><span class=\"p\">&lt;/</span><span class=\"nt\">h1</span><span class=\"p\">&gt;</span>\n\n<span class=\"cp\">{%</span> <span class=\"k\">for</span> <span class=\"nv\">story</span> <span class=\"k\">in</span> <span class=\"nv\">story_list</span> <span class=\"cp\">%}</span>\n<span class=\"p\">&lt;</span><span class=\"nt\">h2</span><span class=\"p\">&gt;</span>\n  <span class=\"p\">&lt;</span><span class=\"nt\">a</span> <span class=\"na\">href</span><span class=\"o\">=</span><span class=\"s\">&quot;</span><span class=\"cp\">{{</span> <span class=\"nv\">story.get_absolute_url</span> <span class=\"cp\">}}</span><span class=\"s\">&quot;</span><span class=\"p\">&gt;</span>\n    <span class=\"cp\">{{</span> <span class=\"nv\">story.headline</span><span class=\"o\">|</span><span class=\"nf\">upper</span> <span class=\"cp\">}}</span>\n  <span class=\"p\">&lt;/</span><span class=\"nt\">a</span><span class=\"p\">&gt;</span>\n<span class=\"p\">&lt;/</span><span class=\"nt\">h2</span><span class=\"p\">&gt;</span>\n<span class=\"p\">&lt;</span><span class=\"nt\">p</span><span class=\"p\">&gt;</span><span class=\"cp\">{{</span> <span class=\"nv\">story.tease</span><span class=\"o\">|</span><span class=\"nf\">truncatewords</span><span class=\"s2\">:&quot;100&quot;</span> <span class=\"cp\">}}</span><span class=\"p\">&lt;/</span><span class=\"nt\">p</span><span class=\"p\">&gt;</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endfor</span> <span class=\"cp\">%}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n<aside class=\"admonition-philosophy admonition\">\n<p class=\"admonition-title\">Fealsúnacht</p>\n<p>Cén fáth teimpléad téacs-bhunaithe a úsáid in ionad ceann XML bunaithe (cosúil le TAL Zope)? Theastaigh uainn go mbeadh teanga teimpléid Django inúsáidte le haghaidh níos mó ná teimpléid XML/HTML amháin. Is féidir leat teanga an teimpléid a úsáid le haghaidh aon fhormáid téacs-bhunaithe mar ríomhphoist, JavaScript agus CSV.</p>\n</aside>\n</section>\n<section id=\"variables\">\n<span id=\"template-variables\"></span><h2>Athróga<a class=\"heading-anchor\" href=\"#variables\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Breathnaíonn athróga mar seo: <code class=\"docutils literal notranslate\"><span class=\"pre\">{{athróg}}</span></code>. Nuair a thagann an t-inneall teimpléid le hathróg, déanann sé an t-athróg sin a mheas agus cuireann sé an toradh in ionad é Is éard atá i ainmneacha athraitheacha aon teaglaim de charachtair alfa-uimhriúla agus an béim (<code class=\"docutils literal notranslate\"><span class=\"pre\">&quot;_&quot;</span></code>) ach ní fhéadfaidh sé tosú le béim, agus b'fhéidir nach bhfuil sé ina uimhir. Tá an ponc (<code class=\"docutils literal notranslate\"><span class=\"pre\">”.</span> <span class=\"pre\">“</span></code>) le feiceáil freisin i rannáin athraitheacha, cé go bhfuil brí speisialta aige sin, mar a léirítear thíos. Tábhachtach, * ní féidir leat spásanna nó carachtair poncaíochta a bheith agat in ainmneacha athraitheacha. *</p>\n<p>Úsáid ponc (.`) chun rochtain a fháil ar thréithe athróg.</p>\n<aside class=\"admonition-behind-the-scenes admonition\">\n<p class=\"admonition-title\">Taobh thiar de na radhairc</p>\n<p>Go teicniúil, nuair a thagann an córas teimpléid le ponc, déanann sé iarracht na cuardaigh seo a leanas, san ord seo:</p>\n<ul class=\"simple\">\n<li><p>Cuardach foclóra</p></li>\n<li><p>Cuardach tréithe nó modh</p></li>\n<li><p>Cuardach innéacs uimhriúil</p></li>\n</ul>\n<p>Má tá an luach mar thoradh air inghlaoch, tugtar air gan aon argóintí. Is é toradh an ghlao an luach teimpléid.</p>\n<p>Is féidir leis an ordú cuardaigh seo a bheith ina chúis le roinnt iompar gan choinne le rudaí a sháraíonn cuardach foclóra Mar shampla, smaoinigh ar an snippet cód seo a leanas a dhéanann iarracht lúbadh thar collections.defaultdict`:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">for</span> <span class=\"nv\">k</span><span class=\"o\">,</span> <span class=\"nv\">v</span> <span class=\"k\">in</span> <span class=\"nv\">defaultdict.items</span> <span class=\"cp\">%}</span>\n    Do something with k and v here...\n<span class=\"cp\">{%</span> <span class=\"k\">endfor</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n<p>Toisc go dtarlaíonn cuardach foclóra ar dtús, cuireann an t-iompar sin isteach agus soláthraíonn sé luach réamhshocraithe in ionad an modh beartaithe <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>.items () <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>a úsáid. Sa chás seo, smaoinigh ar thiontú go foclóir ar dtús.</p>\n</aside>\n<p>Sa sampla thuas, cuirfear an tréith <code class=\"docutils literal notranslate\"><span class=\"pre\">title</span></code> den réad <code class=\"docutils literal notranslate\"><span class=\"pre\">roinn</span> <span class=\"pre\">``in</span> <span class=\"pre\">ionad</span></code> {{section.title}} <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>.</p>\n<p>Má úsáideann tú athróg nach bhfuil ann, cuirfidh an córas teimpléid luach an rogha <code class=\"docutils literal notranslate\"><span class=\"pre\">string_if_invalid</span></code> isteach, atá socraithe go <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>&quot;<a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>(an teaghrán folamh) de réir réamhshocraithe.</p>\n<p>Tabhair faoi deara go léirmhínítear “barra” i abairt teimpléid cosúil le <code class=\"docutils literal notranslate\"><span class=\"pre\">{{foo.bar}}</span></code> mar shreang litriúil agus gan úsáid luach an athróg “barra”, má tá ceann ann i gcomhthéacs an teimpléid.</p>\n<p>Ní fhéadfar rochtain a fháil ar thréithe athraitheacha a thosaíonn le béim toisc go meastar go príobháideach iad de ghnáth.</p>\n</section>\n<section id=\"filters\">\n<h2>Scagairí<a class=\"heading-anchor\" href=\"#filters\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Is féidir leat athróga a mhodhnú le taispeáint trí**scagairí** a úsáid.</p>\n<p>Breathnaíonn scagairí mar seo: <code class=\"docutils literal notranslate\"><span class=\"pre\">{{ainm|níos</span> <span class=\"pre\">ísle}}</span></code>. Taispeánann sé seo luach an athróg <code class=\"docutils literal notranslate\"><span class=\"pre\">{{name}}</span></code> tar éis é a scagadh tríd an scagair:tfilter: lower, a athraíonn téacs go litreacha beaga. Úsáid píopa (| `) chun scagaire a chur i bhfeidhm.</p>\n<p>Is féidir scagairí a “slabhraithe.” &lt;p&gt;Cuirtear aschur scagaire amháin i bhfeidhm ar an gcéad cheann eile. <code class=\"docutils literal notranslate\"><span class=\"pre\">{{text|escape|linebreaks}}</span> <span class=\"pre\">`is</span> <span class=\"pre\">idiom</span> <span class=\"pre\">coitianta</span> <span class=\"pre\">é</span> <span class=\"pre\">chun</span> <span class=\"pre\">ábhar</span> <span class=\"pre\">téacs</span> <span class=\"pre\">a</span> <span class=\"pre\">éalú,</span> <span class=\"pre\">ansin</span> <span class=\"pre\">sosanna</span> <span class=\"pre\">líne</span> <span class=\"pre\">a</span> <span class=\"pre\">thiontú</span> <span class=\"pre\">go</span> <span class=\"pre\">clibeanna`</span></code>.</p>\n<p>Tugann roinnt scagairí argóintí. Breathnaíonn argóint scagaire mar seo: <code class=\"docutils literal notranslate\"><span class=\"pre\">{{bio|truncatewords:30}}</span></code>. Taispeánfaidh sé seo an chéad 30 focal den athróg <code class=\"docutils literal notranslate\"><span class=\"pre\">bio</span></code>.</p>\n<p>Ní mór argóintí scagaire ina bhfuil spásanna a lua; mar shampla, chun liosta le camóga agus spásanna a bheith agat le <code class=\"docutils literal notranslate\"><span class=\"pre\">{{list|join:”,</span> <span class=\"pre\">&quot;}}</span></code>.</p>\n<p>Soláthraíonn Django thart ar seasca scagaire teimpléad ionsuite &lt;ref-templates-builtins-filters&gt;Is féidir leat gach rud fúthu a léamh in:ref: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>tagairt scagaire ionsuite <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>. Chun blas a thabhairt duit ar na rudaí atá ar fáil, seo cuid de na scagairí teimpléid is coitianta a úsáidtear:</p>\n<dl>\n<dt><a class=\"reference internal\" href=\"/ga/5.2/ref/templates/builtins/#std-templatefilter-default\"><code class=\"xref std std-tfilter docutils literal notranslate\"><span class=\"pre\">default</span></code></a></dt><dd><p>Má tá athróg bréagach nó folamh, bain úsáid as réamhshocrú tugtha. Seachas sin, bain úsáid as luach an athróg. Mar shampla:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"nv\">value</span><span class=\"o\">|</span><span class=\"nf\">default</span><span class=\"s2\">:&quot;nothing&quot;</span> <span class=\"cp\">}}</span>\n</code></pre></div>\n<p>Mura gcuirtear <code class=\"docutils literal notranslate\"><span class=\"pre\">luach</span></code> ar fáil nó mura bhfuil sé folamh, taispeánfaidh an méid thuas “<a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>aon rud <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>”.</p>\n</dd>\n<dt><a class=\"reference internal\" href=\"/ga/5.2/ref/templates/builtins/#std-templatefilter-length\"><code class=\"xref std std-tfilter docutils literal notranslate\"><span class=\"pre\">length</span></code></a></dt><dd><p>Tugann sé ar ais fad an luacha. Oibríonn sé seo le haghaidh teaghráin agus liostaí araon. Mar shampla:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"nv\">value</span><span class=\"o\">|</span><span class=\"nf\">length</span> <span class=\"cp\">}}</span>\n</code></pre></div>\n<p>Más é <code class=\"docutils literal notranslate\"><span class=\"pre\">luach</span></code> <code class=\"docutils literal notranslate\"><span class=\"pre\">['a',</span> <span class=\"pre\">'b',</span> <span class=\"pre\">'c',</span> <span class=\"pre\">'d']</span></code>, is é <code class=\"docutils literal notranslate\"><span class=\"pre\">4</span></code> an t-aschur.</p>\n</dd>\n<dt><a class=\"reference internal\" href=\"/ga/5.2/ref/templates/builtins/#std-templatefilter-filesizeformat\"><code class=\"xref std std-tfilter docutils literal notranslate\"><span class=\"pre\">filesizeformat</span></code></a></dt><dd><p>Formáidigh an luach cosúil le méid comhaid “inléite don duine” (ie <code class=\"docutils literal notranslate\"><span class=\"pre\">'13</span> <span class=\"pre\">KB'</span></code>, <code class=\"docutils literal notranslate\"><span class=\"pre\">4.1</span> <span class=\"pre\">MB'</span></code>, <code class=\"docutils literal notranslate\"><span class=\"pre\">`102</span> <span class=\"pre\">bytes'</span></code>, srl.). Mar shampla:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"nv\">value</span><span class=\"o\">|</span><span class=\"nf\">filesizeformat</span> <span class=\"cp\">}}</span>\n</code></pre></div>\n<p>Más é “luach” 123456789, is é <code class=\"docutils literal notranslate\"><span class=\"pre\">117.7</span> <span class=\"pre\">MB</span></code> an t-aschur.</p>\n</dd>\n</dl>\n<p>Arís, níl ach cúpla sampla seo; féach an:ref: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>tagairt scagaire ionsuite &lt;ref-templates-builtins-filters&gt;`don liosta iomlán.</p>\n<p>Is féidir leat do scagairí teimpléad saincheaptha féin a chruthú freisin; féach: doc: /howto/custom-template-tags.</p>\n<aside class=\"admonition admonition-seealso\">\n<p class=\"admonition-title\">See also</p>\n<p>Is féidir le comhéadan riaracháin Django tagairt iomlán a áireamh de gach clib teimpléad agus scagairí atá ar fáil do shuíomh ar leith. Féach: doc: /ref/contrib/admin/admindocs.</p>\n</aside>\n</section>\n<section id=\"tags\">\n<h2>Clibeanna<a class=\"heading-anchor\" href=\"#tags\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Breathnaíonn clibeanna mar seo: <code class=\"docutils literal notranslate\"><span class=\"pre\">{%</span> <span class=\"pre\">tag%}</span></code>. Tá clibeanna níos casta ná athróga: Cruthaíonn cuid acu téacs san aschur, sreabhadh rialaithe roinnt trí lúb nó loighic a dhéanamh, agus luchtaíonn cuid acu faisnéis sheachtrach isteach sa teimpléad le húsáid ag athróga níos déanaí.</p>\n<p>Teastaíonn clibeanna tosaigh agus deireadh ó roinnt clibeanna (ie <code class=\"docutils literal notranslate\"><span class=\"pre\">{%</span> <span class=\"pre\">tag%}...</span> <span class=\"pre\">tag</span> <span class=\"pre\">content...</span> <span class=\"pre\">{%</span> <span class=\"pre\">endtag%}</span></code>).</p>\n<p>Loingíonn Django le thart ar dhá dhosaen clibeanna teimpléad ionsuite. &lt;ref-templates-builtins-tags&gt;Is féidir leat gach rud fúthu a léamh in:ref: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>tagairt clibeanna ionsuite <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>. Chun blas a thabhairt duit ar na rudaí atá ar fáil, seo cuid de na clibeanna is coitianta a úsáidtear:</p>\n<dl>\n<dt><a class=\"reference internal\" href=\"/ga/5.2/ref/templates/builtins/#std-templatetag-for\"><code class=\"xref std std-ttag docutils literal notranslate\"><span class=\"pre\">for</span></code></a></dt><dd><p>Lúb thar gach mír i sraith. Mar shampla, chun liosta lúthchleasaithe a chuirtear ar fáil in athlete_list` a thaispeáint:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"p\">&lt;</span><span class=\"nt\">ul</span><span class=\"p\">&gt;</span>\n<span class=\"cp\">{%</span> <span class=\"k\">for</span> <span class=\"nv\">athlete</span> <span class=\"k\">in</span> <span class=\"nv\">athlete_list</span> <span class=\"cp\">%}</span>\n    <span class=\"p\">&lt;</span><span class=\"nt\">li</span><span class=\"p\">&gt;</span><span class=\"cp\">{{</span> <span class=\"nv\">athlete.name</span> <span class=\"cp\">}}</span><span class=\"p\">&lt;/</span><span class=\"nt\">li</span><span class=\"p\">&gt;</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endfor</span> <span class=\"cp\">%}</span>\n<span class=\"p\">&lt;/</span><span class=\"nt\">ul</span><span class=\"p\">&gt;</span>\n</code></pre></div>\n</dd>\n<dt><a class=\"reference internal\" href=\"/ga/5.2/ref/templates/builtins/#std-templatetag-if\"><code class=\"xref std std-ttag docutils literal notranslate\"><span class=\"pre\">if</span></code></a>, <code class=\"docutils literal notranslate\"><span class=\"pre\">elif</span></code>, and <code class=\"docutils literal notranslate\"><span class=\"pre\">else</span></code></dt><dd><p>Déanann sé athróg a mheas, agus má tá an athróg sin “fíor” taispeántar ábhar an bhloc:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">if</span> <span class=\"nv\">athlete_list</span> <span class=\"cp\">%}</span>\n    Number of athletes: <span class=\"cp\">{{</span> <span class=\"nv\">athlete_list</span><span class=\"o\">|</span><span class=\"nf\">length</span> <span class=\"cp\">}}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">elif</span> <span class=\"nv\">athlete_in_locker_room_list</span> <span class=\"cp\">%}</span>\n    Athletes should be out of the locker room soon!\n<span class=\"cp\">{%</span> <span class=\"k\">else</span> <span class=\"cp\">%}</span>\n    No athletes.\n<span class=\"cp\">{%</span> <span class=\"k\">endif</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n<p>Sa mhéid thuas, mura bhfuil <code class=\"docutils literal notranslate\"><span class=\"pre\">athlete_list</span></code> folamh, taispeánfar líon na lúthchleasaithe ag an athróg <code class=\"docutils literal notranslate\"><span class=\"pre\">{{athlete_list|length}}</span></code>. Seachas sin, mura bhfuil athlete_in_locker_room_list` folamh, taispeánfar an teachtaireacht “Ba chóir go mbeadh lúthchleasaithe amach...”. Má tá an dá liosta folamh, taispeánfar “Gan lúthchleasaithe.”</p>\n<p>Is féidir leat scagairí agus oibreoirí éagsúla a úsáid freisin sa chlib: ttag: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>if:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">if</span> <span class=\"nv\">athlete_list</span><span class=\"o\">|</span><span class=\"nf\">length</span> <span class=\"o\">&gt;</span> <span class=\"m\">1</span> <span class=\"cp\">%}</span>\n   Team: <span class=\"cp\">{%</span> <span class=\"k\">for</span> <span class=\"nv\">athlete</span> <span class=\"k\">in</span> <span class=\"nv\">athlete_list</span> <span class=\"cp\">%}</span> ... <span class=\"cp\">{%</span> <span class=\"k\">endfor</span> <span class=\"cp\">%}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">else</span> <span class=\"cp\">%}</span>\n   Athlete: <span class=\"cp\">{{</span> <span class=\"nv\">athlete_list.0.name</span> <span class=\"cp\">}}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endif</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n<p>Cé go n-oibríonn an sampla thuas, bí ar an eolas go bhfilleann an chuid is mó de na scagairí teimpléid teaghráin, mar sin de ghnáth ní oibreoidh comparáidí matamaitice :tfilter: Is eisceacht é fad.</p>\n</dd>\n<dt><a class=\"reference internal\" href=\"/ga/5.2/ref/templates/builtins/#std-templatetag-block\"><code class=\"xref std std-ttag docutils literal notranslate\"><span class=\"pre\">block</span></code></a> and <a class=\"reference internal\" href=\"/ga/5.2/ref/templates/builtins/#std-templatetag-extends\"><code class=\"xref std std-ttag docutils literal notranslate\"><span class=\"pre\">extends</span></code></a></dt><dd><p>Socraigh <a class=\"reference internal\" href=\"#id1\">oidhreacht teimpléad</a> (féach thíos), bealach cumhachtach chun “boilerplate” a ghearradh síos i dteimpléid.</p>\n</dd>\n</dl>\n<p>Arís, níl an méid thuas ach rogha den liosta iomlán; féach an:ref: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>tagairt clibeanna ionsuite &lt;ref-templates-builtins-tags&gt;`don liosta iomlán.</p>\n<p>Is féidir leat do chlibeanna teimpléad saincheaptha féin a chruthú freisin; féach: doc: /howto/custom-template-tags.</p>\n<aside class=\"admonition admonition-seealso\">\n<p class=\"admonition-title\">See also</p>\n<p>Is féidir le comhéadan riaracháin Django tagairt iomlán a áireamh de gach clib teimpléad agus scagairí atá ar fáil do shuíomh ar leith. Féach: doc: /ref/contrib/admin/admindocs.</p>\n</aside>\n</section>\n<section id=\"comments\">\n<span id=\"template-comments\"></span><h2>Tuairimí<a class=\"heading-anchor\" href=\"#comments\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Chun trácht a dhéanamh amach cuid de líne i dteimpléad, bain úsáid as an gcomhréir tráchtaireachta: <code class=\"docutils literal notranslate\"><span class=\"pre\">{#</span> <span class=\"pre\">#}</span></code>.</p>\n<p>Mar shampla, rinneadh an teimpléad seo mar <code class=\"docutils literal notranslate\"><span class=\"pre\">'hello'</span></code>:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"c\">{# greeting #}</span>hello\n</code></pre></div>\n<p>Is féidir aon chód teimpléid a bheith i dtrácht, neamhbhailí nó nach bhfuil. Mar shampla:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"c\">{# {% if foo %}bar{% else %} #}</span>\n</code></pre></div>\n<p>Ní féidir an comhréir seo a úsáid ach le haghaidh tuairimí aonlíne (ní cheadaítear aon línte nua idir na teorainneacha <code class=\"docutils literal notranslate\"><span class=\"pre\">{#</span></code> agus #}`). Más gá duit trácht a dhéanamh ar chuid illíne den teimpléad, féach an clibe:ttag: comment.</p>\n</section>\n<section id=\"template-inheritance\">\n<span id=\"id1\"></span><h2>Teimpléad oidhreacht<a class=\"heading-anchor\" href=\"#template-inheritance\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Is é an chuid is cumhachtaí - agus dá bhrí sin an chuid is casta - d'inneall teimpléad Django ná oidhreacht teimpléad. Ligeann oidhreacht teimpléad duit teimpléad “cnámharlaigh” bonn a thógáil ina bhfuil na heilimintí coitianta go léir de do shuíomh agus a shainmhíníonn t**bloic** ar féidir le teimpléid leanaí a ath</p>\n<p>Breathnaímid ar oidhreacht teimpléid trí thosú le sampla:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">&lt;!DOCTYPE html&gt;</span>\n<span class=\"p\">&lt;</span><span class=\"nt\">html</span> <span class=\"na\">lang</span><span class=\"o\">=</span><span class=\"s\">&quot;en&quot;</span><span class=\"p\">&gt;</span>\n<span class=\"p\">&lt;</span><span class=\"nt\">head</span><span class=\"p\">&gt;</span>\n    <span class=\"p\">&lt;</span><span class=\"nt\">link</span> <span class=\"na\">rel</span><span class=\"o\">=</span><span class=\"s\">&quot;stylesheet&quot;</span> <span class=\"na\">href</span><span class=\"o\">=</span><span class=\"s\">&quot;style.css&quot;</span><span class=\"p\">&gt;</span>\n    <span class=\"p\">&lt;</span><span class=\"nt\">title</span><span class=\"p\">&gt;</span><span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">title</span> <span class=\"cp\">%}</span>My amazing site<span class=\"cp\">{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span><span class=\"p\">&lt;/</span><span class=\"nt\">title</span><span class=\"p\">&gt;</span>\n<span class=\"p\">&lt;/</span><span class=\"nt\">head</span><span class=\"p\">&gt;</span>\n\n<span class=\"p\">&lt;</span><span class=\"nt\">body</span><span class=\"p\">&gt;</span>\n    <span class=\"p\">&lt;</span><span class=\"nt\">div</span> <span class=\"na\">id</span><span class=\"o\">=</span><span class=\"s\">&quot;sidebar&quot;</span><span class=\"p\">&gt;</span>\n        <span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">sidebar</span> <span class=\"cp\">%}</span>\n        <span class=\"p\">&lt;</span><span class=\"nt\">ul</span><span class=\"p\">&gt;</span>\n            <span class=\"p\">&lt;</span><span class=\"nt\">li</span><span class=\"p\">&gt;&lt;</span><span class=\"nt\">a</span> <span class=\"na\">href</span><span class=\"o\">=</span><span class=\"s\">&quot;/&quot;</span><span class=\"p\">&gt;</span>Home<span class=\"p\">&lt;/</span><span class=\"nt\">a</span><span class=\"p\">&gt;&lt;/</span><span class=\"nt\">li</span><span class=\"p\">&gt;</span>\n            <span class=\"p\">&lt;</span><span class=\"nt\">li</span><span class=\"p\">&gt;&lt;</span><span class=\"nt\">a</span> <span class=\"na\">href</span><span class=\"o\">=</span><span class=\"s\">&quot;/blog/&quot;</span><span class=\"p\">&gt;</span>Blog<span class=\"p\">&lt;/</span><span class=\"nt\">a</span><span class=\"p\">&gt;&lt;/</span><span class=\"nt\">li</span><span class=\"p\">&gt;</span>\n        <span class=\"p\">&lt;/</span><span class=\"nt\">ul</span><span class=\"p\">&gt;</span>\n        <span class=\"cp\">{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span>\n    <span class=\"p\">&lt;/</span><span class=\"nt\">div</span><span class=\"p\">&gt;</span>\n\n    <span class=\"p\">&lt;</span><span class=\"nt\">div</span> <span class=\"na\">id</span><span class=\"o\">=</span><span class=\"s\">&quot;content&quot;</span><span class=\"p\">&gt;</span>\n        <span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">content</span> <span class=\"cp\">%}{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span>\n    <span class=\"p\">&lt;/</span><span class=\"nt\">div</span><span class=\"p\">&gt;</span>\n<span class=\"p\">&lt;/</span><span class=\"nt\">body</span><span class=\"p\">&gt;</span>\n<span class=\"p\">&lt;/</span><span class=\"nt\">html</span><span class=\"p\">&gt;</span>\n</code></pre></div>\n<p>Sainmhíníonn an teimpléad seo, a thabharfaimid <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>base.html`, doiciméad cnámharlaigh HTML a d'fhéadfá a úsáid le haghaidh leathanach dhá cholún. Is obair teimpléid “leanbh” é na bloic folmha a líonadh le hábhar.</p>\n<p>Sa sampla seo, sainmhíníonn an clibe:ttag: bloc trí bhloc ar féidir le teimpléid leanaí a líonadh isteach. Is é an clibe:ttag: bloc go léir ná insint don inneall teimpléid go bhféadfadh teimpléad leanbh na codanna sin den teimpléad a shárú.</p>\n<p>D'fhéadfadh cuma seo a bheith ar theimpléad linbh:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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;base.html&quot;</span> <span class=\"cp\">%}</span>\n\n<span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">title</span> <span class=\"cp\">%}</span>My amazing blog<span class=\"cp\">{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span>\n\n<span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">content</span> <span class=\"cp\">%}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">for</span> <span class=\"nv\">entry</span> <span class=\"k\">in</span> <span class=\"nv\">blog_entries</span> <span class=\"cp\">%}</span>\n    <span class=\"p\">&lt;</span><span class=\"nt\">h2</span><span class=\"p\">&gt;</span><span class=\"cp\">{{</span> <span class=\"nv\">entry.title</span> <span class=\"cp\">}}</span><span class=\"p\">&lt;/</span><span class=\"nt\">h2</span><span class=\"p\">&gt;</span>\n    <span class=\"p\">&lt;</span><span class=\"nt\">p</span><span class=\"p\">&gt;</span><span class=\"cp\">{{</span> <span class=\"nv\">entry.body</span> <span class=\"cp\">}}</span><span class=\"p\">&lt;/</span><span class=\"nt\">p</span><span class=\"p\">&gt;</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endfor</span> <span class=\"cp\">%}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n<p>Is é an clib: ttag: extens an eochair anseo. Insíonn sé don inneall teimpléid go leathnaíonn an teimpléad seo teimpléad eile. Nuair a dhéanann an córas teimpléid measúnú ar an teimpléad seo, aimsíonn sé an tuismitheoir ar dtús - sa chás seo, &quot;base.html”.</p>\n<p>Ag an bpointe sin, tabharfaidh inneall an teimpléid faoi deara na trí chlib: ttag: bloc i base.html` agus cuirfidh ábhar an teimpléid linbh in ionad na bloic sin. Ag brath ar luach <code class=\"docutils literal notranslate\"><span class=\"pre\">blog_entries</span></code>, d'fhéadfadh cuma ar an aschur:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">&lt;!DOCTYPE html&gt;</span>\n<span class=\"p\">&lt;</span><span class=\"nt\">html</span> <span class=\"na\">lang</span><span class=\"o\">=</span><span class=\"s\">&quot;en&quot;</span><span class=\"p\">&gt;</span>\n<span class=\"p\">&lt;</span><span class=\"nt\">head</span><span class=\"p\">&gt;</span>\n    <span class=\"p\">&lt;</span><span class=\"nt\">link</span> <span class=\"na\">rel</span><span class=\"o\">=</span><span class=\"s\">&quot;stylesheet&quot;</span> <span class=\"na\">href</span><span class=\"o\">=</span><span class=\"s\">&quot;style.css&quot;</span><span class=\"p\">&gt;</span>\n    <span class=\"p\">&lt;</span><span class=\"nt\">title</span><span class=\"p\">&gt;</span>My amazing blog<span class=\"p\">&lt;/</span><span class=\"nt\">title</span><span class=\"p\">&gt;</span>\n<span class=\"p\">&lt;/</span><span class=\"nt\">head</span><span class=\"p\">&gt;</span>\n\n<span class=\"p\">&lt;</span><span class=\"nt\">body</span><span class=\"p\">&gt;</span>\n    <span class=\"p\">&lt;</span><span class=\"nt\">div</span> <span class=\"na\">id</span><span class=\"o\">=</span><span class=\"s\">&quot;sidebar&quot;</span><span class=\"p\">&gt;</span>\n        <span class=\"p\">&lt;</span><span class=\"nt\">ul</span><span class=\"p\">&gt;</span>\n            <span class=\"p\">&lt;</span><span class=\"nt\">li</span><span class=\"p\">&gt;&lt;</span><span class=\"nt\">a</span> <span class=\"na\">href</span><span class=\"o\">=</span><span class=\"s\">&quot;/&quot;</span><span class=\"p\">&gt;</span>Home<span class=\"p\">&lt;/</span><span class=\"nt\">a</span><span class=\"p\">&gt;&lt;/</span><span class=\"nt\">li</span><span class=\"p\">&gt;</span>\n            <span class=\"p\">&lt;</span><span class=\"nt\">li</span><span class=\"p\">&gt;&lt;</span><span class=\"nt\">a</span> <span class=\"na\">href</span><span class=\"o\">=</span><span class=\"s\">&quot;/blog/&quot;</span><span class=\"p\">&gt;</span>Blog<span class=\"p\">&lt;/</span><span class=\"nt\">a</span><span class=\"p\">&gt;&lt;/</span><span class=\"nt\">li</span><span class=\"p\">&gt;</span>\n        <span class=\"p\">&lt;/</span><span class=\"nt\">ul</span><span class=\"p\">&gt;</span>\n    <span class=\"p\">&lt;/</span><span class=\"nt\">div</span><span class=\"p\">&gt;</span>\n\n    <span class=\"p\">&lt;</span><span class=\"nt\">div</span> <span class=\"na\">id</span><span class=\"o\">=</span><span class=\"s\">&quot;content&quot;</span><span class=\"p\">&gt;</span>\n        <span class=\"p\">&lt;</span><span class=\"nt\">h2</span><span class=\"p\">&gt;</span>Entry one<span class=\"p\">&lt;/</span><span class=\"nt\">h2</span><span class=\"p\">&gt;</span>\n        <span class=\"p\">&lt;</span><span class=\"nt\">p</span><span class=\"p\">&gt;</span>This is my first entry.<span class=\"p\">&lt;/</span><span class=\"nt\">p</span><span class=\"p\">&gt;</span>\n\n        <span class=\"p\">&lt;</span><span class=\"nt\">h2</span><span class=\"p\">&gt;</span>Entry two<span class=\"p\">&lt;/</span><span class=\"nt\">h2</span><span class=\"p\">&gt;</span>\n        <span class=\"p\">&lt;</span><span class=\"nt\">p</span><span class=\"p\">&gt;</span>This is my second entry.<span class=\"p\">&lt;/</span><span class=\"nt\">p</span><span class=\"p\">&gt;</span>\n    <span class=\"p\">&lt;/</span><span class=\"nt\">div</span><span class=\"p\">&gt;</span>\n<span class=\"p\">&lt;/</span><span class=\"nt\">body</span><span class=\"p\">&gt;</span>\n<span class=\"p\">&lt;/</span><span class=\"nt\">html</span><span class=\"p\">&gt;</span>\n</code></pre></div>\n<p>Tabhair faoi deara ós rud é nár sainmhínigh an teimpléad linbh an bloc <code class=\"docutils literal notranslate\"><span class=\"pre\">taobharra`,</span> <span class=\"pre\">go</span> <span class=\"pre\">n-úsáidtear</span> <span class=\"pre\">an</span> <span class=\"pre\">luach</span> <span class=\"pre\">ón</span> <span class=\"pre\">teimpléad</span> <span class=\"pre\">tuismitheora</span> <span class=\"pre\">ina</span> <span class=\"pre\">ionad.</span> <span class=\"pre\">Úsáidtear</span> <span class=\"pre\">ábhar</span> <span class=\"pre\">laistigh</span> <span class=\"pre\">de</span> <span class=\"pre\">chlib</span> <span class=\"pre\">``{%</span> <span class=\"pre\">block%}</span></code> i dteimpléad tuismitheora mar fhriotán i gcónaí.</p>\n<p>Is féidir leat an oiread leibhéil oidhreachta a úsáid agus is gá. Bealach coitianta amháin chun oidhreacht a úsáid ná an cur chuige trí leibhéal seo a leanas:</p>\n<ul class=\"simple\">\n<li><p>Cruthaigh teimpléad <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>base.html` a choinníonn príomh-chuma agus mothú do shuíomh.</p></li>\n<li><p>Cruthaigh teimpléad <code class=\"docutils literal notranslate\"><span class=\"pre\">Base_SectionName.html</span> <span class=\"pre\">``do</span> <span class=\"pre\">gach</span> <span class=\"pre\">“rannóg”</span> <span class=\"pre\">de</span> <span class=\"pre\">do</span> <span class=\"pre\">shuíomh.</span> <span class=\"pre\">Mar</span> <span class=\"pre\">shampla,</span> <span class=\"pre\">``base_news.html</span></code>, <code class=\"docutils literal notranslate\"><span class=\"pre\">base_sports.html</span></code>. Leathnaíonn na teimpléid seo go léir <code class=\"docutils literal notranslate\"><span class=\"pre\">base.html</span></code> agus folaíonn stílea/dearadh roinn-shonrach.</p></li>\n<li><p>Cruthaigh teimpléid aonair do gach cineál leathanaigh, mar shampla alt nuachta nó iontráil blag. Leathnaíonn na teimpléid seo an teimpléad roinn cuí</p></li>\n</ul>\n<p>Uasmhéadaíonn an cur chuige seo athúsáid cód agus cuidíonn sé le míreanna a chur le réimsí ábhar roinnte, mar shampla nascleanúint ar fud an ranná</p>\n<p>Seo roinnt leideanna chun oibriú le oidhreacht:</p>\n<ul>\n<li><p>Má úsáideann tú: ttag: {% leathnaíonn%}&lt;extends&gt; i dteimpléad, ní mór gurb é an chéad chlib teimpléad sa teimpléad sin. Ní oibreoidh oidhreacht teimpléid, ar shlí eile.</p></li>\n<li><p>Tuilleadh: TTag: Tá clibeanna {% block%}&lt;block&gt; i do theimpléid bonn níos fearr. Cuimhnigh, ní gá le teimpléid leanaí gach bloc tuismitheora a shainiú, ionas gur féidir leat réamhshocruithe réasúnta a líonadh isteach i roinnt bloic, ansin na cinn a theastaíonn uait a shainiú níos déanaí. Is fearr níos mó crúcaí a bheith agat ná níos lú crúcaí.</p></li>\n<li><p>Má aimsíonn tú féin ag dúbailt ábhar i roinnt teimpléid, is dócha go gciallaíonn sé gur chóir duit an t-ábhar sin a bhogadh go <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>{% block%} <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>i dteimpléad tuismitheoirí.</p></li>\n<li><p>Más gá duit ábhar an bhloc a fháil ón teimpléad tuismitheora, déanfaidh an athróg <code class=\"docutils literal notranslate\"><span class=\"pre\">{{block.super}}</span></code> an cleas. Tá sé seo úsáideach más mian leat cur le hábhar tuismitheoirí bloc in ionad é a shárú go hiomlán. Ní éalófar sonraí a cuireadh isteach ag baint úsáide as <code class=\"docutils literal notranslate\"><span class=\"pre\">{{block.super}}</span></code> go huathoibríoch (féach an <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>chéad roinn eile <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>_), ós rud é go raibh sé éalaithe cheana féin, más gá, sa teimpléad tuismitheora.</p></li>\n<li><p>Trí úsáid a bhaint as an ainm teimpléid céanna a bhfuil tú ag oidhreacht uaidh, is &lt;extends&gt;féidir: ttag: {%%} a úsáid chun teimpléad a oidhreacht ag an am céanna agus é a shárú. In éineacht le <code class=\"docutils literal notranslate\"><span class=\"pre\">{{block.super}}</span></code>, is féidir leis seo a bheith ina bhealach cumhachtach chun saincheaptha beaga a dhéanamh. Féach:ref: extending_an_overridden_template sna teimpléid <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">*</span></a>Overriding * Conas le haghaidh sampla iomlán.</p></li>\n<li><p>Ní féidir athróga a cruthaíodh lasmuigh de a:ttag: {% block%}&lt;block&gt; ag baint úsáide as an gclib teimpléad <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>as <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>comhréiteach taobh istigh den bhloc. Mar shampla, ní dhéanann an teimpléad seo aon rud:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">translate</span> <span class=\"s2\">&quot;Title&quot;</span> <span class=\"k\">as</span> <span class=\"nv\">title</span> <span class=\"cp\">%}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">content</span> <span class=\"cp\">%}{{</span> <span class=\"nv\">title</span> <span class=\"cp\">}}{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n</li>\n<li><p>Le haghaidh léiteachta breise, is féidir leat <em>ainm</em> a thabhairt go roghnach do chlib <code class=\"docutils literal notranslate\"><span class=\"pre\">{%</span> <span class=\"pre\">endblock%}</span></code>. Mar shampla:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">block</span> <span class=\"nv\">content</span> <span class=\"cp\">%}</span>\n...\n<span class=\"cp\">{%</span> <span class=\"k\">endblock</span> <span class=\"nv\">content</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n<p>I dteimpléid níos mó, cabhraíonn an teicníc seo leat a fheiceáil cé na clibeanna <code class=\"docutils literal notranslate\"><span class=\"pre\">{%</span> <span class=\"pre\">block%}</span></code> atá á dhúnadh.</p>\n</li>\n<li><p><a class=\"reference internal\" href=\"/ga/5.2/ref/templates/builtins/#std-templatetag-block\"><code class=\"xref std std-ttag docutils literal notranslate\"><span class=\"pre\">{%</span> <span class=\"pre\">block</span> <span class=\"pre\">%}</span></code></a> tags are evaluated first. That's why the content\nof a block is always overridden, regardless of the truthiness of surrounding\ntags. For example, this template will <em>always</em> override the content of the\n<code class=\"docutils literal notranslate\"><span class=\"pre\">title</span></code> block:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">if</span> <span class=\"nv\">change_title</span> <span class=\"cp\">%}</span>\n    <span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">title</span> <span class=\"cp\">%}</span>Hello!<span class=\"cp\">{%</span> <span class=\"k\">endblock</span> <span class=\"nv\">title</span> <span class=\"cp\">%}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endif</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n</li>\n</ul>\n<p>Mar fhocal scoir, tabhair faoi deara nach féidir leat clibeanna iolracha: ttag: bloc a shainiú leis an ainm céanna sa teimpléad céanna. Tá an teorannú seo ann toisc go n-oibríonn bloc clib sa “dá threo”. Is é sin, ní sholáthraíonn bloc clib ach poll le líonadh - sainmhíníonn sé freisin an t-ábhar a líonann an poll san <em>tuismitheoir</em>. Dá mbeadh dhá chlib den chineál céanna: ttag: bloc i dteimpléad, ní bheadh a fhios ag tuismitheoir an teimpléid sin cén ceann de ábhar na mbloic le húsáid.</p>\n</section>\n<section id=\"automatic-html-escaping\">\n<span id=\"id2\"></span><h2>Éalú uathoibríoch HTML<a class=\"heading-anchor\" href=\"#automatic-html-escaping\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Agus HTML á ghiniúint agat ó theimpléid, tá baol ann i gcónaí go mbeidh carachtair san athróg a théann i bhfeidhm ar an HTML mar thoradh air Mar shampla, smaoinigh ar an mblúirt teimpléid seo</p>\n<div class=\"code-block\" data-language=\"html+django\"><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>Hello, <span class=\"cp\">{{</span> <span class=\"nv\">name</span> <span class=\"cp\">}}</span>\n</code></pre></div>\n<p>Ar dtús, is cosúil gur bealach neamhdhíobhálach é seo chun ainm úsáideora a thaispeáint, ach smaoinigh ar cad a tharlódh dá gcuirfeadh an t-úsáideoir a ainm isteach mar seo:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"p\">&lt;</span><span class=\"nt\">script</span><span class=\"p\">&gt;</span><span class=\"nx\">alert</span><span class=\"p\">(</span><span class=\"s1\">&#39;hello&#39;</span><span class=\"p\">)&lt;/</span><span class=\"nt\">script</span><span class=\"p\">&gt;</span>\n</code></pre></div>\n<p>Leis an luach ainm seo, déanfaí an teimpléad a léiriú mar:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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>Hello, <span class=\"p\">&lt;</span><span class=\"nt\">script</span><span class=\"p\">&gt;</span><span class=\"nx\">alert</span><span class=\"p\">(</span><span class=\"s1\">&#39;hello&#39;</span><span class=\"p\">)&lt;/</span><span class=\"nt\">script</span><span class=\"p\">&gt;</span>\n</code></pre></div>\n<p>... rud a chiallaíonn go gcuirfeadh an brabhsálaí bosca foláirimh JavaScript!</p>\n<p>Ar an gcaoi chéanna, cad a tharlaíonn má bhí siombail <code class=\"docutils literal notranslate\"><span class=\"pre\">'&lt;'</span></code> san ainm, mar seo?</p>\n<div class=\"code-block\" data-language=\"html\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Html</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=\"Html code\"><code><span class=\"p\">&lt;</span><span class=\"nt\">b</span><span class=\"p\">&gt;</span>username\n</code></pre></div>\n<p>Bheadh teimpléad rindreáilte mar seo mar thoradh air sin:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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>Hello, <span class=\"p\">&lt;</span><span class=\"nt\">b</span><span class=\"p\">&gt;</span>username\n</code></pre></div>\n<p>... rud a d'fhágfadh, ina dhiaidh sin, go mbeadh an chuid eile den leathanach gréasáin i dtrom!</p>\n<p>Is léir, níor cheart muinín a bheith ag sonraí a chuirtear isteach ag úsáideoirí go dall agus a chur isteach go díreach i do leathanaigh ghréasáin, toisc go bhféadfadh úsáideoir mailíseach poll den chineál seo a úsáid chun rudaí a d'fhéad Tugtar ionsaí <a class=\"reference external\" href=\"https://en.wikipedia.org/wiki/Cross-site_scripting\">Cross Site Scripting</a> (XSS) ar an gcineál seo saothrú slándála.</p>\n<p>Chun an fhadhb seo a sheachaint, tá dhá rogha agat:</p>\n<ul class=\"simple\">\n<li><p>Ceann amháin, is féidir leat a chinntiú go rith gach athróg neamhiontaofa tríd an scagair:tfilter: escape (doiciméadaithe thíos), a athraíonn carachtair HTML a d'fhéadfadh a bheith díobhálach go cinn neamhdhíobhálacha. Ba é seo an réiteach réamhshocraithe i Django dá chéad chúpla bliain, ach is í an fhadhb ná go gcuireann sé an t-ualach ar* uis*, an forbróir/údar teimpléid, chun a chinntiú go bhfuil tú ag éalú ó gach rud. Tá sé éasca dearmad a dhéanamh ar shonraí a éalú.</p></li>\n<li><p>Dá cheann, is féidir leat leas a bhaint as éalú uathoibríoch HTML Django. Déanann an chuid eile den chuid seo cur síos ar an gcaoi a n-oibríonn éalú uath</p></li>\n</ul>\n<p>De réir réamhshocraithe i Django, éalaíonn gach teimpléad aschur gach clib athraitheach go huathoibríoch. Go sonrach, éalaítear na cúig charachtar seo:</p>\n<ul class=\"simple\">\n<li><p>Déantar <code class=\"docutils literal notranslate\"><span class=\"pre\">&lt;</span></code> a thiontú go <code class=\"docutils literal notranslate\"><span class=\"pre\">&lt;</span></code></p></li>\n<li><p>Tiontaítear &gt;` go &gt;`</p></li>\n<li><p>Tiontaítear <code class=\"docutils literal notranslate\"><span class=\"pre\">````(luachan</span> <span class=\"pre\">aonair)</span> <span class=\"pre\">go</span> <span class=\"pre\">```</span></code></p></li>\n<li><p>Déantar <code class=\"docutils literal notranslate\"><span class=\"pre\">&quot;``(luachan</span> <span class=\"pre\">dúbailte)</span> <span class=\"pre\">a</span> <span class=\"pre\">thiontú</span> <span class=\"pre\">go</span></code>&quot;``</p></li>\n<li><p>Tiontaítear &amp; ``go `&amp;`</p></li>\n</ul>\n<p>Arís, cuirimid béim go bhfuil an t-iompar seo ar siúl de réir réamhshocraithe. Má tá córas teimpléad Django á úsáid agat, tá tú cosanta.</p>\n<section id=\"how-to-turn-it-off\">\n<h3>Conas é a mhúchadh<a class=\"heading-anchor\" href=\"#how-to-turn-it-off\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Mura dteastaíonn uait go n-éalfaí sonraí go huathoibríoch, ar leibhéal in aghaidh an láithreáin, in aghaidh an teimpléid nó in aghaidh an leibhéal athraithe, is féidir leat iad a mhúchadh ar bheal</p>\n<p>Cén fáth ar mhaith leat é a mhúchadh? Mar gheall ar uaireanta, tá sonraí i n-athróga teimpléid a thugtar agat* a léiriú mar HTML amh, agus sa chás sin níl tú ag iarraidh go n-éalfaí a n-ábhar. Mar shampla, d'fhéadfá blob HTML a stóráil i do bhunachar sonraí agus gur mhaith leat é sin a leabú go díreach i do theimpléad. Nó, b'fhéidir go bhfuil tú ag úsáid córas teimpléad Django chun téacs ar* ní* HTML a tháirgeadh - cosúil le teachtaireacht ríomhphoist, mar shampla.</p>\n<section id=\"for-individual-variables\">\n<h4>Maidir le hathróga aonair<a class=\"heading-anchor\" href=\"#for-individual-variables\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h4>\n<p>Chun éalú uathoibríoch a dhíchumasú le haghaidh athróg aonair, bain úsáid as an scagair:tfilter: safe:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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>This will be escaped: <span class=\"cp\">{{</span> <span class=\"nv\">data</span> <span class=\"cp\">}}</span>\nThis will not be escaped: <span class=\"cp\">{{</span> <span class=\"nv\">data</span><span class=\"o\">|</span><span class=\"nf\">safe</span> <span class=\"cp\">}}</span>\n</code></pre></div>\n<p>Smaoinigh ar <em>sábháilte</em> mar ghearrthóg d'<em>sábháilte ó éalú tuilleadh</em> nó <em>is féidir é a léirmhíniú go sábháilte mar HTML</em>. &lt;b&gt;Sa sampla seo, má tá <code class=\"docutils literal notranslate\"><span class=\"pre\">`sonraí</span> <span class=\"pre\">``</span></code> <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>, is é an t-aschur:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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>This will be escaped: <span class=\"ni\">&amp;lt;</span>b<span class=\"ni\">&amp;gt;</span>\nThis will not be escaped: <span class=\"p\">&lt;</span><span class=\"nt\">b</span><span class=\"p\">&gt;</span>\n</code></pre></div>\n</section>\n<section id=\"for-template-blocks\">\n<h4>Le haghaidh bloic teimpléad<a class=\"heading-anchor\" href=\"#for-template-blocks\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h4>\n<p>Chun éalú uathoibríoch le haghaidh teimpléad a rialú, fillte an teimpléad (nó cuid áirithe den teimpléad) sa chlibe:ttag: autoescape, mar shampla:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">autoescape</span> <span class=\"nv\">off</span> <span class=\"cp\">%}</span>\n    Hello <span class=\"cp\">{{</span> <span class=\"nv\">name</span> <span class=\"cp\">}}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endautoescape</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n<p>Glacann an clibe:ttag: autoescape <code class=\"docutils literal notranslate\"><span class=\"pre\">on</span></code> nó <code class=\"docutils literal notranslate\"><span class=\"pre\">off</span></code> mar argóint. Uaireanta, b'fhéidir gur mhaith leat éalú uathoibríoch a chur i bhfeidhm nuair a bheadh sé faoi mhíchumas Seo teimpléad sampla:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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>Auto-escaping is on by default. Hello <span class=\"cp\">{{</span> <span class=\"nv\">name</span> <span class=\"cp\">}}</span>\n\n<span class=\"cp\">{%</span> <span class=\"k\">autoescape</span> <span class=\"nv\">off</span> <span class=\"cp\">%}</span>\n    This will not be auto-escaped: <span class=\"cp\">{{</span> <span class=\"nv\">data</span> <span class=\"cp\">}}</span>.\n\n    Nor this: <span class=\"cp\">{{</span> <span class=\"nv\">other_data</span> <span class=\"cp\">}}</span>\n    <span class=\"cp\">{%</span> <span class=\"k\">autoescape</span> <span class=\"nv\">on</span> <span class=\"cp\">%}</span>\n        Auto-escaping applies again: <span class=\"cp\">{{</span> <span class=\"nv\">name</span> <span class=\"cp\">}}</span>\n    <span class=\"cp\">{%</span> <span class=\"k\">endautoescape</span> <span class=\"cp\">%}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endautoescape</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n<p>Cuireann an chlib éalaithe uathoibríoch a éifeacht ar theimpléid a leathnaíonn an ceann reatha chomh maith le teimpléid atá san áireamh tríd an gclibe:ttag: include, díreach cosúil le gach bloc chlib. Mar shampla:</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\">Base.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\">autoescape</span> <span class=\"nv\">off</span> <span class=\"cp\">%}</span>\n<span class=\"p\">&lt;</span><span class=\"nt\">h1</span><span class=\"p\">&gt;</span><span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">title</span> <span class=\"cp\">%}{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span><span class=\"p\">&lt;/</span><span class=\"nt\">h1</span><span class=\"p\">&gt;</span>\n<span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">content</span> <span class=\"cp\">%}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endautoescape</span> <span class=\"cp\">%}</span>\n</code></pre></figure>\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\">Child.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;base.html&quot;</span> <span class=\"cp\">%}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">title</span> <span class=\"cp\">%}</span>This <span class=\"ni\">&amp;amp;</span> that<span class=\"cp\">{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">block</span> <span class=\"nv\">content</span> <span class=\"cp\">%}{{</span> <span class=\"nv\">greeting</span> <span class=\"cp\">}}{%</span> <span class=\"k\">endblock</span> <span class=\"cp\">%}</span>\n</code></pre></figure>\n<p>&lt;b&gt;Toisc go bhfuil éalú uathoibríoch a mhúchadh sa bhonn teimpléad, múchfar é freisin sa teimpléad linbh, agus mar thoradh air sin beidh an HTML rindreáilte seo a leanas nuair a bhíonn an teaghrán <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>Dia duit!&lt;/b&gt; <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"p\">&lt;</span><span class=\"nt\">h1</span><span class=\"p\">&gt;</span>This <span class=\"ni\">&amp;amp;</span> that<span class=\"p\">&lt;/</span><span class=\"nt\">h1</span><span class=\"p\">&gt;</span>\n<span class=\"p\">&lt;</span><span class=\"nt\">b</span><span class=\"p\">&gt;</span>Hello!<span class=\"p\">&lt;/</span><span class=\"nt\">b</span><span class=\"p\">&gt;</span>\n</code></pre></div>\n</section>\n</section>\n<section id=\"notes\">\n<h3>Nótaí<a class=\"heading-anchor\" href=\"#notes\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Go ginearálta, ní gá d'údair teimpléid a bheith buartha faoi éalú go huathoibríoch go mór. Caithfidh forbróirí ar thaobh Python (daoine a scríobhann tuairimí agus scagairí saincheaptha) smaoineamh ar na cásanna nár chóir sonraí a éalú, agus sonraí a mharcáil go cuí, mar sin rudaí Just Work sa teimpléad.</p>\n<p>Má tá teimpléad á chruthú agat a d'fhéadfaí a úsáid i gcásanna nach bhfuil tú cinnte an bhfuil éalú uathoibríoch cumasaithe, ansin cuir scagair:tfilter: escape le haon athróg a chaithfidh éalú. Nuair a bhíonn éalú uathoibríoch ar siúl, níl aon chontúirt ann go ndéanfaidh an scagair:tfilter: éalú `sonraí *éalú dúbailte* - ní dhéanann an scagair:tfilter: `éalú difear do athróga uathoibríoch éalaithe.</p>\n</section>\n<section id=\"string-literals-and-automatic-escaping\">\n<span id=\"id3\"></span><h3>Litríochtaí teaghráin agus éalú uathoibríoch<a class=\"heading-anchor\" href=\"#string-literals-and-automatic-escaping\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Mar a luaigh muid níos luaithe, is féidir argóintí scagaire a bheith ina teaghráin:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"nv\">data</span><span class=\"o\">|</span><span class=\"nf\">default</span><span class=\"s2\">:&quot;This is a string literal.&quot;</span> <span class=\"cp\">}}</span>\n</code></pre></div>\n<p>Cuirtear gach litríl teaghrán isteach ** gan aon éalú uathoibríoch isteach sa teimpléad - gníomhaíonn siad amhail is dá gcuirfí iad uile tríd an scagaire: tfilter: safe. Is é an réasúnaíocht atá taobh thiar de seo ná go bhfuil an t-údar teimpléid i smacht ar an méid a théann isteach sa sreang liteartha, ionas gur féidir leo a chinntiú go bhfuil an téacs éalaithe i gceart nuair a scríobhtar</p>\n<p>Ciallaíonn sé seo go scríobhfá:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"nv\">data</span><span class=\"o\">|</span><span class=\"nf\">default</span><span class=\"s2\">:&quot;3 &amp;lt; 2&quot;</span> <span class=\"cp\">}}</span>\n</code></pre></div>\n<p>... seachas:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"nv\">data</span><span class=\"o\">|</span><span class=\"nf\">default</span><span class=\"s2\">:&quot;3 &lt; 2&quot;</span> <span class=\"cp\">}}</span>  <span class=\"c\">{# Bad! Don&#39;t do this. #}</span>\n</code></pre></div>\n<p>Ní dhéanann sé seo difear don rud a tharlaíonn do shonraí a thagann ón athróg féin. Éalaítear ábhar an athróg go huathoibríoch fós, más gá, toisc go bhfuil siad lasmuigh de smacht údar an teimpléid.</p>\n</section>\n</section>\n<section id=\"accessing-method-calls\">\n<span id=\"template-accessing-methods\"></span><h2>Glaonna modh a rochtain<a class=\"heading-anchor\" href=\"#accessing-method-calls\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Tá an chuid is mó de na glaonna modh atá ceangailte le rudaí ar fáil ó theimpléid laisti Ciallaíonn sé seo go bhfuil rochtain ag teimpléid ar i bhfad níos mó ná tréithe ranga amháin (cosúil le hainmneacha réimse) agus athróga a rith isteach ó thuairimí Mar shampla, soláthraíonn an ORM Django comhréire:ref: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>&quot;entry_set” &lt;topics-db-queries-related&gt;`chun bailiúchán rudaí a bhaineann le heochair eachtrach a aimsiú. Dá bhrí sin, i bhfianaise samhail ar a dtugtar “trácht” le príomhchaidreamh eachtrach le samhail ar a dtugtar “tasc” is féidir leat lúb trí gach trácht atá ceangailte le tasc ar leith mar seo:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">for</span> <span class=\"nv\">comment</span> <span class=\"k\">in</span> <span class=\"nv\">task.comment_set.all</span> <span class=\"cp\">%}</span>\n    <span class=\"cp\">{{</span> <span class=\"nv\">comment</span> <span class=\"cp\">}}</span>\n<span class=\"cp\">{%</span> <span class=\"k\">endfor</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n<p>Ar an gcaoi chéanna, soláthraíonn :doc: QuerySets modh&lt;/ref/models/querysets&gt; <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>count () <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>chun líon na rudaí atá iontu a chomhaireamh. Dá bhrí sin, is féidir leat comhaireamh de na tuairimí go léir a bhaineann leis an tasc reatha a fháil le:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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=\"nv\">task.comment_set.all.count</span> <span class=\"cp\">}}</span>\n</code></pre></div>\n<p>Is féidir leat rochtain a fháil ar mhodhanna atá sainmhínithe agat go sainráite ar do chuid samhlacha féin:</p>\n<figure class=\"code-block code-block-captioned\" data-language=\"python\"><figcaption class=\"code-block-caption\"><code class=\"docutils literal notranslate\"><span class=\"pre\">models.py</span></code></figcaption>\n<div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python</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=\"Python code\"><code><span class=\"k\">class</span><span class=\"w\"> </span><span class=\"nc\">Task</span><span class=\"p\">(</span><span class=\"n\">models</span><span class=\"o\">.</span><span class=\"n\">Model</span><span class=\"p\">):</span>\n    <span class=\"k\">def</span><span class=\"w\"> </span><span class=\"nf\">foo</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">):</span>\n        <span class=\"k\">return</span> <span class=\"s2\">&quot;bar&quot;</span>\n</code></pre></figure>\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éad.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=\"nv\">task.foo</span> <span class=\"cp\">}}</span>\n</code></pre></figure>\n<p>Toisc go gcuireann Django teorainn d'aon ghnó ar an méid próiseála loighic atá ar fáil i dteanga na teimpléid, ní féidir argóintí a chur ar aghaidh chuig glaonna modh a rochtaítear orthu ó laistigh Ba chóir sonraí a ríomh i radhairc, ansin a chur chuig teimpléid le taispeáint.</p>\n</section>\n<section id=\"custom-tag-and-filter-libraries\">\n<span id=\"loading-custom-template-libraries\"></span><h2>Clib saincheaptha agus leabharlanna scagaire<a class=\"heading-anchor\" href=\"#custom-tag-and-filter-libraries\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Soláthraíonn feidhmchláir áirithe leabharlanna clibeanna saincheaptha Chun rochtain a fháil orthu i dteimpléad, cinntigh go bhfuil an feidhmchlár in:setting: INSTALLED_APPS (chuirfimid <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>django.contrib.humanize' leis an sampla seo), agus ansin úsáid an clibe:ttag: `load i dteimpléad:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">load</span> <span class=\"nv\">humanize</span> <span class=\"cp\">%}</span>\n\n<span class=\"cp\">{{</span> <span class=\"m\">45000</span><span class=\"o\">|</span><span class=\"nf\">intcomma</span> <span class=\"cp\">}}</span>\n</code></pre></div>\n<p>Sa mhéid thuas, luchtaíonn an clibe:ttag: load leabharlann clibeanna <code class=\"docutils literal notranslate\"><span class=\"pre\">humanize</span></code>, rud a fhágann go bhfuil an scagaire <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">``</span></a>intcomma` ar fáil le húsáid ansin. Má tá: mod: django.contrib.admindocs cumasaithe agat, is féidir leat dul i gcomhairle leis an réimse doiciméadaithe i do riarachán chun liosta na leabharlanna saincheaptha i do shuiteáil a fháil.</p>\n<p>Is féidir leis an gclibe:ttag: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>load <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>ilainmneacha leabharlainne a thógáil, scartha le spásanna. Sampla:</p>\n<div class=\"code-block\" data-language=\"html+django\"><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\">load</span> <span class=\"nv\">humanize</span> <span class=\"nv\">i18n</span> <span class=\"cp\">%}</span>\n</code></pre></div>\n<p>Féach: doc: /howto/custom-template-tags le haghaidh faisnéise maidir le do leabharlanna teimpléad saincheaptha féin a scríobh.</p>\n<section id=\"custom-libraries-and-template-inheritance\">\n<h3>Leabharlanna saincheaptha agus oidhreacht te<a class=\"heading-anchor\" href=\"#custom-libraries-and-template-inheritance\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Nuair a luchtaíonn tú leabharlann clibeanna saincheaptha nó scagaire, ní chuirtear na clibeanna/scagairí ar fáil ach don teimpléad reatha - ní aon teimpléid tuismitheora nó leanbh ar feadh an chonair oidhreachta teimpléad.</p>\n<p>Mar shampla, má tá <code class=\"docutils literal notranslate\"><span class=\"pre\">{%</span> <span class=\"pre\">load</span> <span class=\"pre\">humanize%}</span></code> i teimpléad <code class=\"docutils literal notranslate\"><span class=\"pre\">foo.html</span></code>, ní bheidh rochtain ag teimpléad leanbh (m.sh., ceann a bhfuil <code class=\"docutils literal notranslate\"><span class=\"pre\">{%</span> <span class=\"pre\">leathnaíonn</span> <span class=\"pre\">&quot;foo.html&quot;%}</span></code>) <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">*</span></a>ní bheidh rochtain ar na clibeanna agus na scagairí teimpléad daonnaithe. Tá an teimpléad leanbh freagrach as a <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">``</span></a>{% load humanize%} <a href=\"#id5\"><span class=\"problematic\" id=\"id6\">`</span></a>féin.</p>\n<p>Is gné é seo ar mhaithe le cothabháil agus sláine.</p>\n<aside class=\"admonition admonition-seealso\">\n<p class=\"admonition-title\">See also</p>\n<dl class=\"simple\">\n<dt><a class=\"reference internal\" href=\"/ga/5.2/ref/templates/\"><span class=\"doc\">The Templates Reference</span></a></dt><dd><p>Clúdaíonn sé clibeanna ionsuite, scagairí ionsuite, ag baint úsáide as teanga teimpléad malartach, agus</p>\n</dd>\n</dl>\n</aside>\n</section>\n</section>","rootId":"the-django-template-language","toc":[{"title":"Teimpléid","anchor":"templates","children":[]},{"title":"Athróga","anchor":"variables","children":[]},{"title":"Scagairí","anchor":"filters","children":[]},{"title":"Clibeanna","anchor":"tags","children":[]},{"title":"Tuairimí","anchor":"comments","children":[]},{"title":"Teimpléad oidhreacht","anchor":"template-inheritance","children":[]},{"title":"Éalú uathoibríoch HTML","anchor":"automatic-html-escaping","children":[{"title":"Conas é a mhúchadh","anchor":"how-to-turn-it-off","children":[{"title":"Maidir le hathróga aonair","anchor":"for-individual-variables","children":[]},{"title":"Le haghaidh bloic teimpléad","anchor":"for-template-blocks","children":[]}]},{"title":"Nótaí","anchor":"notes","children":[]},{"title":"Litríochtaí teaghráin agus éalú uathoibríoch","anchor":"string-literals-and-automatic-escaping","children":[]}]},{"title":"Glaonna modh a rochtain","anchor":"accessing-method-calls","children":[]},{"title":"Clib saincheaptha agus leabharlanna scagaire","anchor":"custom-tag-and-filter-libraries","children":[{"title":"Leabharlanna saincheaptha agus oidhreacht te","anchor":"custom-libraries-and-template-inheritance","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/5.2/ref/"},{"docname":"ref/templates/index","title":"Teimpléid","url":"/ga/5.2/ref/templates/"}],"prev":{"docname":"ref/templates/index","title":"Teimpléid","url":"/ga/5.2/ref/templates/"},"next":{"docname":"ref/templates/builtins","title":"Clibeanna teimpléad ionsuite agus scagair","url":"/ga/5.2/ref/templates/builtins/"},"formats":{"html":"/ga/5.2/ref/templates/language/","markdown":"/ga/5.2/ref/templates/language.md","json":"/ga/5.2/ref/templates/language.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/templates/language.txt","official":"https://docs.djangoproject.com/ga/5.2/ref/templates/language/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}