Aiuto:Template

Questa pagina di aiuto ha lo scopo di aiutare i nuovi arrivati a destreggiarsi con i template disponibili su Wikivoyage.

Cos'è un template

Prima di avventurarci nel fantastico (e per molti ostico) mondo dei template, è utile dire un paio di parole su queste strane creature del mondo wiki.

La parola "template" viene dall'inglese e significa letteralmente "modello, esempio". Nelle versioni italiane dei progetti wiki il termine è stato preso in prestito dall'inglese, mentre altre versioni hanno un nome più vicino alla loro lingua. Se - quindi - vieni da altre versioni linguistiche, sappi che stiamo parlando di ciò che i tedeschi chiamano "Vorlage", gli spagnoli "Plantilla", gli olandesi "sjablonen" e i russi "Шаблоны".

In concreto, un template è una pagina speciale, scritta in un linguaggio particolare che può essere inclusa in altre pagine, semplicemente riportando il suo nome tra parentesi graffe {{NOME TEMPLATE}}

Perché usarli

I motivi per cui si ricorre all'inclusione e quindi ai template sono facilmente intuibili:

Per inserire facilmente del testo ripetuto su diverse pagine, scrivendolo una sola volta. Supponiamo ad esempio che molti articoli debbano avere per qualche ragione una stessa sezione, con lo stesso testo. In questo caso potrai fare certamente copia e incolla; ma se poi volessi modificare qualcosa o ti accorgi di un errore? Se hai fatto copia-incolla ti toccherà rivedere le pagine una ad una. Se invece quel testo è richiamato tutte le volte da un'unica pagina (un template per l'appunto) sarà sufficiente modificare solo quella e la modifica si adatterà a tutte le pagine che lo contengono. Un esempio pratico: tutti i paesi dell'area Schengen condividono le stesse modalità riguardo all'entrata nel paese (visto, passaporto ecc...). Per non stare a riscrivere queste info tante volte, anche perché come ogni trattato potrebbe essere riveduto o ampliato, abbiamo creato la pagina template con il testo e questa è stato richiamato ogni volta semplicemente digitando {{Schengen}}. Guarda un po' i risultati: Polonia, Germania, Repubblica Ceca e tanti altri.
Per una questione - possiamo dire - "estetica". Immagina di dover scrivere una tabella molto complicata o del codice in una pagina molto lunga e non vuoi appesantire inutilmente il testo per poterla editare comodamente. A quel punto scriverai il testo complesso su una pagina apposita (normalmente in un namespace apposito, il namespace Template) e lo richiamerai alla solita maniera. Per un esempio pratico, prova a sbirciare il testo degli articoli candidati in Vetrina. Sorpreso vero? La pagina ha solo poche righe e richiama, con il procedimento classico dei template, altre pagine che poi vengono incluse nella principale.
Per inserire elementi di cui sia possibile programmare il comportamento in funzione di alcune variabili. Questo è il caso tipico dei template che ti verranno spiegati tra poco; Senza dilungarci troppo in questioni tecniche, i template hanno il grande vantaggio di poter gestire più casi di uno stesso problema tramite parametri, senza che ad occuparsene sia l'utente senza conoscenze informatiche. Inoltre una modifica nel template ha effetti su tutte le pagine che lo applicano e questo significa semplificare di parecchio il compito di manutenzione e/o verifica di alcuni aspetti del progetto. Solo un esempio pratico: Tra un po' ti verrà mostrata l'esistenza di un template {{Da aggiornare}}, che si usa nel caso inseriamo informazioni che sappiamo avranno bisogno di modifiche dopo un certo tempo. Bene, se io scrivo ad esempio la data di una festa che cambia di anno in anno e devo ricordarmi in quale pagina si trova per poterla modificare, compilerà il template così: {{Da aggiornare|anno=2016}} e il buon template capirà se è una modifica urgente o se ce ne dobbiamo ricordare tra un po' e inserirà la pagina in una delle sottocategorie degli articoli da Aggiornare.
Per uniformare lo stile. In progetti come questo è importante una certa fluidità grafica. Non sarebbe carino vedere ogni pagina su una città organizzata in maniera diversa e, inoltre, sarebbe molto difficile il lavoro di manutenzione. Se invece tutte le informazioni su un dato elemento, supponiamo sui ristoranti, sono gestite in un certo modo, allora sarà facile uniformare il tutto e sarà meno difficile che un utente si dimentichi alcune informazioni (tipo prezzo, descrizione o indirizzo) visto che sono indicati esplicitamente nel template. Ma questo lo vediamo tra un po'.

