Documentatio formulae

Descrizione recensere

Il template costituisce un'alternativa al marckup File: per la visualizzazione delle immagini; l'idea è di en:User:George Orwell III. Inserisce l'immagine in un "box primario", visualizzabile a destra, a sinistra, centrato o "centrato-flottante", e di integrare facilmente nel box una didascalia, il cui stile può essere finemente regolato.

L'opzione "centrato-flottante" permette di visualizzare un'immagine centrata, che non interrompe il flusso del testo.

Attenzione
L'opzione "centrato-flottante" richiede CSS3. L'esportazione in ePub funziona correttamente ma richiede un lettore di ePub abilitato a CSS3 (ePub3).

Uso recensere

  • Per favore usate sempre l'abbreviazione per FreedImg, {{FI}}, piuttosto che il nome per esteso.
{{FI
 | type          = opzionale 
 | file          = obbligatorio
 | tsize         = opzionale; dimensioni dell'immagine ridotta, in pixel; default 450px
 | width         = opzionale; default 100%
 | cclass        = opzionale; classe del contentore primario, default floatnone
 | float         = opzionale; default center; valori ammessi left|right|center|floating-center
 | margin-left   = opzionale; default 1em; lasciare vuoto se floating-center
 | margin-right  = opzionale; default 1em; lasciare vuoto se floating-center
 | margin-top    = opzionale; default 1em
 | margin-bottom = opzionale; default 1em
 | clear         = opzionale; default nessuno
 | header        = opzionale; titolo in alto
 | hstyle        = opzionale: stile del titolo
 | halign        = opzionale; allineamento del titolo, default center
 | caption       = opzionale; didascalia
 | talign        = opzionale; allineamento della didascalia, default center
 | indent        = opzionale; indentatura della didascalia
 | tstyle        = opzionale: stile della didascalia
 | talign        = opzionale; allineamento della didascalia, default center
 | alt           = opzionale; default nessuno
 | link          = opzionale; parametro link come da markup standard
}}

Parametri recensere

per l'mmagine
  • file: Il nome del file (senza il prefisso "File:") (parametro obbligatorio)
    • alt: Testo alternativo per l'immagine, cioè per il box di testo al passaggio del mouse o per l'uso su un lettore di schermo per gli ipovedenti)

Al momento non vi è la possibilità di utilizzare l'immagine come link utilizzando il parametro|link=.

quando ( type=user ) è presente e contiene un valore
  • Il codice per le immagini generate da alcune estensioni (es. the default <math> User preference, <score>, etc.) può essere inserito al posto del file.
Contenitore SPAN (tipo inline-block) primario
  • width: la larghezza del contenitore primario in percentuale (present, variable, default 100%). Fortemente consigliato l'uso della misura espressa come percentuale (viene calcolata come percentuale del box testo corrente).
  • cclass: La classe del contenitore primario, (presente, modificabile, default floatnone [un nome di classe indefinito che serve unicamente come segnaposto])
  • float: L'allineamento del contenitore primario (non presente; deve essere aggiunto, le opzioni sono "left" or "right"; altrimenti l'immagine risulta centrata).
  • clear: I margini del contenitore primario da collassare (non presente; deve essere aggiunto, le opzioni sono "left", "right" or "both").
  • margin-left,margin-right : Ogni margine speciale da applicare al contenitore primario (default adatto alla posizione centrata). Vedi sotto una alternativa più utile.
    • per generare un'immagine centrata, conservando la continuità del testo sopra e sotto l'immagine, esprimere width, margin-left e margin-right in percentuale, con valori tali che la somma dia 100%, e porre float = left oppore float = right.
Didascalia
  • caption: La didascalia (assente; deve essere aggiunto).
  • tstyle,talign: Qualsiasi stile o allineamento speciale da aggiungere al blocco della didascalia (se presente).
  • mleft,indent: Ogni contollo di flow del testo da ap licare alla didascalia (se presente).
Intestazione
  • header: La didascalia (assente; deve essere aggiunto).
  • hstyle: Qualsiasi stile o allineamento speciale da aggiungere al blocco dell'intestazione (se presente).
  • halign: Ogni contollo di allineamento del testo da aplicare all'intestazione (se presente).