3 581
contributi
S3v (discussione | contributi) mNessun oggetto della modifica |
mNessun oggetto della modifica |
||
(12 versioni intermedie di 2 utenti non mostrate) | |||
Riga 1: | Riga 1: | ||
{{Help}} | |||
== Introduzione == | == Introduzione == | ||
Per aiutare nella formattazione della pagina sono disponibili diversi template. I template sono delle scorciatoie per inserire degli elementi standard in una pagina e possono essere liberamente utilizzati per mettere in evidenza messaggi di avvertimento, note e suggerimenti, | Per aiutare nella formattazione della pagina sono disponibili diversi template. I template sono delle scorciatoie per inserire degli elementi standard in una pagina e possono essere liberamente utilizzati per mettere in evidenza messaggi di avvertimento, note e suggerimenti, per contrassegnare la guida secondo il suo stato, per inserire sommari, immagini o tabelle e, in generale, per permettere di ridurre la complessità di inserimento di elementi destinati ad essere utilizzati in più pagine.<br/> | ||
Ad esempio, su questo Wiki abbiamo dei template già pronti | Ad esempio, su questo Wiki, abbiamo dei template già pronti che permettono l'inserimento di elementi usati frequentemente nelle guide.<br/> | ||
La lista completa dei template disponibili è consultabile [[:Categoria:Template|qui]]. | La lista completa dei template disponibili è consultabile [[:Categoria:Template|qui]]. | ||
Riga 16: | Riga 16: | ||
;Template dinamici: utilizzano ''parametri'' che permettono di modificare il contenuto visualizzato dal template. | ;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. | tipicamente la flessibilità dei template permette loro di risultare dinamici o statici in base al fatto che vengano richiamati con o senza parametri. | ||
Si può fare pratica con i template direttamente sul Wiki, modificando la pagina [[Template:Sandbox]] per provare un nuovo template, richiamandolo poi nella stessa pagina con '''<nowiki>{{Sandbox}}</nowiki>''' all'interno della sezione '''<nowiki><noinclude> </noinclude></nowiki>''' oppure nella pagina [[Sandbox]] o in una propria bozza. | |||
== Utilizzare i template == | == Utilizzare i template == | ||
Riga 24: | Riga 26: | ||
{{Nome_template}} | {{Nome_template}} | ||
</pre> | </pre> | ||
oppure: | |||
<pre> | <pre> | ||
{{Nome_template|valore1|valore2|valore3|...}} | {{Nome_template|valore1|valore2|valore3|...}} | ||
</pre> | </pre> | ||
o: | o anche: | ||
<pre> | <pre> | ||
{{Nome_template | {{Nome_template | ||
Riga 38: | Riga 40: | ||
</pre> | </pre> | ||
se il template prevede l'utilizzo di parametri.<br/> | se il template prevede l'utilizzo di parametri.<br/> | ||
Si noti che l'inserimento del [[Aiuto:Varie#I namespace|namespace]] per richiamare un template, ad esempio: | |||
<pre> | |||
{{Template:Nome_template}} | |||
</pre> | |||
produce lo stesso risultato ma è del tutto superfluo poiché il motore Wiki stabilisce che si tratta di un template dalla sola presenza delle parentesi graffe. | |||
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. | ||
Di seguito sono elencati alcuni template, la lista completa è visibile [[:Categoria:Template | qui]]. | |||
==Template "Versioni compatibili"== | ==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/> | 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/> | ||
Tra la riga contenente il testo per l'inserimento del template e il testo successivo non inserire righe vuote | Tra la riga contenente il testo per l'inserimento del template e il testo successivo non inserire righe vuote; questo consentirà l'allineamento del template con l'eventuale [[Aiuto:Sintassi#Indice | indice]] della pagina. | ||
Si occupa di indicare la compatibilità di una guida per una o più versioni di Debian. Inoltre ne permette il [[Stati di una guida|tracciamento automatico]]. | |||
Per questo l'uso della forma "senza parametri", per segnalare la compatibilità per tutte le versioni, è '''sconsigliata''', se non per guide trattanti argomenti generali o relativi a pacchetti di sistema (priorità: ''required'', ''important'', ''standard'').<br/> | |||
Queste guide (come anche le pagine di [[:Categoria:Glossario|glossario]]), che si suppongono molto importanti, possono far uso di [[Template:Codename|template Codename]] e [[Template:APT-mirror|template APT-mirror]] per tenere aggiornate informazioni riguardanti gli attuali [[codename]] delle [[suite]] supportate di Debian e i [[mirror]] di default dei [[repository]], in modo da non dover essere modificate a ogni nuovo rilascio di Debian solo per aggiornare tali informazioni. | |||
== Box informativi== | == Box informativi== | ||
Riga 48: | Riga 63: | ||
;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à. | ;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à. | ||
;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. | ;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, o che pregiudicano la sicurezza del sistema o di dati riservati. | ||
;Template "Cautionbox":Il template [[Template:Cautionbox|"Cautionbox"]] va utilizzato per inserire avvisi più generici di prestare maggiore cautela, per cui non è necessaria la gravità del precedente. | |||
;Template "Suggerimento":Il template [[Template:Suggerimento|""Suggerimento"]] è utilizzato per inserire suggerimenti, trucchi o consigli. | ;Template "Suggerimento":Il template [[Template:Suggerimento|""Suggerimento"]] è utilizzato per inserire suggerimenti, trucchi o consigli. | ||
Riga 55: | Riga 72: | ||
== Stato di una guida == | == Stato di una guida == | ||
{{Box | Nota | Prima di utilizzare uno di questi template per contrassegnare una guida, si raccomanda la lettura della pagina dedicata a quel template, dove sono presentate più nel dettaglio tutte le linee guida a cui è bene attenersi.}} | |||
;Template "Stub":Il template [[Template:Stub|"Stub"]] è da inserire nelle guide o articoli ancora incompleti. | ;Template "Stub":Il template [[Template:Stub|"Stub"]] è da inserire nelle guide o articoli ancora incompleti. | ||
Riga 67: | Riga 87: | ||
== Template di sommario == | == Template di sommario == | ||
;Sommario verticale:Il template [[Template: | ;Sommario verticale:Il template [[Template:Sommario_verticale|"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:Sommario_verticale|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 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. | :L'inserimento del carattere "=" (uguale) all'interno dei template può portare a problemi di corretta interpretazione dei parametri e, quindi, ad un output indesiderato. | ||
Per risolvere si può ricorrere ad uno dei seguenti metodi: | :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 [[Aiuto:Sintassi#Caratteri speciali HTML | il codice HTML]] corrispondente ('''&#61;''') | :# Utilizzare [[Aiuto:Sintassi#Caratteri speciali HTML | il codice HTML]] corrispondente ('''&#61;''') | ||
# Utilizzare il [[Template:=|template apposito]] | :# Utilizzare la codifica URL ('''%3D''') se si sta assegnando un indirizzo attraverso il parametro "link=" e l'inserimento di immagini. | ||
:# Utilizzare il [[Template:=|template apposito]] (sintassi: <nowiki>{{=}}</nowiki>) | |||
;Carattere "|" all'interno dei template, comandi e tabelle: | |||
:Analogamente l'inserimento del carattere "|" (pipe) all'interno del testo dei template, comandi o tabelle può portare a un output indesiderato. È usato infatti per delimitare un argomento dal successivo nei template e nei comandi (per esempio forniti dall'estensione MediaWiki [https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions ParserFunctions]); e a delimitare celle, righe, colonne e la fine delle tabelle. | |||
:Per risolvere si può ricorrere ad uno dei seguenti metodi, quando si intende utilizzare il carattere ''pipe'' come semplice testo: | |||
:# Utilizzare [[Aiuto:Sintassi#Caratteri speciali HTML | il codice HTML]] corrispondente ('''&#124;''') | |||
:# Utilizzare il [[Template:!|template apposito]] (sintassi: <nowiki>{{!}}</nowiki>) | |||
:Si noti comunque che è possibile annidare più template/comandi senza problemi, fintanto che il carattere ''pipe'' non è usato come testo, e che gli accorgimenti di cui sopra vanno utilizzati unicamente in tale circostanza. I problemi sorgono invece se si annidano template/comandi e tabelle, a prescindere dall'ordine, e sarebbe necessario sostituire sempre tutti i caratteri ''pipe'' annidati. |
contributi