Wikiviaggiatore alle prese della scrittura di un template

Per semplificare la vita agli utenti: Alcune caratteristiche di un progetto come Wikivoyage che sono accattivanti e - a volte - essenziali per una guida turistica (mappe, specchietti riassuntivi a lato, tabelle), sono invero molto difficili da realizzare per un utente medio senza particolari conoscenze informatiche. Indicare anche solo un puntino su una mappa per localizzare un posto presuppone, ad esempio, tutta una serie di dati. E invece, con l'utilizzo dei template, il codice è già stato scritto da un ~~nerd~~ utente volenteroso e a noi basterà inserire latitudine e longitudine e il gioco è fatto. Comodo anche questo vero?
Per segnalare facilmente gli errori: Ci sono sezioni o elementi, evidentemente complessi da compilare. Se sbagliassi qualcosa in una sezione con solo testo sarà molto difficile accorgersene. Se invece sbagli nell'inserire un parametro o non è uniformato agli altri (può capitare nell'indicazione del numero di telefono ad esempio), il template è, nella maggior parte dei casi, abbastanza intelligente da capirlo e inserire la pagina che presenta errori in una categoria di manutenzione apposita.

Note sull'utilizzo

Ora ti dovrebbe essere chiaro cosa sia e perché si usino questi famigerati template. Prima di elencarli, permettici ancora un paio di note sul loro utilizzo pratico:

I template distinguono maiuscole e minuscole come ogni altra pagina dei progetti wiki. Il che vuol dire che le scritte {{DaAggiornare}} e scrivere {{daaggiornare}} fanno riferimento a due template diversi. Occhio!
Alcuni template, molti a dir la verità, sono parametrici. Ciò significa che il template, come un camaleonte, cambierà aspetto a seconda del testo che inseriamo dentro. Possiamo specificare diversi parametri, alcuni obbligatori altri opzionali per raggiungere esattamente lo scopo a cui il template ci serve.

Un paio di trucchetti

Se sei curioso e vuoi capire come funzionano i template, apri la pagina in modifica per visualizzare il codice e potrai vedere come è stato programmato. Attenzione però a non modificare nulla se non sei sicuro di quello che fai. Come già detto, una modifica al template, per quanto sempre reversibile può compromettere molte pagine contemporaneamente.

Un secondo trucchetto è il seguente; Mettiamoci nella situazione in cui hai trovato il template giusto per te, hai letto la pagina del manuale del template.... ma questa era fatta male o tu non hai capito cosa in effetti produce quel template. In questo caso c'è un'operazione semplicissima da fare: clicca sulla barra laterale sinistra sul link "Puntano qui" e avrai immediatamente una lista delle pagine che utilizzano il template. Così potrai vedere, cliccandone un paio, come, dove e perché quel template è stato usato.

Vediamo ora i principali template in uso qui su Wikivoyage. Cliccando su ognuno di loro, ti si aprirà la pagina specifica con la spiegazione dettagliata del loro uso e delle situazioni in cui usarlo.

Template obbligatori

In questa sezione, ti verranno presentati i template indispensabili per creare un articolo su Wikivoyage. All'inizio potrai non capirli a pieno ma dopo un po' - fidati - ne diverrai dipendente! Ovviamente non tutti sono indispensabili ogni volta che ti accingerai a scrivere una nuova pagina, essendo alcuni di essi specifici per alcune tipologie di articolo. Ma procediamo con ordine.

Modelli

Per approfondire, vedi: Wikivoyage:Modelli per gli articoli.

Un regista italiano ha detto: «Per difendere la cultura serve organizzarsi». Per costruire una guida turistica accattivante e far sì che il lettore non si senta disorientato è utile fornire le informazioni in un dato ordine. Che senso avrebbe dire prima dove si mangia bene in una città e poi come ci si arriva? A volte però capita che non si sa da dove iniziare a scrivere. Questi modelli, obbligatori, fanno al caso nostro. Ogni articolo, a seconda della località in questione, deve essere diviso in sezioni standard. Maggiori informazioni su questi modelli le trovi su questa pagina. Ti basterà fare copia incolla nel tuo nuovo articolo del modello che ti serve (la spiegazione di ogni sezione la trovi in fondo alla pagina). Questi non sono template propriamente detti ma semplicemente degli scheletri per creare gli articoli. Eccone una lista:

