Transkluzija (v izvirniku pogosto imenovana tudi transclusion ali v slovenščini nekdaj poenostavljeno »prenos«) je način uporabe vsebine iz enega elektronskega dokumenta v drugem brez neposrednega kopiranja besedila. Če se izvirna vsebina spremeni, se sprememba samodejno odrazi v vseh dokumentih, ki to vsebino vključujejo. Oba dokumenta sta povezana z hipertekstom. Beseda izhaja iz latinsko/angleške kombinacije trans (čez) in inclusion (vključitev) — torej vključitev vsebine, prinešene s druge lokacije.

Kako transkluzija deluje v Wikipediji in drugih wikijih

V Wikipediji se transkluzija najpogosteje uporablja za vstavljanje vsebine iz posebnih strani, imenovanih predloga, v druge članke. Metoda pa deluje tudi za druge vrste strani. Ko okrog imena strani v izvorni kodi wikija postavite dvojni oklepaj {{ }},, parser prebere izvorno kodo vključene strani, jo pretvori v HTML in jo vstavi na mestu oklepaja, preden nadaljuje s pretvorbo preostale vsebine izvirne strani v obliko, primerno za prikaz v brskalniku. Ta postopek — avtomatsko »vlečenje« in vstavljanje vsebine — je transkluzija. Na stran, ki jo želite vključiti, se sklicujete z navajanjem njenega imena v oklepaju, kar imenujemo sklicevanje.

Izbiranje in izključevanje delov strani

Obstajajo mehanizmi, s katerimi lahko vključite ali izključite le določene dele strani. Pogosti pristopi vključujejo:

  • uporabo parametrov predlog (da se prikažejo različne vsebine glede na podane argumente),
  • posebne sintakse za vključevanje samo posameznih sekcij ali razdelkov,
  • pogojne izjave in parser-funkcije, ki omogočajo logiko pri vnašanju vsebine.
Ti načini omogočijo prilagodljivost transkluzije, vendar ne spremenijo osnovnega koncepta — vsebina se še vedno bere iz vira in dinamično vstavi v cilj.

Gnezdenje in omejitve

Stran, ki je vključena, lahko sama vsebuje transkluzije drugih strani; temu pravimo gnezdenje. To je lahko uporabno (npr. ko je skupna vsebina sestavljena iz manjših delov), a lahko vodi tudi v težave, če gnezdenje postane pregloboko ali krožno. Zato sistemi običajno omejijo dovoljeno število ravni vključenosti, da preprečijo neskončne zanke, ki bi lahko ustavile parser ali povzročile prekomerno obremenitev strežnika.

Tehnični vidiki in ograničenja

Pomembne tehnične točke, ki jih je treba upoštevati:

  • Keširanje: ker transkluzija dinamično vleče vsebino, sistemi običajno uporabljajo keširanje, da se izogne pogostim ponovnim pretvorbam in obremenitvam.
  • Varnost in dovoljenja: v nekaterih sistemih je vključevanje strani omejeno zaradi varnostnih razlogov (da se prepreči vnašanje zlonamerne kode ali dostopa do skritih vsebin).
  • Parametri in nadzor izhoda: predloge kot v Wikiju pogosto sprejemajo parametre, ki nadzorujejo izpis (npr. prikaz naslova, izbira jezikovne različice ali oblikovanja).
  • Razreševanje imen in veliko/small črke: iskanje strani za transkluzijo je odvisno od pravil o poimenovanju; v nekaterih wikijih različice z različnimi črkami štejejo drugače.

Prednosti in slabosti

Prednosti:

  • Urejanje na enem mestu: sprememba izvorne strani se samodejno posodobi povsod, kjer je bila vključena.
  • Konsistenca: skupne informacije (npr. predloge z vpisom podatkov) ostanejo enotne po celotnem spletnem mestu.
  • Manj podvajanja besedil in lažje vzdrževanje.
Slabosti:
  • Zapletena diagnostika: kadar pride do napačnega izpisa, je včasih težje ugotoviti, kje v gnezdu je napaka.
  • Možne učinkovitostne težave brez ustreznega keširanja.
  • Odvisnost od razpoložljivosti izvorne strani — če je izvor izbrisan ali spremenjen, se to odrazi posredno.

Primeri uporabe in nasveti

Transkluzija je uporabna za:

  • skupne elemente oblikovanja (npr. noge strani, infookvirji),
  • ponovljene vsebine, kot so podatkovne tabele ali opozorilna sporočila,
  • lokalizacijo vsebin (ko isti vir vsebuje več jezikovnih različic) ter
  • dinamično sestavljanje člankov iz manjših sestavnih delov.
Nasveti:
  • Uporabljajte jasna imena strani in dokumentirajte predloge, da drugi uredniki vedo, kako jih uporabljati.
  • Izogibajte se nepotrebnemu gnezdenju in predolgim verigam vključevanja.
  • Preizkusite učinek sprememb na straneh, ki vključujejo vašo predlogo, da preverite neželene posledice.

Transkluzija je močno orodje za modularno in vzdržno gradnjo vsebin na spletu; pravilno uporabljena poveča učinkovitost urejanja in izboljša konsistentnost informacij.