I template sono un tipo di pagina pensata per essere inclusa in altre pagine. Si trovano nel namespace Template: e generalmente contengono contenuti o codici che devono essere mostrati su più pagine allo stesso tempo. I template sono strumenti vitali per far funzionare una wiki in modo efficiente.
Ci sono molte tipologie di template diverse che servono scopi differenti. I template come gli infobox o i riferimenti promuovono uno stile uniforme sulla wiki, mentre altri sono usati per costruire insieme una singola pagina come la pagina principale.
Le pagine di template sono create e modificabili utilizzando l'editor sorgente. La maggior pare dei template può essere aggiunta, o inclusa, in una pagina utilizzando qualsiasi interfaccia di modifica, ma per i template complessi potrebbe essere più semplice lavorare in modalità sorgente. Modificare un template aggiornerà come appare in tutte le pagine in cui è incluso.
Trovare e usare i template
Inserisci un template con il VisualEditor usando questo menù.
Le nuove community di Fandom hanno un set di template predefiniti pronti all'uso. Puoi vedere la lista completa di template di qualsiasi community recandoti su Speciale:TutteLePagine e selezionando il namespace "Template" dal menù a tendina.
Una volta che hai capito con quali template puoi lavorare, puoi iniziare a pensare a come usarli nella loro forma più basilare. Le istruzioni sono leggermente diverse a seconda dell'editor:
- Nel VisualEditor, clicca la parola in grassetto INSERISCI tra le opzioni dell'editor in alto e seleziona "Template" dalla lista a tendina. Puoi anche digitare
{{nella pagina stessa. Nella finestra di dialogo che appare, cerca il nome del templare che vuoi includere. - Nell'editor sorgente, digita semplicemente
{{NomeTemplate}}sostituendo "NomeTemplate" con il nome del template.
Come creare un template di base
I template possono essere molto potenti, ma anche complicati. Generalmente aiuta creare inizialmente i template più semplici possibili, per poi imparare a sperimentare con quelli più complessi.
- Sulla tua community, recati su
Template:Esempio. usando la barra degli indirizzi del browser. Sulla Wiki della Community, questo sarebbe https://community.fandom.com/it/wiki/Template:Esempio - Clicca il pulsante "Crea" nell'angolo in alto a destra della pagina. Questo aprirà l'editor sorgente.
- Apparirà un popup, chiedendoti di scegliere una tipologia di template. Seleziona l'opzione che corrisponde al template che vuoi creare, o seleziona "Sconosciuto" se non sei sicuro; poi clicca "Salva" in alto a destra.
- Digita qualche parola o una frase nell'editor. Esempio:
Questo è un testo per un template d'esempio. Solo per scopi dimostrativi. - Clicca "Salva" in basso a destra. Hai appena creato un template!
- Vai sul tuo profilo utente o su un'altra pagina di prova della tua community.
- Segui gli step qui sopra per inserire il template a seconda del tuo editor preferito.
La pagina che hai creato dovrebbe mostrare:
- Questo è un testo per un template d'esempio. Solo per scopi dimostrativi.
Congratulazioni! Hai appena creato e usato un template con successo! Ora puoi modificare il contenuto del tuo template e aggiungerlo a più pagine per renderlo più utile alla tua communtiy.
Per una guida completa sulla creazione e sull'utilizzo dei template, visita Help:Templates su MediaWiki per imparare di più
Uso avanzato
Parametri dei template
Selezione dei parametri nello strumento del VisualEditor
Molti templati presentano anche dei parametri. Pensa a loro come a delle variabili. Pagine diverse possono usare lo stesso template con diversi valori per ciascun parametro. A seconda del template. questo può modificare il testo del template o lo stile con cui appare.
Prendiamo Template:Wikipedia ad esempio. Questo template è pensato per le pagine che usano il contenuto di una pagina di wikipedia; crea un riquadro con un link alla pagina di Wikipedia. Aggiungere solo {{Wikipedia}} assume che la pagina di Wikipedia abbia esattamente lo stesso nome della pagina in cui viene usato il template. Tuttavia, se le due pagine hanno nomi diversi, possiamo usare un parametro per cambiare il link. Aggiungere {{Wikipedia|Microsoft}} assicura che il link punterà alla pagina "Microsoft" di "Microsoft". Il VisualEditor fornisce opzioni per impostare i valori dei parametri quando si aggiunge un template o cliccandolo nell'editor.
Per scoprire di più, visita Aiuto:Parametri dei template.
Sostituzione di un template
Sostituire un template è come usare uno stampino per fare i biscotti.
Aggiungere un template ad una pagina con il VisualEditor o digitando {{NomeTemplate}} mostrerà sempre la versione più recente del template su quella pagina. Questo processo è chiamato inclusione.
Un modo diverso per usare un template è sostituire il suo contenuto su una pagina. La sostituzione di un template può essere fatta solo in modalità sorgente cambiato il codice in {{SUBST:NomeTemplate}}. Dopo il salvataggio della pagina, il codice del template viene rimosso e sostituito con il suo contenuto.
Modificare il template non influenzerà più il contenuto aggiunto alla pagina. Pensa alla sostituzione come ad uno stampino per fare i biscotti: se usi uno stampino e fai qualche biscotto e poi cambi la forma dello stempino, i biscotti già fatti non cambierannò forma.
Per scoprire di più, visita Aiuto:Sostituzione di template.
Documentazione per template
Supponi di voler usare un template. Provi ad utilizzare un template standardizzato, come {{Box avviso}}. Tuttavia, non sai come usare il template e non vuoi guardare il codice del template.
Qui è dove arriva la necessità della documentazione. Molti template complessi hanno spesso una sezione di documentazione, aggiunta usando {{Documentazione}}. La documentazione di un template è utile per fornire istruzioni su come usare il template, i suoi parametri e anche alcuni esempi di utilizzo. Può anche avere mw:Help:TemplateData per aiutarti quando usi il VisualEditor.
Puoi aggiungere facilmente documentazione ai template che non la hanno. , se sai come usare il template.
Per scoprire di più, visita Aiuto:Documentazione per template.
Template a base di Lua
La maggior parte dei template di base sono costruiti usando il wikitext, lo stesso codice usate sulle pagine. Tuttavia, i template complessi in wikitext possono apparire troppo complicati da leggere e rallentano le pagine in cui sono usati. In questi casi, Lua è l'opzione alternativa. Benché scrivere in Lua possa sembrare spaventoso all'inizio, i template a base di Lua sono più veloci della controparte in wikitext e possono essere letti e capiti più facilmente. La Fandom Developers Wiki mantiene una lista dei moduli Lua globali pensati per sostituire o migliorare alcuni template in wikitext comune; alcuni di questi moduli globali sono disponibili anche sulle nuove community.
Per scoprire di più, visita Aiuto:Lua.
Copiare e aggiornare i template
Gli utenti di Fandom hanno creato tanti differenti tipologie di template. È spesso più facile copiare un template esistente e modificarlo per i propri bisogni piuttosto che crearne uno da zero. Nella maggior parte dei casi, sei libero di copiare un template da altre wiki di Fandom secondo la licenza CC-BY-SA condivisa. Fornire la corretta attribuzione alla community da cui hai copiato il template è vitale.
È consigliato esportare e importare i template, dato che mantiene la cronologia delle modifiche che è vitale per la licenza CC-BY-SA richiesta da Fandom. (Benché richieda permessi di amministratore.)
Se non puoi importare la pagine, un'alternativa è copiare il template. Ecco alcuni semplici passi per copiare la maggior parte dei template:
- Trova il template che vuoi copiare.
- Clicca il pulsante "Modifica", seleziona tutto il wikitext, e copialo.
- Crea una nuova pagina di template sulla tua community.
- Incolla il codice wikitext che hai copiato, aggiungi un riassunto della modifica che fornisce l'attribuzione alla wiki da cui hai ottenuto il template, poi clicca il pulsante "Salva".
Maggiori informazioni si possono trovare su questa pagina della Template Wiki.
Dove trovare più template
- La Template Wiki ha diversi template utili pensati per l'uso in molte wiki. (Template consigliati da copiare)
- Dev Wiki, benché più azzeccata per i template a base di Lua. Una lista dei moduli (e pertanto, template) può essere vista tramite Global Lua Modules sulla Dev Wiki.
- Wiki della Community. Ma è consigliabile cercare prima sulla Template Wiki, poichè contiene le versioni più aggiornate dei template.
- Wikipedia o MediaWiki, anche se devi leggere la loro guida su come copiare i template. Fornisci i crediti usando
{{wikipedia}}. - Altre wiki connesse al tuo argomento. Per esempio, se sei su una wiki di una serie TV, guarda altre wiki su serie TV che ammiri, in particolare quelle dello stesso genere del tuo argomento.
- UCP Fandom Starter. Questa è la struttura predefinica quando crei una nuova wiki (e pertanto, i template) e può essere usata come punto di partenza per creare/mettere le fondamenta ai tuoi template.
Vedi anche
- Help:Template su MediaWiki.org, la guida completa sull'uso dei template.
- Aiuto:Tipologie di template
- Aiuto:Parametri dei template
- Aiuto:Template condivisi
- Aiuto:Infobox, uno stile di template usato di recente per riassumere un articolo.
- Aiuto:Sostituzione di template
- Aiuto:Documentazione per template
- Help:Transclusion su MediaWiki
- Aiuto:Lua
Aiuto aggiuntivo e feedback
- Naviga e cerca altre pagine di aiuto su Contenuti.
- Esplora la Wiki della Community per ulteriori fonti di aiuto o supporto.
- Leggi come contattare Fandom per problemi o segnalare errori.