P.s: Quando crei un nuovo articolo, questi modelli si caricheranno in automatico appena clicchi su uno di essi nella lista in cima alla nuova pagina che stai creando. Vedi l'immagine qui sotto:

All'inizio di ognuno dei precedenti modelli c'è un template, abbastanza lungo e pieno di parametri. È il cosiddetto Quickbar. Assolve tutta una serie di funzioni in incognito che per il momento non ci interessa ed è di vitale importanza per un articolo che aspiri ad essere degno di questo nome. Compilalo in ogni sua parte e quando salverai la pagina vedrai il risultato.

Ogni articolo ben fatto ha un buon inizio e una buona fine. Questo template è la "buona fine". Lo troverai già presente nel modello che abbiamo già citato. È fondamentale che tu lo compili bene. Se hai dubbi non esitare a contattare qualche utente più ~~attempato~~...ehm volevamo dire esperto. Una spiegazione delle funzioni e dell'uso del Quickfooter la trovi su questa pagina.

Tramite il Quickfooter si indica anche il livello di qualità di un articolo (tramite un apposito parametro). Una bozza o stub, viene indicata tramite "Livello = 1" a differenza di Wikipedia dove si usa apporre direttamente l'omonimo template "stub".

Veniamo ora ad un altro tipo di template essenziali eppure - chissà perché - incompresi da molti. Come dice il nome, i listing servono a creare delle liste "tematiche" (attrazioni, ristoranti, negozi, alberghi...) di un dato posto e garantisce che tutti gli elementi su tutte le pagine che li utilizzano siano trattati in maniera uniforme. In più sono addestrati per poter inserire tutte le informazioni utili in sezioni apposite, comprese latitudine e longitudine, che riporteranno fedelmente su una mappa dinamica. Una spiegazione del loro uso la trovi qui: Wikivoyage:Listing. Essi sono 7, sono utilissimi e sono questi:

See: da utilizzare per le attrazioni di una città, siano esse musei, monumenti, chiese o altro.
Do: per le attività ricreative. Puoi metterci quello che a tuo parere presuppone un'attività più che la semplice "visita". Si può trattare di un parco, un cinema, un teatro, un'escursione ecc. È il listing che domina la sezione "Cosa vedere"
Buy: da utilizzare per i negozi e...ovviamente va nella sezione "Acquisti"
Drink: da utilizzare per pub, bar o locali in cui passare una piacevole serata. Il suo uso è fortemente consigliato in "Come divertirsi"
Sleep: da utilizzare per alberghi, hotel, ostelli e qualsiasi posto in cui è possibile pernottare. Non dimenticare mai di usarlo nella sezione "Dove alloggiare".
Eat: da utilizzare per i ristoranti, taverne, trattorie e posti in cui riempire lo stomaco. E se servono per indicare dove riempirsi lo stomaco, loro stessi riempiono la sezione "Dove mangiare".
Listing: da utilizzare per... tutti i casi in cui non c'è un altro listing adatto e in particolare per aeroporti, stazioni e attrazioni nella sezione "Nei dintorni"

Noterai che durante la redazione di un articolo, non avrai bisogno di ricercare la pagina del listing vuoto da compilare ma potrai richiamarlo tramite appositi, simpaticissimi, tasti nella barra strumenti in alto, in modalità modifica. Eccoli qui:

In tutti i listing laddove venga compilato il campo "prezzo" deve essere necessariamente aggiunto tra parentesi il mese e l'anno di modifica es: (ottobre 2017). In questo modo chiunque potrà controllare se i prezzi andranno ri-verificati e aggiornati.

N.B:Tutti gli articoli che hanno dei listing completi di coordinate visualizzeranno un'icona in alto a destra (). Cliccandoci su verrà scaricato un file che può essere caricato dai navigatori satellitari che permettono l'importazione dei PoI in modo che il visitatore possa orientarsi in una città anche senza la connessione a Wikivoyage. Tutto questo può essere testato anche con siti ad hoc tipo questo caricando il file scaricato dall'articolo di Wikivoyage.

