Guida all'Estensione “Bibbia Interattiva: Studio & Note”

(Versione 1.0)

Funzionamento Offline con Bibbia Integrata

Completamente Autonomo: L'estensione non si basa su fonti online per le sue funzioni principali. L'intero testo della Bibbia, versione Riveduta/Luzzi, è incluso direttamente all'interno dell'estensione.

Accesso Istantaneo e Offline: Questo significa che il sistema di rilevamento automatico dei riferimenti biblici in una pagina e la visualizzazione dei versetti sono gestiti localmente. L'accesso al testo biblico è istantaneo e l'estensione funziona perfettamente anche senza una connessione internet attiva, garantendo privacy e disponibilità continua dei contenuti biblici.

1. Individuazione Automatica dei Riferimenti

  • L'estensione analizza il contenuto testuale della pagina web.
  • Utilizza un sistema di parsing per identificare stringhe di testo che corrispondono a formati comuni di citazioni bibliche. Questo include:
    • Riferimenti a specifici versetti o intervalli di versetti (ad esempio, “Mt 1:1”, "Giov. 1:32-34").
    • Riferimenti a capitoli interi (ad esempio, "Genesi 1", "Matteo 3", "Ef 2", "Genesi capitolo 1", "Genesi cap. 1").

2. Evidenziazione Visiva

Una volta identificato un riferimento biblico (sia a un versetto, un intervallo di versetti o un intero capitolo), l'estensione lo evidenzia visivamente cambiando il colore di sfondo del testo del riferimento (rendendolo giallo). Questo rende i riferimenti immediatamente riconoscibili all'interno del testo principale.

3. Tooltip Interattivo (al passaggio del mouse) e Accesso alla Finestra Modale

  • Quando l'utente posiziona il cursore del mouse sopra un riferimento evidenziato, appare un piccolo riquadro (tooltip).
  • Questo tooltip mostra il testo effettivo del versetto, dei versetti biblici citati o l'inizio del capitolo.
  • Se il testo da visualizzare nel tooltip è troppo lungo per essere contenuto nello spazio disponibile, il tooltip diventa scorrevole e presenta una barra di scorrimento per permettere la lettura completa del contenuto.
  • L'intestazione del tooltip (che mostra il riferimento biblico e la versione, es. "Genesi 1 (Riv)", dove "(Riv)" indica la versione della Bibbia Riveduta/Luzzi) è cliccabile.
  • Cliccando sull'intestazione del tooltip si apre la finestra modale/popup che offre una visualizzazione più ampia del testo.
  • Il tooltip stesso contiene anche un pulsante "Copia Testo" per copiare il testo direttamente visualizzato nel tooltip.

4. Finestra Modale/Popup (aperta tramite click sull'header del tooltip)

  • Questa finestra modale, che si apre dopo aver cliccato sull'intestazione del tooltip, fornisce un contesto più ampio.
  • Mostra il titolo del libro, il capitolo e la versione (es. "Genesi 1 (Riv)", indicando la versione Riveduta/Luzzi).
  • Visualizza l'intero contenuto del capitolo a cui si riferisce la citazione, tratto dalla versione specificata.
  • Se il riferimento originale nel testo era a versetti specifici, quei versetti sono ulteriormente evidenziati all'interno della visualizzazione del capitolo.
  • Questa finestra è scorrevole, permettendo di leggere l'intero contenuto del capitolo.
  • Dispone di un pulsante "Copia Testo", che copia l'intero testo del capitolo visualizzato nella modale negli appunti.
  • È presente un pulsante di chiusura ("X") per chiudere la finestra modale.

5. Funzionalità di Copia negli Appunti

  • L'utente ha la possibilità di copiare il testo biblico:
    • Direttamente dal tooltip (per il suo contenuto specifico).
    • Dalla finestra modale (per l'intero capitolo).
  • L'utente può quindi incollare questo testo in altre applicazioni per studio, citazioni o riferimenti.

In sintesi, l'estensione trasforma i riferimenti biblici in elementi interattivi: al passaggio del mouse appare un tooltip con il testo (dalla versione Riveduta/Luzzi) e un'intestazione cliccabile. Cliccando su tale intestazione, si apre una finestra modale più ampia con l'intero capitolo (dalla stessa versione), entrambi con opzioni per copiare il testo.

Pannello Riepilogativo dei Riferimenti (accessibile dall'icona dell'estensione)

Oltre alle interazioni dirette sulla pagina, l'estensione offre un pannello dedicato per una visione d'insieme e una gestione avanzata dei riferimenti biblici trovati:

Accesso

Cliccando sull'icona dell'estensione nella barra degli strumenti del browser, si apre un popup iniziale. Da qui, un pulsante ("Mostra riferimenti in questa pagina") permette di accedere a un pannello dedicato all'"Elenco riferimenti biblici".

Contenuto del Pannello Elenco

  • Questo pannello presenta un elenco completo di tutti i riferimenti biblici trovati nella pagina corrente.
  • Include il titolo della pagina e il numero totale di riferimenti rilevati.
  • I riferimenti nell'elenco sono interattivi, comportandosi in modo simile a quelli evidenziati direttamente sulla pagina (mostrando tooltip e permettendo l'accesso alla finestra modale del capitolo).

Opzioni di Visualizzazione e Gestione dell'Elenco

  • Ordinamento: Un menu a tendina permette di ordinare l'elenco dei riferimenti (es. "Ordinamento Canonico" – secondo l'ordine dei libri nella Bibbia, o "Ordine di Apparizione" – come si trovano nella pagina).
  • Raggruppamento: Un altro menu a tendina offre diverse modalità di visualizzazione dei riferimenti:
    • "Raggruppati per Testamento": organizza i riferimenti sotto Antico e Nuovo Testamento.
    • "Raggruppati per Libro": organizza i riferimenti sotto il nome di ciascun libro biblico (es. tutti i riferimenti a Matteo insieme, ecc.). Queste sezioni raggruppate possono essere espandibili o comprimibili (tramite icone "+" o "-").
    • "Lista Piatta": mostra tutti i riferimenti in un semplice elenco, senza raggruppamenti.
    • "Solo riferimenti": mostra solo le citazioni testuali dei riferimenti senza il testo biblico associato direttamente nell'elenco.

