Ajutor: șablon
În Wikipedia, un șablon [1] este o pagină specială creată pentru a fi inclusă în alte pagini prin intermediul mecanismului de includere .
Poate fi folosit în mai multe scopuri:
- introduceți cu ușurință text repetat pe diferite pagini, scriindu-l o singură dată, ca și pentru șabloanele de navigare
- introduceți elemente standard, tabele de informații sau notificări
- introduceți elemente al căror comportament poate fi programat în funcție de unele variabile.
Șabloanele sunt conținute în șablonul spațiului de nume (sau spațiul de nume 10), adică spațiul de nume ale cărui pagini au forma „ Șablon: NUME ” (de exemplu: Șablon: S , Șablon: Bun venit , Șablon: Europa ).
Pentru a vă referi la un șablon puteți utiliza și abrevierea T, de ex. t: Europa .
![]() |
Inserare
Toate paginile aparținând spațiului de nume 10 pot fi inserate rapid într-o pagină, pur și simplu scriind numele șablonului (partea care urmează șablonului: text) între paranteze buclate duble [2] , ca în {{ NAME }}. Această referință din wikitext face ca conținutul șablonului să fie inserat atunci când pagina este afișată.
Dacă pagina „Șablon: nume ” nu există, atunci {{ nume }} funcționează ca [[Șablon: nume ]], un link către o pagină inexistentă, care duce la pagina de editare.
Nu este permisă inserarea de șabloane inexistente.
Dacă șablonul nu se află în spațiul de nume corespunzător (deoarece este încă în lucru sau pentru că este o inserție a unei alte pagini), acesta poate fi folosit oricum, prin introducerea numelui cu calea completă (de exemplu {{utilizator: NAME) PRENUME / pagina Test}}).
Intrarea este sensibilă la majuscule , adică software-ul distinge majuscule și minuscule, cu excepția primei litere și a spațiilor care sunt echivalente cu punctele de subliniere („_”). Prin urmare:
- șablonul {{pagina de test}} și șablonul {{pagina de test}} vor fi recunoscute ca fiind diferite
- șabloanele {{pagina de test}} și {{test_page}} vor fi identice.
Puteți utiliza incluziunea imbricată: un șablon inclus într-o pagină poate conține, de asemenea, unul sau mai multe șabloane.
Când introduceți șabloane, este posibil să declarați variabile care vor fi utilizate în șablon : în acest caz vorbim despre un șablon parametric .
Bretele
Pentru a insera parantezele duble care deschid și închid un șablon există mai multe moduri care depind atât de aspectul tastaturii , cât și de sistemul de operare . De asemenea, puteți copia și lipi de aici: {{}}
clip deschis | clip închis | sistem |
---|---|---|
Alt + Gr + 7 | Alt + Gr + 0 | GNU / Linux |
Alt + Gr + 8 | Alt + Gr + 9 | GNU / Linux |
Alt + 123 | Alt + 125 | Microsoft Windows |
Alt + Gr + ⇧ Shift + este | Alt + Gr + ⇧ Shift + + | Microsoft Windows - GNU / Linux |
Alt + Ctrl + ⇧ Shift + este | Alt + Ctrl + ⇧ Shift + + | Microsoft Windows |
⌥ + ⇧ + este | ⌥ + ⇧ + + | macOS (cu aspect italian - Pro ) |
Notă : Cheia ⇧ Shift , pe unele tastaturi poate fi numit și „Shift”. Se găsește adesea chiar sub cheie ↵ Enter (sau "Enter").
Utilizare
Șabloanele sunt utile pentru orice element complex, în special cu formatarea grafică, care trebuie repetată în două sau mai multe pagini fără a fi nevoie să o tastați de fiecare dată. Datorită parametrilor, este posibilă și schimbarea aspectului său în funcție de articol, întotdeauna fără a fi nevoie să tastați totul de fiecare dată. Șabloanele nu sunt doar convenabile, ci pot contribui la obținerea coerenței între pagini.
Aplicațiile tipice sunt:
- Alerte precum {{ S }}
- Șablon de navigare ca Șablon: Europa . Aceste șabloane merg în partea de jos a paginii, după linkurile externe și înainte de șablonul și categoriile {{ portal }}.
- Șabloane sinoptice (numite și infobox-uri ), care arată de fiecare dată același tip de informații cu același format, dar diferențiate utilizând parametrii, de exemplu {{ Status }}. Aceste șabloane sunt inserate în colțul din dreapta sus al elementului.
Utilizări contraindicate
Nu este recomandat să duplicați conținut textual (atât cu cât și fără șabloane), de exemplu punerea unei secțiuni care are legătură cu A și B atât în articolul A, cât și în articolul B. Acest lucru creează confuzie, în special pentru colaboratorii începători. În aceste cazuri, este recomandabil să vizualizați textul într-un singur loc și să utilizați linkuri wikil pentru a-l conecta din mai multe locuri.
Șabloane parametrice
Atunci când creați un șablon, poate fi necesar să lăsați utilizatorul posibilitatea de a personaliza o parte din textul sau comportamentul șablonului, în funcție de pagina în care este inserat. În acest caz, utilizatorul indică unul sau mai mulți parametri care vor fi apoi exploatați pentru reprezentarea video a șablonului în sine. De exemplu șablonul: Filmul afișează date diferite în funcție de filmul pe care îl descrie.
În fiecare pagină în care este introdus șablonul, parametrii sunt exprimați după numele șablonului, separați prin bare verticale și pot fi identificați printr-un nume de parametru sau printr-o ordine progresivă. Metoda de identificare depinde de modul în care a fost construit șablonul și este explicată în manualul său; ambele pot fi, de asemenea, acceptate.
Exemplu de includere cu parametri numiți după nume:
{{numele șablonului | numele = Tom | prenumele = Tom | data = marți}}
Exemplu de includere cu parametri secvențiali:
{{numele șablonului | Tizio | Caio | Marți}}
În interiorul șablonului însuși, în mijlocul wikicodului care constituie pagina „Șablon: numele șablonului”, parametrii sunt reprezentați de etichete închise în paranteze triple ; când șablonul este inclus, aceste etichete vor fi înlocuite cu valorile de text atribuite din când în când de către utilizator parametrilor.
În primul exemplu:
{{{name}}}, {{{surname}}} și {{{data}}}
In secunda:
{{{1}}}, {{{2}}} și {{{3}}}
Prin urmare, sintaxa în întregime este
{{templatename | nume parametru1 = valoare parametru1 | nume parametru2 = valoare parametru2}}
cu etichetele{{{nomeparametro}}}
din șablon
- sau
{{templatename|valoreparametro1|valoreparametro2}}
cu etichetele{{{1}}}
,{{{2}}}
etc. în șablon.
note importante :
- etichetele parametrilor din șablon au trei paranteze cretate și nu două !
- numele parametrilor trebuie să se potrivească exact; majusculele contează, iar spațiile nu sunt echivalente cu punctele de subliniere.
Exemplu |
---|
Pagina „Șablon: salut” conține: Bună ziua {{{name}}}, ce mai faci? Șablonul este inclus într-o intrare tastând: {{Salut | nume = Tom}} După salvarea modificării (sau în previzualizare ), elementul va afișa: Bună tipule, ce mai faci? |
În faza de redare (adică generarea rezultatului inserării șablonului pe ecran), parametrii suplimentari vor fi ignorați. Dacă, pe de altă parte, parametrii sunt insuficienți, va apărea în mod normal o eroare, cu excepția cazului în care a fost prevăzută posibilitatea omiterii unui parametru dat.
Parametrii opționali
De obicei, un parametru este făcut opțional cu formularul {{{1|}}}
sau {{{1|Pippo}}}
, adică cu o bară verticală după nume. Bara înseamnă că, în absența acelui parametru, valoarea care urmează barei va fi utilizată în mod implicit (nimic în primul caz; „Pippo” în al doilea).
Valoarea implicită nu se aplică dacă parametrul este gol, dar declarația sa este încă prezentă: apelând {{nome template|}}
(sau {{nome template|nome=}}
dacă parametrul are un nume) valoarea parametrului va fi doar nul și nu „Pippo”. Pentru a verifica dacă parametrul nu este nici absent, nici gol, este necesară funcția #if .
Personaje spațiale
Când se utilizează notația, orice spațiu și returnarea căruței în jurul valorilor parametrilor sunt ignorate, deci {{Saluto|nome=Tizio}}
este echivalent cu {{Saluto| nome = Tizio }}
. Din acest motiv, șabloanele care au numeroși parametri numiți sunt adesea plasate în următorul format, care este mai ușor de citit și mai ușor de completat:
{{Nume șablon
| nume = Tom
| prenume = Caio
...
}}
Cu toate acestea, acesta nu este cazul declarațiilor implicite: {{Saluto|Tizio}}
și {{Saluto| Tizio }}
sunt diferite, iar în al doilea caz spațiile vor fi raportate text în pagina de apelare. Spațiile sunt adesea inofensive, dar dacă nu, un posibil truc pentru a le elimina este să folosiți {{#if:toglispazi|{{{1}}}}}
în codul șablonului („spațiu-eliminare” este orice șir ).
Limitări
Un nume de parametru sau valoarea acestuia nu pot conține caracterul " | ", deoarece este utilizat pentru separarea parametrilor. Orice „|” în link-uri wikil ( link-uri piped ) sau alte șabloane nu reprezintă o problemă, dar dacă trebuie să inserați un „|” din alte motive, utilizați comanda {{!}}.
- această sintaxă funcționează corect: {{Șablon | [[Marte (astronomie) | Marte]]}}
- dar acest lucru nu funcționează: {{Template | La | este un bar}}
- pentru a remedia acest lucru, trebuie să utilizați această variantă: {{Șablon | {{!}} este o bară}}
De asemenea, dacă numele variabilei nu este specificat, valoarea lor nu poate conține semnul " = ". Dacă trebuie să inserați semnul „=” într-un șablon care utilizează nume de variabile implicite, atunci trebuie să specificați numele, de exemplu:
- această sintaxă funcționează corect: {{Șablon | A | B}}
- dar acest lucru nu funcționează: {{Șablon | A = 10 | B = 32}}
- pentru a remedia acest lucru, trebuie să utilizați această variantă: {{Șablon | 1 = A = 10 | 2 = B = 32 }}
Sau puteți utiliza șablonul {{ = }} după cum urmează: {{Șablon | A {{=}} 10 | B {{=}} 32}}.
Editați un șablon
Pentru a vedea conținutul unui șablon, este necesar să îl deschideți în modul de editare.
Pur și simplu accesând pagina șablonului, în funcție de modul în care este configurată, veți primi în cele mai frecvente cazuri un exemplu de afișare a șablonului sau o pagină de instrucțiuni, uneori însoțită de un avertisment care marchează șabloanele cele mai complexe și dificil de modificat.
Pentru a accesa pagina unui șablon, pe lângă introducerea numelui său în caseta de căutare, este posibil să faceți clic pe eticheta de editare a unui element în care este conținut șablonul. În partea stângă jos, după codul wikic al elementului, va apărea o secțiune cu titlul „Șabloane utilizate în această pagină”, care conține linkuri către toate șabloanele inserate în pagină.
Este necesară o clarificare importantă:
NU MODIFICAȚI NICIODATĂ CONȚINUTUL UNUI MODEL DE UTILIZARE DACĂ NU ȘTIEȚI CE FĂCȚI
Editarea unui șablon puternic reamintit poate deteriora numeroase pagini, precum și supraîncărcarea serverelor Wikipedia, care trebuie să actualizeze toate paginile care îl includ. În special, nu modificați numele / ordinea parametrilor , cu excepția cazului în care intenționați să corectați una câte una toate paginile care conțin deja șablonul. Este întotdeauna cel mai bine să experimentați înainte de a modifica șabloanele populare, folosind previzualizarea sau sandbox-urile .
Când un șablon este deschis pentru editare, este posibil, ca pentru toate paginile, să vizualizați previzualizarea șablonului în sine; în plus, o altă funcție este disponibilă pentru șabloane (caseta „Previzualizați o pagină cu acest șablon”) care vă permite să vizualizați direct efectul pe care l-ar avea modificările într-un element care include deja șablonul, fără a fi nevoie să salvați, nici măcar nisip.
Creați un șablon
Crearea unui nou șablon se face ca pentru orice altă pagină. Întrucât un șablon este conceput pentru a fi utilizat în mai multe voci, uneori chiar mii, este bine să discutăm despre oportunitatea creației sale, de exemplu într-un proiect tematic .
Atunci când scrieți un șablon, este întotdeauna o idee bună să introduceți categoriile cărora le aparține șablonul, un text instructiv scurt (sau mai bine un manual ) și o prezentare a funcțiilor șablonului între etichetele <noinclude> </noinclude>. Consultați Ajutor: Includere pentru o descriere a acestor etichete. Dacă nu utilizați noinclude, categoriile și instrucțiunile vor apărea, de asemenea, eronat în toate elementele în care este inserat șablonul.
Dacă este necesar, codul șablonului real este în schimb inclus în etichetele <includeonly> </includeonly>, pentru a evita afișarea unui rezultat fără sens pe pagina șablonului în sine. Nu inserați spații și înfășurați în afara etichetelor include și noinclude, deoarece acestea ar apărea și în intrări.
Numele șablonului
Nu există limite tehnice pentru titluri, altele decât cele pe care le au toate celelalte pagini; un șablon poate fi ușor numit „Șablon: orașe majore italiene”, fără a fi nevoie de nume de limbaj de programare precum „Șablon: CittaITA1” (același lucru se poate spune despre numele parametrilor). Prin urmare, în general, urmați aceleași convenții folosite pentru voci , alegând nume în italiană corectă.
Abrevierile sunt utilizate de obicei numai pentru șabloanele utilizate pe scară largă care necesită o viteză manuală mare de intrare, acesta este cazul de exemplu cu principalele avertismente .
Rețineți că redirecționările funcționează și pentru șabloane.
Lista paginilor care conțin un șablon
Pentru a verifica ce pagini conțin un șablon pe care îl utilizați (ca pentru orice pagină) instrumentele Punctează aici din stânga. Instrumentul vă permite să distingeți ce pagini includ șablonul și care îl indică pur și simplu cu un wikilink.
Lista șabloanelor incluse într-o pagină
Dacă doriți să vizualizați lista șabloanelor incluse într-o pagină, deschideți acea pagină în modul de editare (sau vizualizați sursa, pentru paginile protejate).
Chiar sub caseta de editare, în stânga, există o parte a paginii intitulată „Șabloane utilizate în această pagină:” care listează diferitele șabloane incluse în pagina în cauză. Puteți face clic pe numele uneia dintre ele pentru a accesa pagina relevantă și, dacă este necesar, să o editați de acolo.
Notă: nu numai șabloanele incluse direct, ci și indirect (adică cele incluse la rândul lor într-un șablon inclus în pagină și așa mai departe) sunt indicate acolo.
Cache
Când un șablon este modificat, versiunea HTML stocată în cache a tuturor paginilor care utilizează șablonul sunt marcate ca fiind regenerate, ceea ce se realizează printr-o coadă de lucru de către servere. Prin urmare, actualizarea poate dura ceva timp, mai ales când șablonul este inclus în multe pagini; deci nu vă faceți griji dacă modificările șablonului nu apar imediat pe pagini. Pentru a forța imediat actualizarea unei anumite pagini, faceți doar o salvare (chiar și fără modificări) a paginii.
Înlocuirea unui șablon (subst :)
Punând „subst:” după paranteze deschise, această comandă din wikitext va fi înlocuită de conținutul șablonului atunci când pagina este salvată. Dacă cineva schimbă pagina mai târziu, nu va mai vedea eticheta în wikitext ci doar textul înlocuit.
Verificați aspectul
Când editați grafica unui șablon, este o idee bună să verificați aspectul acestuia cu principalele browsere, deoarece nu toate browserele afișează grafica Wikipedia în același mod. Vezi și Wikipedia: Accesibilitatea conținutului .
Variabile de sistem
Variabilele de sistem pot fi considerate șabloane speciale gestionate cu aceeași sintaxă, chiar dacă sistemul le recunoaște fără a fi nevoie de o pagină corespunzătoare în spațiul de nume Șablon, care, de fapt, dacă ar fi create cu un nume deja utilizat de variabile, ar fi ignorat.
De asemenea, este posibil să utilizați variabile în șabloane, pe lângă parametrii declarați de utilizator, pentru a obține unele informații, cum ar fi numele paginilor în care este inclus șablonul ({{PAGENAME}}) sau data ({{ CURRENTDAY}} {{CURRENTMONTHNAME}} și {{CURRENTYEAR}} în diferitele combinații). Un cuvânt magic într-un șablon este evaluat după inserarea în pagina care îl face referire, de exemplu, dacă cuvântul magic {{PAGENAME}} apare în codul wikic al unui șablon, acesta este redat cu numele paginii care îl conține și nu cu numele șablonului.
msgnw
Utilizați „msgnw:” după acoladele deschise pentru a afișa codul wikic intern al șablonului în loc de aspectul acestuia. De exemplu, {{ITA}} și respectiv {{msgnw: ITA}} afișează:
Italia
Și
{{flag | ITA | name}} <noinclude> {{Protected}} [[Category: National flag templates]] [[fr: Model: Italie]] </noinclude>
Căutare combinată
![]() (pagini cu caractere cursive ) |
► Module |
![]() |
Notă
- ^ Termenul este în engleză ( [ˈtɛmpleɪt] sau [ˈtɛmplɪt] ): în italiană înseamnă „model”, dar literalmente este „siluetă”, „cast”. Pentru informații generale, consultați intrarea Șablon .
- ^ Cu tastatura italiană, brațul deschis poate fi obținut apăsând Alt Gr + ⇧ Shift + [ , în timp ce brațul de închidere apăsând Alt Gr + ⇧ Shift + ] )
Pagini conexe
- Șablon: Tl : util pentru citarea șabloanelor (în documentație, exemple, discuții etc.)
- Șablon: Notificare : În mod normal, șabloanele de notificare din intrările și paginile serviciului se bazează pe aceasta
- Ajutor: diagramă șablon (cu excepția celor sinoptice, tematice și de navigare)
- Ajutor: manuale șablon
- Ajutor: Incluziune
- Ajutor: funcții de analizor (pentru variații dinamice, cum ar fi în programare)
- Ajutor: Module (programare efectivă)
- Ajutor: Stiluri de șabloane (pentru stiluri CSS specifice)
- Wikipedia: Șablon de navigare
- Wikipedia: Șabloane sinoptice
- Categorie: șablon
- m: spațiu de nume MediaWiki (link către Meta-Wiki)
- m: MediaWiki 1.3 comentarii și rapoarte de erori # Erori legate de șabloane (link către Meta-Wiki)
- m: foaia de parcurs MediaWiki # Sintaxa șablonului (link către Meta-Wiki)
- m: Înlocuirea mesajului (link către Meta-Wiki)
- m: Ajutor: Șabloane avansate (link către Meta-Wiki)
Alte proiecte
-
Wikicitată conține citate din sau pe Ajutor: șablon
-
Wikibooks conține texte sau manuale despre Ajutor: șablon
-
Wikiversitatea conține resurse despre Ajutor: Șabloane
-
Wikimedia Commons conține imagini sau alte fișiere din Ajutor: șablon
-
Meta-Wiki conține informații despre Ajutor: Șabloane
-
Wikivoyage conține informații turistice despre Ajutor: Șabloane