Dai listing alle liste

No, non abbiamo solo cambiato lingua, ma anche tipologia di template. :-) Se i listing sono template molto complessi che permettono l'inserimento di tutta una serie di parametri, i template per le liste, sono strumenti relativamente più semplici che servono solo per dare un tocco di ordine a paragrafi in cui sono presenti liste, ad esempio, di città o distretti di una città o altro ancora. I principali sono:

{{Citylist}}: tipicamente usato negli articoli inerenti Stati o regioni. serve per creare liste di città. Il vantaggio rispetto a un semplice elenco puntato è - ancora una volta - l'uniformità in tutto Wikivoyage. Una volta inserito l'elenco di città con le relative descrizioni, questo template le mostrerà ordinate alfabeticamente a meno che non gli si "chieda" qualcosa di diverso, come il raggruppare le città secondo criteri stabiliti dall'editore e specificati tramite opportuni parametri (p.es. mostrare in prima posizione il capoluogo, oppure creare un primo gruppo per le città costiere e un secondo per quelle nell'entroterra). È anche possibile indicare il nome in lingua originale di ogni città. Un esempio è disponibile qui

{{Eventlist}}: tipicamente usato negli articoli inerenti Stati (ma niente vieta opportuni utilizzi in quello delle regioni). Serve per elencare ordinatamente e uniformemente le festività e gli eventi di quel dato Paese in una tabella. Guarda qui per un esempio.

{{Regionlist}}: tipicamente usato negli articoli inerenti Stati o regioni. Molto utile per indicare ed evidenziare le aree turistiche con cui è stato suddiviso l'intero territorio in oggetto. Riempiendo opportunamente i suoi parametri sarà possibile visualizzare una mappa (possibilmente in linea con gli standard di progetto), l'elenco delle suddette aree, ed una simpatica legenda colorata che permetterà di individuare velocemente la loro disposizione all'interno della mappa. Guardate un esempio applicato alle regioni in cui è divisa la Russia.

Mappe

Che guida saremmo se non fornissimo ai nostri lettori anche delle mappe dei luoghi che descriviamo? Wikivoyage ne usa diffusamente più tipi, sia statiche che dinamiche. Una prima mappa, statica (che deve attenersi a determinati standard di progetto), è quella descritta poco sopra e gestita tramite il template {{Regionlist}}. Un'altra mappa statica è quella visualizzata automaticamente del {{QuickbarCity}}, atta a indicare dove la città in oggetto si trova all'interno della sua nazione. Altre eventuali mappe statiche non sono altro che semplici immagini e potrai inserirle con la normale sintassi delle immagini [[File:NOME IMMAGINE|thumb|DIMENSIONEpx|DIDASCALIA]]. Ci sono però su Wikivoyage alcune mappe particolari, dette dinamiche, capaci di mostrare al loro interno la posizione di tutti i punti di interesse descritti tramite i listing prima citati, a patto che in questi template siano presenti le coordinate geografiche (latitudine e longitudine) del luogo. Questa mappa è detta dinamica perché non appena si aggiunge o modifica un listing, questo viene mostrato in tempo reale sulla mappa; ma anche perché all'utente è consentito spostarsi per la città "virtualmente" e regolare a piacimento lo zoom. Questa mappa si inserisce con un semplice template:

{{MappaDinamica}}: la cui visualizzazione può essere personalizzata in termini di dimensione della mappa all'interno dell'articolo e punto in cui centrarla.

Template per frasari

I template che seguono ora, sono sì obbligatori, ma solamente in una particolare tipologia di articoli - che speriamo sia presto completata - e cioè quella dei Frasari.

{{TabAvere}} e {{TabEssere}}: mostrano una tabella con la coniugazione dei due ausiliari principali.

{{TabGiorni}}: mostra una tabella con le traduzioni e le pronunce dei giorni della settimana.

{{TabMesi}}: mostra una tabella con le traduzioni e le pronunce dei mesi.

{{TabNumeri}}: mostra una tabella in cui è possibile - e doveroso - inserire le traduzioni e le pronunce dei numerali nella lingua in oggetto.

{{TabPronomiBase}} e {{TabPronomiFlesse}}: mostrano una tabella con le forme dei pronomi personali. Si può usare solo uno dei due, a seconda delle necessità della lingua in oggetto.

