Transklúzia: definícia a vkladanie obsahu vo Wikipédii

Transklúzia vo Wikipédii: jasné vysvetlenie a praktický návod na vkladanie šablón/častí stránok pomocou {{}} — dynamické prepojenie obsahu a vnorenie pre aktualizovateľné články.

Transklúzia (zložka slov trans = naprieč a inklúzia = zahrnutie) je spôsob, ako použiť obsah z jednej stránky (dokumentu) priamo v inom dokumente bez kopírovania. Ak sa pôvodný obsah zmení, zmena sa automaticky zobrazí aj vo všetkých stránkach, ktoré ho transkludujú. Na rozdiel od bežného hypertextom (odkazu), ktorý iba smeruje čitateľa na iné miesto, transklúzia vloží výsledný obsah pôvodnej stránky priamo do zobrazovanej stránky.

Vo Wikipédii sa transklúzia najčastejšie používa na vkladanie obsahu zo špeciálnych stránok nazývaných šablóna do bežných článkov, ale funguje aj pre stránky v iných menách priestorov. Technicky editor napíše do zdrojového textu stránky výraz v tvare {{Názov}} a parser prečíta zdrojový kód wiki, skonvertuje obsah cieľovej stránky do HTML, vloží ho na miesto volania a následne vygeneruje výsledný obsah pre prehliadači. Toto vkladanie obsahu sa nazýva transklúzia; samotný zápis stránky v zátvorkách sa často nazýva odkazovanie.

Základná syntax a varianty

• Transkludovanie šablóny: {{Názov šablóny}}
• Parametre šablóny: {{Názov|param=hodnota|1=hodnota}} – šablóny prijímajú parametre, vďaka čomu sú flexibilné.
• Transkludovanie stránky z hlavného menného priestoru: {{:NázovStránky}} (dvojbodka pred názvom zabráni interpretácii ako odkaz/ kategorizácii v niektorých prípadoch a umožní priamu transklúziu stránky mimo menného priestoru Šablóna).
• Substitúcia (skopírovanie obsahu pri uložení): {{subst:Názov}} – vloží text šablóny do stránky pri uložení a ďalej sa už nezmení po úpravách pôvodnej šablóny.
• Volanie modulov (Lua) a parserových funkcií: {{#invoke:Modul|funkcia|args}} a {{#if: ...}} – pre zložitejšiu logiku pri transklúzii.

Riadenie, ktoré časti sa prekladajú

Na stránke, ktorá bude transkludovaná (najčastejšie šablóne), sa často používajú špeciálne značky na určenie, ktoré časti sa majú alebo nemajú vkladať:

• <noinclude>...</noinclude> – obsah v týchto značkách sa NEzobrazí pri transklúzii; je viditeľný iba priamo na stránke šablóny (používa sa napr. pre dokumentáciu alebo kategórie, ktoré by ste nechceli pripájať k transkludovaným stránkam).
• <includeonly>...</includeonly> – obsah sa zobrazí len pri transklúzii, nie priamo na stránke šablóny pri jej úpravách (užitočné pre text, ktorý má byť viditeľný iba v cieľových stránkach).
• <onlyinclude>...</onlyinclude> – ak sú v šablóne použité, transkluduje sa iba obsah v nich; všetko mimo nich sa ignoruje pri transklúzii.

Vnorenie a limity

Stránka, ktorá je transkludovaná, môže sama obsahovať ďalšie transklúzie. Toto sa nazýva vnorenie (nesting). Vnorenie môže pokračovať niekoľkokrát – jedna šablóna môže volať inú šablónu, ktorá volá ďalšiu atď. Aby sa zabránilo nekonečným slučkám a preťaženiu servera, softvér MediaWiki obvykle obmedzuje hĺbku transklúzie (rekurziu) – bežné predvolené nastavenie je približne 10 úrovní, ale konkrétna hodnota sa môže líšiť podľa inštalácie a administrátorských nastavení.

Praktické dôsledky a dobré postupy

• Transklúzia uľahčuje opätovné použitie obsahu a udržanie konzistentnosti (napr. infoboxy, varovania, referenčné boxy).
• Pozor na výkon: rozsiahle alebo veľmi zložité vnorené transklúzie môžu spomaliť generovanie stránok. Pre náročnú logiku je vhodnejšie použiť moduly (Lua) než veľa vnorených šablón.
• Kategórie a sprievodná dokumentácia sa zvyčajne dávajú do <noinclude>, aby sa nepripájali k stránkam používajúcim šablónu.
• Ak chcete obsah len jednorazovo vložiť a nechcete, aby neskoršie zmeny šablóny ovplyvnili stránku, použite {{subst:...}}.
• Pri transkludovaní obsahu z iných stránok dbajte na to, aby cieľový obsah bol vhodný na opakované použitie a aby neobsahoval neočakávané vedľajšie efekty (napr. skryté kategórie alebo skripty).

Ako zistiť a vyriešiť problémy

• Ak sa po úprave šablóny zmena ihneď neprejaví inde, môže pomôcť vyčistenie cache stránky (purge) alebo jednoduchý reload. Zmeny sa však zvyčajne prejavia pri ďalšom zobrazení stránky.
• Pri chybe „infinite loop“ alebo nedosiahnuteľnom renderovaní skontrolujte vnorené volania šablón; často je príčinou navzájom sa volajúce šablóny.
• Pre dokumentáciu šablón použite stránku šablóny (a <noinclude> pre viditeľnú dokumentáciu), aby používatelia vedeli, aké parametre sú dostupné a aký je účel šablóny.

Celkovo je transklúzia mocný nástroj na spravovanie opakovaného obsahu v Wikipédii a iných systémoch postavených na MediaWiki, ale vyžaduje rozumné používanie a pozornosť pri návrhu šablón a modulov.

Otázky a odpovede

Otázka: Čo je to transmastný tuk?

Otázka: Ako funguje transklúzia vo Wikipédii?

Otázka: Čo sa stane, ak sa v pôvodnom dokumente vykonajú zmeny?

Otázka: Existuje obmedzenie, koľko úrovní transclusionu je možné vykonať?

Otázka: Ako sa nazýva odkazovanie pri použití transclusion?

Otázka: Je možné vylúčiť časti trankludovanej stránky?

Hľadajte podľa písmena