Azioni sull'Elenco

  • "Copia Testo": Copia l'elenco dei riferimenti (le citazioni testuali, formattate secondo l'ordinamento e il raggruppamento scelti) negli appunti.
  • "Stampa": Apre la finestra di dialogo di stampa del browser per stampare l'elenco dei riferimenti così come visualizzato.
  • "Esporta CSV": Permette di scaricare l'elenco dei riferimenti in un file formato CSV (Comma Separated Values), utile per l'importazione in fogli di calcolo.
  • "Esporta MD": Permette di scaricare l'elenco dei riferimenti in formato Markdown (.md), utile per la documentazione o l'uso in editor che supportano Markdown.
  • "Salva in Libreria": Apre una finestra di dialogo che consente all'utente di salvare la collezione corrente di riferimenti trovati nella pagina. È possibile assegnare un "Nome Collezione", aggiungere "Tag" (separati da virgola) per l'organizzazione, e inserire "Note" personali. Viene mostrato anche il numero di "Riferimenti trovati" che verranno salvati.

Chiusura del Pannello Elenco

Un pulsante ("X") permette di chiudere questo pannello di riepilogo.

In sintesi, questa estensione non solo facilita la lettura e la consultazione immediata dei versetti biblici citati in una pagina web, ma fornisce anche strumenti per raccogliere, organizzare, esportare e salvare questi riferimenti per uno studio più approfondito o per riferimenti futuri.

Ricerca accessibile cliccando sull'icona dell'estensione

Cliccando sull'icona dell'estensione nella barra degli strumenti del browser, si apre un popup compatto che offre anche funzionalità di ricerca rapida e accesso ai segnalibri. Nello specifico:

1. Campo di Ricerca ("Cerca") con Autocompletamento per Parole

  • In cima al popup è presente un campo di testo etichettato "Cerca" dove l'utente può digitare:
    • Riferimenti biblici specifici: Ad esempio, "gen 1:4" (Genesi capitolo 1, versetto 4), "gen 1:5-9" (Genesi capitolo 1, versetti da 5 a 9), "matteo 3" (Matteo capitolo 3), "Giovanni 1:1" (Giovanni capitolo 1, versetto 1).
    • Parole: Ad esempio, "amore", per cercare tutte le occorrenze di quella parola all'interno della Bibbia (secondo la versione Riveduta/Luzzi).
  • Autocompletamento per Parole: Mentre l'utente inizia a digitare una parola in questo campo, l'estensione fornisce suggerimenti in tempo reale per le parole da cercare. Questa funzione sfrutta un elenco interno, basato su una concordanza biblica, per suggerire parole esistenti nel testo biblico (es. digitando "amo" suggerisce "amore", "amorei", ecc., se presenti nella concordanza). Questo aiuta l'utente a trovare termini esatti e a evitare errori di battitura quando cerca parole specifiche. L'autocompletamento non si applica ai nomi dei libri biblici durante la digitazione di un riferimento.

2. Pulsante "Cerca versetto o parola"

Una volta inserito il testo nel campo "Cerca", cliccando questo pulsante o premendo il tasto “Invio” sulla tastiera si avvia la ricerca. L'azione risultante dipende dal tipo di input:

  • Se viene inserito un riferimento biblico (versetto, intervallo o capitolo): L'estensione apre una finestra modale più grande, dedicata alla lettura. Questa finestra:
    • Mostra il titolo del libro e il capitolo (es. "Genesi Capitolo 1 (Riv)").
    • Visualizza l'intero capitolo, con il versetto o i versetti specifici cercati evidenziati (es. con sfondo giallo).
  • Se viene inserita una parola: L'estensione apre una finestra modale differente, intitolata "Risultati Ricerca" (es. "Risultati per: amore"). Questa finestra:
    • Indica quante volte e in quanti versetti è stata trovata la parola.
    • Offre filtri opzionali per restringere la ricerca (es. per Testamento: Entrambi, AT, NT; e per Libro: un elenco dei libri in cui la parola è stata trovata, con il numero di occorrenze per libro).
    • Presenta un elenco scorrevole dei versetti che contengono la parola cercata, con la parola stessa evidenziata nel contesto del versetto. Ogni riferimento nel risultato è interattivo e al passaggio del mouse mostra il tooltip con il testo del versetto e l'opzione "Copia Testo".
    • Include pulsanti come "Applica Filtri", "Reset Filtri", "Copia Testo" (per copiare tutti i risultati filtrati) e "Chiudi".

3. Sezione "Segnalibri"

  • Sotto i pulsanti di ricerca, il popup visualizza un elenco dei capitoli che l'utente ha precedentemente aggiunto ai segnalibri (tipicamente dal "Pannello degli Strumenti" nella finestra di lettura del capitolo).
  • Cliccando su un segnalibro (es. "Genesi 1", "Giovanni 1") si apre direttamente la finestra modale di lettura per quel capitolo specifico.

Questa funzionalità del popup dell'estensione fornisce quindi un punto di accesso rapido e versatile sia per consultare passaggi biblici specifici, sia per effettuare ricerche testuali nell'intera Bibbia, sia per accedere rapidamente ai capitoli preferiti salvati come segnalibri.

