Aiuto:Mappe Interattive

Le Mappe Interattive sono una funzione disponibile su Fandom che permette alle community di progettare le proprie mappe personalizzate ed è disponibile di default su tutte le wiki.

Per iniziare

La creazione e la modifica delle mappe è attualmente limitata a chi possiede il permesso utente editinteractivemap, che è automaticamente fornito agli amministratori e allo Staff di Fandom. C'è poi un gruppo utente "Interactive map tester" che gli amministratori possono dare agli utenti per permettere loro di creare e modificare le Mappe.

Una volta che hai il permesso di modificare le mappe, poi trovare un link "Mappe Interattive" nel menù di navigazione Esplora, o puoi direttamente recarti allo strumento di creazione visitando la pagina Speciale:AllMaps sulla tua wiki, dove poi creare la tua Mappa e trovare la lista di tutte le Mappe che esistono sulla tua community.

Tutte le Mappe Interattive vivono nel namespace Mappa:, per esempio /wiki/Mappa:La_Mia_Nuova_Mappa. Le Mappe create in qualsiasi altro namespace, incluse le sottopagine utente, non saranno generate correttamente. Quando si crea una Mappa attraverso il pulsante in Speciale:AllMaps, questo namespace viene aggiunto automaticamente evitando di dover inserire come parte del titolo della pagina.

A meno che tu non abbia impostato le tue preferenze per usare l'editor sorgente, il pulsante "Modifica" in alto a destra in qualsiasi pagina del namespace Map aprirà l'editor visuale delle Mappe Interattive, che è l'opzione studiata per modificare le Mappe velocemente e facilmente. Cliccare "Modifca sorgente" dal menù a tendina ti porterà invece all'editor sorgente e caricherà la struttura JSON (JavaScript Object Notation) sottostante della mappa. Se hai l'editor sorgente come tua preferenza, queste opzioni sono invertite e il pulsante nel menù a tendina recita "Modifica mappa". Cliccare l'icona con la matita presente sulla mappa stessa aprirà sempre l'editor visuale delle Mappe Interattive. All'interno dell'editor visuale delle Mappe Interattive, portando il cursore sopra i tre pallini verticali ⋮ si aprirà una tendina con l'opzione per la modifica sorgente.

Costruire una Mappa con l'editor Mappe Interattive

Visualizzazione della mappa

Questa sezione ti permette di visualizzare il nome della tua mappa, di caricare un'immagine della mappa come sfondo e di raggruppare i marcatori che si trovano nelle vicinanze.

• Nome della mappa: Questo è il titolo della tua Mappa. La tua Mappa sarà visibile usando l'URL /wiki/Mappa:NomeMappa. Se desideri cambiare il nome dopo la creazione della Mappa, passa il cursore sopra il pulsante con i tre pallini verticali ⋮ nell'angolo in alto a destra e seleziona l'opzione "Sposta". Questo chiuderà l'editor delle Mappe Interattive e ti porterà a Speciale:Sposta dove puoi scegliere un nuovo nome per la mappa.
• Immagine della mappa: Clicca su quest'area per caricare l'immagine che voi utilizzare come tua Mappa. Puoi caricarla in formato .jpg, .jpeg, .png, o .svg. La dimensione massima del file è 10 MB.
• Marcatori di gruppo: Attiva questa opzione per semplificare il numero di marcatori su una mappa raggruppando quelli che sono nelle immediate vicinanze. Se clicchi su una posizione raggruppata, essa ingrandirà e mostrerà un sottogruppo o i singoli marcatori in una posizione selezionata. Si consiglia di raggruppare un gran numero di marcatori per una migliore esperienza visiva.

Categorie

Organizza i tuoi marcatori di uno stesso tipo raggruppandoli in categorie. Questa lista apparirà accanto alla Mappa e ti permetterà di filtrare i marcatori per categorie. Clicca il pulsante "Aggiungi categoria" per crearne una nuova, clicca sul colore alla destra della categoria per cambiare il colore associato e trascina le barre orizzontali sulla destra delle categorie per riordinare la lista come preferisci. Cliccando in un qualsiai punto della categoria, la barra orizzontale si trasforma nell'icona di un cestino permettendoti di eliminare la categoria.

Marcatori

