# Manuale Completo: Suite Concettualizzatore Questo documento è la guida ufficiale per l'utilizzo delle quattro applicazioni di concettualizzazione. ## 1. Installazione e Configurazione (Una Tantum) Tutte le applicazioni funzionano localmente sul tuo computer grazie a **Ollama**. ### Passo A: Scarica Ollama 1. Vai su [ollama.com](https://ollama.com) e scarica l'installer per il tuo sistema operativo. 2. Installa e avvia il programma. ### Passo B: Scarica un Modello (Intelligenza) Apri il terminale (PowerShell o CMD) e digita uno di questi comandi per scaricare un "cervello" elettronico: * `ollama pull llama3` (Consigliato, bilanciato) * `ollama pull qwen2.5` (Ottimo per l'italiano) * `ollama pull mistral` (Veloce) ### Passo C: Abilita il Collegamento (CORS) - FONDAMENTALE Per far parlare le App (HTML) con Ollama, devi dare un permesso speciale. **Su Windows (PowerShell):** 1. Chiudi Ollama (Tasto destro sull'icona nella barra in basso a destra -> Quit). 2. Apri PowerShell e incolla questo comando: ```powershell [Environment]::SetEnvironmentVariable("OLLAMA_ORIGINS", "*", "User") ``` 3. Premi Invio. 4. **Riavvia Ollama**. --- ## 2. Le Quattro Applicazioni Scegli l'applicazione in base al tuo obiettivo. | Applicazione | File | Colore Tema | Obiettivo & Target | | :--- | :--- | :--- | :--- | | **Standard** | `Concettualizzatore.html` | Viola/Dark | **Accademico**. Genera 3 concetti complessi e denotativi. Per universitari e saggisti. | | **Junior** | `ConcettualizzatoreJr.html` | Arancio | **Didattico (11-14 anni)**. Genera 6 concetti rigorosi (Nome+Aggettivo). Per la scuola media. | | **VdB1** | `ConcettualizzatoreVdB1.html` | Verde | **Fondamentale**. Usa *solo* le 2000 parole più semplici dell'italiano. Per alta leggibilità e inclusione. | | **VdB All** | `ConcettualizzatoreVdBAll.html` | Blu | **Vocabolario di Base**. Usa le 7000 parole del VdB De Mauro. Per comunicazione chiara e istituzionale. | | **Adattatore** | `AdattatoreUniversale.html` | Teal | **Facilitazione Generale**. 3 livelli classici. Vedi `Manuale_AdattatoreUniversale.md`. | | **Ctrl+Scrittura** | `ScritturaControllata.html` | Viola/Oro | **Protocolli Rigorosi**. Coach e adattatore L1-L3. Vedi `Manuale_ScritturaControllata.md`. | --- ## 3. Come Usarle 1. **Apri il file**: Fai doppio clic sul file `.html` che vuoi usare. 2. **Verifica**: Controlla il pallino in basso a destra. * 🟢 **Verde**: Tutto ok. * 🔴 **Rosso**: Ollama è spento o il CORS non è configurato (vedi Passo C). 3. **Scegli il Modello**: Selezionalo dal menu a tendina in alto. 4. **Genera**: * Scrivi la frase metaforica (es. "Un mare di problemi"). * Clicca il pulsante centrale. * Attendi la generazione delle card. ## 4. Risoluzione Problemi * **Non succede nulla quando clicco**: Controlla il pallino rosso. Se è rosso, riesegui il comando CORS e riavvia Ollama. * **Risposte strane/inglesi**: Prova a cambiare modello (es. usa `llama3` invece di modelli più piccoli). * **"Errore Network"**: Ollama non è raggiungibile. Assicurati che l'icona di Ollama sia visibile nella barra delle applicazioni. --- *Suite Concettualizzatore - Versione 1.1* --- # 5. Suite Estensioni Vocabolario di Base (VdB) Oltre al conceptualizzatore, la suite include tre strumenti specifici per il lavoro sul lessico: ## 5.1 Analizzatore Lessicale VdB (`AnalizzatoreVdB.html`) Strumento di analisi che "legge" un testo e colora le parole in base alla loro appartenenza al Vocabolario di Base di Tullio De Mauro. - **Verde**: Parole Fondamentali (le 2000 parole base). - **Giallo**: Alto Uso (molto frequenti). - **Rosso**: Fuori VdB (parole complesse, rare o tecniche). **Uso**: Incolla un testo e premi "Analizza". Ideale per verificare la leggibilità di un documento. ## 5.2 Deburocratizzatore (`Deburocratizzatore.html`) Traduttore automatico da "Burocratese" a Italiano Semplice. - **Input**: Circolari, avvisi legali, testi amministrativi complessi. - **Output**: Una versione riscritta usando solo il Vocabolario di Base, frasi brevi e sintassi lineare (Soggetto-Verbo-Oggetto). ## 5.3 Generatore di Esercizi (`GeneratoreEserciziVdB.html`) Creatore di materiali didattici istantanei. - **Cloze (Testi bucati)**: Crea un testo su un argomento e rimuove parole chiave. - **Riordino**: Genera frasi con parole mescolate da rimettere in ordine. - **Abbinamento**: Crea definizioni da collegare alle parole corrette. Tutti gli strumenti richiedono **Ollama** attivo (`localhost:11434`).