Transklusioon ehk ümberliitmine: sisu kaasamine Vikipeedias

Ümberliitmine on võimalus kasutada ühe elektroonilise dokumendi sisu teises dokumendis, ilma et oleks vaja sisu ühest dokumendist teise kopeerida. Kui algset sisu muudetakse, ilmneb muudatus automaatselt artiklis, mis kasutab ülekantud sisu. Kaks dokumenti on omavahel ühendatud hüpertekstiga. Sõna on kombinatsioon sõnadest trans, mis tähendab üle ja kaasamine, seega tähendab see millegi teisest kohast üle toodud asja kaasamist.

Vikipeedias kasutatakse seda tavaliselt selleks, et paigutada sisu spetsiaalsest artiklist, mida nimetatakse malliks, teistesse artiklitesse, kuid see meetod töötab ka muud liiki artiklite puhul. Mallid (template’id) võimaldavad keskselt hoida korduvat vormindust, andmeid ja tekste, näiteks infokastid, hoiatused, navigeerimisribad jms.

Kui paned topelt sulgudes {{ }} lehekülje nime ümber, loeb programm wiki lähtekoodi ja konverteerib selle HTML-ks, et see brauseris kuvataks. Tarkvara näeb, et sa soovid nimetatud lehe sisu selles punktis lisada, ja läheb seda lugema, konverteerib selle html-ks ja lisab selle selles punktis, enne kui jätkab algse lehe ülejäänud lähtekoodi html-ks konverteerimist. See on transklatsioon. Te viitate ümberliidetavale lehele, nimetades selle sulgudes, mida nimetatakse viitamiseks.

On olemas viisid, kuidas välistada ümberlülitatava lehe osad ja kuidas ümberlülitada osa lehest, näiteks ainult lõik, kuid see ei muuda põhikontseptsiooni.

Ümberliidetud lehekülg võib sisaldada ka teiste lehekülgede ümberliitmisi. Seda nimetatakse nestinguks. Seda võib teha mõõdukalt palju kordi, kusjuures üks lehekülg võib teisi lehekülgi, mis omakorda võivad teisi lehekülgi uuesti ja uuesti sulgeda. Et vältida juhuslikke või tahtlikke lõpmatuid silmuseid, mis põhjustavad tõlkeprogrammi takerdumise, on piiratud, kui palju tasandeid on lubatud.

Kuidas transklatsioon praktiliselt töötab

Põhitasandil lisad teise lehe sisu oma ellipsisena, kirjutades lehe nime topeltkurdude vahele, näiteks {{Mall:Nimi}}. Malli lehel võib olla tavaline wikitähistus, parameetrid ja loogika (parser-funktsioonid).

Kasutusvõimalused ja head tavad

Korduva sisu hoidmine: infokastid, hoiatused, viited, autoriõiguse märgised jt, mida kasutatakse mitmes artiklis.
Ühtsus ja hooldatavus: kui sisu tuleb muuta, tehakse see ühes kohas (mallis) ja muudatus kajastub kõikjal, kus mall on ümberliidetud.
Dokumentatsioon: mallile lisatakse tavaliselt selgitus ja näited <noinclude> siltidega, et mallilehte lugedes oleks arusaadav, kuidas mallit kasutada.

Olulised märgendid ja tööriistad

Et kontrollida, mis transklatsiooni käigus kaasatakse, kasutatakse järgmisi wikitag’e:

<noinclude> ... </noinclude> — sisu, mis KUVALELE mallilehel (selle redigeerimisel) peab jääma, aga mida ei tohi ümberliita; sageli kasutatakse dokumentatsiooni ja kategooriate lisamiseks.
<includeonly> ... </includeonly> — sisu, mis kuvatakse ainult siis, kui lehte ümberliidetakse, aga ei näy mallilehel otse.
<onlyinclude> ... </onlyinclude> — kui lehel on ainult üks osa, mida soovitakse ümberliita, siis märgistatakse see osa ainult selle märgendiga; ümberliidetakse ainult see sisu.

Parameetrid ja asendamine

Mallid võivad vastu võtta parameetreid: näiteks {{Mall:Nimi|esimene|võti=võrdlus}}. Need võimaldavad mallil käituda dünaamiliselt ja kuvada erinevat infot sõltuvalt sellest, kuidas seda kutsutakse.

Kui soovid sisu kopeerida staatiliselt (et see ei uuenduks pärast algse muutmist), kasutatakse asendusfunktsiooni: {{subst:Mall:Nimi}}. See asendab mallikoodi tegeliku sisu redigeeringu salvestamise ajal.