Per aggiungere un marcatore alla tua Mappa, clicca l'icona con la puntina nell'angolo in alto a destra. Porta il tuo cursore nella posizione desiderata sulla Mappa e clicca per fissarlo. Dopo aver posizionato il marcatore, si aprirà un menù con diverse opzioni per controllare come il tuo marcatore apparirà sulla Mappa:

• Titolo: Questo è il nome del tuo marcatore/luogo. Deve essere massimo 50 caratteri.
• Descrizione (opzionale): Questa descrizione sarà mostrata sotto il titolo nella finestra di dialogo che si apre quando viene cliccato il marcatore. Deve essere massimo 150 caratteri.
• Link (opzionale): Hai l'ozione di linkare ad un qualsiasi articolo della tua wiki (magari uno che fornisce maggiori dettagli sul marcatore/luogo selezionato).
  • Titolo della pagina: Inserisci il nome dell'articolo che vorresti fosse linkato in questo campo. Non importa se utilizzi spazio oppure trattini bassi nel nome dell'articolo.
  • Testo di visualizzazione del link: Scegli come vorresti che fosse visualizzato il testo del link. Potrebbe essere lo stesso nome dell'articlo oppire qualcosa come "Leggi di più". Questo campo è obbligatorio se si collega un titolo di pagina.
• Categoria Seleziona a quale categoria vorresti aggiungere il tuo marcatore. Ogni marcatore deve essere associato a una categoria per raggruppare meglio marcatori simili.

Una volta creato il marcatore, puoi spostarlo in un altro punto della Mappa se desideri. Puoi anche cliccare sul marcatore e passare sopra i tre puntini verticali ⋮ per mostrare le opzioni per modificare o eliminare il marcatore.

Funzioni aggiuntive

• Zoom: Usa i pulsanti + e - nell'angolo in basso a destra per ingrandire o meno la tua Mappa. Puoi anche usare la rotellina del mouse.

Passare il cursore sopra il pulsante con i tre pallini verticali aprirà un menù a tendina. A seconda dei tuoi permessi utente, avrai sempre l'opzione di "Modifica sorgente", "cronologia" e "sposta".

• Modifica sorgente: Cliccare questa opzione ti porterà fuori dall'editor visuale al codice JSON della Mappa. Se desideri poi tornare all'editor visuale, devi uscire dalla modalità sorgente e cliccare di nuovo l'icona con la matita sulla Mappa.
• Cronologia: Cliccare questa opzione ti porterà fuori dall'editor alla cronologia della Mappa, che mostra tutte le modifiche e i cambiamenti effettuati, fornendoti l'opzione di annullarli se necessario.
• Sposta: Cliccare questa opzione ti porterà fuori dall'editor a Speciale:Sposta.

Le opzioni seguenti sono invece disponibili solo a chi ha i diritti di moderatore di contenuti o superiore.

• Proteggi: Apre l'opzione per la protezione della Mappa.
• Cancella: Questo cancellerà la Mappa. Puoi sempre ripristinarla se lo avessi fatto per sbaglio.

Mentre fai le tue modifiche, la finestra di anteprima visualizzerà i tuoi cambiamenti in tempo reale, così puoi vedere come apparirà la Mappa prima di salvarla. Quando hai finito, clicca il pulsante "Salve" e la tua nuova Mappa sarà disponibile sulla wiki!

Costruire una mappa in JSON nell'editor sorgente

Tutte le Mappe Interattive sono definite in JSON (JavaScript Object Notation). I seguenti campi dovrebbero essere definiti in modo da generare la Mappa:

• mapImage (obbligatotio) - nome del file che deve essere usato come immagine di sfondo. L'immagine deve essere caricata sulla wiki (per esempio, usando Speciale:Carica). Sono supportate le seguenti estensioni di file: jpg / jpeg / png / svg
• mapBounds (obbligatorio) – limiti che definiscono i bordi della mappa, forniti come matrici 2x2 di interi
• categories (obbligatorio) – lista di categorie che saranno visualizzate nella lista dei filtri (il menù a tendina in alto a sinistra della mappa)
• markers (obbligatorio) – lista dei marcatori che saranno visualizzati sulla mappa. Ciascun marcatore deve essere associato ad una specifica categoria
• origin – posizione dell'origine [0,0] del sistema di coordinate
  • Valori possibili: bottom-left (default) oppure top-left
