• • •
Questo manuale accompagna il lettore dalla prima apertura di TableHistory alla creazione di archivi tematici e all’esportazione di materiali condivisibili. È rivolto a chi insegna, fa ricerca, studia la storia, documenta collezioni o deve mettere a confronto avvenimenti, persone e documenti lungo il tempo.
TableHistory aiuta a rappresentare una cronologia, ma non verifica automaticamente i dati. Date, nomi, luoghi, attribuzioni e fonti restano da controllare. I risultati migliori si ottengono combinando schede chiare, convenzioni coerenti, note trasparenti e revisioni regolari.
I nomi dei menu sono in inglese poiché l’interfaccia dell’applicazione è attualmente soltanto in inglese.
1. Che cos’è TableHistory e a chi serve
TableHistory è un’applicazione gratuita e open source per organizzare schede storiche e visualizzarne la collocazione nel tempo attraverso un diagramma di tipo Gantt. Le schede rappresentano persone, documenti oppure eventi. Per ognuna si possono registrare nome, anno iniziale e finale, incertezza degli estremi, luogo e una nota di lunghezza libera con formattazione di base.
La griglia consente di consultare e ordinare gli elementi; il diagramma mostra intervalli, sovrapposizioni e successioni cronologiche. Per esempio, un archivio su un movimento culturale può raccogliere autori, opere, manifesti e mostre: l’elenco aiuta a controllare i dati, mentre il diagramma rivela quali elementi sono contemporanei e quali appartengono a fasi diverse.
TableHistory è adatto a cronologie, indici di documenti, biografie collettive, percorsi didattici, storia locale, storia della scienza e cataloghi tematici. La funzione di copia e incolla fra archivi aiuta a produrre sottoinsiemi: da un archivio generale si può estrarre una raccolta più piccola destinata a una ricerca, a una lezione o a un PDF.
Il programma non è un calendario di precisione: il diagramma si basa sugli anni, mentre mesi, giorni e orari vanno nelle note. Non gestisce relazioni strutturate fra schede, genealogie, bibliografie complete o verifiche automatiche delle fonti. È possibile menzionare altre schede, usare tag e inserire link nelle note, ma tali riferimenti sono testuali e non vengono aggiornati automaticamente quando un elemento cambia nome.
La semplicità dei CSV rende facile copiare e conservare i file, ma rende importante il backup. Inoltre, è preferibile modificare i dati tramite l’applicazione; intervenire direttamente sul CSV con un editor esterno richiede attenzione a virgole, virgolette e ritorni a capo.
Il programma è scritto in C++ con librerie Qt e supporta Windows, macOS e Linux. I dati sono salvati in file .csv, senza bisogno di un database o di un server separato. La correzione ortografica per l’Inglese, l’Italiano, lo Spagnolo, il Tedesco, il Francese e il Portoghese è gestita da Hunspell. Il progetto è distribuito sotto licenza GPLv3.
2. Il modello mentale: schede, archivio e diagramma
L’unità fondamentale è la scheda (item). Una raccolta di schede è contenuta in un file in formato CSV. La finestra principale offre una griglia sul lato sinistro, un’area di consultazione delle note sotto la griglia e il diagramma Gantt sul lato destro. Selezionando una riga si può leggere la relativa nota e osservarne la posizione temporale.
La griglia principale e il pannello delle note sono di sola lettura, per ridurre le modifiche accidentali. Per creare una scheda si usa Items - Add...; per modificarla Items - Edit... oppure si fa doppio clic sulla riga. Le modifiche avvengono in un modulo apposito e diventano effettive quando si confermano.
Il diagramma è una rappresentazione sintetica, non un sostituto dei dati. Una barra mostra l’intervallo annuale della scheda; se un estremo è marcato come incerto, la barra viene visualizzata con una trama chiara. Il diagramma aiuta a confrontare cronologie, ma la vicinanza nel tempo non dimostra di per sé un rapporto causale: l’interpretazione va spiegata nelle note e sostenuta dalle fonti.
Le schede sono indipendenti: non esistono link strutturati che le colleghino automaticamente. Questa limitazione facilita la copia di alcuni elementi in un nuovo archivio senza lasciare riferimenti rotti. Per organizzare le relazioni, usare nomi coerenti, tag e menzioni nelle note. Ricordare però che una modifica al nome di una scheda non aggiorna le menzioni testuali nelle altre note.
Per progetti lunghi è utile mantenere un archivio master e creare file tematici separati, ad esempio Storia_Europa.csv, Rinascimento.csv e Stampa_e_libri.csv. La copia delle schede consente di focalizzare l’analisi e condividere dati pertinenti senza distribuire tutto il materiale raccolto. Le copie non si sincronizzano fra loro: una correzione nel master dovrà essere propagata manualmente oppure il sotto archivio dovrà essere ricreato.
3. Installazione, primo avvio e aggiornamenti
Scaricare il pacchetto di installazione (Windows, Linux) o l’app (Mac) dal repository GitLab.
L'app macOS nel repository è compilata per Apple Silicon (M1 o successivo) e non è notarizzata da Apple. Usare il seguente comando dopo aver copiato TableHistory.app nella cartella Applicazioni:
xattr -r -d com.apple.quarantine /Applications/TableHistory.app
Questo comando rimuove l’attributo di quarantena dal percorso specificato. Non eseguirlo su un’applicazione di provenienza sconosciuta.
Scaricare il pacchetto di installazione per Windows dallo stesso repository e lanciarlo. Dopo il primo avvio, creare un archivio di prova, aggiungere una scheda, salvarla e riaprirla per verificare che il ciclo di lavoro funzioni.
Scaricare il pacchetto di installazione .deb (Debian Ubuntu, ecc.) o .rpm (Fedora, ecc.) dallo stesso repository e lanciarlo. Dopo il primo avvio, creare un archivio di prova, aggiungere una scheda, salvarla e riaprirla per verificare che il ciclo di lavoro funzioni.
Il programma salva questi file di configurazione:
Windows (System Registry): Path / Key: HKEY_CURRENT_USER\Software\Massimo Nardello\TableHistory
Windows: C:\Users\<YourUsername>\AppData\Local\Massimo Nardello\TableHistory\
macOS (Property List file): ~/Library/Preferences/Massimo Nardello/TableHistory.plist
macOS: ~/Library/Application Support/Massimo Nardello/TableHistory/
Linux: ~/.config/TableHistory/TableHistory.conf
Linux: ~/.local/share/TableHistory/
Prudenza nell’aggiornamento
Prima di sostituire una versione del programma, salvare e duplicare i CSV importanti. Installare quindi la nuova release, aprire una copia dell’archivio e controllare griglia, note e diagramma prima di proseguire sul file di lavoro. La copia precedente va conservata fino alla verifica del funzionamento.
4. Orientarsi nella finestra principale
La finestra è organizzata intorno a tre aree: griglia, note e diagramma. La griglia elenca le schede; il pannello sottostante mostra la nota della riga selezionata; il diagramma a destra illustra gli intervalli temporali. Questa disposizione consente di leggere struttura e contesto senza aprire ogni scheda in un modulo.
Fare clic sull’intestazione di una colonna della griglia per ordinare in senso crescente e fare clic di nuovo per invertire l’ordine. Le colonne sono utili per raggruppare tipologie, confrontare anni, trovare elementi con lo stesso luogo o controllare i nomi. L’ordinamento modifica la visualizzazione dell’elenco, non i dati registrati.
Le note nella finestra principale sono di sola lettura. I link web e a file in esse contenuti sono formattati come collegamenti attivi; non lo sono invece nel modulo di modifica il testo, che è predisposto per correggere i link più facilmente senza attivarli per errore. Per modificare una nota, aprire la scheda con Items - Edit....
Il diagramma può essere ingrandito, ristretto e fatto scorrere. Se rappresenta molti secoli, partire da una vista ampia e poi ingrandire il tratto che interessa. Se una barra sembra sbagliata, verificare prima gli anni nella scheda: lo zoom cambia la scala visiva, non la cronologia delle schede.
I tre menu principali sono: File per creare, aprire, salvare ed esportare; Items per aggiungere, modificare, cercare, selezionare, copiare o eliminare schede; View per regolare lo zoom e passare a schermo intero. Prima di compiere un’azione in blocco, controllare quale file è aperto e quali righe sono selezionate.
5. Creare un archivio e salvare il lavoro
Scegliere File - New per creare un archivio vuoto. Prima di inserire molti dati, stabilire il tema, i confini della raccolta e una convenzione di denominazione. Nomi come Storia_della_stampa.csv o Comune_1940-2000.csv sono più utili di Nuovo.csv o Finale2.csv, perché permettono di riconoscere il contenuto anche dopo mesi.
Con File - Open... si apre un CSV esistente. Dopo l’apertura, verificare il contenuto e accertarsi di non aver scelto una copia con nome simile. File - Recent files permette di aprire gli ultimi otto file utilizzati, ma la lista non sostituisce un’organizzazione chiara delle cartelle.
File - Save salva le modifiche nel file corrente; File - Save As... salva il lavoro con un nome diverso. Usare quest’ultimo comando prima di una riorganizzazione ampia, per creare una variante o per ottenere una copia di sicurezza. Per costruire un sotto archivio, copiare le schede selezionate in un nuovo file invece di cancellare quelle non pertinenti dal master.
Prima che un file venga salvato, la sua versione esistente viene copiata come file di backup con estensione .bak. Per ripristinare i dati contenuti in questo file di backup, rimuovere l'estensione .bak e aprilo con l'applicazione.
Una più ampia strategia di backup consiste nel conservare il CSV di lavoro, una copia datata e un’altra copia su un supporto o servizio separato. Eseguire la copia dopo aver salvato e, se possibile, a programma chiuso. La frequenza dipende dall’importanza del progetto: per un archivio usato ogni giorno può essere ragionevole salvare una copia a fine sessione.
Distinguere sempre tre tipi di file: il master completo, i sotto archivi tematici e i PDF destinati alla lettura. Il PDF non sostituisce il CSV modificabile; un sotto archivio non deve essere scambiato per la raccolta completa; una copia di sicurezza non va sovrascritta finché non si è certi che il file di lavoro sia integro.
6. Le tre tipologie di scheda
Il campo Kind indica se l’elemento è Person, Document oppure Event. La scelta dovrebbe riflettere la funzione della scheda nella ricerca, non soltanto il modo in cui l’elemento è chiamato.
Usare Person per una persona storica o contemporanea: politica, artista, scienziata, autrice, testimone o protagonista di un evento. In una biografia, l’anno iniziale normalmente rappresenta la nascita e quello finale la morte. Per le persone ancora in vita, ripetere l’anno di nascita nei due campi; nelle note si può aggiungere che la persona è in vita alla data dell’ultimo aggiornamento.
Se l’obiettivo fosse studiare un movimento culturale, gli anni potrebbero invece rappresentare il periodo di attività e non l’intera vita. È possibile adottare questo criterio, ma va spiegato nelle note e mantenuto coerente in tutto l’archivio: non mescolare estremi biografici e anni di attività senza segnalarlo.
Usare Document per libri, lettere, trattati, atti, manifesti, leggi, manoscritti, edizioni e altre testimonianze documentarie. Il titolo dovrebbe essere riconoscibile; se utile, includere l’autore nel nome secondo una convenzione, per esempio Autore - Titolo o Titolo (Autore). Per un documento datato in un singolo anno, impostare inizio e fine allo stesso valore.
Se redazione e pubblicazione avvengono in anni diversi, decidere quale data collocare nel diagramma e spiegare le altre nelle note. In alternativa, si possono creare schede distinte, una per il documento e una per l’evento di pubblicazione, se le due prospettive sono importanti per il progetto. Nelle note si possono conservare sintesi, provenienza, edizioni, fonti e link digitali.
Usare Event per episodi puntuali e processi: battaglie, riforme, conferenze, migrazioni, scoperte, costruzioni, crisi, rivoluzioni o periodi come l’Illuminismo. Per un evento puntuale, inizio e fine coincidono; per un periodo, si inseriscono gli estremi scelti. La denominazione deve distinguere l’evento da episodi simili.
Se il luogo è multiplo, il campo Place può riportare l’area generale e la nota può descrivere le località. Usare sempre una convenzione coerente, per esempio Città, Paese. Un luogo testuale non equivale a un sistema di coordinate geografiche.
Un decreto è in genere un Document; la sua promulgazione può essere un Event. Una persona è Person, mentre il suo regno può essere rappresentato come Event se l’interesse è il periodo politico. Se due aspetti sono entrambi importanti, usare due schede distinte e spiegare il rapporto nelle note.
Per le persone, scegliere una forma principale del nome e annotare alias o varianti nelle note. Per i documenti, mantenere una struttura uniforme. Per gli eventi, aggiungere luogo o altri dettagli al nome solo quando servono a evitare ambiguità. La convenzione ideale è quella applicata con costanza e comprensibile a chi consulta l’archivio senza conoscerne l’autore.
7. Anni, intervalli e date incerte
TableHistory copre gli anni da -20.000 a 3.000, per includere anche la cronologia di romanzi di fantascienza o le previsioni sui cambiamenti climatici. Gli anni negativi rappresentano il periodo avanti Cristo e vengono mostrati come B.C. nel diagramma; gli anni positivi rappresentano l’era comune. Per un evento del 44 a.C., per esempio, inserire -44 nei campi annuali. Nei dati importati non sostituire il numero negativo con una stringa come 44 B.C..
La scala del diagramma è annuale. Mesi, giorni e orari vanno nelle note. Se un evento è datato precisamente, si può scrivere in nota 15 marzo 44 a.C. anche se il campo temporale contiene soltanto -44. Un intervallo di anni deve seguire il criterio adottato per la scheda: vita di una persona, attività, durata di un evento o periodizzazione scelta.
Due flag, StartUncertain e EndUncertain, indicano se l’estremo iniziale o finale è incerto. La barra nel diagramma appare con una trama chiara quando un estremo è marcato come incerto. L’incertezza deve anche essere spiegata nelle note: ad esempio datazione tradizionale, anno approssimativo, fonti divergenti o attribuzione discussa. La trama è un segnale visivo, non una valutazione automatica dell’attendibilità storica.
Per ordinare eventi in base a una data più precisa, inserire questa data all’inizio del nome e poi ordinare per nome. Il formato dev’essere uniforme: anno a quattro cifre, mese e giorno a due cifre, eventualmente seguito dall’orario con due cifre per ore e minuti. Esempi:
Si noti però che questo sistema non consente l'immissione di anni negativi. Quindi, per garantire un corretto ordinamento delle date contenute nel campo del nome, occorre che siano solamente a.C. oppure d.C.. In caso contrario, le date a.C. si mescolerebbero con quelle d.C.. Del resto, il campo nome è testuale, non di tipo data.
Per i periodi storici, scegliere gli estremi in modo esplicito. L’inizio di un’epoca può variare secondo la scuola storiografica o l’area geografica; annotare nelle note la convenzione adottata e distinguere i confini convenzionali dai dati documentati. La precisione apparente non dovrebbe nascondere una controversia.
8. Creare una scheda passo per passo
Scegliere Items – Add... per aprire il modulo di creazione; per modificare una scheda già esistente usare Items - Edit... oppure fare doppio clic sulla riga. Compilare i campi con una convenzione coerente e confermare soltanto dopo aver verificato i dati principali.
Tipo e nome. Selezionare Person, Document o Event. Scrivere un titolo che consenta di identificare la scheda senza aprire le note.
Anno iniziale e finale. Inserire numeri annuali; usare valori negativi per B.C. Se si tratta di un episodio annuale, i due campi coincidono.
Incertezza. Attivare il flag dell’estremo dubbio e spiegare il motivo nella nota.
Luogo. Usare un nome coerente con il resto dell’archivio: ad esempio Bologna, Italia anziché alternare varianti equivalenti.
Note. Cominciare con una sintesi e aggiungere contesto, fonti e dettagli più fini.
Verifica. Controllare il titolo, gli anni e il luogo; confermare con OK oppure Meta / Ctrl + Return; per salvare e continuare la scrittura, confermare con Save oppure Meta / Ctrl + S.
In basso sono disponibili un campo per la ricerca di una parola all’interno del testo della nota corrente e i bottoni First e Next per evidenziare la prima occorrenza e quelle seguenti. Inoltre, è possibile specificare la lingua per la correzione ortografica, o disattivarla selezionando la voce No spell-checking.
Premere Esc nel modulo per scartare le modifiche. Dopo il salvataggio, verificare la riga della griglia, la nota visualizzata e la barra nel diagramma. Questa rapida revisione permette di riconoscere subito un segno meno mancante, un intervallo invertito o un flag attivato per errore.
Per esempio, una scheda di storia urbana può usare Kind = Event, nome Inaugurazione della stazione, anno iniziale e finale 1932 e luogo Bologna, Italia. Nella nota si può riportare la data completa, l’ente promotore, il contesto e un link a un archivio locale. Se in seguito si scopre che apertura ufficiale e avvio dell’esercizio sono avvenuti in momenti diversi, creare due schede o spiegare chiaramente la distinzione nella nota.
9. Scrivere e formattare le note
Le note sono il campo flessibile della scheda. Possono contenere sintesi, contesto, bibliografia essenziale, link, date precise, trascrizioni, questioni aperte e spiegazioni dell’incertezza. Una nota utile comincia con ciò che il lettore deve sapere, poi aggiunge i dettagli necessari a verificarlo.
Nel modulo Add item / Edit item, i pulsanti sopra l’editor consentono di applicare intestazioni di livello 1, 2 e 3, grassetto, corsivo o nessuna formattazione al testo selezionato. Le scorciatoie sono:
Intestazione livello 1
Intestazione livello 2
Intestazione livello 3
Grassetto
Corsivo
Rimuovere formattazione
Dopo questi pulsanti si trova una lista a discesa, seguita da due pulsanti, Fill e Insert. Il pulsante Fill popola la lista a discesa con tutti i tag presenti nel file in uso. Per essere riconosciuto come tale, ciascun tag deve essere racchiuso tra due simboli cancelletto (#), non deve contenere spazi e deve trovarsi all'interno di un singolo paragrafo. Il pulsante Insert inserisce il tag selezionato nella lista a discesa all'interno del testo della nota corrente, nella posizione in cui si trova il cursore. Questa funzionalità consente di utilizzare gli stessi tag in modo coerente.
Una nota lunga può essere organizzata in Descrizione, Datazione, Contesto, Fonti e Osservazioni. Non è necessario usare tutte le sezioni in ogni scheda; il vantaggio è che una struttura ripetibile rende più semplice trovare le informazioni. Per una nota breve può bastare un paragrafo, purché il nome e la data siano comprensibili.
Per incollare testo dagli appunti senza trasportare la formattazione di origine, usare l’apposito comando del menu contestuale o Ctrl + Shift + V. È utile quando si copia materiale da un browser o da un word processor. Dopo l’incolla, verificare che non siano entrati numeri di pagina, intestazioni estranee o passaggi duplicati.
Le dimensioni del testo nel modulo si possono regolare con Ctrl + Alt + + e Ctrl + Alt + -. Nella finestra principale, il menu View offre lo zoom delle note.
Nella vista principale i link web delle note sono formattati e cliccabili. Per una fonte importante, non conservare soltanto l’URL: annotare titolo, ente responsabile, data di consultazione e informazione utilizzata. Un link può cambiare o scomparire; una nota bibliografica leggibile aiuta a identificare la risorsa anche in seguito.
È possibile inserire dei link a file utilizzando percorsi sia assoluti che relativi. Se il percorso o il nome del file contiene spazi, l’intero link va racchiuso tra virgolette. Fare attenzione a non inserire le virgolette usate nell’editoria (“ ”) al posto di quelle normali (" "). Ad esempio:
File nella stessa cartella del file CSV in uso: "my document.pdf" oppure "./my document.pdf".
File in una sottocartella: "attachments/my picture.png" oppure "./attachments/my picture.png".
File nella cartella superiore: "../my file.docx”.
Poiché non esistono relazioni strutturate tra schede, si possono aggiungere tag nel testo delle note e poi trovarli con la ricerca. Racchiudere il tag tra simboli, per esempio #storia-romana#, così da rendere la ricerca più precisa. Stabilire una grafia e non alternare forme come #Roma#, #roma# e #roma-antica# se indicano lo stesso gruppo. È utile separare tag tematici (#archeologia#) da tag di stato (#da-verificare#).
10. Ordinare, selezionare, copiare, incollare ed eliminare
Fare clic sull’intestazione di una colonna per ordinare in modo crescente; un altro clic inverte l’ordine. Per un ordinamento su più campi, procedere partendo dall’ultima priorità. Per esempio, per ordinare prima per tipo e poi per anno iniziale, ordinare prima per anno e successivamente per tipo.
Si possono selezionare più righe usando Shift o Command, secondo l’operazione di selezione, e selezionare tutto con Ctrl / Meta + A. Prima di eseguire un’operazione massiva, controllare le righe evidenziate: la selezione può essere più ampia del previsto, soprattutto dopo una ricerca.
Items - Find... cerca la prima scheda che contiene il testo specificato dall'utente nel nome, nel luogo o nelle note. Items – Find next e Items - Find previous selezionano le occorrenze successive o precedenti. Per individuare tutti gli elementi che contengono una stringa o un tag, usare Items - Find and select...: il comando seleziona i risultati e può fungere da filtro temporaneo, senza nascondere permanentemente tutte le altre righe. Nel modulo che si apre con questo comando, è possibile selezionare i tag disponibili e inserirli nel campo di ricerca. Inoltre, è possibile aggiungere ulteriori tag o parole, separati dal simbolo | e circondati da spazi (ad esempio #rome# | Augustine), per trovare tutti gli elementi che contengono almeno una delle sottostringhe specificate.
I tag sono utili per le ricerche mirate. Per esempio, aggiungendo #storia-locale# alle note delle schede pertinenti, la funzione di ricerca può selezionare il sottoinsieme senza confondere nomi simili o occorrenze casuali della parola. Per gruppi molto ampi, usare una stringa distintiva e verificare la selezione prima di copiare o cancellare.
Items - Copy selected copia negli appunti le schede selezionate. Nel file di destinazione usare Items - Paste from selection per inserirle. La stessa voce serve a importare un blocco di testo ricavato dall'AI avante l’intestazione prevista. Prima di incollare dati in un archivio importante, fare una prova su un CSV separato.
Items - Delete elimina le schede selezionate dal file corrente. Se si vuole produrre una raccolta più piccola, è più sicuro copiare gli elementi pertinenti in un nuovo file che cancellare dal master quelli non necessari. Dopo un’operazione massiva, salvare e verificare il risultato; mantenere una copia di sicurezza prima delle pulizie importanti.
La ricerca, la selezione e la copia permettono di organizzare un archivio modulare: dal master Storia delle scienze, ad esempio, si selezionano le schede col tag #astronomia#, si copiano e si incollano in Astronomia.csv. Il sotto archivio è autonomo, ma non viene aggiornato automaticamente con le successive correzioni al master. Stabilire quindi quale file rappresenta la versione di riferimento e quando ricreare o aggiornare le copie.
11. Leggere e regolare il diagramma Gantt
Il diagramma Gantt è la vista che distingue TableHistory da un semplice elenco CSV. Mostra dove si collocano nel tempo gli elementi dell’archivio e permette di riconoscere sovrapposizioni e intervalli. Non sostituisce la lettura della scheda: sintetizza gli estremi temporali, mentre le spiegazioni e i dettagli restano nelle note.
Nel menu View sono disponibili Zoom In Diagram, Zoom Out Diagram e Reset Zoom Diagram. Ingrandire significa assegnare più spazio visivo al tratto temporale mostrato; restringere significa vedere un intervallo più ampio. Reset Zoom Diagram ripristina la scala iniziale. Nella parte inferiore del diagramma è disponibile anche il controllo di zoom. Il diagramma può essere fatto scorrere per esplorare la cronologia.
Per una panoramica che va dall’antichità all’età contemporanea, cominciare con una scala abbastanza ampia da contenere molti secoli. Poi ingrandire una sezione per confrontare eventi vicini. Se si lavora soltanto su un periodo di pochi anni, lo zoom ampio può far sembrare insignificanti le differenze e rendere le etichette meno facili da leggere.
11.2 Interpretare le barre
La lunghezza della barra riflette l’intervallo registrato. Un evento puntuale ha estremi uguali; una persona può coprire una parte consistente della scala; un periodo storico può estendersi per molti anni. La trama chiara segnala un’estremità incerta. Se la barra non corrisponde alla cronologia attesa, tornare alla scheda e verificare i campi numerici: lo zoom non cambia gli anni sottostanti.
La posizione relativa può rivelare domande utili: quali documenti sono contemporanei a un personaggio? Quali eventi precedono una riforma? Quante generazioni si sovrappongono in un periodo? La prossimità temporale, però, non prova automaticamente un rapporto causale. Il diagramma mostra una coesistenza o una sequenza; l’interpretazione va argomentata nelle note e nelle fonti.
11.3 Preparare il diagramma per un lettore esterno
Prima di esportare, scegliere uno zoom che mostri il periodo rilevante senza ridurre tutte le barre a segni illeggibili. Verificare la presenza di date fuori scala, nomi troppo generici e intervalli inseriti per errore. Se il progetto copre una storia molto lunga, può essere preferibile esportare diagrammi distinti per periodo, anziché pretendere che ogni dettaglio sia leggibile in un’unica tavola.
L’esportazione del diagramma crea un PDF vettoriale con sfondo bianco, indipendentemente dal tema chiaro o scuro del sistema. La rappresentazione vettoriale può essere ridimensionata senza la perdita di nitidezza tipica di un’immagine raster; resta comunque importante verificare il risultato effettivo, in particolare la leggibilità delle scritte dopo l’inserimento in una presentazione o in un documento più ampio.
12. Esportare schede e diagrammi in PDF
TableHistory offre due esportazioni principali, con scopi diversi. File - Export diagram... esporta il diagramma cronologico in PDF vettoriale. File - Export selected items... genera invece un documento PDF con le schede selezionate. La seconda opzione chiede un titolo e prepara un riepilogo degli elementi con i relativi numeri di pagina.
12.1 Esportare il diagramma
Usare File - Export diagram... quando si desidera condividere una vista temporale: per una lezione, una relazione, un pannello illustrativo o un confronto fra periodi. Il diagramma esportato ha sfondo bianco, anche quando l’interfaccia è visualizzata in modalità scura. In questo modo il PDF rimane adatto alla stampa e all’inserimento in altri documenti.
Il diagramma è vettoriale, quindi può essere ingrandito senza sfocatura. La qualità vettoriale non risolve tuttavia problemi di impaginazione: se la cronologia è troppo densa, alcuni elementi resteranno visivamente affollati. Conviene regolare lo zoom, dividere l’argomento in sottoinsiemi e controllare il PDF prima di distribuirlo.
12.2 Esportare le schede selezionate
Selezionare nella griglia gli elementi che devono comparire nel documento, poi usare File - Export selected items.... Inserire il titolo richiesto dalla procedura. Il PDF risultante comprende un riepilogo degli elementi e i relativi riferimenti alle pagine, così che un lettore possa individuare le schede nel documento.
Questa modalità è adatta a un catalogo breve, a un allegato di ricerca, a una dispensa o a un fascicolo tematico. Prima dell’esportazione, controllare le selezioni e la qualità delle note. I PDF usano font come Helvetica Neue o Arial e dispongono di numeri di pagina.
12.3 Controlli prima della distribuzione
Aprire il PDF e verificare che titolo, pagine, caratteri, link e contenuti siano leggibili. Controllare che le note non riportino appunti interni non destinati al pubblico e che le date incerte siano spiegate. Se il documento verrà stampato, verificare la leggibilità anche a dimensione pagina, non solo con lo zoom dello schermo.
Il CSV resta il file da conservare come archivio modificabile; il PDF è la copia destinata alla lettura. Se si corregge una data dopo aver esportato, occorre esportare nuovamente il documento per riflettere la versione aggiornata.
13. Usare l’intelligenza artificiale per preparare dati
È possibile importare elementi preparati con strumenti come Gemini, ChatGPT e Claude. L’applicazione non va intesa come un motore che verifica autonomamente la storia: l’AI può proporre un primo insieme di schede, ma le informazioni devono essere controllate. La procedura richiede un blocco di testo strutturato con intestazione e campi specifici, non una risposta narrativa libera.
13.1 Il formato richiesto
Il blocco deve iniziare con queste due righe:
TableHistoryItems:
Kind,Name,StartYear,StartUncertain,EndYear,EndUncertain,Place,Notes
Ogni scheda deve essere una riga CSV singola con otto campi. Event corrisponde al valore 0, Document al valore 1 e Person al valore 2. Gli anni devono essere numerici; per gli anni avanti Cristo si usano numeri negativi. I due estremi coincidono per un evento o documento puntuale. Per una persona ancora in vita, ripetere l’anno di nascita nei due campi temporali. I flag d’incertezza devono essere true o false.
Nome e luogo vanno racchiusi tra virgolette se contengono spazi o virgole. Le note, se contengono virgole, virgolette o formattazione, devono essere protette con una quotatura CSV valida. Per evitare errori, non chiedere a un modello AI di creare una tabella Markdown, un elenco puntato o un oggetto JSON: chiedere espressamente il blocco nel formato qui indicato.
Il seguente prompt è un modello operativo in italiano. Sostituire il tema e la quantità desiderata prima di inviarlo all’assistente AI:
Prepara [50] voci significative riguardanti persone, eventi e documenti relativi a [INSERIRE ARGOMENTO]. Fornisci un unico blocco di codice in formato CSV, senza alcun testo introduttivo né commenti dopo il blocco. Le prime due righe devono essere esattamente:
TableHistoryItems:
Kind,Name,StartYear,StartUncertain,EndYear,EndUncertain,Place,Notes
Ogni voce deve costituire una singola riga CSV, contenente gli otto campi sopra indicati esattamente nello stesso ordine. Il campo "Kind" deve essere impostato su 2 per le persone, 1 per i documenti e 0 per gli eventi. "StartYear" e "EndYear" devono essere valori numerici; utilizza numeri negativi per gli anni a.C. Nel caso di un evento o documento circoscritto a un solo anno, inserisci lo stesso valore sia in "StartYear" che in "EndYear". Per le persone ancora in vita, riporta l'anno di nascita sia in "StartYear" che in "EndYear". I campi "StartUncertain" ed "EndUncertain" devono essere impostati su "true" (vero) o "false" (falso). Se i campi contengono virgole o virgolette, assicurati di utilizzare correttamente le virgolette di delimitazione. Il campo "Notes" deve contenere un breve riassunto in italiano, fornire chiarimenti sulla datazione (ove utile) e includere fonti verificabili o URL, se disponibili. Non inventare riferimenti bibliografici; segnala nel campo "Notes" eventuali dettagli incerti o non verificati. Evita i duplicati e mantieni coerenti i nomi e i luoghi.
Per argomenti di ampia portata, 50 righe possono già rappresentare un volume notevole da verificare; per una prima prova, richiederne 5 o 10. Una volta appurato che il formato è corretto e i dati sono esatti, procedere alla generazione di una raccolta più ampia. Evitare di richiedere contemporaneamente una quantità enorme di elementi, note molto estese e un livello di precisione specialistico: spesso è più efficace suddividere il lavoro in sotto-argomenti e, in seguito, combinare i risultati ottenuti.
Questo è un altro modello operativo in italiano molto più complesso del precedente, in due passaggi. Il primo:
Crea 300 voci relative a persone, eventi e documenti inerenti a [argomento], attingendo da [opere allegate] e altre fonti specializzate, seguendo questo formato:
(n. | Kind | Name | StartYear | EndYear)
Per il campo 'Kind' è necessario utilizzare i seguenti valori: 2 = Person, 1 = Document, 0 = Event.
Il secondo:
Predisponi [300] voci relative a [argomento]. Le voci sono elencate nel file indice allegato [nome file, creato nello step 1] e seguono questa struttura:
(n. | Kind | Name | StartYear | EndYear).
Fornisci i contenuti in lotti da 2.
FONTI
- Autore1, Titolo1 (allegato in PDF): fonte primaria.
- Autore2, Titolo2 (allegato in PDF).
- Altri studi specialistici.
Non leggere i file integralmente: per ogni voce, ricerca solo le sezioni pertinenti ed estrai le pagine specifiche. Qualora non venissero individuate sezioni rilevanti, segnalalo e fai riferimento alle altre fonti.
CAMPO NOTE: STRUTTURA OBBLIGATORIA (sempre in questo ordine)
Lunghezza: almeno [10.000] caratteri, in lingua italiana; utilizza esclusivamente i seguenti tag: h1, h2, h3, p, b, i.
<h1>Nome della voce</h1>
<h2>Dati essenziali</h2>
Una riga <p><b>Campo:</b> valore</p> per ciascun campo, a seconda della tipologia:
- PERSONA: Nome (nome, nazionalità/appartenenza religiosa, qualifica professionale); Nascita (luogo e data; se in vita, indicare “attualmente vivente” e la località di residenza); Morte (luogo e data, solo se deceduta); Attività (incarichi ricoperti e cattedre accademiche, con relativi anni); Opere principali (titoli in <i> con anno); Metodo (o Posizione/Dottrina); Rilevanza per l'argomento; Tag.
- DOCUMENTO: Tipologia; Titolo originale; Autore; Data; Luogo; Tesi; Rilevanza per l'argomento; Tag.
- EVENTO: Tipologia (natura dell'evento); Data (inclusa eventuale discussione sulla datazione); Luoghi; Figure chiave; Fonti (con riferimenti precisi); Rilevanza per l'argomento; Tag.
Tag: includi sempre 3–5 tag tematici nel formato #tag#, separati da spazi, in minuscolo e utilizzando i trattini; l'ultimo tag deve essere sempre #da-verificare#.
<h2>N. Titolo</h2> (numerati in sequenza). Prima parte, a seconda della tipologia:
- PERSONA: 1. “Il soggetto secondo l’Autore1” (riferimento al paragrafo, brevi citazioni tra virgolette “...”, con una nota finale che specifica come il resto si basi su ricerche accademiche); una panoramica generale (opzionale) a cura dell’Autore1; due o tre sezioni “(basate su ricerche)” che trattano la vita, la metodologia e le opere; Valutazione (giudizio dell’Autore1).
- DOCUMENTO: presentazione secondo l’Autore1; l’opera e la sua struttura “(basata su ricerche)”; ricezione e critica; valutazione dell’Autore1.
- EVENTO: l’evento storico secondo l’Autore1, citandolo all’interno del testo; contesto e collegamenti; interpretazione nell’ambito dei testi cristiani, utilizzando il tag <h3> per le questioni irrisolte (es. “Il problema cronologico”). Il titolo deve includere la dicitura “(basato su ricerche)” solo se la sezione si avvale di fonti diverse dall’Autore1.
Includere sempre, alla fine e in quest’ordine:
- Rilevanza per l’argomento
- Cronologia essenziale: una riga per ogni voce, formattata come <p><b>anno</b> - evento</p>
- Parole chiave: un unico elemento <p> contenente i termini in corsivo (<i>), separati da virgole
- Bibliografia essenziale: un elemento <p> per ogni voce; elencare per primo l’Autore1 (indicando capitolo/paragrafo), seguito dalle fonti primarie (con i relativi passaggi specifici) e infine dalla letteratura accademica.
LINEE GUIDA PER I CONTENUTI
- Distinguere sempre tra le informazioni fornite dall’Autore1 e quelle derivate da ricerche accademiche.
- Non inventare citazioni o dati. Aggiungere “(dato da verificare)” dopo ogni informazione incerta. Citare l’Autore1 riportando solo brevi espressioni fedeli al testo originale.
- Verificare gli anni presenti nell’indice e correggerli, segnalando la correzione effettuata.
FORMATO CSV (il file inizia con “TableHistoryItems:” seguito dall’intestazione):
Kind,Name,StartYear,StartUncertain,EndYear,EndUncertain,Place,Notes
- Kind (Tipologia): 2=Persona, 1=Documento, 0=Evento
- Anni in formato numerico (gli anni a.C. vanno indicati con segno negativo); Per una persona vivente: anno di nascita
Utilizzato sia per l'anno di inizio (StartYear) che per l'anno di fine (EndYear)
- Incerto (Uncertain): vero/falso (true/false)
- Racchiudere Nome e Luogo tra virgolette se contengono spazi o virgole
- Note: l'intera voce deve trovarsi su una SINGOLA riga, senza interruzioni di riga, e deve essere racchiusa tra virgolette.
All'interno della voce, non utilizzare le virgolette doppie standard ("); utilizzare invece «…» e ’.
- Esempio di riga (Evento):
0,”Censimento di Quirinio”,6,false,7,true,”Giudea, Siria”,”<h1>...</h1>...”
- Includere l'intestazione “TableHistoryItems:” e la riga del titolo prima di ogni invio, all'interno dello stesso blocco di codice.
OUTPUT
Per ciascuna delle due voci: fornire esclusivamente la riga CSV completa, senza introduzioni o commenti. Dopo ogni blocco, attendere che io scriva “continua”.
Iniziare dal n. ___ (n. ___ e ___).
Dopo aver ricevuto la risposta, copiare il blocco di codice e usare Items - Paste from selection. Prima di utilizzare l’intero blocco in un archivio esistente, provare su un file nuovo o su una copia. Controllare alcune schede di ciascuna tipologia: almeno una persona, un documento, un evento puntuale, un periodo e una scheda con un anno negativo.
Se gli anni non sono corretti, se i nomi finiscono nei campi sbagliati o se le note appaiono troncate, non continuare con un’importazione più grande. Correggere il prompt e ripetere la prova. La funzione importa i dati secondo lo schema; non può sapere se un evento è attribuito all’anno giusto o se due documenti sono duplicati.
13.4 Verificare i dati suggeriti dall’AI
La revisione dovrebbe controllare almeno: esistenza e grafia dei nomi; correttezza degli anni; valori negativi per il periodo B.C.; tipologia appropriata; distinzione fra date puntuali e intervalli; coerenza del campo luogo; URL effettivamente pertinenti; segnalazione delle controversie. Per un lavoro storico, è importante leggere la fonte cui il modello fa riferimento, non limitarsi a verificare che il link esista.
Una tecnica utile consiste nel chiedere all’AI anche una breve lista separata dei punti dubbi, ma poi registrare nell’archivio soltanto dati verificati e note che distinguano chiaramente l’ipotesi dal fatto. Se si decide di conservare una scheda provvisoria, aggiungere un tag come #da-verificare# e cercare periodicamente quel tag per completare la revisione.
13.5 Generare per l’archivio principale e per temi
Per costruire una raccolta ampia, richiedere insiemi distinti: uno di persone, uno di documenti e uno di eventi; oppure una serie per periodi o aree geografiche. È più facile controllare 20 elementi ben delimitati che 200 elementi eterogenei. Una volta importati, utilizzare la ricerca e i tag per individuare duplicati, schede prive di fonte o elementi fuori dal perimetro del progetto.
L’AI è più utile quando funziona da acceleratore di una ricerca guidata, non da sostituto del giudizio umano. Il valore dell’archivio nasce dalla selezione, dalla verifica e dalla spiegazione degli elementi, non dalla sola quantità delle righe.
14. Metodo di lavoro consigliato
Per un progetto piccolo, è sufficiente creare il file, aggiungere le schede e salvarle. Per un archivio che crescerà nel tempo, conviene applicare un processo regolare in sei fasi.
Definire la domanda. Stabilire che cosa si vuole comprendere: una cronologia di eventi, una raccolta di fonti, una biografia collettiva o la storia di un luogo.
Stabilire le convenzioni. Decidere come denominare gli elementi, come usare gli anni negativi, che cosa significa l’intervallo di una persona e quali tag verranno impiegati.
Raccogliere le schede. Inserire manualmente i dati oppure usare un blocco AI strutturato. Lavorare per piccoli gruppi, non soltanto per quantità.
Controllare e completare. Verificare anni, incertezza, luoghi, note e fonti. Usare i tag per rendere rintracciabili gli elementi ancora da rivedere.
Costruire una vista tematica. Con Find and select... cercare tag o termini, copiare le schede pertinenti in un archivio separato e regolare il diagramma.
Pubblicare e archiviare. Esportare un PDF, aprirlo e rileggerlo. Salvare sia il CSV sia la copia PDF, quindi creare un backup del file di lavoro.
Una scheda dovrebbe essere considerata pronta per la condivisione quando un lettore che non conosce il progetto può capire che cosa rappresenta, perché si trova in quell’anno e dove controllare l’informazione. Il livello di dettaglio dipenderà dall’uso: una lezione introduttiva necessita di note sintetiche; un catalogo di ricerca può richiedere riferimenti più precisi.
I casi seguenti sono esempi di metodo, non archivi storici già verificati. Servono a mostrare come organizzare le schede e come usare la ricerca, la selezione e il diagramma per rispondere a domande diverse.
15.1 Preparare una lezione sulla Rivoluzione francese
Creare un archivio Rivoluzione_francese.csv e includere le persone rilevanti, i documenti politici e gli eventi principali. Utilizzare Person per i protagonisti, Document per dichiarazioni e atti, Event per assemblee, rivolte, riforme e passaggi istituzionali. Nelle note distinguere la data del documento dalla data dell’evento che lo ha prodotto.
Aggiungere il tag #rivoluzione-francese# a tutte le schede centrali. Ordinare per anno iniziale e controllare il diagramma per capire quali processi si sovrappongono. Per una lezione su un singolo anno, usare Find and select... per una selezione più mirata e copiarla in un archivio breve. Esportare il diagramma per la presentazione e le schede selezionate per preparare una dispensa con definizioni e fonti.
15.2 Ricostruire la storia di un comune
Per la storia di una città, usare Place con una convenzione costante come Bologna, Italia, oppure con una località più specifica se il progetto riguarda un quartiere. Le schede possono includere eventi urbanistici, documenti amministrativi, persone legate alla vita civica e periodi di trasformazione. In una nota si possono conservare il riferimento all’archivio comunale, l’indicazione del fondo e il link a eventuali risorse digitalizzate.
Quando l’archivio diventa grande, usare Find and select... per il nome della città o per un tag di quartiere. Copiare la selezione in Centro_storico.csv o Infrastrutture.csv, così da produrre PDF con una cronologia più focalizzata. Non cancellare dal master le schede che non servono al sotto archivio.
15.3 Catalogare un movimento artistico
Per un movimento artistico, registrare le persone come Person, le opere o i manifesti come Document quando la scheda si concentra sull’oggetto documentario, e gli eventi - mostre, fondazioni di gruppi, pubblicazioni di manifesti - come Event. Stabilire prima se gli anni delle persone rappresentano la vita o il periodo di attività artistica; non mescolare i due significati senza spiegarlo.
Nelle note si possono inserire stile, opere principali, influenze e fonti museali. Un tag #movimento-artistico# collega la raccolta a livello di ricerca testuale. Il diagramma aiuta a vedere quali artisti hanno operato contemporaneamente e quali mostre si collocano nelle stesse fasi, ma non dimostra da solo un’influenza artistica: questa va argomentata nelle schede.
15.4 Organizzare una raccolta di documenti familiari
TableHistory può fungere da indice cronologico di documenti di famiglia: lettere, fotografie descritte testualmente, certificati, contratti e memorie. Usare Document per l’oggetto documentario e indicare in Place il luogo di produzione o conservazione secondo una convenzione esplicita. Nel campo note, annotare segnatura, proprietario o archivio, stato di digitalizzazione e informazioni di contesto.
Se la data è approssimativa, usare i flag d’incertezza e spiegare il criterio. Non inserire dettagli personali sensibili in un PDF destinato a circolare senza aver valutato prima chi lo leggerà. Un archivio familiare condiviso con parenti può richiedere una versione pubblica ridotta, preparata copiando soltanto le schede appropriate in un nuovo file.
15.5 Confrontare scoperte scientifiche e pubblicazioni
Per una cronologia della scienza, si possono rappresentare come Event le scoperte o le dimostrazioni, come Document gli articoli e i libri, e come Person i ricercatori. Il nome del documento dovrebbe distinguere il titolo dalla data di pubblicazione e l’eventuale ristampa. Nelle note annotare se la data si riferisce alla scoperta, alla comunicazione pubblica, alla pubblicazione o al riconoscimento successivo.
Ordinare prima per anno e poi per tipologia per facilitare il confronto tra risultati e pubblicazioni. Se si desidera una cronologia più fine delle uscite nello stesso anno, seguire il formato di data inserita all’inizio del nome descritto nella sezione 7. Questo metodo rimane testuale, quindi richiede uniformità e controllo.
15.6 Creare un catalogo di opere letterarie
Un archivio letterario può includere autori, opere, prime edizioni, riviste, manifesti e premi. Occorre decidere come rappresentare le persone e le opere: una scheda Person può descrivere la vita o l’attività letteraria; una scheda Document può rappresentare l’opera; un Event può rappresentare la pubblicazione o un incontro letterario. La distinzione evita che una scheda abbia due significati temporali diversi.
Usare una denominazione omogenea per le opere, ad esempio Autore - Titolo, e collocare nelle note l’anno della prima edizione, le traduzioni o le varianti di titolo. Tag come #poesia#, #romanzo# e #prima-edizione# consentono di creare raccolte mirate. I sotto archivi possono diventare dispense o indici per un corso.
15.7 Preparare un percorso museale
Per un percorso espositivo, l’archivio può riunire oggetti documentari, figure storiche ed eventi che contestualizzano una collezione. Ogni nota dovrebbe avere una sintesi adatta al pubblico e, quando serve, un secondo livello più specialistico con fonti e informazioni di conservazione. Se le didascalie finali saranno diverse dalle note interne, preparare un sotto archivio con le schede approvate per la pubblicazione.
Il diagramma serve a mostrare il contesto temporale degli oggetti, mentre il PDF delle schede può essere utilizzato per la revisione editoriale. Prima di distribuire il materiale, controllare nomi, attribuzioni e diritti delle immagini eventualmente citate esternamente; TableHistory non gestisce in modo autonomo i diritti o i prestiti museali.
15.8 Costruire una raccolta tematica con AI
Un ricercatore può chiedere a un modello AI di proporre 10 schede su un sotto argomento, importarle in un file di prova e verificare struttura e campi. Dopo il controllo, le schede pertinenti possono essere copiate nell’archivio master oppure conservate in un file tematico. Se il modello produce voci duplicate, i nomi e la ricerca aiutano a individuarle; se una data è contestata, le note e i flag d’incertezza permettono di segnalare che il lavoro non è concluso.
La procedura più affidabile è iterativa: generazione breve, verifica delle fonti, importazione, revisione nel diagramma, integrazione del gruppo successivo. Un blocco enorme importato in una sola volta fa risparmiare clic soltanto se la struttura è già corretta; altrimenti aumenta il numero di errori da riparare.
15.9 Preparare una cronologia per una presentazione
Creare un file con le sole schede necessarie alla domanda della presentazione. Usare nomi comprensibili, note non troppo dispersive e un diagramma regolato sul periodo che verrà discusso. Esportare il diagramma in PDF e le schede selezionate come fascicolo di supporto. Prima dell’esposizione, verificare che il PDF si apra sul computer della presentazione e che la tipografia sia leggibile sullo schermo o sulla stampa.
Per non sovraccaricare una slide, non utilizzare necessariamente l’intero archivio. Un diagramma generale può essere accompagnato da una seconda esportazione dedicata alla sezione centrale. La selezione deve sostenere un’argomentazione, non soltanto dimostrare che sono stati raccolti molti dati.
16. Controllo qualità e buone pratiche
La qualità di un archivio dipende soprattutto dalla coerenza. Un dato ben verificato ma inserito in un campo sbagliato può confondere il lettore; una nota accurata con un anno errato può produrre una barra fuorviante; un tag scritto in più modi può rendere incompleta la selezione. Per questo è utile riservare del tempo a controlli regolari.
Prima di dichiarare pronto un archivio, verificare:
che ogni scheda sia del tipo appropriato;
che gli anni rientrino nell’intervallo ammesso e siano negativi per il periodo B.C.;
che l’uguaglianza fra anno iniziale e finale sia intenzionale;
che gli estremi incerti siano marcati e spiegati nelle note;
che i luoghi e i nomi seguano le stesse convenzioni;
che le note distinguano i fatti verificati dalle ipotesi e citino fonti consultabili;
che i tag siano scritti sempre nella stessa forma;
che le esportazioni PDF siano state aperte e controllate;
che esista un backup aggiornato del file CSV.
16.1 Evitare l’eccesso di dettaglio nel diagramma
Il diagramma non deve contenere ogni informazione disponibile: deve rendere leggibile il confronto temporale. Se una cronologia appare troppo affollata, ridurre il numero di schede, creare sottoinsiemi o esportare viste differenti invece di tentare di far entrare tutti i dettagli in un unico grafico.
16.2 Separare fatti, ipotesi e interpretazioni
Nelle note conviene usare formule linguistiche che rendano esplicito il grado di certezza. “La fonte documenta” è diverso da “si ritiene che”; “secondo la cronologia tradizionale” è diverso da “data confermata da documento coevo”. Questa precisione migliora l’uso didattico del materiale e riduce il rischio che una scelta editoriale sia scambiata per un fatto privo di contestazione.
Un file CSV può essere condiviso con altri utenti attraverso le normali modalità di trasferimento dei file. Questo non significa che TableHistory fornisca un sistema integrato di collaborazione simultanea, blocco delle modifiche o risoluzione dei conflitti. Se più persone lavorano sullo stesso progetto, concordare chi aggiorna il master, come si consegnano le copie e come si consolidano le modifiche.
Se ciascun collaboratore modifica una copia indipendente dello stesso CSV, le differenze non vengono riconciliate automaticamente dall’applicazione. Prima di combinare le modifiche, confrontare le schede e scegliere quale versione mantenere. Per una semplice collaborazione editoriale, può bastare una persona responsabile del file master e un processo di revisione per i contributi.
17. Risoluzione dei problemi
Un anno avanti Cristo compare in modo sbagliato
Controllare che il campo contenga un numero negativo e non il testo, come 44 B.C.. Se il valore numerico è corretto ma la visualizzazione non corrisponde alla descrizione, verificare il file aperto.
La barra temporale è più lunga o più corta del previsto
Aprire la scheda e controllare gli anni iniziale e finale. Verificare anche se l’archivio rappresenta la vita di una persona o soltanto il periodo di attività, e se gli estremi sono stati inseriti secondo quella convenzione. Il diagramma riflette i campi della scheda; non corregge le date in base al nome.
Il PDF appare affollato o poco leggibile
Regolare lo zoom del diagramma, restringere la selezione o creare esportazioni separate per periodi o temi. Per il PDF delle schede, selezionare soltanto le schede necessarie e accorciare le note che non servono al pubblico. Aprire il PDF prima di inviarlo o stamparlo.
I dati AI finiscono nei campi sbagliati o la nota appare incompleta
Controllare il formato CSV, l’intestazione a otto campi, le virgolette e le virgole interne. La risposta deve iniziare con TableHistoryItems: e la riga d’intestazione prevista. Provare con cinque schede su un file nuovo, correggere il prompt e solo dopo importare un insieme più grande.
Non trovo una scheda che so di avere inserito
Provare Items - Find... con una parte distintiva del nome, del luogo o di una frase nelle note. Se si cercano risultati in sequenza, usare Find next e Find previous. Controllare anche che sia aperto il file corretto e non una copia con nome simile.
Ho selezionato troppe schede
Prima di eseguire un comando, interrompersi e rileggere la selezione. Se lo scopo è esportare o copiare un sottoinsieme, ripetere la ricerca con un termine più specifico o usare un tag completo. Non cancellare dal master per simulare un filtro: creare un sotto archivio con le schede desiderate.
Ho modificato il file sbagliato
Se il lavoro non è stato salvato, valutare la possibilità di scartare le modifiche. Se è già stato salvato, confrontare il file con l’ultima copia di backup. Non sovrascrivere la copia di sicurezza finché non si è chiarito quale versione contiene i dati corretti.
TableHistory è gratuito?
Sì. Il repository lo pubblica come software libero e open source sotto licenza GPLv3. Per distribuzione, modifica o riutilizzo del codice, consultare il testo della licenza incluso nel repository.
L’app usa un database?
No: i dati sono memorizzati in file CSV. Questo facilita la copia e l’archiviazione, ma richiede una buona disciplina di backup.
Posso inserire mesi e giorni nel diagramma?
I campi temporali sono annuali. I dettagli più precisi si annotano nelle note; per ordinare eventi dello stesso anno si può usare, con attenzione, la convenzione testuale della data all’inizio del nome.
Posso collegare una persona a tutti i documenti che ha scritto?
Non esiste una funzionalità di collegamento strutturato tra schede. Si possono nominare gli altri elementi nelle note, usare tag e adottare convenzioni di denominazione; questi riferimenti non si aggiornano automaticamente quando una scheda viene modificata.
Posso creare un archivio più piccolo da uno grande?
Sì. Cercare e selezionare le schede interessate, copiarle con Items - Copy selected, creare o aprire il file di destinazione e usare Items - Paste from selection.
Il diagramma può essere esportato in PDF?
Sì, con File - Export diagram.... Il PDF è vettoriale e ha sfondo bianco. Per esportare le schede come documento, usare File - Export selected items....
I dati prodotti da Gemini, ChatGPT o Claude sono verificati?
No. L’AI può preparare righe nel formato previsto, ma nomi, date, luoghi, fonti e duplicati devono essere controllati da una persona.
L’interfaccia è in italiano? L’interfaccia soltanto in inglese.
Che cosa significa una barra a trama chiara?
Indica che almeno uno degli estremi temporali è stato contrassegnato come incerto. La ragione storica dell’incertezza va spiegata nella nota.
19. Glossario e promemoria rapido
Archivio: l’insieme di schede contenute in un file CSV.
Scheda / item: una scheda che rappresenta una persona, un documento o un evento.
Kind: tipologia della scheda: Person, Document, oppure Event.
StartYear / EndYear: anno iniziale e finale utilizzati nel diagramma.
StartUncertain / EndUncertain: flag che marcano l’incertezza dell’estremo iniziale o finale.
Note: campo testuale libero per descrizione, contesto, fonti e link.
Griglia: elenco delle schede nella zona sinistra della finestra.
Diagramma Gantt: rappresentazione temporale a barre, nella zona destra.
Tag: etichetta testuale inserita nella nota per trovare gruppi di schede.
Sotto archivio: file separato ottenuto copiando un insieme di schede dal master.
CSV: formato testuale tabellare in cui i campi sono separati e, quando necessario, racchiusi tra virgolette.
Guida di riferimento rapido dei menu
Comandi dei menù
File - New • Creare un nuovo archivio
File - Open... • Aprire un CSV esistente
File - Save • Salvare il file corrente
File - Save As... • Salvare una copia con un nome nuovo
File - Recent files • Aprire uno degli ultimi otto file usati
File - Export diagram... • Esportare il diagramma come PDF vettoriale
File - Export selected items... • Esportare le schede selezionate in PDF
Items - Add... • Creare una scheda
Items - Edit... • Modificare la scheda selezionata
Items - Delete • Eliminare le schede selezionate
Items - Find... • Cercare la prima occorrenza del testo
Items - Find next/previous • Scorrere le occorrenze trovate
Items - Find and select... • Selezionare tutti gli elementi corrispondenti
Items - Copy selected • Copiare le schede selezionate
Items - Paste from selection • Incollare schede copiate o importare dati strutturati
View - Zoom In Diagram • Ingrandire il diagramma
View - Zoom Out Diagram • Ridurre il diagramma
View - Reset Zoom Diagram • Ripristinare lo zoom del diagramma
View - Zoom In Notes • Aumentare il testo delle note nella vista principale
View - Zoom Out Notes • Ridurre il testo delle note nella vista principale
View - Enter full screen • Usare la finestra a schermo intero
Scorciatoie nel modulo di modifica
Meta / Ctrl + 1 • Titolo livello 1
Meta / Ctrl + 2 • Titolo livello 2
Meta / Ctrl + 3 • Titolo livello 3
Meta / Ctrl + B • Grassetto
Meta / Ctrl + I • Corsivo
Meta / Ctrl + 4 • Rimuovere la formattazione
Ctrl + Shift + V • Incollare testo semplice nel modulo
Meta / Ctrl + Return • Confermare e chiudere il modulo
Meta / Ctrl + S • Confermare senza chiudere il modulo
Esc • Scartare le modifiche nel modulo
TableHistory è efficace quando si utilizza il suo modello per ciò che è: un archivio di schede temporali, una griglia per consultare e controllare i dati, un diagramma per vedere periodi ed eventi in relazione cronologica e due strumenti di esportazione PDF per condividere risultati. La struttura semplice non impedisce di creare raccolte ampie; richiede però convenzioni editoriali chiare, salvataggi regolari e revisioni accurate.
Per iniziare, basta un archivio piccolo con alcune persone, documenti ed eventi. Conviene sperimentare l’inserimento manuale, il flag di incertezza, la ricerca, la selezione e l’esportazione. In seguito, tag e sotto archivi consentiranno di gestire progetti più complessi. L’intelligenza artificiale può accelerare la prima raccolta, a condizione di rispettare il formato CSV e verificare ogni dato significativo.
La regola più importante resta questa: il diagramma aiuta a porre domande e a comunicare una cronologia, ma il valore scientifico o didattico del risultato dipende dalla precisione delle schede e dalla trasparenza con cui si dichiarano fonti, convenzioni e incertezze.
Appendice A. Esempio completo e checklist finale
Questa scheda d’esempio è fittizia e serve soltanto a mostrare un modo ordinato di compilare i campi; non va interpretata come un fatto storico reale.
Kind: Event
Name: Inaugurazione del ponte comunale
StartYear: 1984
StartUncertain: false
EndYear: 1984
EndUncertain: false
Place: Borgonuovo, Italia
Esempio di note
Descrizione. Apertura al pubblico del ponte comunale, inserita in un progetto di collegamento fra le due rive del fiume.
Datazione. Il campo annuale registra il 1984. La data completa dell’inaugurazione, se verificata in seguito, va indicata qui senza modificare la risoluzione annuale del diagramma.
Contesto. Annotare il nome dell’ente promotore, lo scopo dell’opera e gli eventuali lavori preparatori. Se la data di apertura al traffico è diversa dalla cerimonia ufficiale, distinguerle chiaramente e valutare se siano necessari due record.
Fonti. Inserire il riferimento all’archivio comunale, alla delibera o al periodico locale consultato. Per una pagina web, annotare il titolo e l’URL; non lasciare soltanto un collegamento senza spiegare quale informazione conferma.
Questa scheda è utile perché ogni elemento ha una funzione chiara: la tipologia descrive che cosa è, il nome identifica il fatto, gli anni stabiliscono la posizione nel diagramma, il luogo fornisce una localizzazione e le note spiegano contesto e provenienza delle informazioni. In un archivio reale, i testi devono essere sostituiti da dati verificati e le fonti devono essere consultate direttamente.
Verifica rapida prima della consegna
Prima di condividere un archivio o un PDF, eseguire un controllo finale dall’inizio alla fine. Aprire il CSV corretto, scegliere alcune schede iniziali, centrali e finali e verificare che i campi principali siano coerenti. Cercare tag di revisione come #da-verificare# e decidere se completare, documentare o escludere le schede ancora provvisore. Controllare che i nomi dei luoghi seguano la stessa convenzione e che le date B.C. utilizzino numeri negativi.
Controllare poi il diagramma a due scale: una panoramica per accertarsi che l’intervallo complessivo sia plausibile e una vista ravvicinata per leggere una selezione di barre. Le date incerte devono essere marcate in modo coerente e spiegate nelle note. Il grafico è una sintesi: se la storia descritta è complessa, accompagnarlo con una spiegazione testuale anziché affidarsi soltanto all’immagine.
Prima dell’esportazione, selezionare solo le schede che si desidera rendere pubbliche. Rileggere i PDF dopo averli creati e verificare titolo, numeri di pagina, dimensione dei caratteri, contenuto delle note e link. Conservare sempre il CSV sorgente e una copia di backup. Se l’archivio sarà aggiornato in futuro, annotare la versione o la data di esportazione nei metadati del progetto o nella documentazione che accompagna il file.
• • •