{{Traduzione}}: serve per inserire una traduzione di un'espressione in lingua straniera e affiancarle anche la pronuncia. Questo template è usato diffusamente nelle pagine dei frasari. Guarda quello tedesco per un esempio.

Altri template obbligatori

Come già detto per i frasari, alcuni template sono obbligatori solamente quando si presentano casi particolari. Ad esempio:

{{Disambigua}}: la fantasia a volte non è abbastanza e nel corso della storia, per svariate ragioni, più città hanno preso lo stesso nome. E allora come fa l'utente che cerca una città ma potrebbe confondersi con un'altra omonima e raggiungere il posto sbagliato? Semplice, lo guidiamo su una particolare pagina, chiamata disambigua, che presenta tutte le città con lo stesso (o quasi nome). Un esempio, un po' esagerato a dir la verità, è Alekseevka. Questo template serve per uniformare tutte le pagine con lo stessa funzione e indica le città del mondo che portano il nome da lui cercato. Le disambigue si possono poi segnalare anche con {{Nota disambigua}} ma questo lo vediamo tra pochissimo.

{{Exchange_Rate}}: questa comoda tabella crea dei link ai principali siti convertitori di valuta. Si rivela utile, e obbligatorio, solo nelle pagine sugli Stati e in particolare nella sezione "Valuta e acquisti".

Template raccomandati

