==============================================================================
      DIZIONARIO LATINO CLONE - ISTRUZIONI PER IL PC DI ARRIVO
==============================================================================

Questa guida spiega come installare ed eseguire l'applicazione sul computer
di destinazione (Windows 10 o Windows 11).

------------------------------------------------------------------------------
PREREQUISITO: Interprete Python
------------------------------------------------------------------------------
Sul computer deve essere installato Python (versione 3.8 o superiore).

1. Se non e gia presente, scaricalo da:
   https://www.python.org/downloads/

2. FONDAMENTALE DURANTE L'INSTALLAZIONE:
   Nella prima schermata dell'installer di Python, metti la spunta alla casella:
   [x] "Add python.exe to PATH"  (oppure "Add Python to environment variables")
   e poi clicca su "Install Now".


------------------------------------------------------------------------------
PASSO 1: ESTRAZIONE DELLO ZIP
------------------------------------------------------------------------------
Estrai l'archivio zip "dizionario-latino-clone.zip" in una cartella a tua scelta.
Ad esempio:
  - C:\DizionarioLatino
  - oppure nella tua cartella Documenti
  - oppure sul Desktop


------------------------------------------------------------------------------
PASSO 2: CONFIGURAZIONE AUTOMATICA (1 SOLO CLIC)
------------------------------------------------------------------------------
Apri la cartella estratta "dizionario-latino-clone":

1. Fai clic con il TASTO DESTRO del mouse sul file:
   "installa.ps1"

2. Nel menu contestuale di Windows, seleziona:
   "Esegui con PowerShell" (Run with PowerShell)

Lo script compira automaticamente le seguenti operazioni:
  - Rilevera la posizione corretta di Python sul PC
  - Installera la libreria necessaria (beautifulsoup4)
  - Creera sul tuo Desktop il collegamento "Dizionario Latino.lnk"
  - Creera nella cartella del programma il collegamento "Avvia Dizionario Latino.lnk"


------------------------------------------------------------------------------
PASSO 3: UTILIZZO QUOTIDIANO
------------------------------------------------------------------------------
D'ora in poi, per usare il dizionario:

1. Fai doppio clic sul collegamento "Dizionario Latino" presente sul Desktop.
2. Il programma avviera in background il server locale (senza finestre nere
   di terminale) e aprira automaticamente il tuo browser all'indirizzo:
   http://127.0.0.1:8080

FUNZIONALITA DISPONIBILI:
- Ricerca Latino -> Italiano con lemmi, paradigmi e oltre 100 citazioni d'autore
- Riconoscimento delle forme flesse (declinate e coniugate)
- Declinatore e Coniugatore automatico con radici e desinenze evidenziate
- Ricerca inversa Italiano -> Latino
- Barra dei caratteri latini con quantita vocaliche (a, e, i, o, u con macron)
- Caching automatico su database SQLite locale (consultabile anche offline)
==============================================================================
