Ajutor: șablon

De la Wikipedia, enciclopedia liberă.
Salt la navigare Salt la căutare
TIPURI DE PAGINĂ
Element · Fir ( Bara )
Categorie · Portal
Fișier ( imagine · sunet )
Pagina de servicii
Șablon · Ghid
Proiect · Pagina utilizatorului
Modul
Toate spațiile de nume
Abrevieri
WP: TL
WP: Tl

Î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 .

Gnome-help.svg - Birou de informare

Inserare

Pictogramă lupă mgx2.svg Același subiect în detaliu: Ajutor: Includere .
Exemplu de includere

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:

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

Curly Brackets.svg

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

Pictogramă lupă mgx2.svg Același subiect în detaliu: Ajutor: purjare .

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 :)

Pictogramă lupă mgx2.svg Același subiect în detaliu: Ajutor: 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 Italia
Și
{{flag | ITA | name}} <noinclude> {{Protected}} [[Category: National flag templates]] [[fr: Model: Italie]] </noinclude>

Căutare combinată

Exquisite-kfind.png Arborele categoriilor referitoare la șabloane
(pagini cu caractere cursive )

Exquisite-kfind.png Căutați în spațiul de nume Șablon


Notă

  1. ^ 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 .
  2. ^ 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

Alte proiecte

șablon Proiect șablon : colaborați cu Wikipedia la subiectul șablon