Cimitero:Aiuto:Manuale/Creazione template (visualizza wikitesto)
Versione delle 00:17, 6 mar 2011
, 13 anni fanessun oggetto della modifica
MFHbot (rosica | curriculum) m (Bot: tentativo fallito #2) |
Nessun oggetto della modifica |
||
Riga 24:
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 />
Riga 36:
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 ⟶ 42:
{{quote|{{Template|Quote}} è un template, ma '''non è un riquadro'''}}
{| width="100%
|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 ⟶ 49:
=== 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: se hai un'idea per uno nuovo, parlane prima con gli altri utenti per assicurarti che ce ne sia davvero bisogno. Nel 99,999% dei casi si può ricorrere ai template già esistenti (ad esempio {{Template|Restauro}} ) oppure - meglio ancora - alle pagine di discussione. E comunque,
;Template per sfottere/minacciare i niubbi:Basta! Ce ne sono a trigliaia!
;Doppioni di template già esistenti:Per ovvî motivi
Line 61 ⟶ 60:
== 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. Comunque non è difficile, in una pagina, lasciare degli spazi tra un template e l'altro con il tag
===
* Il codice compreso tra '''
'''<nowiki><noinclude>{{</nowiki>cat|''Nome categoria''}}<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 t., questi parametri verranno richiamati con i nomi
Esempio: supponiamo che ''Template:Pappappero'' contenga il codice
<nowiki>::
<noinclude>{{cat|template citazione}}</noinclude></nowiki>
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>.
Line 129 ⟶ 128:
== 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" [[File:Button box.png]] al tuo editor in modo da generare rapidamente un codice base di partenza. Vedi '''[[Aiuto:Preferenze]]''' per sapere come fare.
Line 146 ⟶ 147:
Un'altra sintassi per creare dei riquadri si basa sul tag
<nowiki><div</nowiki> ''parametri''>
''contenuto''
Line 154 ⟶ 155:
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 css come [http://css.html.it/guide/leggi/2/guida-css-di-base/ questa], oppure dai un'occhiata ai codici dei template già esistenti. Qui troverai solo l'essenziale.
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 />
Invece per posizionare il riquadro '''al centro''' useremo la sintassi
margin-left: auto; margin-right: auto;
(v. anche <code>[[{{FULLPAGENAME}}#margin|margin]]</code>)
Con "div" non funziona se non si specifica una larghezza con <code>[[{{FULLPAGENAME}}#width|width]]</code>.
==== ''background'' ====
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]].
==== ''color'' ====
Definisce il '''colore del testo'''. Questo parametro però
==== '''font-size''' ====
Modifica la dimensione del testo. Può avere valori in pixel, pt, em
==== ''border'' ====
Gestisce i '''bordi'''. ''border'' ha 3 proprietà: spessore, stile e colore. Lo
{|cellspacing="6" style="float: center;"
|style="border: solid"|solid
|style="border: dotted"|dotted
Riga 195:
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, viene generata in automatico in base all'ampiezza del testo.
==== ''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''.
=== Classi ===
Le classi contengono delle impostazioni preformate, e talvolta delle funzionalità avanzate scritte in javascript. Per attivarle si utilizza il parametro
==== radius ====
| |||