Barra Strumenti Finestra Modale Testo Biblico

All'interno della finestra modale che si apre quando si consulta un testo biblico (sia cercandolo direttamente, sia accedendovi dai segnalibri), è presente una barra degli strumenti superiore con diverse funzionalità chiave:

1. Pulsante "Copia Testo" e Opzioni di Copia

  • Questo pulsante permette di copiare negli appunti il testo dei versetti biblici. L'utente può prima selezionare specifici versetti all'interno del capitolo visualizzato spuntando le caselle di controllo a sinistra di ciascun versetto.
  • Al click sul pulsante "Copia Testo": Non avviene la copia immediata, ma si apre una sezione sottostante chiamata "Opzioni di Copia". Questa sezione permette all'utente di personalizzare il formato del testo che verrà copiato:
    • "Includi riferimento biblico": Se spuntato, il riferimento del versetto (es. Gen 1:1) verrà incluso insieme al testo.
      • "Abbreviazione (es. Gen 1:1)": Opzione per usare la forma abbreviata del riferimento.
      • "Forma estesa (es. Genesi 1:1)": Opzione per usare la forma estesa del nome del libro.
    • "Includi numeri di verso": Se spuntato, il numero del versetto sarà anteposto al testo del versetto.
    • "Racchiudi versetti tra virgolette": Se spuntato, ogni versetto copiato sarà racchiuso tra virgolette.
    • "Delimitatore versetti": Un menu a tendina per scegliere come separare i versetti multipli (es. "Ritorno a capo", "Punto e virgola", “Spazio”, ecc.).
    • "Nuova riga per ogni versetto": Se spuntato, ogni versetto inizierà su una nuova riga.
    • "Template personalizzato": Un campo di testo che permette di definire un formato di output personalizzato usando segnaposto come [Testo del versetto] e [Riferimenti].
    • "Copia Elementi Aggiuntivi": Ulteriori opzioni per includere nella copia:
      • "Includi note personali nella copia"
      • "Includi tag nella copia"
      • "Includi riferimenti incrociati nella copia"

"Opzioni di Stampa"

