Ajutor: Subst
- Birou de informare |
Cuvântul cheie subst: (prescurtare pentru cuvântul englez substituție ) poate fi folosit ca prefix în numele unui șablon sau al altei pagini incluse , pentru a schimba modul în care software-ul redă șablonul.
În mod normal, conținutul unui șablon inclus într-o pagină este redat în funcție de starea curentă a șablonului. Aceasta înseamnă că orice modificare a conținutului șablonului reamintit în diferite pagini îl modifică și pe acesta din urmă, deoarece conținutul reamintit este actualizat la versiunea curentă a șablonului. Cu alte cuvinte, o modificare a șablonului original este reprodusă în toate paginile care conțin șablonul în sine.
Inserarea subst:
în codul șablonului comandă software-ului să înlocuiască șablonul cu rezultatul procesării sale, efectuată la salvarea paginii . Cu alte cuvinte, atunci când șablonul este inserat cu subst:
pagina salvată nu va conține șablonul, dar rezultatul acestuia ca și cum ar fi fost transcris, astfel încât orice modificare a șablonului original nu va mai afecta aceste pagini, deoarece acestea nu includ șablonul.
Înlocuirea poate fi aplicată și variabilelor și funcțiilor , pentru a insera direct valoarea expresiilor.
Utilizare
Puteți substata (în terminologia argoului) un șablon adăugând subst:
la începutul etichetei șablon. De exemplu: în loc să inserați șablonul {{NomeTemplate}}
în mod obișnuit, este inserat ca {{subst:NomeTemplate}}
. Înlocuirea unui șablon trebuie indicată întotdeauna în câmpul supus modificării.
Dacă doriți să utilizați o versiune modificată a mesajului standard, trebuie să salvați versiunea standard și apoi să o modificați, deoarece în previzualizare codul nu este înlocuit în caseta de editare. În obiect puteți indica faptul că nu ați făcut o greșeală, dar că lucrați în continuare la pagină.
Dacă specificați parametrii furnizați de șablon, ca în {{subst:t2|R|s}}
, valorile inserate vor fi prezente și în textul înlocuit; dacă în schimb există câțiva parametri care nu sunt prevăzuți de șablon, sintaxa comenzii subst este acceptată, dar acești parametri sunt ignorați, adică valorile lor nu sunt incluse în textul înlocuit.
Avantajele înlocuirii
- Șabloanele sunt adesea editate sau șterse. Când introduceți un șablon în intrare, acesta evaluează dacă conținutul său trebuie actualizat pe măsură ce codul șablonului se modifică; dacă credeți că nu este , introduceți șablonul cu
subst:
Un exemplu tipic este șablonul {{ întâmpinare }}: pagina de discuție a unui utilizator trebuie să afișeze mesajul de întâmpinare pe care l- a primit efectiv și nu versiunea curentă a mesajului de întâmpinare. - Dacă intenționați să editați un șablon pe o pagină, dar nu doriți să modificați rezultatul șablonului în toate celelalte pagini care îl utilizează și nici nu doriți să creați un șablon nou, puteți trimite șablonul și apoi faceți modificările cu o modificare ulterioară.
De exemplu: un șablon ar putea fi utilizat pentru toate statele din Statele Unite și, de asemenea, pentru Districtul Columbia ; într-o intrare din Districtul Columbia poate fi necesar să se utilizeze diferite expresii: acest lucru poate fi realizat prin trimiterea șablonului la intrare și apoi modificarea părților care o necesită. - Înlocuirea poate fi utilizată și pentru a evita daunele rezultate din vandalism pe paginile șablonului.
- Observarea rezultatelor generate de un șablon de subestat poate favoriza o mai bună învățare a expresiilor wikicode, care rămân invizibile dacă șablonul nu este subestat.
- Unele șabloane sunt concepute special pentru a fi utilizate numai cu subst. Acestea sunt marcate cu {{ șablonul nu este inclus }} și sunt colectate în Categorie: Șabloane neincluse .
Dezavantaje ale substituției
- După ce un șablon a fost substatificat, rezultatul nu mai este legat de șablon și, prin urmare, devine dificil să găsești toate paginile care îl conțineau. Această problemă poate fi rezolvată prin adăugarea, în propriul cod, a unui link către șablon sau prin intermediul categoriilor.
- După trimiterea unui șablon, conținutul paginii nu va mai reproduce actualizările șablonului.
În special, nu toate șabloanele al căror scop este să creeze elemente uniforme și actualizabile în elemente, ca în cazul șabloanelor sinoptice, de navigație etc. - Înlocuirea crește dimensiunea paginilor.
- Un șablon secundar poate adăuga o cantitate mare de cod wikicode și cod HTML la pagină, ceea ce poate face dificilă modificarea paginii pentru utilizatorii care nu sunt familiarizați cu aceste coduri.
- Înlocuirea reduce probabilitatea ca utilizatorii noi să învețe cum să folosească șabloanele.
- Dacă șablonul trebuie utilizat doar temporar, este de preferat să evitați substatarea acestuia, deoarece este oarecum complex să eliminați sau să editați rezultatul șabloanelor de sub-stat.
- Un șablon vandalizat și substatat generează daune greu de reparat, deoarece soluția de șablon nu corectează și textul substat de pe pagini.
Înlocuirea lanțului
În mod normal, orice variabilă , funcție și alte șabloane conținute în șablonul de subsol sunt copiate așa cum apar în wikitext. De exemplu, dacă șablonul Ciccio conține un {{CURRENTYEAR}}
, executând {{subst:Ciccio}}
vom primi un text „{{CURRENTYEAR}}” în pagina de destinație.
Dacă doriți ca elementele interne ale șablonului să fie substatificate împreună cu șablonul, acestea trebuie să fie precedate și de subst: în codul șablonului. Dacă șablonul Ciccio conține un {{subst:CURRENTYEAR}}
, executând {{subst:Ciccio}}
vom primi un „2021” text pe pagina de destinație. Desigur, atunci când creați pagina Șablon: Ciccio, părțile substabile trebuie să fie între <includeonly>
altfel vor fi deja subestate în momentul creării!
Există, de asemenea, comanda safesubst:
care funcționează într-un mod similar cu subst: dar asigură atât înlocuirea lanțului când se face șablonul părinte, cât și șablonul funcționează în continuare atunci când este pur și simplu inclus. Dacă șablonul Ciccio conține un {{safesubst:CURRENTYEAR}}
, efectuând {{subst:Ciccio}}
vom primi un „2021” textual și inclusiv {{Ciccio}}
vom vedea anul în mod regulat.
Limitări
Nu puteți utiliza substituirea în interiorul etichetelor <ref>…</ref>
[1] . Dacă introduceți {{subst:Ciccio}}
într-o notă, aceasta va rămâne așa cum este în sursa vocală și șablonul va fi inclus ca și cum comanda „subst:” nu ar fi prezentă. Singura soluție parțială la această limitare este utilizarea {{subst:#tag:ref
pentru a scrie o notă: tastând {{subst:#tag:ref|Testo della nota {{subst:Ciccio}} Altro testo}}
, Ciccio
șablonul va fi trimis cu succes.
Notă
Alte proiecte
- Meta-Wiki conține un ghid mai complet (în engleză) despre Ajutor: Subst
- Wikidata conține date despre Ajutor: Subst