56 487
contributi
Zaza (rosica | curriculum) m (→Template da NON creare: tolto carattere assurdo) |
Wedhro (rosica | curriculum) (rimozione template decorativi obsoleti) |
||
(31 versioni intermedie di 7 utenti non mostrate) | |||
Riga 4:
E così vorresti imparare a creare dei template? Tu? Con quella faccia?<br />
==Prima di iniziare==
Riga 11:
Esempio pratico: consideriamo il [[Template:Paranormale]]. Se in una pagina scrivo:
<nowiki>{{Paranormale}}</nowiki>
il contenuto del
=== [[:categoria:template|Categorie di template]] ===
Line 18 ⟶ 17:
* '''Template parametrici.''' Contengono codice che si adatta per ogni pagina. In particolare abbiamo le categorie di template [[:categoria:Utility templates|di sistema]], [[:categoria:template di servizio|di servizio]], [[:categoria:template di collegamento|di collegamento]] e [[:categoria:template citazione|di citazione]]
* '''[[:categoria:Template di sezione|Template di navigazione]].''' Raggruppano tutte le pagine di un certo tipo.
* '''Template di abbellimento.''' [[:categoria:Template galleggianti|
* '''[[:categoria:template di avviso|Avvisi]].''' Segnalano un problema relativo alla pagina, e generalmente inseriscono una categoria di manutenzione nell'articolo in cui vengono piazzati.
=== Tipologie di template ===
Quando creerai il tuo template Wikia (non noi!) ti farà apparire un rompicoglionissimo avviso di scegliere una '''tipologia'''. Non c'entra un cazzo con le categorie, è solo un modo per far capire ai server '''come visualizzare il template in versione mobile''', una cosa fondamentale per non imputtanare l'uso del sito con dispositivi manovrati a ditate. Se non scegli una tipologia corretta gli articoli saranno una schifezza da leggere in mobile, quindi studiati [[Aiuto:Tipologie di template]] e scegli bene.
=== Cosa non è un template ===
Un riquadro non è un template.<br />
Aspetta, forse non è chiaro, te lo ripeto.<br />
Sicuro di aver capito? No, non posso fidarmi, devo essere certo che ti entri in testa.<br />
Un riquadro '''non è''' un template<br />▼
Un riquadro '''non è''' un template<br />
Un riquadro '''non è''' un template<br />
Line 37 ⟶ 38:
Un riquadro '''non è''' un template<br />
Un riquadro '''non è''' un template<br />
▲Un riquadro '''non è''' un template<br />}}
Mmm no, mi sa che non hai ancora capito. Meglio se ti faccio un esempio.
Line 43 ⟶ 44:
{{quote|{{Template|Quote}} è un template, ma '''non è un riquadro'''}}
{|
|Questo è un riquadro, ma '''non è un template'''. Non lo è perché il codice che lo genera si trova in questa stessa pagina, non in una pagina separata ''Template:Vattelapesca''.
|}
Line 50 ⟶ 51:
=== Template da NON creare ===
;Riquadri che devono apparire su un solo articolo:
;Riquadri per la propria pagina utente: come sopra.
;Avvisi: Abbiamo già decine di template di avviso
;Template per sfottere/minacciare i niubbi: Basta! Ce ne sono a trigliaia!
;Doppioni di template già esistenti: Per ovvi motivi
;Template che violano le [[Linee guida]]: Ad
===Esperimenti===
Line 61 ⟶ 62:
== Codice dei template ==
Come già detto, il sistema integra il codice del template nelle pagine in cui è incluso. Questo può portare a degli inconvenienti: sovrapposizioni, sovraccarichi, bug ecc. Per questo è bene fare attenzione quando si scrive il codice di un template.
===
* Il codice compreso tra '''
'''<nowiki><noinclude>{{</nowiki>
* ''includeonly'' funziona esattamente al contrario: il codice compreso tra '''
=== Parametri ===
<nowiki>{{pappappero|</nowiki>'''''valore 1''|a=''valore a''|''valore 2'''''}}
In questo esempio il template viene evocato con tre parametri, di cui uno nominale ("a"). Nel codice del
Esempio: supponiamo che ''Template:Pappappero'' contenga il codice
<nowiki>::
<noinclude>{{
Una chiamata
<nowiki>{{pappappero|a=un
produrrà
::
Come puoi notare
# i parametri sono normale testo wiki con normale formattazione wiki (come il 2).
# può essere specificato un valore predefinito che compaia nel caso che il parametro non venga chiamato (es: il valore predefinito di
# nella chiamata del template i parametri nominali possono essere inseriti in qualsiasi ordine, mentre quelli numerici vanno inseriti in ordine numerico<ref>Però anche i parametri numerici possono essere chiamati in un ordine casuale con la sintassi ''1=..., 2=... ecc''</ref>.
Se nel template scrivi {{tt|<nowiki>{{{</nowiki>''parametro''}}}}}, il parametro è da inserire obbligatoriamente, altrimenti si vedrà la scritta {{tt|<nowiki>{{{parametro}}}</nowiki>}} all'interno del template. Se invece scrivi {{tt|<nowiki>{{{</nowiki>''parametro''{{!}}}}}}}, il parametro è opzionale, quindi compare solo se viene specificato. Infine, come già detto, se scrivi {{tt|<nowiki>{{{</nowiki>''parametro''{{!}}''valore di default''}}}}} se non viene specificato nulla viene usato il valore di default. '''Pensa bene a quando usare uno dei tre casi!'''
=== Variabili e funzioni parser ===
{|class="wikitable"
!style="width: 30%;"|Funzione
!|Spiegazione
|-
!|<nowiki>{{PAGENAME}}</nowiki>
||Il titolo della pagina: {{PAGENAME}}.
|-
!|<nowiki>{{FULLPAGENAME}}</nowiki>
||Il nome completo della pagina: {{FULLPAGENAME}}.
|-
!|<nowiki>{{TALKPAGENAME}}</nowiki>
||La discussione della pagina: {{TALKPAGENAME}}.
|-
||'''<nowiki>{{fullurl:</nowiki> ''Pagina'' |action=edit}}'''
||Un link alla modifica della pagina 'Pagina' (che può anche essere <nowiki>{{FULLPAGENAME}} o {{TALKPAGENAME}}</nowiki>)
|-
||'''<nowiki>{{lc:</nowiki>
'''<nowiki>{{uc:</nowiki>
'''<nowiki>{{lcfirst:</nowiki>
'''<nowiki>{{ucfirst:</nowiki>
||testo a caso (tutto il testo diventa in minuscolo)<br />
TESTO A CASO (tutto il testo diventa in maiuscolo)<br />
testo a Caso (la prima lettera diventa minuscola)<br />
Testo a Caso (la prima lettera diventa maiuscola)
|-
||'''<nowiki>{{#if:</nowiki>'''
||Se il parametro 1 ha un valore non nullo compare il testo 'A', altrimenti il testo 'B'.
|-
||'''<nowiki>{{#ifeq:</nowiki>'''
||Se il namespace della pagina è nullo (cioè è un articolo) compare il testo 'A', altrimenti viene chiamato il template 'B'.
|-
||'''<nowiki>{{#switch:
||Restituisce un valore a seconda del parametro 'nazione' ("Italiano" per "Italia", "Tedesco" per "Germania" e "Austria", "Altre lingue" per altri valori). Notare che il parametro viene passato attraverso <nowiki>{{
|}
Line 129 ⟶ 134:
== Riquadri ==
<div style="width: 70%; margin-left: auto; margin-right: auto; border: 3px dashed black; font-size: 120%; padding: 2px; text-align: center;">'''NB.''' Esiste già un comodo e completo template per creare dei riquadri: si chiama appunto {{Template|Riquadro}}. Utilizza il codice grezzo solo se non puoi ottenere un risultato equivalente con quel template.</div>
Se hai intenzione di creare molti template, ti consiglio di aggiungere il pulsante "box" [[Immagine:Button box.png]] al tuo editor in modo da generare rapidamente un codice base di partenza. Vedi '''[[Aiuto:Preferenze]]''' per sapere come fare.▼
▲Se hai intenzione di creare molti template, ti consiglio di aggiungere il pulsante "box" [[
=== Generale ===
Solitamente i riquadri (detti anche box) vengono generati con il markup delle '''tabelle''', per cui ti invito fortemente a leggere anche la '''[[Aiuto:Formattazione avanzata#Tabelle|guida delle tabelle]]'''.<br />
Il codice generico per una tabella è
<nowiki>{|</nowiki>''parametri''
Line 145 ⟶ 152:
|}
{{Dimensione|150%|Ricorda che le tabelle servono per tabulare dati!|div}}
Per strutturare dei template, è preferibile usare il template {{Template|Riquadro}} o il sistema spiegato qui sotto.
Un'altra sintassi per creare dei riquadri si basa sul tag
<nowiki><div</nowiki> ''parametri''>
''contenuto''
<nowiki></div></nowiki>
"div" è consigliato per fare i riquadri a scatole cinesi (l'uno dentro l'altro)
I parametri delle tabelle e di "div" sono pressappoco gli stessi, e a loro volta sono praticamente identici a quelli dei fogli di stile. Per cui, se te li vuoi smaronare tutti leggiti una guida ai
La sintassi di tutti i parametri è <code>'''parametro = "valore"'''</code>. È da notare che
===
Dà la '''larghezza del riquadro'''. Può essere una percentuale riferita alla larghezza della pagina oppure una dimensione assoluta, in pixel (es. <code>"120px"</code>). Se non viene specificata, viene generata in automatico in base all'ampiezza del testo.<br />▼
Ecco il segreto di tutta la magia: ''style'' raggruppa un numero abominevole di attributi che definiscono l'aspetto del riquadro fin nei minimi dettagli. La sintassi di ''style'' è:
'''style="'''attributo1''':'''valore''';''' attributo2''':'''valore''';''' ....'''"'''
====
Per gestire la posizione '''a destra o a sinistra''' si utilizza l'attributo <code>'''''float:''' left/right''</code><br />
Determina il '''colore di sfondo'''. In questo attributo, come in tutti quelli relativi ai colori, possono essere utilizzati sia i nomi standard (es: <code>background: red;</code>) sia i codici RGB (es: <code>background: #d0d0f0;</code>). Per saperne di più consulta la [[Aiuto:Colori|guida apposita]].▼
Invece per posizionare il riquadro '''al centro''' useremo la sintassi
margin: 0.5em auto;
(vedi anche <code>[[{{FULLPAGENAME}}#margin|margin]]</code>)
Con "div" non funziona se non si specifica una larghezza con <code>[[{{FULLPAGENAME}}#width|width]]</code>.
==== ''background-color'' ====
▲Determina il '''colore di sfondo'''. In questo attributo, come in tutti quelli relativi ai colori, possono essere utilizzati sia i nomi standard (es: <code>background-color: red;</code>) sia i codici RGB (es: <code>background-color: #d0d0f0;</code>). Per saperne di più consulta la [[Aiuto:Colori|guida apposita]].
==== ''color'' ====
Definisce il '''colore del testo'''. Questo parametro però <u>non influenza i collegamenti</u>, a meno che non si utilizzi la class ''link-inherit-color'', in questo modo:
In alternativa, per modificare il colore di un singolo collegamento, usa il template {{Template|Colore}}.
==== ''font-size'' ====
Modifica la dimensione del testo. Può avere valori in pixel,
==== ''border'' ====
Gestisce i '''bordi'''. ''border'' ha 3 proprietà: spessore, stile e colore. Lo
{|style="width: auto; margin: 0.5em auto; border-spacing: 6px;"
|style="border: solid;"|solid
|style="border: dotted;"|dotted
|style="border: dashed;"|dashed
|style="border: double;"|double
|style="border: ridge;"|ridge
|style="border: groove;"|groove
|style="border: inset;"|inset
|style="border: outset;"|outset
|none
|}
Esempi:
<nowiki>style="... border: 2px solid #
style=" ... border: 0.25em outset blue; ..."
style=" ... border: thin dashed maroon; ..."</nowiki>
==== ''text-align'' ====
Imposta
==== ''width'' ====
▲Dà la '''larghezza del riquadro'''. Può essere una percentuale riferita alla larghezza della pagina oppure una dimensione assoluta, in pixel (es. <code>"120px"</code>). Se non viene specificata
* la tabella avrà una larghezza automatica in base al contenuto
* il ''div'' avrà una larghezza del 100%. Per far sì che la dimensione sia calcolata in automatico bisogna dare a ''width'' valore ''auto''.
==== ''height'' ====
Il corrispondente verticale di ''width''.
==== ''margin'' ====
Imposta la '''distanza tra il bordo del riquadro e gli elementi all'esterno''' nella pagina. Generalmente è espresso in pixel (es: <code>margin: 4px;</code>) o in em (es: <code>margin: 0.5em;</code>). Puoi anche specificare separatamente i margini per ciascun lato, scrivendo <code>margin-top: ... ; margin-bottom: ... ; margin-left: ... ; margin-right: ... ;</code>
==== ''padding'' ====
Imposta la '''distanza tra il bordo del riquadro e il contenuto all'interno'''. Funziona esattamente come ''margin''.
==== ''clear'' ====
Se noti che il template ha la tendenza a sovrapporsi con delle immagini o con altri template, puoi inserire ''clear: both;'', in modo da evitare che oggetti fluttuanti (ovvero che hanno la proprietà <code>[[{{FULLPAGENAME}}#Allineamento_orizzontale|float]]</code> impostata) si sovrappongano. Altri valori possono essere <code>left</code> e <code>right</code>, che impediscono rispettivamente la presenza di oggetti fluttuanti a sinistra e a destra.<br />
{{Dimensione|130%|'''Evita'''}} il più possibile l'uso di <nowiki><br style="clear: both;" /></nowiki>, o peggio ancora <nowiki><br clear="all" /></nowiki>, poiché lo scopo del tag <nowiki><br /></nowiki> è mandare a capo una riga, non separare due riquadri.
=== Classi ===
Le classi contengono delle impostazioni preformate, e talvolta delle funzionalità avanzate scritte in javascript. Per attivarle si utilizza il parametro
==== radius ====
La classe "radius" permette di generare delle caselle dai margini arrotondati, come questa:
<div class="
== Template di navigazione e template a scomparsa==
I template di navigazione sono essenzialmente dei riquadri che contengono dei collegamenti alle stesse pagine in cui sono inclusi (fungono da indice). Molti di essi sono "a scomparsa", cioè visualizzano il loro contenuto solo se vengono attivati da un click.
Ci sono due modi per creare dei
# utilizzare il template {{Template|Cassetto}}
# aggiungere la class "collapsible" alla tabella:
<nowiki>{|<
'''{{colore|#f00|!}} Titolo della tabella''' (unica cosa visibile quando è collassata)
'''{{colore|#f00||-}}'''
▲ <nowiki><div class="NavContent" style="...">
|.....
|}
== Template galleggianti ==
Sono template che si posizionano sullo schermo in modo indipendente rispetto al resto della pagina, e non scorrono con essa ("galleggiano"). Vanno creati '''con molta cautela''' e senza esagerare, o possono risultare estremamente fastidiosi. Il codice grezzo per crearli è:
<nowiki><div style="position: fixed; right: ...px; bottom: ...px; overflow: visible;">
[[
<div style="position:absolute; right: ...px; bottom:...px; overflow: hidden">Testo
</div>
</div>
Line 249 ⟶ 264:
== Note ==
{{Note}}
{{tutorial}}
|