{{Attenzione}}: stai scrivendo un articolo su una nazione attualmente in guerra o una regione molto pericolosa e vuoi che il lettore ne sia cosciente prima di prenotare subito "un imperdibile" low cost per quella destinazione? Bene, usa questo template inserendo la motivazione del pericolo. Data la sensibilità dell'argomento è opportuno citare la fonte sia all'inserimento che alla sua rimozione (anche all'interno del campo oggetto della modifica).

{{GPX}}: questo template serve a visualizzare dei tracciati GPX all'interno di una mappa dinamica. I tracciati, tipicamente usati per itinerari o per delimitare aree come per un distretto nel relativo articolo, possono essere attivati o meno con una spunta nel menù della mappa. La creazione del tracciato GPX può essere fatto a mano ma è molto più comodo e veloce ricorrere a strumenti esterni. Il file di testo contenente il tracciato GPX dovrà essere inserito in una sottopagina del suddetto template recante il nome dell'articolo in cui lo si vuole visualizzare come per esempio Template:GPX/Covent Garden che produrrà il tracciato in Covent Garden.

{{Lingue}}: ammettiamolo, non tutti hanno dimestichezza con le lingue straniere; eppure può capitare che un articolo abbia collegamenti esterni importanti solo in una lingua che non sia l'italiano. A quel punto possiamo evitare un mal di testa all'utente che aprendo il link si troverà davanti una pagina in russo, cinese o qualsiasi altro oscuro linguaggio apponendo questo semplice template davanti al link. Genera un'etichetta che informa l'utente sulla lingua del sito o dell'elemento che si sta citando: (DE) Alles klar? (tutto chiaro?)

{{Mapmask}}: è utilizzato come GPX per segnare delle aree specifiche in una mappa, magari quella di un quartiere cittadino. Si serve come GPX di alcuni dati ricavabili da un sito esterno, anche se Mapmask non necessita di una pagina template per ogni articolo e tutti i dati possono essere inclusi direttamente nella pagina in cui deve essere usato il template. Consulta la pagina del template per saperne di più.

{{Marker}}: questo template vi aiuterà enumerando automaticamente degli elementi (più propriamente dei punti di interesse) che hanno delle coordinate geografiche quando, a differenza dei {{listing}}, non c'è la necessità (o la possibilità) di aggiungere tutte le altre informazioni (e.g. telefono, indirizzo, sito web, ecc.). Un uso tipico è nei testi in prosa (ossia non nelle liste puntate), perché non producendo nell'articolo visualizzato il link [modifica], ne deriva un output più pulito e scorrevole. Un esempio lo vedete nell'articolo su Reggio Calabria.

{{Nota disambigua}}: il template si usa per quelle pagine che recano un nome simile o uguale ad altre. L'utente potrebbe essere capitato per sbaglio su quella pagina cercandone un altro. Questo template gli indicherà la strada giusta. Questo template è stretto amico del precedente {{Disambigua}} e infatti serve a portare gli utenti da alcune pagine ad una pagina di disambigua. Quali pagine però? Beh, in genere si usa nell'articolo di una città molto più conosciuta rispetto alle altre con lo stesso nome. Facciamo un esempio pratico: Qui su Wikivoyage italiano è molto probabile che se un lettore cerca Genova, stia cercando proprio la città capoluogo della Liguria. Ma magari un utente che cercava l'omonimo comune del Guatemala è capitato li per sbaglio, ma a questo punto come trovare l'articolo desiderato? Proprio a questo scopo è stato inserito il nostro template in cima alla pagina: per indirizzarlo alla corrispettiva pagina di disambigua. Guarda un altro esempio di applicazione in Colombia. Questo template è solitamente inserito automaticamente.
{{Clima}}: template utilizzato per mostrare le condizioni climatiche medie di una località. In genere viene apposto nella sezione "Quando andare" e mostra chiaramente le temperature e le precipitazioni medie per quel luogo. Un articolo completo dovrebbe avere anche questo template.

Template opzionali

Template di avviso

Solitamente vanno apposti in cima alla pagina oppure in corrispondenza del testo "incriminato".

{{Avviso}}: si tratta di un template versatile e multiuso. Può essere usato, a seconda dei parametri inseriti, per decine di situazioni e serve a mostrare un riquadro con un avviso ai lettori.

{{Cancella}}: mostra un avviso che richiede la cancellazione immediata della pagina per i motivi previsti dalle apposite linee guida. Un amministratore verificherà e nel caso eliminerà la pagina.

{{Copyvio}}: se hai scoperto che un pezzo di articolo presente su Wikivoyage è copiato da una fonte non libera, allora non solo puoi ma sei fortemente incoraggiato a rimuoverlo immediatamente. Poi apponi questo template in cima, in modo che un amministratore possa controllare la situazione e agire di conseguenza.

{{Da aggiornare}}: quando si inserisce un prezzo per una camera in hotel questo può cambiare oppure capita che si menzioni una manifestazione che avrà luogo solamente questo o il prossimo anno, è conveniente porre un promemoria che ci ricordi il momento in cui quel prezzo o quel testo va aggiornato. Il template fa esattamente questo.

{{Da dividere}}: quando una pagina è troppo ampia e si pensa che sia meglio dividerla in due più specifiche, inserire questo emplate in cima.

{{Da unire}}: quando due pagine trattano un argomento simile e unificabile, inserire questo emplate in cima.

{{Disclaimer}}: quando i contenuti di un articolo che si sta consultando potrebbero potenzialmente provocare un rischio, una situazione di pericolo o una condizione di disagio per il lettore.

{{Stile}}: è un po' come un cattivo voto a scuola; indica che una pagina ~~fa pena~~ s'impegna ma non ha raggiunto buoni risultati in quanto a stile oppure che il modello non è stato applicato correttamente.

{{WIP open}}: stai apportando modifiche importanti a una pagina e vorresti finire prima che altri utenti diano il loro contributo per evitare di pestarvi vicendevolmente i piedi (alias conflitti di edizioni)? Questo template fa per te. Inseriscilo in cima alla pagina e segnalerai che nella pagina ci sono Work In Progress e che qualcuno (cioè tu) è già all'opera per migliorarla.

Vari

{{Abbr}}: nel tuo articolo compare qualche sigla e per chissà quale motivo non puoi esplicitarla ma vuoi comunque che si capisca cosa significhi. Bene QTLFPT (poni sopra il mouse e aspetta un secondo).

{{Citazione}}: i maestri romanzieri insegnano che è meglio evitare di inserire troppe citazioni in un testo ma a volte una ci può scappare. Questo template è programmato per gestire al meglio i casi in cui si abbia bisogno di citare una frase altrui. Non abusarne!

{{Lista su Colonne}}: utile se avete bisogno di dividere il testo in colonne. Sebbene molto utile, è opportuno non abusarne per via dell'incompatibilità con alcuni vecchi browser, i quali lo ignoreranno mostrando il testo in un'unica colonna.

Template per bandiere nazionali: Se si sta compilando una lista e si vuole indicare visivamente i vari paesi interessati, si possono usare questi simpatici templati. Basta inserire il codice del paese tra le parentesi graffe tipiche del template e il gioco sarà fatto. Esempio {{BIH}} produrrà Bosnia ed Erzegovina

{{Galleria}}: com'è facile immaginare il template crea un riquadro con una serie di immagini. Il suo uso su Wikivoyage è sconsigliato per varie ragioni che potrai leggere nella pagina del template. Va utilizzato in alternativa al <gallery> quando, per esempio, stai descrivendo l'evoluzione di qualcosa e ti servono immagini in sequenza per corredare - anche visivamente - la tua spiegazione. Cerca però di non abusarne.

{{IsInCat}}: è il template fratello del codice [[Categoria:NOME CATEGORIA]] [[Categoria:Aiuto]] e infatti serve per... categorizzare. Crea, inoltre, il menù di navigazione in cima alla pagina detto anche breadcrumb. Un suo fratello più generico è il template {{IsIn}}

{{Maiuscoletto}}: questo template che è fondamentale in altri progetti come Wikisource, qui non trova grandi campi d'applicazione. Può essere utile se scrivete delle guide così precise tanto da riportare un'antica iscrizione latina (molto spesso rese appunto con questa formattazione).

{{Photolist}}: serve nei casi in cui una lista di monumenti, o chiese, debba essere affiancata da una foto per ogni elemento. Al momento questo template è in disuso ma potete vedere un esempio nell'articolo sulla Franciacorta

Template per le pagine discussioni e pagine di servizio

I template che seguono sono stati separati dagli altri perché non possono essere usati (o meglio, si consiglia di non usarli) nelle pagine degli articoli. Tornano utili, invece, nelle discussioni (articolo, lounge o utente) e nelle pagine di servizio di Wikivoyage.

{{Richiesta modifica}}: alcune pagine sono protette per evitare vandalismi o perché molto delicate. Se individui un errore o hai bisogno di modificarle, questo template serve ad avvertire un amministratore che provvederà ad effettuare la modifica.

{{Tradotto da}}: siete instancabili traduttori? Avete tutta la nostra stima, ma come ben saprete, è buona norma, a volte è obbligatorio, citare la fonte da cui si traduce. Ricordatevi che la traduzione di un sito non libero non elimina il copyright. Anche la traduzione va riformulata a parole vostre. Tornando all'indicazione della fonte, potete farlo in diversi modi, uno dei quali è l'utilizzo di questo template da apporre nella pagina di discussione dell'articolo. Tuttavia è consigliabile, al suo posto, inserire il link permanente del sito tradotto nell'oggetto della vostra modifica prima di salvare la traduzione.

Votazioni

A volte, a dire il vero sempre, nelle discussioni è consigliabile marcare visivamente se il proprio intervento è a favore, contro, è solo un commento. Questo rende immediato per chi guarda una votazione, ad esempio, capire se il parere degli utenti pende favorevolmente o meno.

{{Domanda}}: produce Domanda:
{{Commento}}: produce Commento:
{{Contrario}}: produce Contrario
{{Favorevole}}: produce Favorevole
{{Cancellare}}: produce Cancellare
{{Neutrale}}: produce Neutrale
{{Mantenere}}: produce Mantenere

Vari

Altre volte è necessario indicare, specie nelle pagine di servizio, ciò che è stato già fatto e ciò che ancora necessita il nostro aiuto. Quest'indicazione si può ottenere in maniera molto efficace con due semplicissimi template:

{{Fatto}}: produce Fatto
{{Doing}}: produce In corso...
{{Non fatto}} produce Non fatto

Ad ognuno di questi potrete aggiungere un parametro con un testo alternativo, mantenendo però icona e stile.

Ci sono ancora altri template che si possono usare nella normale vita di comunità, nelle discussioni, ad esempio. Essi sono:

{{Cassetto}}: stai creando la tua pagina utente e la vuoi il più completa possibile, oppure hai necessità di creare una pagina in cui una porzione di testo appaia "a comando". In questo caso puoi infilare tutto nel cassetto che - obbediente come un fido - si aprirà solo se cliccherai su "Espandi". Tieni conto che gli articoli di Wikivoyage devono essere pensati per essere stampati, e questo template ne preclude la possibilità, quindi il suo utilizzo deve essere ponderato.

{{Section}}: serve a formattare il testo, il titolo e il box di testo delle pagine dei portali. In aggiunta si possono inserire parametri aggiuntivi per la formattazione dei bordi. Tuttavia, non è un template che ti troverai ad usare spesso, a meno che (lo speriamo tutti), tu non diventi un wikivoyage-dipendente.

{{U}}: è uno dei template più usati in assoluto e serve per notificare ad un utente che lo si sta menzionando in una discussione. In gergo quest'operazione si chiama pingare.

{{Tasto}}: utile se state discutendo e volete indicare quali tasti pigiare per una determinato scopo. Supponiamo che tu voglia aiutare un utente che ha pochissime conoscenze informatiche e voglia spiegarli come fare a copiare e incollare velocemente del testo; in questo caso gli potrai scrivere così: "Puoi semplicemente selezionare il testo e premere Ctrl+C per copiare e Ctrl+V per incollarlo."

{{Vetrina inserimento}} e {{Vetrina rimozione}} servono per avvisare dell'intenzione di candidare alla o rimuovere dalla vetrina un articolo. Va posto in cima all'articolo relativo ma con raccomandiamo di usarlo con mooolta parsimonia. Arrivare in vetrina è un percorso lungo e l'articolo sarà analizzato, letto e riletto e non sfuggirà nessun difetto. Di norma dovrebbero essere molto pochi gli articoli considerati ad vetrina.

A volte può anche essere utile citare un template o una categoria, senza pericolo che questi si applichino alla pagina corrente. In questo caso ci vengono in aiuto due comodi template:

{{Ct}}: quest'altro, amico del successivo, mostra il link alla categoria inserita come parametro, senza che la pagina in cui è stato utilizzato questo template venga inserita in quella categoria.

{{Tl}}: spiegare cosa fa è semplice; basta guardare questa stessa pagina in cui è stato usato diffusamente. Serve per mostrare un link alla pagina del template (senza eseguirne il codice) mostrandone il nome tra due parentesi graffe.

Se invece siete utenti appassionati di questioni tecniche potrete voler citare un bug relativo ad un'aspetto di Wikivoyage o una discussione importante in Phabricator. Il template giusto da usare in questo caso è:

{{Tracked}}: il template accetta due parametri; uno con l'id del bug o della discussione su Phabricator (e per retrocompatibilità anche su Bugzilla) e l'altro (opzionale) con lo stato attuale di quel bug: risolto, respinto, stallo, duplicato o aperto.

Limitazioni

Un nome di parametro o il suo valore non può contenere il carattere "|", dal momento che serve per separare i parametri. Eventuali "|" all'interno dei wikilink (piped link) o di altri template non sono un problema, ma se occorre inserire un "|" per altri motivi, usare il comando {{!}}.

questa sintassi funziona correttamente: {{Template|[[Selandia (isola)|Selandia]]}}

ma questa non funziona: {{Template|La | è una barra}}

per porvi rimedio, è necessario usare questa variante: {{Template|La {{!}} è una barra}}

Inoltre, se il nome delle variabili non viene specificato, il loro valore non può contenere il segno "=". Se si ha bisogno di inserire il segno "=" in un template che usa i nomi impliciti per le variabili allora è necessario esplicitarne il nome, ad esempio:

questa sintassi funziona correttamente: {{Template|A|B}}

ma questa non funziona: {{Template|A=10|B=32}}

per porvi rimedio, è necessario usare questa variante: {{Template|1= A=10|2= B=32}}

Oppure si può usare il template {{=}} nel seguente modo: {{Template|A{{=}}10|B{{=}}32}}.

Vedi anche

Mi sembra di aver capito, ma...

Se non riesci ad afferrare qualche concetto o non capisci il perché di tale procedura, ci metti cinque secondi a chiederlo e avere risposta. Se pensi invece di avere una proposta, piccola o grande che sia, siamo tutti pronti ad ascoltarti.

L'elenco di tutte le pagine riguardanti Wikivoyage si trova nella pagina Aiuto:Aiuto.

Aiuto:Template

Cos'è un template

Perché usarli

Note sull'utilizzo

Un paio di trucchetti

Template obbligatori

Modelli

{{Quickbar}}

{{Quickfooter}}

{{Listing}}

Dai listing alle liste

Mappe

Template per frasari

Altri template obbligatori

Template raccomandati

Template opzionali

Template di avviso

Vari

Template per le pagine discussioni e pagine di servizio

Votazioni

Vari

Limitazioni

Vedi anche

Mi sembra di aver capito, ma...