• coordinateOrder – ordine delle coordinate usate nella definizione dei bordi della mappa e delle posizioni dei marcatori
  • Valori possibili: xy (default) oppure yx

Categorie

Le categorie sono un gruppo di marcatori dello stesso tipo. Ciascuna categoria di marcatori è definita da questi campi:

• id (obbligatorio) – ID definito in modo univoco per ciascuna categoria, associato con la proprietà categoryId di ciascun marcatore. Qualsiasi stringa è valida come "id".
• name (obbligatorio) – nome della categoria, che sarà mostrato nella lista dei filtri
• color (obbligatorio) – colore con cui apparirà ciascun marcatore della categoria, che può essere espresso in codice hex o nome proprio. Le categoria con un colore non valido saranno mostrate con il colore nero.

Marcatori

Ciascun singolo marcatore è definito attraverso i seguenti campi:

• categoryId (obbligatorio) – categoria associata al marcatore
• position (obbligatorio) – coordinate della posizione del marcatore, all'interno dei mapBounds forniti e nell'ordine definito da coordinateOrder
• popup (obbligatorio) – proprietà della finestra pop-up che appare quando si clicca un marcatore:
  • title (obbligatorio) – titolo del marcatore. Il titolo ha un limite massimo di 50 caratteri
  • description (obbligatorio) – descrizione da visualizzare nel pop-up. La descrizione ha un limite massimo di 150 caratteri
  • link – collegamento all'articolo da aggiungere al pop-up. I link dei marcatori sono opzionali, ma se sono inclusi devono essere definiti sia con un url (il titolo dell'articolo a cui linkare) e una label (il testo del link da mostrare). L'URL può linkare ad articoli completi o sezioni di articoli.

Esempio

{
  "origin": "bottom-left",
  "coordinateOrder": "xy",
  "mapImage": "File:MapBackground.jpg",
  "mapBounds": [[0, 0], [1000, 1000]],
  "categories": [
    { "id": "1", "name": "Artefatti", "color": "#ff00ff" },
    { "id": "2", "name": "Dungeon", "color": "#00ff00" }
  ],
  "markers": [
    {
      "categoryId": "1",
      "position": [500, 300],
      "popup": {
        "title": "Una spada",
        "description": "Un artefatto molto importante",
        "link": {
          "url": "Articolo sulla spada",
          "label": "Leggi di più"
        }
      } 
    },
    {
      "categoryId": "2",
      "position": [300, 500],
      "popup": {
        "title": "Una caverna",
        "description": "Un dungeon molto spaventoso",
        "link": {
          "url": "Articolo su una caverna",
          "label": "Leggi di più"
        }
      } 
    }
  ] 
}

Visualizzare una Mappa

Gruppi di marcatori

Per semplificare la visualizzazione, i marcatori sono raggruppati localmente in gruppi. Passare il cursore sopra un gruppo mostrarà una traccia dell'area dei marcatori contenuti all'interno di quel gruppo, con un numero che identifica la quantità. Cliccare su un gruppo ingrandirà quell'area.

Non c'è attualmente alcuni modo per aggiustare la sensibilità del raggruppamento.

Incorporare una Mappa

Per rendere la tua Mappa più visibile, puoi incorporarla dentro un articolo se desideri. Una vola che la Mappa è stata creata, può essere inclusa in un articolo usando la sintassi wikitext {{Map:La_Mia_Nuova_Mappa}}. Si può incorporare in un articolo anche più di una Mappa. La Mappe incorporate negli articoli avranno un pulsante di modifica nell'angolo in alto a destra della Mappa. Cliccarlo aprirà l'editor della Mappe Interattive in una nuova scheda, permettendo di modificarla direttamente.

Link utili

• Primo annuncio della Mappe Interattive
• Aggiornamento 2022 per le Mappe Interattive
• Le Mappe Interattive sono qui!

Esempi di mappe

• Map of the World of Avatar

Vedi anche

• Aiuto:Estensione mappe, un'estensione standard di MediaWiki per incorporare mappe del mondo reale.
• Aiuto:ImageMap, un'estensione standard di MediaWiki per incorporare mappa basate sulle coordinate di un'immagine.
• Blog utente:KuroUrufu/Vediamo insieme che cosa sono le Mappe Interattive e come crearle.

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.