Template:Stv

Da Wikisource.
[visualizza] [modifica] Documentazione


(questa pagina è transclusa da Template:Stv/doc)

Descrizione[modifica]

Il template è collegato a Modulo:StyleVoc e permette di concatenare un numero qualsiasi di espressioni di stile (coppie proprietà-valore) o di loro abbreviazioni mnemoniche in un'espressione complessiva corretta.

  • Ogni abbreviazione può essere costituita da una singola espressione, o da una sequenza di espressioni separate da punto e virgola.
  • Le abbreviazioni sono facilmente memorizzate all'interno di una tabella di Modulo:StyleVoc.
  • Dal punto di vista pratico, ogni abbreviazione si comporta come una classe css, costituendo un "nome" per una o più espressioni di stile.
  • La lista di abbreviazioni o di espressioni viene semplicemente passata al template come lista di parametri.
  • Il template può essere passato come valore di parametro nei template che accettano espressioni di stile (Cs, Ct, Type, Left, Blocco a destra.......)

Uso del template[modifica]

Un comune problema nelle opere a formattazione complessa (es. titoli di vari livelli; blocchi di testi a destra con font particolare per citazioni; separatori di testo) è la definizione di codice omogeneo da applicare in tutta l'opera. Il problema si può risolvere con combinazioni precise di template annidati, riportati in Discussione pagina, con template opera-specifici o con altri accorgimenti. Stv permette di risolvere il problema con un unico template, e un unico parametro. Variando il codice associato all'abbreviazione-parametro, si adegua la formattazione in tutti i casi in cui il template è stato utilizzato (comportamento "tipo classe").

La compattezza e la regolarità nella struttura del template potrebbe facilitare la rilettura, spesso ostacolata dalla presenza di codice di formattazione "pesante".

Esempi[modifica]

Abbreviazioni semplici
  • {{stv|center}} -> text-align:center;
  • {{stv|center|smaller}} -> text-align:center;font-size:83%;
Abbreviazioni complesse
  • {{stv|titolo1}} -> font-size:175%;margin-top:3pc; margin-bottom:1.5pc; font-weight:bold;

Integrazione in template comuni[modifica]

Il template può essere integrato nel codice di template comuni; in questo caso il template "genitore" accetta direttamente l'abbreviazione come parametro, e chiama il template Stv con codice interno.

Una prima integrazione è stata effettuata nel comunissimo template Centrato, dove l'abbreviazione viene inserita come valore del parametro sv. Tenendo conto che il template Centrato prevede un parametro s dove può essere passata un'espressione di stile non abbreviata queste possibilità sono equivalenti:

{{Centrato|'''Prova'''}}

Prova

{{Centrato|s=font-weight:bold|Prova}}

Prova

{{Centrato|s={{stv|bold}}|Prova}}

Prova

{{Centrato|sv=bold|Prova}}

Prova

L'abbreviazione di una serie di dichiarazioni chiarisce i vantaggi, perchè definisce margine superiore e inferiore, grassetto, dimensione del testo con una sola parola:

{{Centrato|sv=titolo1|Prova}}

Il primo paragrafo....

Prova

Il primo paragrafo....

Approfondimento[modifica]

Vedi Modulo:StyleVoc.