Controlli per la formattazione quando si usa la funzione di stampa. Questa sezione permette di definire quali elementi includere e come formattare il testo specificamente per la stampa:

  1. "Includi riferimento nella stampa": Se questa casella di controllo è spuntata, il riferimento biblico di ogni versetto selezionato (es. Genesi 1:1) sarà incluso nell'output di stampa.
  2. "Includi numero del versetto nella stampa": Se spuntato, il numero del versetto (es. "1", "2", "3") sarà anteposto al testo di ogni versetto nell'output di stampa. Bisogna però prima deselezionare: "Includi riferimento nella stampa".
  3. "Includi note personali nella stampa": Se spuntato, e se ai versetti selezionati per la stampa sono associate delle note personali (create dall'utente), queste note verranno incluse sotto il rispettivo versetto nell'output di stampa.
  4. "Includi tag nella stampa": Se spuntato, e se alle note dei versetti selezionati sono associati dei tag, questi tag verranno inclusi sotto il rispettivo versetto nell'output di stampa.
  5. "Includi riferimenti incrociati nella stampa": Se spuntato, e se nelle note dei versetti selezionati sono stati aggiunti dei riferimenti incrociati, anche questi verranno inclusi nell'output di stampa.

Flusso d'Uso per la Stampa:

  1. Selezione dei Versetti: L'utente seleziona i versetti desiderati spuntando le checkbox nella finestra di lettura del capitolo. Se non seleziona nulla, viene considerato l'intero capitolo.
  2. Configurazione delle Opzioni: Clicca su "Copia Testo" per visualizzare la sottosezione "Opzioni di Stampa". L'utente spunta le caselle desiderate per includere riferimenti, numeri di verso, note, tag e riferimenti incrociati nella stampa.
  3. Avvio della Stampa:
    • Dopo aver configurato le opzioni, l'utente clicca sul pulsante "Conferma” e dopodiché sul pulsante "Stampa" presente nella barra degli strumenti superiore della finestra di lettura del capitolo.
    • L'estensione genera un'anteprima di stampa alla finestra di dialogo di stampa del browser.
    • L'anteprima mostrerà i versetti selezionati, formattati secondo tutte le opzioni scelte, inclusi gli elementi specifici per la stampa (note, tag, riferimenti, ecc.).
    • Dalla finestra di dialogo di stampa del browser, l'utente può poi scegliere la destinazione (stampante fisica, "Salva come PDF") e confermare la stampa.

Pulsante "Conferma" (per copia)

Dopo aver impostato le opzioni desiderate (per la copia negli appunti), l'utente clicca il pulsante "Conferma" (che appare al posto di "Copia Testo" quando le opzioni sono visibili) per copiare effettivamente il testo selezionato con la formattazione scelta negli appunti.

2. Pulsante "Note" (Dashboard Note Personali)

Cliccando su questo pulsante, l'utente viene reindirizzato a una schermata più ampia chiamata "Dashboard Note Personali". Questa dashboard è un'area dedicata alla gestione di tutte le note che l'utente ha creato sui versetti biblici. (Vedi sezione dedicata Dashboard Note Personali)

3. Pulsante "Tema Scuro"

Permette di alternare tra un tema chiaro e uno scuro per l'interfaccia della finestra di lettura, migliorando la leggibilità in diverse condizioni di illuminazione.

4. Pulsante "Stampa"

Apre la finestra di dialogo di stampa del browser, pre-formattando il contenuto del capitolo (o dei versetti selezionati con le opzioni di stampa attive) per la stampa.

5. Pulsante "Esporta Note" / 6. Pulsante "Importa Note" (per capitolo corrente)

"Esporta Note": Esporta le note associate solo al capitolo corrente in formato JSON.

"Importa Note": Permette di importare solo le note dal file JSON precedentemente esportato dal capitolo corrente.

Questa combinazione di strumenti nella barra superiore della finestra di lettura e nella dashboard delle note offre un ambiente ricco e personalizzabile per lo studio biblico, permettendo non solo la lettura e la copia, ma anche un'approfondita annotazione e organizzazione del materiale.

Dashboard Note Personali

Accessibile cliccando il pulsante "Note" dalla barra strumenti della finestra modale di lettura, questa dashboard è un'area dedicata alla gestione di tutte le note create sui versetti biblici.

Funzionalità della Dashboard Note Personali:

Filtri di Visualizzazione

In alto, sono presenti diversi campi e menu a tendina per filtrare le note visualizzate: "Tutti i Libri" (o un libro specifico), "Capitolo", "Versetto", "Tag" (Campo di testo per cercare note associate a un tag specifico), "Testo nota" (Campo di testo per cercare note che contengono una parola specifica all'interno del corpo della nota stessa). Accanto a questi filtri ci sono i pulsanti "Applica" e "Reset". Dopo aver inserito i criteri, si clicca su "Applica" per attivare i filtri. I risultati mostreranno solo le note che corrispondono ai criteri, e la parola o il tag cercato verranno evidenziati in giallo all'interno delle note filtrate per una facile individuazione. Il pulsante "Reset" annulla tutti i filtri applicati, mostrando nuovamente tutte le note.

Cestino

Un'icona "Cestino" permette di visualizzare e gestire le note eliminate.

Impostazioni di Visualizzazione Tabellare

Un'icona a forma di ingranaggio permette di scegliere quali colonne visualizzare nella tabella delle note (Riferimento, Nota, Tag, Riferimenti Incrociati, Azioni). Un'altra icona permette di passare da una "Vista tabellare" a una "Vista a schede" e viceversa. Un'icona a forma di calendario apre il Calendario Note e Annotazioni.

Sezioni Espandibili

  • "Note Recenti": Mostra un elenco delle note create o modificate più di recente.
  • "Statistiche": Fornisce un riepilogo numerico delle note (es. Totale Note, Note nell'Antico/Nuovo Testamento, Libri con Note) e dei Riferimenti Incrociati. Include anche una rappresentazione visiva ("heatmap" o grafico a barre) della "Distribuzione" delle note o dei riferimenti incrociati attraverso i libri della Bibbia, con pulsanti per visualizzare "Note Personali", "Riferimenti Incrociati" o una "Vista Combinata".

Elenco delle Note

La parte principale della dashboard mostra un elenco delle note personali. Ogni riga (o scheda, a seconda della vista) tipicamente include:

  • Riferimento Biblico: Il versetto a cui la nota è associata.
  • Nota: Il testo della nota inserita dall'utente.
  • Tag: Eventuali tag associati alla nota.
  • Riferimenti Incrociati: Eventuali altri versetti collegati dall'utente a quella nota. Anche questi riferimenti incrociati sono interattivi (mostrano tooltip al passaggio del mouse).
  • Azioni: Pulsanti per ogni nota, come "Modifica", "Copia" (per copiare la nota, il versetto associato, tag e riferimenti incrociati), "Leggi tutto" (per aprire una finestra modale dedicata che mostra in dettaglio tutti gli elementi relativi a quella singola annotazione.), "Elimina" e "Pin" (Cliccando "Pin", la nota selezionata viene "fissata" in cima all'elenco delle note correntemente visualizzate e nella sezione "Note Recenti". Questo la rende immediatamente visibile e facilmente accessibile, indipendentemente dall'ordinamento o dai filtri applicati al resto delle note).
  • Ordinamento: Icone con frecce permettono di ordinare l'elenco delle note per le diverse colonne (es. per Riferimento, per Data, ecc.).

Esportazione/Importazione Dati Completa

In fondo alla dashboard, ci sono pulsanti per "Esporta JSON", "Esporta Testo", "Esporta Markdown" e "Importa".

  • Per le funzioni di esportazione testo e markdown, è necessario prima selezionare le note desiderate spuntando le apposite caselle di controllo (checkbox) presenti accanto a ciascuna nota nell'elenco.
  • Il pulsante "Esporta JSON" consente di creare un backup completo dei propri dati, includendo note personali, annotazioni del calendario, libreria personale e segnalibri.
  • Gli altri due pulsanti ("Esporta Testo" e "Esporta Markdown") salvano invece solo le note personali.
  • Il pulsante "Importa" permette di ripristinare un file JSON precedentemente esportato.

Pulsante "Chiudi"

Per tornare alla schermata precedente (la finestra modale di lettura del testo biblico).

Interazione Note e Evidenziazione nella Finestra Modale

All'interno della finestra modale che si apre quando si consulta un capitolo biblico, l'interazione per le note e l'evidenziazione avviene come segue:

1. Visualizzazione dei Versetti

  • Il testo del capitolo è suddiviso per versetti, ciascuno preceduto dal suo numero.
  • A sinistra di ogni versetto è presente una casella di controllo (checkbox) per la selezione.
  • Inizialmente, non c'è un'icona specifica per le note accanto a ogni versetto.

2. Aggiungere una Nuova Nota al Versetto

  • Attivazione: Per aggiungere una nuova nota a un versetto, l'utente clicca direttamente sul testo del versetto stesso. Questo fa apparire un'area di input a fianco del versetto cliccato.
  • Interfaccia di Inserimento Nota:
    • Campo "Scrivi la tua nota qui...": Un'area di testo multiriga per scrivere l'annotazione.
    • Campo "Aggiungi tag (premi Invio)": Per inserire tag. Premendo "Invio" dopo aver digitato un tag, questo viene aggiunto come etichetta.
    • Campo "Riferimenti incrociati": Per inserire altri riferimenti biblici correlati.
  • Pulsanti di Azione per la Nota:
    • "Salva": Salva la nuova nota, i tag e i riferimenti incrociati. Dopo aver salvato una nota per la prima volta, un'icona (un foglio con una matita/penna) apparirà accanto al versetto, indicando che ora quel versetto ha una nota associata.
    • "Copia": Copia il testo della nota, tag, riferimenti incrociati e il riferimento del versetto in formato markdown.
    • "Elimina": Rimuove la nota.
    • "Annulla": Chiude l'area di input senza salvare.

3. Modificare una Nota Esistente

  • Una volta che una nota è stata aggiunta a un versetto, l'icona a forma di foglio con una matita/penna apparirà stabilmente accanto a quel versetto.
  • Per modificare la nota esistente, l'utente clicca su questa icona. Si riaprirà l'area di input con i dati precedentemente salvati (testo della nota, tag, riferimenti incrociati), permettendo all'utente di modificarli e salvarli nuovamente. Questa operazione può essere effettuata anche dalla Dashboard Note Personali.
  • Quando si modifica una nota per un versetto biblico, l'area di input che appare a fianco del versetto offre un campo di testo multiriga per scrivere la nota. Nell'angolo inferiore destro di questo campo di testo, è presente una maniglia di ridimensionamento (spesso visualizzata come una piccola icona con linee diagonali o un triangolino). Trascinando questa maniglia con il mouse, l'utente può espandere o ridurre verticalmente (e anche orizzontalmente nella Dashboard Note Personali) l'area del campo di testo della nota, adattandola alla lunghezza del contenuto che desidera inserire, per una migliore visibilità e comodità durante la scrittura.

4. Pannello degli Strumenti (Espandibile) per l'Evidenziazione

  • Sotto il titolo del capitolo e sopra l'elenco dei versetti, la sezione espandibile "Pannello degli Strumenti" contiene gli strumenti per l'evidenziazione del testo.
  • Selezione del Testo: L'utente seleziona con il mouse una porzione di testo all'interno di un versetto.
  • Strumenti di Evidenziazione: Una volta selezionato il testo, diventano attivi i pulsanti nel "Pannello degli Strumenti":
    • "E" (Evidenzia Selezione): Applica uno sfondo colorato.
    • "S" (Sottolinea Selezione): Applica una sottolineatura.
    • Menu a tendina "Seleziona colore": Per scegliere un colore specifico.
    • "G" (Grassetto).
    • "R" (Testo Rosso/Colore Testo).
    • "B" (Box/Cornice).
    • "X" (Rimuovi Evidenziazione).
  • Il pannello include anche pulsanti "Seleziona tutto" / "Deseleziona tutto" e contiene link ad altre sezioni.

Libreria Personale

All'interno della finestra modale che mostra il testo di un capitolo biblico, il "Pannello degli Strumenti" (espandibile) offre accesso a diverse funzionalità, tra cui la "Libreria Personale".

Accesso e Contenuto dell'Elenco

  • Accesso: Cliccando sull'intestazione "Libreria Personale" all'interno del "Pannello degli Strumenti", si espande una sezione che elenca le collezioni di testi e riferimenti salvati precedentemente dall'utente.
  • Contenuto dell'Elenco: Ogni voce in questo elenco rappresenta una "collezione" salvata e tipicamente mostra:
    • Nome della Collezione: Il nome che l'utente ha assegnato alla collezione al momento del salvataggio (es. "storia di Capernaum", "studio sulla predestinazione", "battesimo", "ades").
    • Indicatore di Tipo (T o R): Accanto al nome della collezione, un piccolo simbolo indica l'origine o il tipo di contenuto della collezione:
      • "T" (Testo): Questo simbolo indica che la collezione è stata creata selezionando del testo generico da una qualsiasi pagina web e salvandolo tramite un'apposita funzione dell'estensione. Questi sono quindi "ritagli" di testo salvati dall'utente.
      • "R" (Riferimenti): Questo simbolo indica che la collezione è stata creata salvando l'elenco dei riferimenti biblici trovati automaticamente dall'estensione in una specifica pagina web (come descritto precedentemente, tramite il pulsante "Salva in Libreria" nel pannello "Elenco riferimenti biblici").
    • Dettagli della Collezione: Sotto il nome, possono essere visualizzate informazioni aggiuntive come il numero di testi o riferimenti contenuti e la data di creazione.

Azioni per ogni Collezione

Accanto a ogni voce della libreria, sono presenti delle icone per interagire con la collezione:

  • Icona "Visualizza" (es. un occhio): Cliccando su questa icona, si apre una finestra modale che mostra il contenuto dettagliato della collezione selezionata.
    • Se la collezione è di tipo "T" (Testo): Il popup mostrerà il testo che era stato selezionato e salvato, insieme al nome della collezione, eventuali tag e note associate, e un link alla pagina web originale da cui il testo è stato preso. Sarà presente un pulsante "Copia tutto" per copiare il contenuto del popup.
    • Se la collezione è di tipo "R" (Riferimenti): Il popup mostrerà l'elenco dei riferimenti biblici che erano stati salvati da quella pagina, insieme al nome della collezione, eventuali tag e note, e un link alla pagina web originale. Ogni riferimento nell'elenco è interattivo (viene mostrato il tooltip e permette l'accesso al capitolo). Anche qui, un pulsante "Copia tutto" permetterà di copiare l'intero contenuto della collezione.
  • Icona "Cestino": Permette di eliminare la collezione selezionata dalla Libreria Personale.

Chiusura del Popup della Collezione

Il popup che mostra il dettaglio di una collezione ha un pulsante di chiusura ("X").

La "Libreria Personale" funge quindi da archivio organizzato per due tipi distinti di informazioni salvate dall'utente: Testi liberi selezionati da pagine web (marcati con "T") e Elenchi di riferimenti biblici estratti automaticamente da pagine web (marcati con "R").

Arricchire le Note Personali con Testo Selezionato da Pagine Web

L'estensione permette di arricchire le note personali associate ai versetti biblici aggiungendo porzioni di testo selezionate da qualsiasi pagina web. Ecco come funziona:

  1. Selezione del Testo su una Pagina Web:
    • L'utente si trova su una pagina web (diversa dalla finestra dell'estensione stessa) e seleziona con il mouse una porzione di testo che ritiene rilevante.
    • Dopo aver selezionato il testo compare automaticamente un menu contestuale flottante con due pulsanti principali:
      • "Aggiungi a Nota": Selezionando questa opzione, si apre un popup.
      • "Salva in Libreria": Questa opzione (già descritta) salva il testo selezionato come una nuova collezione di tipo "T" (Testo) nella Libreria Personale.
  2. Funzione "Aggiungi a Nota":
    • Popup "Scegli a quale nota aggiungere il testo": Cliccando "Aggiungi a Nota" dal menu contestuale, appare un popup che elenca tutte le note personali precedentemente create dall'utente (quelle associate a specifici versetti biblici). Questo popup presenta:
      • Un campo "Filtra note..." per cercare rapidamente una nota specifica nell'elenco.
      • Un elenco scorrevole delle note esistenti, ognuna identificata dal riferimento biblico (es. "Giovanni 3:5", "Genesi 1:10"), dal testo della nota (se presente) e dai tag associati.
    • Selezione della Nota di Destinazione: L'utente seleziona dall'elenco la nota biblica a cui desidera aggiungere il testo precedentemente selezionato sulla pagina web.
    • Campi Aggiuntivi: Scorrendo con la barra verranno visualizzati "Campi aggiuntivi" (come "Tag" e "Riferimenti incrociati") per modificare ulteriormente la nota di destinazione prima di aggiungere il testo. Se questi campi sono già compilati per la nota scelta, verranno mostrati.
    • Conferma dell'Aggiunta: Dopo aver eventualmente modificato i campi aggiuntivi, si sceglie una nota biblica dall'elenco. Il testo selezionato nella pagina web viene quindi inserito all'interno della nota biblica selezionata.
  3. Visualizzazione nella Dashboard Note Personali:
    • Una volta aggiornata, la nota sarà visibile sia nella sezione "Dashboard Note Personali" (accessibile tramite il pulsante Note) sia nel capitolo contenente il versetto scelto. In entrambe le visualizzazioni, sarà possibile leggere il testo aggiunto.
    • Formattazione del Testo Aggiunto:
      • Il testo proveniente da una pagina web esterna è preceduto dall'icona 📄, che lo distingue dal contenuto originale della nota.
      • Importante, viene inclusa la fonte da cui il testo è stato tratto. Questa informazione è generalmente presentata come: "Da: "[Titolo della pagina web]" ([URL di example.com])".
      • Link alla Fonte: L'URL della pagina web sorgente è un link attivo. Cliccando su questo link, l'utente viene reindirizzato alla pagina web originale da cui il testo è stato copiato.
    • Interazione: Anche il testo aggiunto e i riferimenti biblici presenti in esso (se l'estensione li rileva anche qui) rimangono interattivi (tooltip al passaggio del mouse, ecc.).

Questa funzionalità permette di creare delle note bibliche molto ricche, collegando direttamente le proprie riflessioni sui versetti a citazioni specifiche, commenti o informazioni trovate su altre risorse web, mantenendo sempre traccia dell'origine del materiale aggiunto e facilitandone il recupero e la verifica.

Diario di Lettura (Piano di Lettura Manuale)

All'interno della finestra modale, espandendo il "Pannello degli Strumenti", l'utente trova la sezione "Diario di Lettura".

  1. Accesso e Espansione: L'utente clicca sull'intestazione "Diario di Lettura" nel "Pannello degli Strumenti" per espandere questa sezione.
  2. Aggiunta di Riferimenti al Piano:
    • È presente un campo di testo con un placeholder come "Aggiungi riferimento (es. Romani 8 o Rm 8:1)".
    • L'utente può inserire in questo campo un riferimento biblico, come un singolo versetto, un intervallo di versetti (es. Rom 8:1-5) o un intero capitolo.
    • Accanto al campo di testo c'è un pulsante "Aggiungi". Cliccandolo, il riferimento inserito viene aggiunto a una lista sottostante.
  3. Lista dei Riferimenti del Piano:
    • I riferimenti aggiunti vengono elencati suddivisi per Testamento (Antico e Nuovo Testamento).
    • Ogni riferimento nella lista (es. "Romani 8:1-5", "Giovanni 3", "Salmi 37") è preceduto da una casella di controllo (checkbox).
    • Tracciamento della Lettura: Quando l'utente ha letto un determinato passo o capitolo, può spuntare la relativa checkbox per marcarlo come completato. Accanto al riferimento viene visualizzata la data in cui è stato contrassegnato come letto (es. "(Letto il 23/05/2025)"); il testo del riferimento appare barrato e lo sfondo si colora di verde.
    • Interattività: Ogni riferimento nell'elenco è un link cliccabile. Cliccando su di esso (es. su "Romani 8:1-5"), la finestra di lettura principale si aggiorna per mostrare quel capitolo specifico, con i versetti del riferimento (se è un passaggio) evidenziati.
    • Barra di Avanzamento: Sopra l'elenco dei riferimenti una barra di avanzamento visualizza il progresso (es. "1/3 completato (33.3%)", "3/3 completato (100.0%)").
    • Rimozione: Accanto a ogni riferimento nella lista è presente un'icona (es. una "X" rossa) per rimuovere quel specifico riferimento dal piano di lettura.
    • Pulsante "Reset": Un pulsante "Reset" (di colore rosso) permette di rimuovere tutti i riferimenti dal piano di lettura corrente, dopo una conferma (es. "Sei sicuro di voler rimuovere tutti i riferimenti dal piano di lettura?").
  4. Sezione "Statistiche" (relativa al Diario di Lettura):
    • Espandendo la sezione "Statistiche" (che si trova sotto il "Diario di Lettura"), l'utente può visualizzare un riepilogo del proprio progresso nel piano di lettura manuale.
    • Le statistiche possono includere:
      • "Completamento": Percentuale e frazione dei riferimenti completati (es. "100.0% (2/2)").
      • "Libri": Un dettaglio dei libri e capitoli/versetti inclusi nel piano e quanti di essi sono stati letti (es. "Genesi: 1 capitoli, 31 versetti"; "Proverbi: 1 capitoli, 33 versetti").
      • "Costanza": Una metrica che indica la frequenza di lettura (es. "2.0 letture a settimana").

Piano Flessibile con selezione libera dei capitoli

  1. Accesso e Espansione: Sotto la sezione "Statistiche" del Diario di Lettura, l'utente trova "Piano Flessibile". Cliccando sull'intestazione si espande questa funzionalità.
  2. Selezione dei Capitoli:
    • Questa sezione presenta una visualizzazione dell'intera Bibbia, libro per libro, con i capitoli di ciascun libro rappresentati da caselle di controllo numerate.
    • L'utente può spuntare le checkbox dei capitoli che intende includere nel proprio piano di lettura o che ha già letto.
    • Ogni capitolo è rappresentato da una casella colorata che cambia gradualmente: rosso per i capitoli non iniziati, arancione per quelli selezionati, verde per quelli completati.
    • Feedback Visivo (Monitora i tuoi obiettivi con statistiche in tempo reale):
      • "Capitoli selezionati": Mostra il numero totale di capitoli selezionati rispetto al totale dei capitoli della Bibbia e la percentuale corrispondente (es. "5/1189 (0.4%)").
      • "Capitoli letti": Questa statistica si aggiorna in base ai capitoli marcati come letti nel "Piano Flessibile".
    • L'elenco dei libri e dei relativi capitoli è scorrevole per coprire l'intera Bibbia.

Queste due funzionalità, "Diario di Lettura" e "Piano Flessibile", forniscono all'utente strumenti potenti e flessibili per creare piani di lettura personalizzati, tracciare i progressi e ottenere una visione statistica delle proprie abitudini di lettura della Bibbia.

Sezione "Tag disponibili" (Espandibile nel Pannello degli Strumenti)

  1. Visualizzazione: Cliccando sull'intestazione "Tag disponibili" nel "Pannello degli Strumenti", questa sezione si espande (comportandosi come un accordion) per mostrare un elenco di tutti i tag unici che l'utente ha utilizzato nelle sue note personali salvate nell'estensione.
  2. Aspetto dei Tag: I tag sono presentati come delle etichette (es. "abisso", "acque", "creazione", "gesù", "luce", "mari", "nascere di nuovo", "nuova nascita", "tenebre", "terra").
  3. Interazione con i Tag:
    • Click su un Tag: Cliccando su uno di questi tag (es. "gesù"), l'estensione esegue un'azione di filtro o ricerca:
      • Il tag cliccato viene automaticamente inserito nel campo "Cerca note per tag...".
      • Sotto la sezione "Tag disponibili" viene visualizzata una sezione "Risultati della ricerca" (es. "Risultati per 'gesù'").
      • Questa sezione elenca tutte le note personali (identificate dal riferimento biblico) a cui è stato associato il tag selezionato. Vengono mostrati anche i tag associati a quella nota specifica.
      • Ogni riferimento biblico nei risultati è cliccabile per andare direttamente ad esso.
      • È presente un pulsante "Copia Risultati" per copiare l'elenco delle note trovate tramite la ricerca per tag.
  4. Campo "Cerca note per tag...":
    • Come accennato, questo campo può essere compilato manualmente dall'utente digitando un tag, oppure automaticamente cliccando su un tag dalla lista "Tag disponibili".
    • Digitando un tag si attiva automaticamente la ricerca mostrando i risultati nella sezione "Risultati della ricerca".

Calendario Note e Annotazioni

All'interno della "Dashboard Note Personali", è presente un'icona a forma di calendario che, una volta cliccata, apre una finestra modale più ampia intitolata "Calendario Note e Annotazioni". Questa interfaccia offre una visualizzazione temporale e strumenti per gestire le note bibliche e annotazioni giornaliere.

Struttura del Calendario Note e Annotazioni

1. Layout a Due Colonne:

  • Colonna Sinistra (Dettaglio Note): Quando un giorno viene selezionato sul calendario, questa colonna si popola con l'elenco delle note bibliche (quelle associate a specifici versetti) e le annotazioni giornaliere create o modificate in quella data.
  • Colonna Destra (Calendario): Mostra la visualizzazione mensile del calendario.

2. Visualizzazione Mensile del Calendario (Colonna Destra)

  • Navigazione Temporale:
    • Pulsanti << Anno e Anno >> per passare all'anno precedente o successivo.
    • Pulsanti < Mese e Mese > per passare al mese precedente o successivo.
    • Pulsante "Oggi" per tornare rapidamente al mese e al giorno correnti.
    • Indicazione del mese e anno correntemente visualizzati (es. "Maggio 2025").
  • Griglia del Mese: I giorni sono disposti in una griglia settimanale (Lun, Mar, Mer, Gio, Ven, Sab, Dom).
  • Evidenziazione e Indicatori sui Giorni:
    • Giorno Corrente: Il giorno attuale è solitamente evidenziato (es. con uno sfondo di colore diverso, come giallo chiaro).
    • Giorni con Note/Annotazioni: I giorni in cui sono state create o modificate note bibliche o aggiunte annotazioni giornaliere presentano indicatori visivi:
      • Numero di Note: Un badge e un numero (es. un cerchio blu con un "2" o "3") indica quante note bibliche sono associate a quel giorno (in base alla data di creazione o modifica).
      • Colori di Sfondo Personalizzati: Se è stata impostata un'annotazione con un colore specifico, lo sfondo della cella del giorno rifletterà quel colore (es. rosso, verde).
      • Simboli: Un'icona/simbolo (es. cuore, lampadina per "Idea", pergamena) può apparire in un angolo (es. superiore destro) della cella del giorno per rappresentare il tipo di annotazione.
      • Indicatori di Categoria: Un piccolo indicatore (es. una lettera e un colore) può apparire in un altro angolo (es. inferiore sinistro) per indicare la categoria dell'annotazione.
      • Tooltip con Nota Breve: Passando il mouse sopra un giorno con un'annotazione, un tooltip mostra la "Nota breve" associata.

3. Visualizzazione delle Note per Giorno Selezionato (Colonna Sinistra)

Quando l'utente clicca su un giorno nel calendario:

  • La colonna sinistra si aggiorna mostrando "Note per [Giorno della settimana] [giorno] [mese] [anno]" (es. "Note per Giovedì 22 maggio 2025").
  • Viene indicato il numero totale di note bibliche create/modificate in quel giorno (es. "2 nota(e) creata(e)").
  • Segue un elenco delle note bibliche, ognuna con:
    • Il riferimento biblico (es. "Genesi 1:10", "Giovanni 3:5"), che è un link interattivo (mostra tooltip al passaggio del mouse).
    • Un frammento del testo della nota o del testo aggiunto esternamente.
    • Un pulsante "Vedi" che, se cliccato, apre un popup con i dettagli completi della nota biblica (testo completo, tag, riferimenti incrociati, data di creazione/modifica), simile a quello accessibile dalla "Dashboard Note Personali".
  • Se sono presenti annotazioni specifiche per quel giorno (non legate a un versetto), vengono anch'esse elencate qui.

4. Filtro "Note per data di:"

Un menu a tendina (es. sopra il calendario) permette di scegliere se visualizzare le note bibliche sul calendario in base alla loro data di "Creazione" o di "Ultima modifica".

5. Aggiunta/Modifica di Annotazioni Personalizzate

  • Accesso: L'utente può fare doppio clic su un giorno nel calendario, oppure cliccare con il tasto destro su un giorno e selezionare un'opzione dal menu contestuale (es. "Aggiungi annotazione") per aprire un pannello laterale di modifica.
  • Pannello "Annotazione per [data]": Questo pannello permette di personalizzare l'aspetto e le informazioni del giorno selezionato:
    • "Colore": Menu a tendina per scegliere un colore di sfondo per il giorno (es. Predefinito, Blu, Verde, Rosso, Arancione, Viola, Turchese).
    • "Simbolo": Menu a tendina per selezionare un'icona da visualizzare sul giorno (es. Nessuno, Importante, Segnalibro, Domanda, Frecce, Idea, Penna, Pergamena, Riflessione, Fuoco, Colomba, Lettura fatta, Studio, Promemoria).
    • "Categoria": Menu a tendina per assegnare una categoria all'annotazione (es. Nessuna, Studio, Preghiera, Sermone, Personale, Incontro, Insegnamento, Personalizzato).
    • "Nota breve": Un campo di testo per inserire una breve descrizione o promemoria (es. fino a 250 caratteri) che apparirà nel tooltip del giorno.
    • "Ripeti questa annotazione": Una casella di controllo che, se spuntata, rivela opzioni per impostare una ricorrenza:
      • "Frequenza": Menu a tendina (Giornaliera, Settimanale, Mensile, Annuale).
      • "Ogni": Campo numerico per specificare l'intervallo (es. ogni "1" giorno, ogni "2" settimane).
      • "Fine": Opzione per definire quando termina la ricorrenza (es. "Mai", "Dopo X occorrenze", "Fino al [data specifica selezionabile da un calendario]").
      • Viene mostrata l'indicazione "La ricorrenza inizierà da: [data del giorno selezionato]".
  • Pulsante "Salva": Applica le modifiche e aggiorna la visualizzazione del calendario.

6. Esportazione del Calendario

In fondo alla finestra del calendario, sono presenti pulsanti per:

  • "Esporta Mese iCal": Esporta le note e le annotazioni del mese visualizzato in formato iCalendar (.ics), compatibile con la maggior parte delle applicazioni di calendario.
  • "Esporta Mese CSV": Esporta le note e le annotazioni del mese in formato CSV.

Questa interfaccia a calendario offre un modo potente e visivo per organizzare non solo le note bibliche in base alla data, ma anche per aggiungere promemoria, eventi o temi specifici ai singoli giorni, con opzioni di personalizzazione e ricorrenza.

Importa/Esporta Facilmente Tutti i Tuoi Dati dalla Dashboard Note Personali

  • Esportazione Completa con un Click: Con un solo clic, puoi esportare tutti i tuoi contenuti – note personali sui versetti (comprese eventuali aggiunte da pagine web), annotazioni del calendario, l'intera libreria personale e i tuoi segnalibri – in un unico file JSON compatto e portatile. (Questa funzionalità è accessibile dal pulsante "Esporta JSON" nella Dashboard Note Personali).