Osade või lõikude kaasamine

Lisaks <onlyinclude> ja <includeonly> kasutamisele saab mõnikord viidata konkreetsele sektsioonile või alamlehele (sõltuvalt Vikipeedia seadistustest). Kui soovid ainult pühendatud osa kaasata, on sageli lihtsam markeerida see too osa <onlyinclude> abil mallilehel.

Kategooriad ja kõrvalmõjud

Kui mall sisaldab [[Kategooria:...]], siis võivad kõik artiklid, kus mall on ümberliidetud, sattuda samasse kategooriasse. Selle vältimiseks paigutatakse kategooria märkmed tavaliselt <noinclude> sildi sisse mallilehel.

Limitatsioonid ja ohud

Sõltuvused ja pesastamine: liiga palju pesastamist (nestingut) raskendab vigade leidmist ja suurendab renderdamise aega.
Silmsilmused: tarkvara piirab ümberliitmise tasandeid, et vältida lõpmatuid silmuseid; see piirang sõltub serveri seadistustest (tavaliselt on tasandeid piiratud mitu korda).
Soorituse kulu: laiaulatuslikud ja sügavad transklatsioonid võivad aeglustada lehe kuvamist ja suurendada serverikoormust.
Versioonihaldus: kuna muutused toimuvad keskse malli muutmisel, tuleb hoolikalt jälgida muudatuste mõju kõigile transkludeeritud lehtedele.

Praktilised näpunäited

Kasutage transklatsiooni, kui sama või sarnane sisu ilmub mitmel lehel.
Ärge ülepesastage — püüa hoida malli lihtsana ja hästi dokumenteerituna.
Kui soovite sisu ühekordselt kopeerida (nt ajalooline seis), kasutage {{subst:...}}.
Paigutage mallilehel dokumentatsioon ja kategooriad <noinclude> sisse, et need ei kanduks üle kõigile kasutavate lehtedele.

Kui soovid praktilisi näiteid või abi konkreetse malli loomiseks või olemasoleva malliga töötamiseks, võin aidata samm-sammult näidetega.

Küsimused ja vastused

K: Mis on transrasvumine?

V: Transklatsioon on võimalus kasutada ühe elektroonilise dokumendi sisu teises dokumendis, ilma et oleks vaja sisu kopeerida. Need kaks dokumenti on ühendatud hüperteksti abil ja kui lehekülje nime ümber pannakse topeltklambrid {{ }}, loeb tarkvara seda ja lisab selle lehekülje sisu sellesse punkti, enne kui jätkab algse lehekülje lähtekoodi teisendamist.

K: Kuidas toimib Vikipeedias transklatsioon?

V: Vikipeedias kasutatakse transklatsiooni tavaliselt selleks, et lisada sisu spetsiaalsest artiklist, mida nimetatakse malliks, teistesse artiklitesse, kuid see toimib ka muud liiki artiklite puhul. Kui lehekülje nime ümber pannakse topeltklambrid {{ }}, loeb tarkvara seda ja lisab selle lehekülje sisu sellesse punkti, enne kui jätkab esialgse lehekülje lähtekoodi teisendamist.

K: Mis juhtub, kui algdokumendis tehakse muudatusi?

V: Kui algdokumendis tehakse muudatusi, ilmuvad need automaatselt igas artiklis, mis kasutab selle dokumendi ülevõetud sisu.

K: Kas on olemas piirang, kui palju tasandeid saab ümberliitmist teha?

V: Jah, on olemas piirang, kui palju tasandeid saab ümberkontrolli teha, et vältida juhuslikke või tahtlikke lõpmatuid tsükleid, mis põhjustaksid probleeme programmide tõlkimisel.

K: Kuidas te nimetate viitamist, kui kasutate transklatsiooni?

V: Viitamine transklatsiooni kasutamisel tähendab lehekülgede nimetamist sulgudes {{ }}, et nende sisu saaks lisada teatud kohtadesse teises dokumendis.

K: Kas on võimalik välistada osa transklusiivsest lehest?

V: Jah, on võimalik välistada trancluded lehe osi, samuti on võimalik lisada ainult osa sellest, nagu näiteks ainult üks lõik.

K: Kas eraldatud lehekülg võib sisaldada teisi eraldatud lehekülgi? V: Jah, seda nimetatakse nestinguks ja seda saab teha kuni seatud piirini, vältides juhuslikke või tahtlikke lõpmatuid silmuseid, mis võivad tekitada probleeme tõlkeprogrammidega.