Le istruzioni che seguono sono contenute nella sottopagina Template:Mappa di localizzazione/man (modifica · cronologia)
Sandbox: Template:Mappa di localizzazione/Sandbox (modifica · cronologia) · TemplateStyles: Template:Mappa di localizzazione/styles.css (modifica · cronologia) · Tutte le sottopagine: lista
Il template oggetto del presente manuale crea una mappa di localizzazione utilizzando un'immagine composta da una mappa esistente in proiezione ortografica e un simbolo ed etichetta ad essa sovrapposti.
Utilizzo
|
{{Mappa di localizzazione
|"CODICE MAPPA"
|label =
|label_size =
|position =
|background =
|latitudineGradi =
|latitudinePrimi =
|latitudineSecondi =
|latitudineNS =
|longitudineGradi =
|longitudinePrimi =
|longitudineSecondi =
|longitudineEW =
|lat =
|long =
|mark =
|marksize =
|link =
|border =
|caption =
|float =
|width =
|max_height =
|relief =
|AlternativeMap =
|noerr =
|cat_fuorimappa =
|sinottico =
}}
Coordinate
Le coordinate vanno inserite in uno dei due seguenti formati:
- gradi decimali: attraverso i parametri "lat" e "long"
- gradi sessagesimali (gradi, minuti e secondi): attraverso i parametri latitudineGradi, latitudinePrimi, latitudineSecondi, latitudineNS, longitudineGradi, longitudinePrimi, longitudineSecondi e longitudineEW. Questo formato è anche detto DMS (dall'inglese degrees, minites, seconds).
Se si utilizzano lat e long non vanno utilizzati i parametri per i gradi sessagesimali, e viceversa.
Se le coordinate non sono inserite ma sono presenti sull'item Wikidata collegato, vengono lette da Wikidata. Se non presenti neanche su Wikidata viene visualizzato un messaggio di errore.
Mappe disponibili
Sono disponibili mappe per tutti gli stati e dipendenze dotati di codice ISO 3166-1 alpha-3 (il nome della mappa è uguale al codice). Ci sono anche alcune mappe per regioni nazionali e internazionali, stati storici e grandi città.
Per conoscere tutte le mappe attualmente disponibili vedi la Categoria:Template mappa di localizzazione e per un elenco alfabetico Speciale:Prefissi/Template:Mappa_di_localizzazione/ (quelli in corsivo sono redirect, da evitare in quanto utilizzano la codifica CIO anziché i codici ISO).
Segnalazione errori
Il template effettua una serie di controlli sui parametri e in caso di errore visualizza un messaggio appropriato e categorizza la voce in Categoria:Errori di compilazione del template Mappa di localizzazione, o nelle più specifiche Categoria:Pagine con mappa di localizzazione non esistente e Categoria:Pagine con coordinate al di fuori della mappa di localizzazione.
Elenco dei possibili messaggi di errore, con la loro spiegazione:
- "Mappa non specificata": non è stato specificato il primo parametro, senza nome, del template, che rappresenta il nome della mappa
- "Mappa non disponibile": non esiste la pagina "Template:Mappa di localizzazione/nome mappa"
- "Latitudine non specificata": non è stata inserita la latitudine in formato decimale o DMS, e non è presente su Wikidata
- "Longitudine non specificata": non è stata inserita la longitudine in formato decimale o DMS, e non è presente su Wikidata
- "I gradi/minuti/secondi di latitudine/longitudine non sono validi": i valori di latitudine/longitudine inseriti in formato decimale (o DMS) non sono validi
- "Coordinate al di fuori della mappa": le coordinate inserite, o in loro assenza lette da Wikidata, indicano una posizione al di fuori della mappa
- Errori specifici del formato DMS:
- "I gradi decimali e DMS non vanno utilizzati insieme per la latitudine/longitudine": sono stati valorizzati latitudineGradi/longitudineGradi, quando era già presente "lat"/"long" (decimale)
- "I minuti vanno utilizzati insieme ai gradi DMS per la latitudine/longitudine": sono stati valorizzati latitudinePrimi/longitudinePrimi, quando era già presente "lat"/"long" (decimale)
- "I secondi vanno utilizzati insieme ai gradi DMS per la latitudine/longitudine": sono stati valorizzati latitudineSecondi/longitudineSecondi, quando era già presente "lat"/"long" (decimale)
- "L'emisfero va utilizzato insieme ai gradi DMS per la latitudine/longitudine": sono stati valorizzati latitudineNS/longitudineEW, quando era già presente "lat"/"long" (decimale)
- "I minuti di latitudine/longitudine sono utilizzati senza i gradi": sono stati valorizzati latitudinePrimi/longitudinePrimi senza latitudineGradi/longitudineGradi
- "I secondi di latitudine/longitudine sono utilizzati senza i minuti": sono stati valorizzati latitudineSecondi/longitudineSecondi senza latitudinePrimi/longitudinePrimi
- "L'emisfero di latitudine/longitudine è utilizzato senza i gradi": sono stati valorizzati latitudineNS/longitudineEW senza latitudineGradi/longitudineGradi
- "L'emisfero di latitudine/longitudine non è valido": il valore inserito per latitudineNS/longitudineEW non è valido.
Esempi
Mappa con didascalia default (in gradi)
Pago (Croazia)
{{Mappa di localizzazione |HRV |label = Pago |latitudineGradi = 44 |latitudinePrimi = 26 |longitudineGradi = 15 |longitudinePrimi = 3 |position = right |width = 200 |float = right }} |
Mappa con didascalia default (decimale)
Pago (Croazia)
{{Mappa di localizzazione |HRV |label = Pago |lat = 44.44 |long = 15.05 |position = right |width = 200 |float = right }} |
Mappa con didascalia e sfondo personalizzati
Imotski
{{Mappa di localizzazione |HRV |label = Imotski |lat = 43.44 |long = 17.21 |position = right |width = 200 |float = right |background = #FFFFDD |caption = Posizione di Imotski in Croazia }} |
Mappa con etichetta e simbolo più grandi del valore default
Pago (Croazia)
{{Mappa di localizzazione |HRV |label = Pago |label_size = 200 |lat = 44.44 |long = 15.05 |marksize = 14 |position = right |width = 200 |float = right |background = #FFFFDD |caption = L'isola di Pago in Croazia }} |
Mappa senza didascalia
Brčko (Bosnia Erzegovina)
{{Mappa di localizzazione |BIH |label = Brčko |position = left |width = 150 |lat = 44.87 |long = 18.81 |float = right |caption = }} |
Emisfero occidentale (in gradi)
Lockerbie (Scozia)
{{Mappa di localizzazione |SCO |label = Lockerbie |latitudineNS = N |latitudineGradi = 55 |latitudinePrimi = 07 |latitudineSecondi = 15.93 |longitudineEW = W |longitudineGradi = 03 |longitudinePrimi = 21 |longitudineSecondi = 19.05 |position = right |width = 200 |float = right |caption = Posizione di Lockerbie in Scozia }} |
Emisfero occidentale (decimale)
Lockerbie (Scozia)
{{Mappa di localizzazione |SCO |label = Lockerbie |lat = 55.121091 |long = -3.355293 |position = right |width = 200 |float = right |caption = Posizione di Lockerbie in Scozia }} |
Nazioni che attraversano il 180º meridiano
Uelen (Russia)
{{Mappa di localizzazione |RUS |label = Uelen |latitudineGradi = 66 |latitudinePrimi = 09 |latitudineSecondi = 34.00 |longitudineGradi = 169 |longitudinePrimi = 48 |longitudineSecondi = 33.00 |longitudineEW = E |position = left |width = 500 |float = right |background = #FFFFDD }} |
Creare nuove mappe
- Trovate una mappa senza scritte e in proiezione ortografica
- Create la sottopagina del Template:Mappa di localizzazione utilizzando, se esiste, la codifica ISO 3166-1 alpha-3 altrimenti il nome del luogo (altri nomi si possono creare come redirect)
- Inserire nella pagina (completandolo) il seguente codice:
{{#switch:{{{1}}} |name = |top = |bottom = |left = |right = |image = |image1 = }}<noinclude>{{Mappa di localizzazione/info|cat=}} </noinclude>
- name = nome italiano del luogo
- top = latitudine decimale della cima della mappa
- bottom = latitudine decimale del fondo della mappa
- left = longitudine decimale del lato sinistro della mappa
- right = longitudine decimale del lato destro della mappa
- image = nome del file della mappa
- image1 = [opzionale] nome del file della mappa fisica (se la precedente è politica)
Altri elementi opzionali dello #switch, raramente utilizzati:
- ratio = rapporto altezza : larghezza dell'immagine, con il punto per i decimali, ad es. se l'immagine base è 250x400 indicare 0.625; abilita l'uso di max_height, generalmente utile per le mappe molto estese in verticale
- crosses180 = inserire valore non vuoto se la mappa attraversa il 180º meridiano
- mark = nome file per un segnalino di default diverso dal pallino rosso
- marksize = dimensione del segnalino di default diverso dal pallino rosso
Nei casi particolari di mappe non equirettangolari, si aggiungono i seguenti elementi allo #switch:
- x = espressione (per #expr) che calcola la posizione orizzontale in pixel in funzione di latitudine (variabile {{{2}}}) e longitudine (variabile {{{3}}})
- y = espressione (per #expr) che calcola la posizione verticale in pixel in funzione di latitudine (variabile {{{2}}}) e longitudine (variabile {{{3}}})
Parametri del Template:Mappa di localizzazione/info:
- cat = assegna un'eventuale sottocategoria alla sottopagina della mappa
N.B. Copiare una mappa da una Teknopedia straniera in genere è facile, basta tradurre il "name" e correggere la parte dopo "noinclude". Verifica però che non abbiamo già tale mappa sotto un altro nome (codice o nome italiano).
Pagine correlate
- Template:Mappa di localizzazione+
- Template:Mappa di localizzazione~
- Modulo:Mappa di localizzazione: modulo che implementa le funzionalità dei template delle mappe di localizzazione
Dati per VisualEditor
La tabella TemplateData che segue è contenuta nella sottopagina Template:Mappa di localizzazione/TemplateData (modifica·cronologia)
Questo template crea una mappa di localizzazione utilizzando un'immagine composta da una mappa esistente in proiezione ortografica e un simbolo ed etichetta ad essa sovrapposti.
Parametro | Descrizione | Tipo | Stato | |
---|---|---|---|---|
Luogo | 1 | Nome descrittivo della mappa o codice ISO 3166-1 alpha-3 (es. ITA, GBR, ...). Il nome si riferisce alla sottopagina {{Template:Mappa di localizzazione/luogo}} contenente i dati della mappa. | Stringa | obbligatorio |
Etichetta | label | Testo dell'etichetta | Stringa | facoltativo |
Etichetta | label_size | Dimensione percentuale dell'etichetta, senza il simbolo % (per esempio, 90)
| Numero | facoltativo |
Posizione | position | Posizione dell'etichetta rispetto al punto. Scegliere tra: left / right / top / bottom / topleft / topright / bottomleft / bottomright. Di default posiziona in basso a destra, o a sinistra se troppo vicino al bordo destro.
| Stringa | facoltativo |
Sfondo | background | Colore di sfondo per l'etichetta. Di default non c'è sfondo. Può essere espresso in coordinate RGB esadecimali (es. #FF0000 per il colore rosso, #FFFF00 per il colore giallo eccetera). | Stringa | facoltativo |
Gradi di latitudine | latitudineGradi | Gradi di latitudine. Inserire solo il numero, senza il simbolo ° e senza unità di misura (es. 45) | Numero | facoltativo |
Primi di latitudine | latitudinePrimi | Minuti primi di latitudine. Inserire solo il numero, senza il simbolo ' e senza unità di misura (es. 45) | Numero | facoltativo |
Secondi di latitudine | latitudineSecondi | Minuti secondi di latitudine. Inserire solo il numero, senza il simbolo " e senza unità di misura (es. 45) | Numero | facoltativo |
Direzione latitudine | latitudineNS | Indica se si tratta di latitudine nord (N) oppure sud (S). Scegliere tra: N / S
| Stringa | facoltativo |
Gradi di longitudine | longitudineGradi | Gradi di longitudine. Inserire solo il numero, senza il simbolo ° e senza unità di misura (es. 45) | Numero | facoltativo |
Primi di longitudine | longitudinePrimi | Minuti primi di longitudine. Inserire solo il numero, senza il simbolo ' e senza unità di misura (es. 45) | Numero | facoltativo |
Secondi di longitudine | longitudineSecondi | Minuti secondi di longitudine. Inserire solo il numero, senza il simbolo " e senza unità di misura (es. 45) | Numero | facoltativo |
Direzione longitudine | longitudineEW | Indica se si tratta di latitudine est (E) oppure ovest (W). Scegliere tra: E / W
| Stringa | facoltativo |
Latitudine | lat | Latitudine espressa in formato decimale (es. 55.121091). Per latitudini sud inserire valori negativi. | Stringa | facoltativo |
Longitudine | long | Longitudine espressa in formato decimale (es. -3.355293). Per longitudini ovest inserire valori negativi. | Stringa | facoltativo |
Marca | mark | Nome del file dell'immagine usata come simbolo per marcare la posizione. Di default è un punto rosso. | Stringa | facoltativo |
Dimensione marca | marksize | Dimensioni del simbolo in pixel, senza unità di misura (es. 8).
| Numero | facoltativo |
Rimando | link | Titolo di una voce a cui mandare quando si clicca il punto rosso. | Nome della pagina | facoltativo |
Bordo | border | Colore del bordo. Il valore "none" indica nessun bordo. Può essere espresso in coordinate RGB esadecimali (es. #FF0000 per il colore rosso, #FFFF00 per il colore giallo eccetera). | Stringa | facoltativo |
Didascalia | caption | Didascalia sotto la mappa; se non si vuole, indicare esplicitamente "caption="; se il parametro è omesso la didascalia sarà il valore indicato per il parametro Luogo. | Stringa | facoltativo |
Allineamento | float | Allineamento della mappa. Scegliere tra: left / right / center / none | Stringa | facoltativo |
Larghezza mappa | width | Larghezza della mappa in pixel, senza unità di misura (es. 200).
| Numero | facoltativo |
Mappa fisica | relief | Inserire un valore qualsiasi per utilizzare la carta fisica anziché politica (se disponibile). | Stringa | facoltativo |
Mappa alternativa | AlternativeMap | Nome dell'eventuale immagine alternativa. | Stringa | facoltativo |