Template:Listing/man
Questo template, largamente utilizzato in ogni articolo presente su una qualunque versione linguistica di Wikivoyage, è utilizzato per organizzare le informazioni in modo strutturato e di conseguenza per visualizzare in modo uniforme.
All'interno del modello degli articoli già si trovano commentati i template specifici di questa famiglia che vanno utilizzati in ogni sezione. Ogni volta che si inseriscono informazioni strutturate tramite questo template, quello commentato potrà e dovrà essere rimosso.
Se le informazioni verranno inserite tramite listing editor, quest'ultimo si occuperà direttamente della rimozione del listing commentato.
Maggiori informazioni sulla relativa pagina di servizio.
Utilizzo
[modifica]* {{listing
| tipo=TIPO DI LISTING (see, do, buy, eat, drink, sleep)
| nome=NOME DELL'OGGETTO LISTATO ('''campo obbligatorio''')
| alt=NOME ALTERNATIVO
| sito=INDIRIZZO WEB
| email=INDIRIZZO MAIL
| indirizzo=INDIRIZZO GEOGRAFICO
| lat=LATITUDINE
| long=LONGITUDINE
| indicazioni=BREVE DESCRIZIONE SU COME ARRIVARE
| tel=NUMERO TELEFONICO
| numero verde=NUMERO VERDE
| fax=NUMERO DI FAX
| orari=ORARI DI VISITA/APERTURA
| prezzo=PREZZO DA PAGARE
| checkin=ORARIO DI CHECKIN (solo per i LISTING di tipo SLEEP)
| checkout=ORARIO DI CHECKOUT (solo per i LISTING di tipo SLEEP)
| descrizione=BREVE DESCRIZIONE
}}
Solo nome è obbligatorio, ma si dovrebbe sempre fornire ulteriori informazioni. Il nome ha anche la funzione di ancora all'interno della pagina in cui si trova, ossia, è possibile creare dei collegamenti interni semplicemente aggiungendo il rispettivo wikilink. Ad esempio questo wikilink (la cui wiki-sintassi è [[#Basilica di Santa Maria Novella|questo wikilink]]) porterà il lettore direttamente nel listing utilizzato in questa pagina.
Importante:
- A differenza di quanto accadeva con i vecchi listing in formato XML, NON vanno usate le virgolette (i.e. ") intorno ai valori forniti.
- "lat" e "long" vanno scritti rispettivamente in accordo alle coordinate WGS84.
- in generale, l'uso dei tag HTML ( <br/> , ecc.) è da evitare nel testo degli articoli. In particolare, va evitato nei listing, in quanto è il template stesso a formattare in modo uniforme i contenuti in esso inseriti.
Esempio
[modifica]- 1 Basilica di Santa Maria Novella, Piazza S. Maria Novella 18, ☎ +39 055 21 92 57, fax: +39 055 90 67 593, info@smn.it.
intero: 5€, ridotto: 3,5€ (gennaio 2014). 
Lun-Gio 9:00-17:30, Ven 11:00-17:30, Sab 9:00-17:00, Dom 13:00-17:00. La prima grande basilica gotica a Firenze che fu il punto di riferimento per l'ordine mendicante dei domenicani. La sua costruzione iniziò nel 1279 terminando a metà del XIV secolo anche grazie alle indulgenze dei benestanti fiorentini che volevano assicurare la propria sepoltura in terra consacrata e dei quali oggi restano i loro blasoni. La facciata venne ristrutturata nel 1456 da Leon Battista Alberti. L'architetto enfatizzò il portale con un arco a tutto sesto e i portali e le tombe laterali con archi a ogiva. Alberti aggiunse anche due volute laterali per nascondere gli spioventi del tetto. All'interno si può ammirare la "Trinità" di Masaccio e in fondo alla navata principale è stato ricollocato dal 2001 il Crocifisso di Giotto (databile verso il 1290), dopo dodici anni di restauro, nella posizione dove verosimilmente doveva trovarsi fino al 1421. 
Generato dal seguente sorgente:
* {{see
| nome=Basilica di Santa Maria Novella | alt= | sito=https://www.smn.it | email=info@smn.it
| indirizzo=Piazza S. Maria Novella 18 | lat=43.7746 | long=11.2493 | indicazioni=
| tel=+39 055 21 92 57 | numero verde= | fax=+39 055 90 67 593
| orari=Lun-Gio 9:00-17:30, Ven 11:00-17:30, Sab 9:00-17:00, Dom 13:00-17:00 | prezzo=intero: 5€, ridotto: 3,5€ (gennaio 2014)
| wikidata=Q51175
| descrizione=La prima grande basilica gotica a Firenze che fu il punto di riferimento per l'ordine mendicante dei domenicani. La sua costruzione iniziò nel 1279 terminando a metà del XIV secolo anche grazie alle indulgenze dei benestanti fiorentini che volevano assicurare la propria sepoltura in terra consacrata e dei quali oggi restano i loro blasoni. La facciata venne ristrutturata nel 1456 da Leon Battista Alberti. L'architetto enfatizzò il portale con un arco a tutto sesto e i portali e le tombe laterali con archi a ogiva. Alberti aggiunse anche due volute laterali per nascondere gli spioventi del tetto. All'interno si può ammirare la "Trinità" di Masaccio e in fondo alla navata principale è stato ricollocato dal 2001 il Crocifisso di Giotto (databile verso il 1290), dopo dodici anni di restauro, nella posizione dove verosimilmente doveva trovarsi fino al 1421.
}}
Utilizzo dei listing all'interno degli articoli
[modifica]L'uso dei {{listing}} va sempre inteso nei confronti dell'articolo gerarchicamente più in basso. Un articolo regionale non dovrebbe contenere listing per descrivere un'attrazione ma rimandare all'articolo della città di pertinenza. Allo stesso modo in una città dove sono presenti delle suddivisioni in distretti i listing andrebbero applicati solo ai distretti. Infine, qualora un distretto di grandi dimensioni (e.g. Manhattan) fosse diviso in più sotto-distretti, i listing andranno inseriti in quest'ultimi. Qualora si voglia localizzare la posizione di un'attrazione negli articoli gerarchicamente superiori, si può utilizzare il {{marker}}, ma con un uso non eccessivo.
Nel caso di trasporti come ferrovie, bus, tram, ecc. il listing può essere utilizzato in tutti i livelli gerarchici e con descrizioni coerenti col grado di prossimità, cioè non si descriveranno nel dettaglio voli e trasporti legati all'aeroporto negli articoli gerarchicamente superiori ma se ne farà un sunto.
Per gli aeroporti vale la regola generale, ma con la differenza che andranno inseriti tramite {{marker}} in quando è prevista la creazione di un articolo ad essi dedicato.
TemplateData
[modifica]Questo template è usato per descrivere elementi di varia natura.
| Parametro | Descrizione | Tipo | Stato | |
|---|---|---|---|---|
| Nome | nome | Nome dell'elemento
| Stringa | obbligatorio |
| Nome alternativo | alt | Nome alternativo con cui è conosciuto l'elemento (se esiste). Spesso usato per elementi stranieri
| Stringa | consigliato |
| Sito | sito | Indirizzo web (URL) dell'elemento in oggetto, inclusivo di http:// o https:// all'inizio
| URL | consigliato |
email | Indirizzo email dell'elemento in oggetto
| Stringa | consigliato | |
| Indirizzo | indirizzo | Indirizzo fisico dell'elemento in questione. Per evitare ridondanze inutili non si specifica mai la città (oggetto dell'articolo), tanto meno la provincia, e nemmeno il CAP quando si parla di piccole città. Nelle metropoli talvolta il CAP (o ZIP code) è essenziale perché lo stesso nome di una via è usato in più luoghi. Il formato preferibile è "nome via, numero civico"
| Stringa | consigliato |
| Latitudine | lat | Latitudine dell'elemento in oggetto
| Numero | consigliato |
| Longitudine | long | Longitudine dell'elemento in oggetto
| Numero | consigliato |
| Indicazioni | indicazioni | Breve descrizione che facilita il raggiungimento dell'indirizzo. Può includere strade limitrofe o con cui l'elemento fa angolo, oppure i mezzi di trasporto pubblici che ci arrivano, comprese le fermate più vicine, o anche una descrizione visiva per quei luoghi di non facile individuazione
| Stringa | consigliato |
| Tel | tel | Contatto telefonico comprensivo del prefisso nazionale. Gli eventuali zeri presenti nel codice distrettuale che non si digitano in presenza del numero nazionale, non vanno inseriti (nemmeno tra parentesi). Qualora ci fosse più di un numero di telefono, questi andreanno separati da una virgola. Qualora si volesse specificare delle note su uno o più di questi numeri, in coda al numero si potrà mettere un breve testo tra parentesi
| Stringa | consigliato |
| Numero verde | numero verde | Numero verde comprensivo del prefisso nazionale. | Stringa | consigliato |
| Fax | fax | Numero di fax
| Stringa | consigliato |
| Orari di apertura | orari | I giorni vanno sempre indicati con le tre lettere iniziali (la prima maiuscola e le altre minuscole). Per indicare una sequenza di giorni, si separa i due giorni estremi con un trattino. Gli orari si indicano con formato a 24 ore in formato italiano (ossia usando i due punti come separatore di ore e minuti). Il simbolo che separa gli orari è il trattino. Il simbolo che separa due coppie di "giorni-orari" è la virgola. Qualora le fasce orarie cambiassero per mesi o stagioni diverse, questi andranno anteposti a tali fasce, separandoli dalle stesse con i due punti. Gruppi contigui di mesi e stagioni saranno separati da un trattino. Le chiusure settimanali non si indicano, ma si evincono dalla loro assenza nella lista delle aperture
| Stringa | consigliato |
| Prezzo | prezzo | Prezzo associato all'elemento in oggetto. Se ci sono più tipologie di prezzi, questi vanno separati da virgole. Dato che i prezzi sono molto soggetti a variazioni, è opportuno specificare tra parentesi un riferimento temporale per capire quanto è affidabile l'informazione
| Stringa | consigliato |
| Articolo su Wikipedia | wikipedia | Articolo su Wikipedia in italiano relativo all'elemento in oggetto. Ottenuto automaticamente se è presente il collegamento a Wikidata.
| Nome della pagina | facoltativo |
| Collegamento a Wikidata | wikidata | Identificativo univoco dell'istanza Wikidata relativa all'elemento in oggetto
| Numero | consigliato |
| Immagine su Commons | immagine | Immagine su Wikimedia Commons dell'elemento in oggetto. Ottenuto automaticamente se è presente il collegamento a Wikidata. Se inserito manualmente va omesso il prefisso 'File:' (o equivalenti)
| Stringa | facoltativo |
| Descrizione | descrizione | Breve Descrizione dell'elemento in oggetto. La descrizione di un listing va sempre conclusa con un punto di fine periodo
| Contenuto | consigliato |