Differenze tra le versioni di "Template:Cassetto/man"

Da Wikimedia Italia.
Jump to navigation Jump to search
m (una revisione importata: template cassetto)
 
(import da Wikipedia versione 93863137 del 15 gen 2018 alle 15:28 https://it.wikipedia.org/w/index.php?title=Template:Cassetto/man&oldid=93863137)
 
(Una versione intermedia di un altro utente non mostrate)
Riga 1: Riga 1:
−
Questo template è utilizzato per creare i cosiddetti cassettamenti, ovvero delle sezioni a scomparsa per migliorare la fruibilità e l'ordine di alcune pagine, in casi particolari. '''L'uso dei cassetti nelle voci è sconsigliato''' ([[Discussioni_aiuto:Manuale_di_stile/Archivio/3#Non_usare_i_cassetti_nelle_voci|v. disc.]]), pertanto questo template andrebbe utilizzato prevalentemente nelle discussioni, nelle pagine utente o altre pagine di servizio.  
+
Questo template è utilizzato per creare i cosiddetti cassettamenti, ovvero delle sezioni a scomparsa per migliorare la fruibilità e l'ordine di alcune pagine, in casi particolari. '''L'uso dei cassetti nelle voci è sconsigliato''' (v. [[Discussioni_aiuto:Manuale_di_stile/Archivio/3#Non_usare_i_cassetti_nelle_voci|disc.1]], [[Discussioni_aiuto:Manuale_di_stile#Benedetti_cassetti|disc.2]]), pertanto questo template andrebbe utilizzato prevalentemente nelle discussioni, nelle pagine utente o altre pagine di servizio.  
  
−
{{vedi anche|Aiuto:Manuale di stile#Cassetti}}
+
Nelle voci i cassetti dovrebbero essere limitati ai template di navigazione (realizzati generalmente non con il template Cassetto, ma con il [[template:Navbox]]), che non fanno parte del contenuto enciclopedico. Il motivo è che i cassetti danno problemi di accessibilità, non funzionano nella stampa, fanno sembrare la pagina più leggera ma in realtà appesantiscono il download, tolgono ingiustamente rilievo. Se l'informazione è enciclopedica ha tutto il diritto di prendere il necessario spazio, mentre se la vogliamo "nascondere" forse non è così enciclopedica. Se una pagina diviene pesante, pensare piuttosto a uno [[aiuto:scorporo|scorporo]]; se si vuol risparmiare spazio, sfruttare meglio le sezioni o le [[Aiuto:Manuale di stile#Colonne|colonne]].
  
 
== Sintassi ==
 
== Sintassi ==
Riga 17: Riga 17:
 
{{parametro|affiancabile|F|commento="si" o lasciare vuoto}}
 
{{parametro|affiancabile|F|commento="si" o lasciare vuoto}}
 
{{parametro|senzabordo|F|commento="si" o lasciare vuoto}}
 
{{parametro|senzabordo|F|commento="si" o lasciare vuoto}}
 +
{{parametro|aperto|F|commento="si" o lasciare vuoto}}
 
}}
 
}}
  
 
;titolo<ref name="numerici">''titolo'' e ''testo'' possono, a differenza degli altri parametri, anche non essere esplicitati; in questo caso basta scrivere <nowiki>{{</nowiki>cassetto|''titolo''|''contenuto''<nowiki>}}</nowiki>. Ricorda però che in alcuni casi, ad esempio per la presenza di un [[WP:LINK|collegamento esterno]], tale sistema NON funziona e il cassetto non si apre. </ref>: '''obbligatorio'''. il titolo che deve apparire nella cornice superiore
 
;titolo<ref name="numerici">''titolo'' e ''testo'' possono, a differenza degli altri parametri, anche non essere esplicitati; in questo caso basta scrivere <nowiki>{{</nowiki>cassetto|''titolo''|''contenuto''<nowiki>}}</nowiki>. Ricorda però che in alcuni casi, ad esempio per la presenza di un [[WP:LINK|collegamento esterno]], tale sistema NON funziona e il cassetto non si apre. </ref>: '''obbligatorio'''. il titolo che deve apparire nella cornice superiore
  
−
;testo<ref name="numerici"/>: '''obbligatorio'''. il contenuto visualizzato quando il cassetto è ''aperto'', può benissimo contenere testo [[Aiuto:Tutorial/Formattazione|formattato]] secondo le convenzioni di Wikipedia
+
;testo<ref name="numerici"/>: '''obbligatorio'''. il contenuto visualizzato quando il cassetto è ''aperto'', può benissimo contenere testo [[Aiuto:Tour_guidato/Tutorial_5-2|formattato]] secondo le convenzioni di Wikipedia
  
 
; larghezza=: La larghezza del riquadro espressa in [[pixel]] o in percentuale; se non espresso assume la larghezza della pagina
 
; larghezza=: La larghezza del riquadro espressa in [[pixel]] o in percentuale; se non espresso assume la larghezza della pagina
 
:*''Pixel''. Assumerà la dimensione pari al numero di pixel indicati; la cifra va fatto seguire da "px", es. 10px
 
:*''Pixel''. Assumerà la dimensione pari al numero di pixel indicati; la cifra va fatto seguire da "px", es. 10px
−
:*''percentuale''. la larghezza varierà a secondo della larghezza della pagina secondo la percentuale indicata la cifra va fatta seguire da "%", es. 30%
+
:*''percentuale''. la larghezza varierà a secondo della larghezza della pagina secondo la percentuale indicata la cifra va fatta seguire da "%", es. 30%
  
−
;livello=: Serve per specificare se si desidera che il cassetto sia una sezione o una sottosezione a sé nella pagina a quale livello di [[Aiuto:Sezioni|sezione]] corrisponde il titolo della finestra. Il livello di sezione va indicato scrivendo il numero di uguali che è necessario mettere davanti al titolo della sezione per ottenere quel livello normalmente in wikipedia (ad esempio <nowiki>== Intestazione ==</nowiki> corrisponderà a <tt>livello=2</tt>). Nota: inserire il livello o cambiarlo non ha alcun effetto grafico. Serve solo a strutturare meglio la pagina da un punto di vista logico.
+
;livello=: Serve per far sì che il cassetto appaia nell'indice come se fosse una [[Aiuto:Sezioni|sezione]]. Il livello di sezione va indicato scrivendo il numero di "=" che è necessario mettere davanti al titolo della sezione per ottenere quel livello normalmente in wikipedia (ad esempio <nowiki>== Intestazione ==</nowiki> corrisponderà a <kbd>livello=2</kbd>). Nota: non ha alcun effetto grafico sul cassetto stesso.
  
 
; colore=: Il colore dello sfondo del rettangolo che contiene il titolo, indicato con [[Aiuto:Tavolozza_dei_colori|questi codici]].
 
; colore=: Il colore dello sfondo del rettangolo che contiene il titolo, indicato con [[Aiuto:Tavolozza_dei_colori|questi codici]].
Riga 33: Riga 34:
 
;coloresfondo=: Il colore di fondo della parte visibile quando la finestra è aperta, indicato con [[Aiuto:Tavolozza_dei_colori|questi codici]].
 
;coloresfondo=: Il colore di fondo della parte visibile quando la finestra è aperta, indicato con [[Aiuto:Tavolozza_dei_colori|questi codici]].
  
−
; allineamento=: Indica la posizione del template rispetto la pagina, può assumere solo due valori: ''destra'' o ''sinistra''; se non specificato il template viene visualizzato al centro
+
; allineamento=: Indica la posizione del template rispetto la pagina, può assumere solo due valori: ''destra'' o ''sinistra''; se non specificato il template viene visualizzato al centro.
  
−
;affiancabile=: Rende il riquadro affiancabile da altri riquadri (div) circostanti, come ad esempio il babelbox. È utile quando si vogliono integrare un cassetto con altri riquadri uno affianco all'altro. Inserire "si" o lasciare vuoto
+
;affiancabile=: Rende il riquadro affiancabile da altri riquadri (div) circostanti, come ad esempio il babelbox. È utile quando si vogliono integrare un cassetto con altri riquadri uno a fianco all'altro. Inserire "si" o lasciare vuoto.
  
−
;senzabordo=: Elimina il bordo del riquadro per avere una continuità con la formattazione circostante. Si usa in situazioni complesse, ad esempio quando il cassetto fa parte di una struttura più grande. Inserire "si" o lasciare vuoto
+
;senzabordo=: Elimina il bordo del riquadro per avere una continuità con la formattazione circostante. Si usa in situazioni complesse, ad esempio quando il cassetto fa parte di una struttura più grande. Inserire "si" o lasciare vuoto.
 +
 
 +
;aperto=: Il cassetto viene inserito inizialmente aperto, anziché inizialmente chiuso. Inserire "si" o lasciare vuoto.
  
 
<references/>
 
<references/>
Riga 92: Riga 95:
 
{{Cassetto
 
{{Cassetto
 
|colore=red
 
|colore=red
−
|titolo=<span style="color:white">Apri il cassetto per vedere il testo...</span>
+
|titolo={{colore|white|Apri il cassetto per vedere il testo...}}
 
|testo=...chiudi il cassetto per nascondere il testo.
 
|testo=...chiudi il cassetto per nascondere il testo.
 
}}
 
}}
Riga 99: Riga 102:
 
{{Cassetto
 
{{Cassetto
 
|colore=red
 
|colore=red
−
|titolo=<span style="color:white">Apri il cassetto per vedere il testo...</span>
+
|titolo={{colore|white|Apri il cassetto per vedere il testo...}}
 
|testo=...chiudi il cassetto per nascondere il testo.
 
|testo=...chiudi il cassetto per nascondere il testo.
 
}}
 
}}
Riga 105: Riga 108:
 
----
 
----
  
−
==Note importanti==
+
Esempio del parametro livello; questo cassetto con <kbd>livello=3</kbd> compare nell'indice a inizio pagina come se fosse una sezione (o meglio una sottosezione della sezione Esempi, che è di livello 2).
 +
{{Cassetto
 +
|titolo=Esempio di cassetto-sezione
 +
|testo=...chiudi il cassetto per nascondere il testo.
 +
|livello=3
 +
}}
 +
 
 +
== Note importanti ==
  
−
* L'inserimento di [[aiuto:Tabelle|tabelle]] nel cassetto dà problemi a causa della presenza di "<code>|</code>". Per risolverli usare {{tl|cassetto inizio}}, oppure sostituire le | con {{tl|!}}, oppure substare il Cassetto (vedi la sezione [[#Istruzioni per il subst|Istruzioni per il subst]]).
+
* L'inserimento di [[aiuto:Tabelle|tabelle]] nel cassetto dà problemi a causa della presenza di "<code>|</code>". Per risolverli usare {{tl|cassetto inizio}}, oppure sostituire le | con <nowiki>{{!}}</nowiki>.
  
 
* Se il testo contiene degli "<code>=</code>" (uguale), ad esempio titoli di sezione come <code>== Titolo ==</code> o URL complessi, la sintassi anonima non funziona. Esplicitare il parametro ''<code>|testo=</code>'' (oppure ''<code>|2=</code>'').
 
* Se il testo contiene degli "<code>=</code>" (uguale), ad esempio titoli di sezione come <code>== Titolo ==</code> o URL complessi, la sintassi anonima non funziona. Esplicitare il parametro ''<code>|testo=</code>'' (oppure ''<code>|2=</code>'').
  
−
=== Istruzioni per il subst ===
+
== Template correlati ==
−
Se desideri [[Aiuto:Subst|substare]] il template
 
−
# Compila il template con i parametri desiderati, ma:
 
−
## substando il template, ovvero scrivendolo nella forma <code><nowiki>{{subst:Cassetto|...}}</nowiki></code>.
 
−
##  omettendo di  includere il testo che vuoi racchiudere nel cassetto e sostituendolo  con un testo segnaposto, con  il parametro <code>|testo=segnaposto</code> per esempio.
 
−
# Salva la  pagina e poi riaprila in modifica.<br  />Troverai che il template <code><nowiki>{{Cassetto|...}}</nowiki></code> è stato sostituito da un  codice misto di [[HTML]]  e wikicode.<br />Ora si  tratta di modificare questo codice:
 
−
## substa le [[Aiuto:Funzioni  parser|funzioni parser]],  ovvero sostituisci <code><nowiki>{{#ifexpr:</nowiki></code>  e  <code><nowiki>{{#switch:</nowiki></code> con <code><nowiki>{{subst:#ifexpr:</nowiki></code> e <code><nowiki>{{subst:#switch:</nowiki></code> — questa operazione può essere considerata  facoltativa, ma è consigliabile, in quanto elimina del codice ormai  inutile;
 
−
## sostituisci <code>segnaposto</code> con il testo che vuoi  racchiudere nel cassetto; è conveniente eseguire questa operazione dopo  la precedente, per poter più immediatamente individuare le funzioni  parser da substare.
 
−
# Salva nuovamente per avere il codice  definitivo.
 
−
 
 
−
==Template correlati==
 
 
*{{tl|Cassetto inizio}}
 
*{{tl|Cassetto inizio}}
 
*{{tl|Cassetto fine}}
 
*{{tl|Cassetto fine}}

Versione attuale delle 13:58, 11 giu 2018

Questo template è utilizzato per creare i cosiddetti cassettamenti, ovvero delle sezioni a scomparsa per migliorare la fruibilità e l'ordine di alcune pagine, in casi particolari. L'uso dei cassetti nelle voci è sconsigliato (v. disc.1, disc.2), pertanto questo template andrebbe utilizzato prevalentemente nelle discussioni, nelle pagine utente o altre pagine di servizio.

Nelle voci i cassetti dovrebbero essere limitati ai template di navigazione (realizzati generalmente non con il template Cassetto, ma con il template:Navbox), che non fanno parte del contenuto enciclopedico. Il motivo è che i cassetti danno problemi di accessibilità, non funzionano nella stampa, fanno sembrare la pagina più leggera ma in realtà appesantiscono il download, tolgono ingiustamente rilievo. Se l'informazione è enciclopedica ha tutto il diritto di prendere il necessario spazio, mentre se la vogliamo "nascondere" forse non è così enciclopedica. Se una pagina diviene pesante, pensare piuttosto a uno scorporo; se si vuol risparmiare spazio, sfruttare meglio le sezioni o le colonne.

Sintassi

(legenda colori)
{{cassetto
|titolo = <!-- titolo del riquadro -->
|testo = <!-- testo contenuto -->
|larghezza = <!-- larghezza del riquadro -->
|livello = <!-- numero del livello della sezione -->
|colore = <!-- colore dello sfondo -->
|coloresfondo = <!-- colore dello sfondo del cassetto aperto -->
|allineamento = <!-- destra o sinistra -->
|affiancabile = <!-- "si" o lasciare vuoto -->
|senzabordo = <!-- "si" o lasciare vuoto -->
|aperto = <!-- "si" o lasciare vuoto -->
}}

titolo[1]
obbligatorio. il titolo che deve apparire nella cornice superiore
testo[1]
obbligatorio. il contenuto visualizzato quando il cassetto è aperto, può benissimo contenere testo formattato secondo le convenzioni di Wikipedia
larghezza=
La larghezza del riquadro espressa in pixel o in percentuale; se non espresso assume la larghezza della pagina
  • Pixel. Assumerà la dimensione pari al numero di pixel indicati; la cifra va fatto seguire da "px", es. 10px
  • percentuale. la larghezza varierà a secondo della larghezza della pagina secondo la percentuale indicata la cifra va fatta seguire da "%", es. 30%
livello=
Serve per far sì che il cassetto appaia nell'indice come se fosse una sezione. Il livello di sezione va indicato scrivendo il numero di "=" che è necessario mettere davanti al titolo della sezione per ottenere quel livello normalmente in wikipedia (ad esempio == Intestazione == corrisponderà a livello=2). Nota: non ha alcun effetto grafico sul cassetto stesso.
colore=
Il colore dello sfondo del rettangolo che contiene il titolo, indicato con questi codici.
coloresfondo=
Il colore di fondo della parte visibile quando la finestra è aperta, indicato con questi codici.
allineamento=
Indica la posizione del template rispetto la pagina, può assumere solo due valori: destra o sinistra; se non specificato il template viene visualizzato al centro.
affiancabile=
Rende il riquadro affiancabile da altri riquadri (div) circostanti, come ad esempio il babelbox. È utile quando si vogliono integrare un cassetto con altri riquadri uno a fianco all'altro. Inserire "si" o lasciare vuoto.
senzabordo=
Elimina il bordo del riquadro per avere una continuità con la formattazione circostante. Si usa in situazioni complesse, ad esempio quando il cassetto fa parte di una struttura più grande. Inserire "si" o lasciare vuoto.
aperto=
Il cassetto viene inserito inizialmente aperto, anziché inizialmente chiuso. Inserire "si" o lasciare vuoto.
  1. ↑ 1,0 1,1 titolo e testo possono, a differenza degli altri parametri, anche non essere esplicitati; in questo caso basta scrivere {{cassetto|titolo|contenuto}}. Ricorda però che in alcuni casi, ad esempio per la presenza di un collegamento esterno, tale sistema NON funziona e il cassetto non si apre.

Esempi

L'utilizzo del template è illustrato in questo esempio: 

{{Cassetto|Titolo del riquadro|
testo contenuto, con tutta la
''formattazione'' necessaria...
}}

Che produce questo risultato:

Titolo del riquadro

testo contenuto, con tutta la formattazione necessaria...

È possibile anche specificare la larghezza della barra del titolo con il parametro "larghezza": 

{{Cassetto|larghezza=30%|Titolo del riquadro|
testo contenuto, con tutta la
''formattazione'' necessaria...
}}

risultato:

Titolo del riquadro

testo contenuto, con tutta la formattazione necessaria...

Si può impostare l'allineamento, a destra o a sinistra, con il parametro "allineamento", in questo caso il riquadro diventa "flottante": 

{{Cassetto|larghezza=30%|allineamento=destra|Titolo del riquadro|
testo contenuto, con tutta la
''formattazione'' necessaria...
}}
Titolo del riquadro

testo contenuto, con tutta la formattazione necessaria...

Il risultato è qui a destra

Si possono anche utilizzare colori diversi per lo sfondo ed il testo del titolo: 

{{Cassetto
|colore=red
|titolo={{colore|white|Apri il cassetto per vedere il testo...}}
|testo=...chiudi il cassetto per nascondere il testo.
}}

risultato:

...chiudi il cassetto per nascondere il testo.

Esempio del parametro livello; questo cassetto con livello=3 compare nell'indice a inizio pagina come se fosse una sezione (o meglio una sottosezione della sezione Esempi, che è di livello 2).

Esempio di cassetto-sezione

...chiudi il cassetto per nascondere il testo.

Note importanti

  • L'inserimento di tabelle nel cassetto dà problemi a causa della presenza di "|". Per risolverli usare {{cassetto inizio}}, oppure sostituire le | con {{!}}.
  • Se il testo contiene degli "=" (uguale), ad esempio titoli di sezione come == Titolo == o URL complessi, la sintassi anonima non funziona. Esplicitare il parametro |testo= (oppure |2=).

Template correlati

template Progetto Template: collabora a Wikipedia sull'argomento template
Estratto da "https://wiki.wikimedia.it/index.php?title=Template:Cassetto/man&oldid=583511"