Guida e formato dei dati
CSV: id,Nome,Chiesa,Tipologia,Y,X,Comune,Com Y,Com X,Date,URL,data,Fonte. Y/X sono latitudine/longitudine della chiesa; Com Y/Com X sono quelle del comune di partenza. Coordinate WGS84 in gradi decimali; accetta virgola, punto e virgola o tab come separatore. Le colonne senza intestazione sono ignorate se vuote. Date e data restano distinti.
Aggiungere un luogo: premi «+ Luogo», inserisci Nome, Tipo, Latitudine (Y) e Longitudine (X), poi «Crea luogo». Non è necessario cliccare sulla mappa. Sono accettati punto o virgola decimale. In alternativa «Scegli invece la posizione sulla mappa» compila le coordinate senza perdere nome e tipo. Per le origini in attesa puoi usare direttamente il pulsante «Coordinate» accanto al Comune: il nome e il tipo vengono precompilati e il salvataggio completa i collegamenti.
Villaggi scomparsi: sono una categoria autonoma, con marcatore viola e bordo tratteggiato. «+ Luogo» → Tipo «Villaggio scomparso», poi coordinate o scelta sulla mappa. La scheda permette di conservare data di riferimento, fonti, note e immagine, ad esempio per documentare l’identificazione del sito e l’incertezza della posizione. Possono essere scelti come origine di una o più processioni e completare collegamenti in attesa con lo stesso nome. Puoi riclassificare un Comune/villaggio esistente come Villaggio scomparso senza perdere le processioni. Nel CSV Tipo=villaggio_scomparso; la categoria e tutti i dati vengono conservati anche in GeoJSON. Non occorre modificare i CSV precedenti.
Soste dei pellegrini: «+ Luogo» → Tipo «Sosta dei pellegrini», oppure «Aggiungi sosta a questa processione» nella scheda del percorso. Il marcatore è giallo con simbolo di pausa. Inserisci le coordinate o scegli la posizione sulla mappa; puoi associarlo a più processioni e compilare note, fonte e immagine. Le associazioni documentano la sosta senza modificare automaticamente la geometria del percorso. Puoi trascinare la sosta liberamente. Eliminare una sosta non elimina le processioni; eliminare una processione conserva le soste e rimuove solo il relativo riferimento. CSV: Tipo=sosta e colonna ID_Percorsi_Sosta con lista JSON degli ID; entrambe vengono esportate automaticamente. I vecchi CSV restano compatibili.
Più comuni per una chiesa: ripeti lo stesso id della chiesa su più righe, cambiando Comune, Com Y e Com X. Nome e coordinate della chiesa devono coincidere. L’app crea una sola chiesa, un solo punto per ogni comune e un percorso per ciascuna riga. Le coordinate ripetute dello stesso comune devono coincidere. Non servono righe separate per i comuni.
Percorsi indipendenti: seleziona una chiesa e scegli il percorso nella lista «Processioni verso questa chiesa», oppure clicca sulla linea. «+ Percorso» e «Aggiungi un altro comune a questa chiesa» aprono il modulo di aggiunta, che mostra i percorsi già presenti e il totale dopo l’aggiunta. Il modulo «Modifica il percorso [ID]» cambia invece soltanto quel collegamento. Puoi anche creare varianti dallo stesso comune: ogni percorso ha un ID distinto. Eliminare un percorso non elimina la chiesa né le altre processioni.
Modifica vertici: premi il pulsante sul percorso selezionato, poi clicca sulla sua linea per inserire un vertice; trascinalo per spostarlo o cliccalo per eliminarlo. Trascinare una chiesa aggiorna tutti i suoi percorsi; trascinare un comune aggiorna tutte le processioni che partono da lì.
Origini: Com Y/Com X creano automaticamente i comuni. Se entrambe sono vuote puoi posizionare il comune manualmente: i suoi collegamenti in attesa vengono completati e attivati, conservando i vertici. Per riparare un comune già collocato, selezionalo e premi «Completa e attiva i collegamenti». Anche creare un nuovo luogo di tipo Comune con il nome esatto dell’origine completa e attiva i collegamenti in attesa. Le coordinate parziali o in conflitto vengono segnalate. Per cambiare l’origine di una sola processione usa il relativo menu Comune nella scheda del percorso.
Esportazione: il CSV conserva le colonne originali e aggiunge Tipo,ID_Percorso,ID_Villaggio_Riferimento,Percorso_Attivo,Waypoints. Ogni percorso è una riga con lo stesso id della chiesa; i comuni sono righe aggiuntive di Tipo villaggio. ID_Percorso è univoco; per aggiungere varianti dello stesso collegamento assegnagli valori diversi. Senza ID_Percorso, righe ripetute per la stessa coppia chiesa-comune sono segnalate per evitare doppioni accidentali. Waypoints è JSON con coppie [latitudine,longitudine]. I percorsi disattivati sono conservati.
Modificare e integrare una chiesa: seleziona il suo simbolo rosso o il nome nell’elenco. La scheda del luogo è sempre modificabile, anche con più processioni: Nome, coordinate, intitolazione, Tipologia, URL, data di riferimento, fonte, note e immagine generali. Premi «Salva scheda del luogo». Nell’elenco delle processioni scegli invece il percorso per modificarne i dati specifici. Le due documentazioni restano indipendenti. Il CSV aggiunge automaticamente Metadati_Luogo (JSON) per conservare integralmente la scheda generale su tutte le righe della stessa chiesa; Date, Fonte, Note e Immagine nelle righe dei percorsi continuano a descrivere le singole processioni. Non devi modificare a mano il CSV.
Scheda di ricerca: ogni processione dispone di Data della processione (testo libero, colonna Date), Fonte delle notizie (Fonte), Note e immagine di anteprima (Immagine). Non serve modificare i CSV precedenti: le colonne mancanti vengono aggiunte all’esportazione. Puoi caricare JPEG, PNG, WebP o GIF dal computer (massimo 10 MB ciascuna), oppure inserire un URL diretto http/https. I file locali sono incorporati come data URL e viaggiano con CSV e GeoJSON. Le immagini da URL restano collegate alla risorsa esterna. Molte immagini possono esaurire lo spazio del salvataggio del browser: in caso di avviso, esporta subito il lavoro. Senza percorsi, i campi si possono compilare nella scheda del luogo; quando crei la prima processione vengono copiati nella nuova scheda.
Metadati: Nome e coordinate appartengono al luogo; Date, URL, data e Fonte di ogni processione sono conservati separatamente e modificabili nella sua scheda. Com Y/Com X nell’esportazione seguono sempre la posizione attuale del comune.
Compatibilità: accetta anche il vecchio CSV ID/Nome/Tipo/Latitudine/Longitudine/ID_Villaggio_Riferimento e i GeoJSON esportati dalle precedenti versioni. Converte la copia locale precedente al primo avvio. Il nuovo GeoJSON contiene punti e percorsi, con coordinate [longitudine,latitudine].
Conservazione: salvataggio automatico in questo browser, se consentito; esporta regolarmente una copia. Importare un file sostituisce il progetto corrente, con possibilità di annullare. La cronologia Annulla/Ripeti riguarda questa sessione.
Rete e dati: occorre Internet per Leaflet 1.9.4 da unpkg e lo sfondo OpenStreetMap. I dati di ricerca restano nel browser. I collegamenti iniziali sono linee dirette da ricostruire; nessun instradamento stradale automatico. Gli esempi sono inventati e non documentano processioni reali.