Guide@Debianizzati.Org

Aiuto:I template: differenze tra le versioni

Aiuto Discussione

Aiuto:I template (visualizza wikitesto)

Versione delle 09:51, 14 ago 2013

3 071 byte rimossi ,  14 ago 2013
nessun oggetto della modifica
Nessun oggetto della modifica
Nessun oggetto della modifica
Riga 4: Riga 4:
Ad esempio, su questo Wiki abbiamo dei template già pronti per vari tipi di riquadro usati frequentemente nelle guide. In questo modo è facilissimo inserire degli elementi tipo note o warning nelle pagine.
Ad esempio, su questo Wiki abbiamo dei template già pronti per vari tipi di riquadro usati frequentemente nelle guide. In questo modo è facilissimo inserire degli elementi tipo note o warning nelle pagine.
La lista completa dei template disponibili è consultabile [[:Categoria:Template|qui]].
La lista completa dei template disponibili è consultabile [[:Categoria:Template|qui]].
== Creare un template ==
Per la creazione di un template bisogna innanzitutto [[Aiuto:Creare e modificare una pagina|creare]] una nuova pagina nel relativo [[Aiuto:Varie#I namespace|namespace]] inserendo nella barra degli indirizzi del browser:
<pre>
http.//guide.debianizzati.org/Template:Nome_template
</pre>
Quindi si può iniziare la creazione della pagina inserendo il testo tra i tag '''<nowiki><includeonly> </includeonly></nowiki>'''; tutto ciò che viene incluso all'interno di questi tag sarà parte integrante del template. Ciò che viene incluso invece tra i tag '''<nowiki><noinclude> </noinclude></nowiki>''' non sarà parte del template ma soltanto della sua pagina.
I template possono essere di due tipi:
;Template statici:contengono testo che non può essere modificato quando il template viene richiamato da una pagina.
;Template dinamici: utilizzano ''parametri'' che permettono di modificare il contenuto visualizzato dal template.
tipicamente la flessibilità dei template permette loro di risultare dinamici o statici in base al fatto che vengano richiamati con o senza parametri.


== Utilizzare i template ==
== Utilizzare i template ==
Riga 28: Riga 40:
Consultare la pagina relativa a ciascun template per tutte le informazioni sul suo utilizzo e seguire la distinzione maiuscole-minuscole per evitare possibili problemi di visualizzazione.
Consultare la pagina relativa a ciascun template per tutte le informazioni sul suo utilizzo e seguire la distinzione maiuscole-minuscole per evitare possibili problemi di visualizzazione.


== Compatibilità ==
==Template "Versioni compatibili"==
 
Il template [[Template:Versioni compatibili|"Versioni compatibili"]] viene automaticamente allineato in alto a destra: se ciò dovesse causare dei problemi con gli altri elementi della pagina, è possibile inserire, tra il template e gli elementi successivi, delle righe vuote (sempre mediante il tag [[Aiuto:Sintassi#Interruzione_di_riga | <code><nowiki><br></nowiki></code>]]).<br/>
===Template "Versioni compatibili"===
Tra la riga contenente il testo per l'inserimento del template e il testo successivo non inserire righe vuote per consentire l'allineamento del template con l'eventuale [[Aiuto:Sintassi#Indice | indice]] della pagina.<br>
 
{|style="-moz-border-radius: 0.5em; -khtml-border-radius: 0.5em;  width:250px; float:right; clear:right; margin:5px; text-align:center;  font-variant:small-caps; background:#f8fbfd; border:1px solid #4e88d0;  padding-bottom:5px"
|[[Image:Debian-swirl.png|33px|link=]]'''Versioni compatibili'''
|-
|Versione 1
|-
|Versione 2
|}
 
Il [[Template:Versioni compatibili]] viene automaticamente allineato in alto a destra: se ciò dovesse causare dei problemi con gli altri elementi della pagina, è possibile inserire, tra il template e gli elementi successivi, delle righe vuote (sempre mediante il tag <code><nowiki><br></nowiki></code>), come è stato fatto in questa stessa pagina (guardate il codice: abbiamo inserito due <code><nowiki><br></nowiki></code> per far coesistere il template "Versioni compatibili" con il successivo).
<br>
Tra la riga contenente il testo per l'inserimento del template e il testo successivo non inserire righe vuote, ad esempio:
<pre>
{{Versioni compatibili|Wheezy}}
==Introduzione==
</pre>
per consentire l'allineamento del template con l'eventuale sommario della pagina.<br>


== Box informativi==
== Box informativi==


===Template "Box"===
;Template "Box":Il template [[Template:Box|"Box"]] andrebbe utilizzato soprattutto quando si desidera inserire delle note o degli aggiornamenti, ma naturalmente è uno strumento estremamente flessibile e può essere utilizzato anche per altre finalità.
Il [[Template:Box]] andrebbe utilizzato soprattutto quando si desidera inserire delle '''Note''' o degli '''Aggiornamenti''', ma naturalmente è uno strumento estremamente flessibile e può essere utilizzato anche per altre finalità.
{{Box|Esempio|Questo è il testo dell'esempio che dimostra l'utilizzo del template '''Box'''.}}


===Template "Warningbox"===
;Template "Warningbox":Il template [[Template:Warningbox|"Warningbox"]] va utilizzato per inserire avvisi importanti. Si consiglia di inserirlo soprattutto nel caso in cui vengano utilizzati comandi o programmi che possono pregiudicare il funzionamento del computer.
Il [[Template:Warningbox]] va utilizzato per inserire avvisi importanti. Si consiglia di inserirlo soprattutto nel caso in cui vengano utilizzati comandi o programmi che possono pregiudicare il funzionamento del computer.
{{Warningbox| Questo è il testo dell'esempio che dimostra l'utilizzo del template '''Warningbox'''.}}


===Template "Suggerimento"===
;Template "Suggerimento":Il template [[Template:Suggerimento|""Suggerimento"]] è utilizzato per inserire suggerimenti, trucchi o consigli.
Il [[Template:Suggerimento]] è utilizzato per inserire suggerimenti, trucchi o consigli.
{{Suggerimento| Questo è un esempio di come verrà visualizzato questo template}}


===Template "Non-free" ===
;Template "Non-free":Il template [[Template:Non-free | "Non-free"]] consente di visualizzare un box di avvertimento per quelle guide che trattano argomenti o software a sorgente chiuso o non aderenti ai principi del Free Software.
[[Template:Non-free | Questo template]] consente di visualizzare un box di avvertimento per quelle guide che trattano argomenti o software a sorgente chiuso o non aderenti ai principi del Free Software.
{| style="border: 1px solid darkgray; background:#f9f9f9; border-spacing: 0px; margin-left:15px; width:70%"
| style="padding-left:6px" width="45px" |[[image:Lock.png|center|38px]]
| style="padding-left:11px; padding-right:10px" | '''ATTENZIONE''': questa guida tratta <font style="color:red;"><u>software a sorgente chiuso e potenzialmente non conforme</u></font> alle [[DFSG | Debian Free Software Guidelines]].<br/>Considerare la possibilità di ricorrere a programmi aderenti ai principi del Free Software.
|}


== Stato di una guida ==
== Stato di una guida ==
;Template "Stub":Il template [[Template:Stub|"Stub"]] è da inserire nelle guide o articoli ancora incompleti:


===Template "Debianized"===
;Template "Guida da adottare":Il template [[Template:Guida da adottare|"Guida da adottare"]] contrassegna quelle guide di particolare interesse che dovrebbero essere aggiornate nei contenuti e, quindi, in cerca di adozione da parte di un membro della comunità. Vedere anche la pagina [[Adozione Guide | adozione guide]] per avere più informazioni su come adottare una guida,
<div style="-moz-border-radius: 0.5em; -khtml-border-radius: 0.5em; width:300px; float:right; margin:5px; text-align:center; background:#E6E6FA; border:3px solid gray; color:#000000; clear:both">
'''Debianized'''
 
<div style="text-align:left; margin:5px;">
Questo è un articolo consigliato dallo staff di Debianizzati.
 
Gli articoli [[:Categoria:Debianized|Debianized]] sono scritti in maniera particolarmente accurata (sia nella forma che nel contenuto) e la loro correttezza è stata verificata personalmente da più persone nella community.
</div>
</div>
Il [[Template:Debianized]] è utilizzato per contrassegnare quelle guide verificate da più persone della comunità Debianizzati. Vedere anche [[Aiuto:Contents#Evoluzione_delle_guide | Evoluzione delle guide]].
<br><br><br><br><br><br><br><br><br>
 
===Template "Stub"===
 
Il [[Template:Stub]] è da inserire nelle guide o articoli ancora incompleti:
{| align="center" style="border: 1px solid darkgray; background:#f4f4f4; border-spacing: 0px; width:80%"
| style="background-color:#aeaf9c;" width="4px" |
| style="padding-left:6px" width="45px" |[[image:Trash.png|center|38px]]
| style="padding-left:11px; padding-right:10px" | '''Attenzione'''<br/>Questo articolo è ancora incompleto o richiede delle verifiche. Sentiti libero di contribuire cliccando sul tasto "Modifica".
|}
 
 
=== Template "Guida da adottare" ===
Il [[Template:Guida da adottare]] contrassegna quelle guide di particolare interesse che dovrebbero essere aggiornate nei contenuti e, quindi, in cerca di adozione da parte di un membro della comunità. Vedere anche la pagina [[Adozione Guide | adozione guide]] per avere più informazioni su come adottare una guida,
{|style="-moz-border-radius: 0.5em; width:100%; background-color:#cdf4cd; border: 2px solid #74b874"
|style="width:100%"|
|-
| style="width:100%;text-align:center; white-space: nowrap" | '''Guida da adottare!''' [[Image:Bannermv.png|link=Adozione_Guide]]
|}
 
 
=== Template "Old" ===
Il [[Template:Old]] contrassegna quelle guide contenenti informazioni ormai obsolete. Le guide vengono mantenute nel Wiki esclusivamente per interesse storico o didattico.
{|style="-moz-border-radius: 0.5em; width:100%; margin-top:+.7em;  background-color:#edcccc; border: 2px solid #c91818; text-align:center;"
| '''Attenzione. ''' Questa guida è obsoleta. Viene mantenuta sul wiki solo per motivi di natura storica e didattica.
|}
 


=== Template "Da cancellare" ===
;Template "Old":Il template [[Template:Old|"Old"]] contrassegna quelle guide contenenti informazioni ormai obsolete. Le guide vengono mantenute nel Wiki esclusivamente per interesse storico o didattico.
Il [[Template:Da cancellare]] deve essere utilizzato per marcare una guida come "da cancellare". La guida sarà automaticamente assegnata alla categoria "Da Cancellare" per consentirne una sua facile individuazione.
{|style="-moz-border-radius: 0.5em; width:100%; margin-top:+.7em; background-color:lightgray; border: 2px solid black"
| '''Attenzione.''' Questa guida è stata proposta per la cancellazione in quanto contenente materiale potenzialmente dannoso, inutile o fuorviante.<br/>Per qualunque comunicazione utilizzare la pagina "Discussione".
|}


;Template "Da cancellare":Il template [[Template:Da cancellare|"Da cancellare"]] deve essere utilizzato per contrassegnare quelle guide che si ritiene debbano essere cancellate. A proposito della cancellazione di una pagina, vedere [[Aiuto:Spostare e cancellare una pagina | Spostare e cancellare una pagina]].


== Testo da segnalare ==
== Testo da segnalare ==
[[Template:Discussione | Questo template]] serve per segnalare parti della guida problematiche o poco chiare. ''Non segnalare problemi <u>derivanti</u> dall'applicazione della guida o riguardanti argomenti ad essa correlati''. Per questo scopo c'è il [http://forum.debianizzati.org forum].<br/>
[[Template:Discussione | Questo template]] serve per segnalare parti della guida problematiche o poco chiare. ''Non segnalare problemi <u>derivanti</u> dall'applicazione della guida o riguardanti argomenti ad essa correlati''. Per questo scopo c'è il [http://forum.debianizzati.org forum].
Il risultato dell'applicazione del template sarà:
 
 
<span style="background-color:#ffeaea">''Questa parte della guida presenta un problema''</span><sup>[[{{TALKPAGENAME}} | discussione]]</sup>
 


== Template di sommario ==
== Template di sommario ==


;Sommario verticale:Il template [[Template:Sommario3|"Sommario verticale"]] crea un sommario per quelle guide che necessitano di essere suddivise in più pagine e dovrebbe essere inserito sulle pagine successive ad una pagina iniziale di introduzione alla guida.<br/>[[Template:Sommario3|Questa è la pagina]] relativa al sommario verticale e [[:Categoria:Template-Sommario |qui]] sono elencati i template che fanno uso del sommario verticale.


 
;Sommario orizzontale:Il seguente template crea un sommario orizzontale comprendente quelle guide che riguardano argomenti strettamente interconnessi.<br/>[[Template:Sommario orizzontale|Questa è la pagina]] relativa al sommario orizzontale e [[:Categoria:Template-Sommario_orizzontale |qui]] sono elencati i template che fanno uso del sommario orizzontale.
=== Sommario verticale ===
{|style="float:right; clear:right"
|
{|style="-moz-border-radius-topright:0.5em; -moz-border-radius-topleft:0.5em; text-align:center; margin-top:+.7em; color:#2a5184; width:250px; border:1px solid #4e88d0; border-bottom:1px solid #ecf0f5; background-color:#ecf0f5"
|'''Titolo'''
|-
|}
{|style="color:#da2471; font-variant:small-caps;font-size:95%; text-align:center; width:250px; background-color:#ecf0f5; border-left:1px solid #4e88d0; border-right:1px solid #4e88d0;"
|'''Sommario'''
|}
{|style="-moz-border-radius-bottomright:0.5em; -moz-border-radius-bottomleft:0.5em; width:250px; color:#2a5184; border:1px solid #4e88d0; border-top:1px dashed #4e88d0; background-color:#f8fbfd"
|
* Titolo 1
:pagina 1
* Titolo 2
:pagina2
|}
|}
Il seguente template crea un sommario per quelle guide che necessitano di essere suddivise in più pagine.<br/>
Il sommario dovrebbe essere inserito sulle pagine successive ad una pagina iniziale di introduzione alla guida.<br/>
[[Template:Sommario3|Questa è la pagina]] relativa al sommario verticale e [[:Categoria:Template-Sommario |qui]] sono elencati i template che fanno uso del sommario verticale.
 
Qui a lato si può vederne un'anteprima.
<br/><br/><br/><br/><br/><br/>
 
=== Sommario orizzontale ===
Il seguente template crea un sommario orizzontale comprendente quelle guide che riguardano argomenti strettamente interconnessi.<br/>
[[Template:Sommario orizzontale|Questa è la pagina]] relativa al sommario orizzontale e [[:Categoria:Template-Sommario_orizzontale |qui]] sono elencati i template che fanno uso del sommario orizzontale.


== Problemi conosciuti ==
== Problemi conosciuti ==
=== Carattere "=" all'interno dei template ===
;Carattere "=" all'interno dei template:
L'inserimento del carattere "=" (uguale) all'interno dei template può portare a problemi di corretta interpretazione dei parametri e, quindi, ad un output indesiderato.<br/>
L'inserimento del carattere "=" (uguale) all'interno dei template può portare a problemi di corretta interpretazione dei parametri e, quindi, ad un output indesiderato.<br/>
Per risolvere:
Per risolvere si può ricorrere ad uno dei seguenti metodi:
# Utilizzare i parametri numerati. Ad esempio <nowiki>{{Template|1=testo}} anziché {{Template|testo}}</nowiki>
# Utilizzare i parametri numerati. Ad esempio <nowiki>{{Template|1=testo}} anziché {{Template|testo}}</nowiki>
# Utilizzare il codice HTML corrispondente (&amp;#61;
# Utilizzare [[Aiuto:Sintassi#Caratteri speciali HTML | il codice HTML]] corrispondente ('''&amp;#61;''')
# Utilizzare il [[Template:=|template apposito]]
S3v
6 999

contributi

Estratto da "https://guide.debianizzati.org/index.php/Speciale:DiffMobile/33071"