Clonare oh oh oh oh

Il clone 2, “modernizzato” con AI

Download del software

MANUALE_WORDPROF_STUDIO.md
# Manuale di Istruzioni — WordProf Studio (Edizione 1992 → 2026)
**WordProf Studio** è la ricostruzione filologica e moderna di **WordProf 1.5** (*CNR – Istituto per le Tecnologie Didattiche di Genova*, 1992 rev. 1996, originariamente distribuito da *Ed. Theorema Libri* e programmato in *Whitewater Actor 3.1/4.0*).
L'applicazione conserva integralmente l'impianto pedagogico e tutti i **657 file didattici originali** (convertiti e bonificati in UTF-8), offrendo un laboratorio completo per l'apprendimento, la pratica, l'analisi e la revisione della scrittura in lingua italiana.
> [!IMPORTANT]
> **Avvio rapido dell'applicazione**
> * **Doppio clic diretto**: esegui [`Avvia_WordProf_Studio.bat`](file:///c:/Users/guast/Documents/wordprof/Avvia_WordProf_Studio.bat) (presente sia in `c:\Users\guast\Documents\wordprof` sia nella cartella di progetto [`wordprof-studio`](file:///C:/Users/guast/.gemini/antigravity/scratch/wordprof-studio/Avvia_WordProf_Studio.bat)).
> * **Avvio tramite Electron**: dalla cartella [`wordprof-studio`](file:///C:/Users/guast/.gemini/antigravity/scratch/wordprof-studio) esegui `npm install` (solo la prima volta) e `npm start`.
> * **Apertura standalone**: apri direttamente [`src/index.html`](file:///C:/Users/guast/.gemini/antigravity/scratch/wordprof-studio/src/index.html) in qualsiasi browser moderno.
---
## 1. Architettura generale e le «5 Anime» di WordProf
WordProf non è un semplice elaboratore di testi, ma un **ambiente cognitivo per la scrittura** articolato in cinque grandi aree operative, accessibili sia dalla **barra dei menu classica** (`Archivio`, `Edit`, `Tipografia`, `Strumenti`, `Modo`, `Biblio`, `Assistente`, `Palestra`, `Aiuto!`) sia tramite le **5 schede rapide** in alto a destra:
```mermaid
flowchart TD
WP["WordProf Studio (657 schede didattiche)"]
WP --> A1["1. Editor, Modo & Strumenti"]
WP --> A2["2. Biblioteca (389 schede)"]
WP --> A3["3. Assistente di Scrittura (82 dialoghi)"]
WP --> A4["4. Palestra Linguistica (87 partite)"]
WP --> A5["5. Sistema Autore & Liste (.LST)"]
A1 --> M1["4 Modalità: Normale, Doppio Testo, Leggi Commentato (.NTZ), Metti Commenti"]
A1 --> S1["Strumenti: Connettivi, Gerundi, Ripetizioni, Liste, Statistica Flesch/Gulpease, Frequenza"]
A2 --> B1["Repertori: Intenti (.INT), Stili (.STI), Testi (.TES), Figure (.FIG), Scenari (.SCE)"]
A3 --> AS1["Dialoghi: Progettare (.PRO), Paragrafi (.PAR), Espandere (.ESP), Riassumere (.RIA)"]
A3 --> AS2["Revisione in 10 fasi (REVIS.REV) + Grillo Pedante live"]
A4 --> G1["Giochi: Cloze, Pesca, Domino, Senza tasto (Lipogramma), Slalom, Arredamento"]
A5 --> AU1["Creazione e validazione nuovi esercizi + Editor liste .LST"]
```
### Controlli rapidi nell'intestazione superiore
Nella fascia blu superiore sono sempre presenti tre pulsanti di stato:
1. **🦗 Grillo Pedante (`ATTIVO` / `DISATTIVO`)**: attiva o silenzia il controllore in tempo reale durante la digitazione.
2. **🎨 Tema (`Moderno` / `Win 3.1 1992`)**: commuta istantaneamente tra l'interfaccia editoriale moderna (carta calda, alta leggibilità) e l'estetica rétro grigio/blu di Windows 3.1.
3. **❓ Aiuto (`657 schede`)**: apre il manuale originale interattivo di WordProf (`INDICE.AIU` e `INDICE.AIT`).
---
## 2. Anima 1 — Editor, Modalità di lavoro (`Modo`) e Gestione File (`Archivio`)
### 2.1. Menu `Archivio`
Dal menu **Archivio** (o dai pulsanti rapidi nella barra degli strumenti dell'Editor) puoi:
* **Nuovo testo (`Ctrl+N`)**: pulisce il foglio di lavoro corrente.
* **Recupera testo WordProf (`.TXT` / `.DCM`)**: apre una finestra con i **14 testi e consegne originali** inclusi in WordProf (es. `SWIFT.TXT`, `TEMA1.TXT`, `IERISERA.TXT`, `VERNE.DCM`, `GUERRA.DCM`).
* *Nota didattica*: se il testo caricato possiede un file di domande associato (`.ASS`, es. `IERISERA.ASS`), nella barra del foglio di scrittura compare automaticamente il pulsante **«💡 Domande su questo testo (.ASS)»**.
* **Leggi testo commentato (`.NTZ`)**: carica uno dei **5 elaborati storici annotati dall'insegnante** (`TEMA1.NTZ`, `RAPINMAG.NTZ`, `COSA.NTZ`, `GERUNDI.NTZ`, `ANNUNCIO.NTZ`) attivando automaticamente la vista di revisione a due colonne.
* **Leggi a sinistra (Doppio testo)**: permette di scegliere un testo da collocare nella finestra di sola lettura a sinistra per prendere appunti, riassumere o rielaborare.
* **Apri file da disco / Registra con il nome (`Ctrl+S`)**: carica o salva sul computer file `.txt`, `.ntz` o esercizi della Palestra.
* **Info scheda**: mostra la scheda metadati del documento (*Titolo*, *Autore/i*, *Data creazione*, *Ultima modifica*, *Caratteri*, *Parole*).
### 2.2. Le 4 Modalità di lavoro (`Menu Modo`)
Il cuore ergonomico di WordProf è la possibilità di cambiare assetto dello schermo in base alla fase del lavoro di scrittura:
| Modalità | Come funziona | Quando usarla |
| :--- | :--- | :--- |
| **1. Normale** | Mostra unicamente il foglio di scrittura principale a tutta larghezza. | Stesura libera o scrittura di getto. |
| **2. Doppio Testo** | Divide lo schermo in due colonne: a **sinistra** il testo di riferimento in sola lettura, a **destra** il foglio di lavoro dello studente. Attiva il pulsante **«Trasferisci! →»**. | Riassunti, riscritture, parafrasi, citazioni o lavoro su scalette prese dalla Biblioteca. |
| **3. Leggi testo commentato (`.NTZ`)** | A **sinistra** mostra il testo originale con il *Giudizio complessivo* e i passaggi commentati **sottolineati ed evidenziati in giallo**; a **destra** offre una copia modificabile del testo. Cliccando su ciascuna porzione sottolineata a sinistra, in basso compare la nota specifica del docente. | Revisione da parte dello studente di un compito corretto dall'insegnante. |
| **4. Metti commenti (Modalità Docente)** | Attiva il pannello laterale di correzione per l'insegnante con la **tassonomia ufficiale degli errori di WordProf 1.5**. | Correzione e annotazione strutturata degli elaborati degli studenti con salvataggio in formato `.NTZ`. |
> [!TIP]
> **Come usare «Trasferisci! →» in Doppio Testo**
> Nella finestra di sinistra (o in qualsiasi scheda della Biblioteca portata a sinistra), evidenzia con il mouse una frase o un brano e premi **«Trasferisci! →»**: il frammento verrà copiato esattamente nel punto del cursore dentro il tuo testo di destra.
### 2.3. Come correggere un compito in modalità «Metti commenti» (Docente)
1. Apri il testo dello studente e seleziona **Modo → Metti commenti** (oppure il pulsante **«Metti Commenti»** nella barra strumenti).
2. Seleziona con il mouse nel testo la parola, il segno di punteggiatura o la frase da commentare.
3. Nel pannello di destra, scegli la categoria dalla **tassonomia originale di WordProf**:
* *Ortografia*
* *Morfo-sintassi: modi/tempi verbo*
* *Morfo-sintassi: concordanze*
* *Morfo-sintassi: reggenza sintattica*
* *Morfo-sintassi: altro*
* *Punteggiatura*
* *Significato*
* *Stile*
* *Coerenza / Coesione*
* *Struttura*
* *Altro*
4. Scrivi l'osservazione e clicca su **«➕ Registra nota sulla selezione»** (WordProf impedisce automaticamente di sovrapporre due note sullo stesso segmento, come previsto da `selOverlappsNote` nell'originale).
5. Puoi aggiungere un **Giudizio complessivo sul testo** nell'apposito riquadro, testare subito l'effetto lato studente con **«👁️ Prova in Leggi commentato»**, oppure esportare il file con **«💾 Salva .NTZ»** (che codifica i marcatori originali `0xD8`/`0xF8` e la coda `|nota`).
---
## 3. Il «Cacciavite Digitale» (`Menu Strumenti`) e il Grillo Pedante
Il menu **Strumenti** contiene gli analizzatori automatici pensati per rendere visibili le strutture nascoste del testo.
### 3.1. Ricerca ed evidenziazione passo-passo (`Cerca...` / `Evidenzia...`)
Ogni strumento di ricerca attiva una **barra gialla di navigazione passo-passo** sopra il testo (*«◀ Precedente»*, *«Trova il prossimo... ▶»*, *«Mostra tutti»*, *«✕ Torna all'editing»*):
* **Cerca... una parola**: trova tutte le occorrenze di un termine specifico.
* **Cerca... una lista di parole**: permette di scegliere una delle **liste storiche `.LST`** oppure di digitare al volo una lista di parole personalizzata:
* `BUROCRAT.LST` (*burocratismi*: *altresì, ancorché, avente, cadauno, confacente, espletamento, idoneo...*)
* `CNTIVI.LST` (*connettivi testuali*)
* `DEITTICI.LST` (*pronomi e riferimenti deittici*: *cui, quale, lo, gli, glielo, esso, ciò, colui, costoro...*)
* `DIMOSTRA.LST` (*dimostrativi*)
* `ESAGERAZ.LST` (*iperboli ed esagerazioni*: *allucinante, bestiale, disastro, incubo, orrendo, pazzesco, spaventoso, tremendo...*)
* `PREPOSIZ.LST` (*preposizioni semplici e articolate*)
* `SOSPETTE.LST` (*espressioni sospette o errori comuni*: *attimino, cioè, fà, ottimale, pè, praticamente, quì, quà, qual'è...*)
* `TEMINWDS.LST` (*parole "da tema in classe"*: *credo, penso, cioè...*)
* **🔗 Cerca... i connettivi**: evidenzia i legami logici e testuali (`CNTIVI.LST`) per verificare la coesione tra le frasi.
* **⚡ Cerca... i gerundi**: individua tutte le forme verbali in `-ando` / `-endo` (incluse le forme enclitiche come `-andosi`, `-endolo`, `-endogli`), **escludendo automaticamente i falsi amici** elencati in [`NONGERUN.LST`](file:///c:/Users/guast/Documents/wordprof/NONGERUN.LST) (*quando, comando, bando, contrabbando, laureando, nefando, blando, rimando, telecomando, brando, venerando, crescendo, tremendo, rammendo, stupendo, reverendo, orrendo, mondo, fondo, secondo...*).
* **🔁 Cerca... le ripetizioni**: analizza il testo **paragrafo per paragrafo**, escludendo le parole vuote ([`STOPWORD.LST`](file:///c:/Users/guast/Documents/wordprof/STOPWORD.LST)), ed elenca nel pannello destro tutte le parole ripetute almeno 2 volte nel paragrafo corrente. Cliccando su una parola ripetuta la vedrai illuminata nel paragrafo; con **«Prossimo paragrafo ▶»** passi al capoverso seguente.
* **Evidenzia... l'inizio dei paragrafi**: illumina le prime parole di ciascun capoverso per valutare a colpo d'occhio la coerenza e la progressione tematica.
* **Evidenzia... le frasi / i paragrafi**: isola una frase (o un paragrafo) alla volta per il controllo analitico della sintassi.
### 3.2. Statistica e Indici di Leggibilità (`📊 Statistica`)
Apre il pannello statistico a destra (richiede almeno alcune parole nel foglio di lavoro) e calcola:
1. **Volumetria**: numero di *Caratteri*, *Parole*, *Frasi* e *Paragrafi*.
2. **Sintassi del periodo**:
* **Lunghezza media delle frasi** (in parole);
* **Indice di dispersione ($\sigma$)** della lunghezza delle frasi (indica se le frasi sono tutte monotone della stessa lunghezza o ben variate);
* **Frase più lunga**: mostra l'anteprima del periodo più lungo con il pulsante **«Vedere!»** per selezionarlo subito nel testo.
3. **Leggibilità Flesch-Vacca (originale WordProf 1.5)**:
$$\text{Flesch}_{\text{IT}} = 206 - 0{,}65 \cdot \left(\frac{\text{Sillabe} \times 100}{\text{Parole}}\right) - 1{,}0 \cdot \left(\frac{\text{Parole}}{\text{Frasi}}\right)$$
Classificata nelle **5 fasce storiche estratte da `WORDPROF.IMA`**:
* `molto facile (>80)`
* `facile (79-60)`
* `difficile (59-50)`
* `molto difficile (49-35)`
* `quasi incomprensibile (<35)`
4. **Indice Gulpease** (specifico per la lingua italiana, basato sulla lunghezza delle parole in lettere):
$$\text{Gulpease} = 89 + \frac{300 \cdot \text{Frasi} - 10 \cdot \text{Lettere}}{\text{Parole}}$$
### 3.3. Indice di Frequenza (`🔢 Frequenza`)
Permette di generare il vocabolario di frequenza del testo:
* **Ambito**: *Tutte le parole del testo* oppure solo le voci appartenenti a un gruppo specifico (*Burocratismi, Connettivi, Deittici, Dimostrativi, Esagerazioni, Preposizioni, Parole sospette*).
* **Filtro**: casella **«Escludi parole vuote (STOPWORD.LST)»** per omettere articoli, preposizioni e particelle.
* **Ordinamento**: per frequenza decrescente (**`123`**) o alfabetico (**`A-Z`**).
* **Interazione**: cliccando su qualsiasi voce della tabella, tutte le sue occorrenze vengono evidenziate nel testo.
### 3.4. Il «Grillo Pedante»
Il **Grillo Pedante** è il celebre «seccatore» ideato dall'ITD-CNR per avvertire chi scrive in tempo reale:
1. **Controllo della lunghezza della frase**: se scrivi troppo a lungo senza inserire un punto fermo (`.`, `!`, `?` o a capo), il Grillo interviene con i 3 avvisi progressivi originali:
* Oltre **30 parole**: *«Che ne diresti di metterci un punto?»*
* Oltre **42 parole**: *«Io ci metterei un punto.»*
* Oltre **55 parole**: *«Mettici un punto! Chi credi di essere, Manzoni?»*
2. **Controllo delle parole sospette**: se digiti un termine presente in `SOSPETTE.LST` (es. *attimino*, *praticamente*, *ottimale*, *qual'è*, *pè*, *fà*), il Grillo segnala: *«"..." compare in una lista di parole e espressioni sospette!»*.
3. Puoi cliccare su **«Prendo atto»** per chiudere l'avviso o su **«Disattiva Grillo»** se non vuoi essere interrotto.
---
## 4. Anima 2 — La Biblioteca (`📚 Biblioteca`: 389 schede)
La **Biblioteca** mette a disposizione cinque repertori consultabili per osservare modelli di scrittura, confrontare registri e attingere lessico:
| Repertorio | Estensione | Chiavi di accesso disponibili | Contenuto didattico |
| :--- | :---: | :--- | :--- |
| **1. Repertorio di Intenti** | `.INT` | Doppia chiave: per **Intento comunicativo** (`INDICE.INT`: *analizzare, confortare, confutare, corrompere, giustificare, ironizzare, supplicare...*) o per **Situazione** (`INDICE.SIT`: *figlio bocciato, licenziamento per ritardi, i computer fanno male...*). | Come cambia un testo al variare dello scopo pragmatico sulla stessa situazione. Include le spiegazioni metodologiche (`SPIEGAZ.INT`). |
| **2. Repertorio di Stili** | `.STI` | Doppia chiave: per **Stile / Registro** (`INDICE.STI`: *arcaico, burocratico, gergale, medico, notarile, tipo Hemingway, tipo fiaba...*) o per **Tema** (`INDICE.TST`: *Lettera d'amore, Caduta dalle scale, Aneddoto, Notizia di cronaca...*). | Ispirato agli *Esercizi di stile* di Raymond Queneau: decine di variazioni stilistiche sullo stesso fatto, corredate da scheda di analisi stilistica (`SPIEGAZ.STI`). |
| **3. Repertorio di Testi** | `.TES` | Gerarchica per **Genere testuale** (`INDICE.TES`: *Aforisma, Annuncio economico, Apologo, Biografia, Curriculum, Favola, Istruzioni, Lettera formale, Recensione, Verbale...*). | Per ogni genere presenta una scheda metodologica (*«Che cosa è, come scriverlo»*) seguita da testi modello e d'autore. |
| **4. Figure Retoriche** | `.FIG` / `.IFG` | Doppia chiave: per **Nome della figura** (`INDICE.FIG`: *adùnaton, allegoria, anacoluto, anafora, chiasmo, litote, ossimoro...*) o per **Scopo comunicativo** (`INDICE.IFG`: *Ottenere frasi d'effetto, Attenuare un significato, Dare rilievo...*). | Definizione chiara ed esempi d'uso pratico di 48 figure retoriche. |
| **5. Scenari Lessicali** | `.SCE` | Per **Area tematica** (`INDICE.SCE`: *casa, lampada, lente, sedia, descrizione di persone e animali...*). | Repertori di nomenclatura, aggettivi, verbi specifici, modi di dire e brani d'autore che riutilizzano il lessico proposto. |
### Azioni rapide su ogni scheda della Biblioteca
* **📖 Esempio e spiegazione**: mostra o nasconde il riquadro verde inferiore con la spiegazione teorica/stilistica associata alla scheda.
* **⬅ Porta in Doppio Testo (a sinistra)**: invia la scheda nella colonna sinistra dell'Editor e attiva automaticamente la modalità *Doppio Testo*, così puoi tenerla sott'occhio mentre scrivi a destra.
* **✍️ Copia nel foglio di scrittura**: porta direttamente il testo della scheda nell'Editor principale per modificarlo o rielaborarlo.
---
## 5. Anima 3 — L'Assistente di Scrittura (`🧭 Assistente`: 82 dialoghi + Revisione)
L'**Assistente** accompagna chi scrive nelle fasi di ideazione, pianificazione, stesura paragrafica, manipolazione e revisione del testo attraverso **dialoghi maieutici interattivi**.
### 5.1. I 4 Ambienti Dialogici (`Progettare`, `Paragrafi`, `Espandere`, `Riassumere`)
1. **Progettare testi (`.PRO` — 20 percorsi)**: guida alla costruzione della scaletta in base al *COSA*, *A CHI* e *PERCHÉ* (es. *Articolo di fondo da fatto di cronaca*, *Divulgare un esperimento scientifico*, *Scheda libro o film*, *Presentare un problema sociale*).
2. **Scrivere paragrafi (`.PAR` — 26 percorsi)**: guida alla composizione di paragrafi *Descrittivi*, *Narrativi*, *Espositivi/Spiegazione* e *Argomentativi* (es. *Confutazione di una tesi*, *Confronto per contrasto*, *Ritratto psicologico*).
3. **Espandere (`.ESP` — 24 percorsi)**: tecniche per *Allungare un testo*, *Esplodere una frase* (es. *"Giorgio beve il caffè"* o *"Leggere è noioso"*), *Espandere singoli elementi* e *Ampliare gli aspetti narrativi/descrittivi/argomentativi*.
4. **Riassumere (`.RIA` — 16 percorsi)**: tecniche di riduzione e sintesi (*Togliere parole superflue*, *Togliere parti secondarie*, *Generalizzare termini e azioni*, *Estrarre idee chiave*).
### 5.2. Come funziona il motore dialogico dell'Assistente
* Scegli l'**Obiettivo/Genere** nella prima lista a sinistra e l'**Attività guidata** nella seconda lista.
* Nelle schede di tipo dialogico (`\B`, `\C`, `\D`, `\E`), a sinistra compare il dialogo passo-passo:
* Leggi il testo o lo schema di partenza (se presente) e rispondi alla domanda nella casella di testo.
* Le domande successive **integrano dinamicamente le tue risposte precedenti** (es. se alla domanda `#0` hai risposto *"la scuola"*, la domanda successiva ti chiederà: *«Esprimi un'opinione che non condividi su "la scuola"»*).
* Se sei bloccato, premi **«💡 Esempio»** per leggere la risposta modello preparata dagli autori del CNR, oppure **«Usa esempio»** per inserirla.
* Nel pannello di destra (**«📝 Ricostruzione dinamica del testo»**) vedi in tempo reale la tua bozza prendere forma: i segnaposto arancioni (`<...>`) vengono sostituiti in verde dalle tue risposte.
* **🔄 Altra struttura!**: quando un esercizio prevede più architetture testuali possibili (tipico di *Scrivere paragrafi*), in alto compare il pulsante **«🔄 Altra struttura!»** che riassembla istantaneamente le tue stesse risposte secondo un'organizzazione sintattica e retorica diversa.
* Al termine, clicca su **«✍️ Copia in WordProf (Editor)»** per trasferire la bozza nel foglio di scrittura e rifinirla.
### 5.3. La Revisione Assistita in 10 fasi (`REVIS.REV`)
Dal menu **Assistente → Revisionare** (o dal pulsante **«🔍 Revisione Guidata»** nell'Editor) si apre sul lato destro dell'Editor il percorso di revisione strutturato in **10 stadi successivi**:
1. **Intero testo: Struttura (Griglia)** — verifica della presenza degli elementi essenziali.
2. **Intero testo: Struttura (Paragrafi)** — controllo dell'articolazione in blocchi paragrafici.
3. **Intero testo: Coerenza** — evidenziazione dell'*inizio dei paragrafi* per controllare se la sequenza logica regge.
4. **Intero testo: Lessico** — apertura dell'*Indice di frequenza* per verificare termini tecnici, ripetizioni o parole vaghe.
5. **Paragrafo: Coesione (Connettivi)** — evidenziazione di tutti i connettivi usati nel testo.
6. **Paragrafo: Coesione (Riferimenti pronominali)** — evidenziazione dei deittici e pronomi (`DEITTICI.LST`) per verificare che sia sempre univoco a chi o a che cosa si riferiscono.
7. **Paragrafo: Complessità sintattica (Gerundi)** — individuazione dei gerundi che appesantiscono il periodo.
8. **Paragrafo: Complessità sintattica (Parole sospette / da tema)** — ricerca di burocratismi e locuzioni stereotipate (`TEMINWDS.LST` + `BUROCRAT.LST`).
9. **Paragrafo: Statistica** — verifica numerica della lunghezza delle frasi e dell'indice di leggibilità.
10. **Controllo frase per frase** — scansione di una frase alla volta chiedendosi: *«È necessaria? Posso essere più chiaro o usare meno parole?»*.
---
## 6. Anima 4 — La Palestra di Scrittura (`🎯 Palestra`: 87 giochi)
La **Palestra** propone 6 ambienti di esercizio ludico e vincolato (di chiara ispirazione *Oulipo* e didattica attiva), ciascuno dotato del proprio archivio di partite originali e del pulsante **«🎲 Altra partita!»**:
### 6.1. Cloze (`.CLZ` — 23 partite)
* **Scopo**: ricostruire un testo in cui alcune parole chiave sono state sostituite da caselle numerate `(1)`, `(2)`...
* **Uso**: digita le parole mancanti nelle caselle e premi **«✓ Verifica punteggio»**. Le risposte corrette diventano verdi, quelle errate rosse. Il pulsante **«💡 Soluzione»** svela tutte le parole originali.
### 6.2. Pesca (`.FSH` — 13 partite)
* **Scopo**: individuare e selezionare con il mouse, all'interno di un brano d'autore, tutte le parole o espressioni che rispondono al criterio indicato nel banner (es. *«Pesca tutte le similitudini tratte dal mondo animale in questo brano di Calvino»*).
* **Uso**: fai clic direttamente sulle parole del testo. WordProf risponde nel banner giallo con i suoi feedback storici (*«Dov'è il problema? Questo va benissimo!»*, *«Questo lo hai già trovato!»*, *«Questo non risulta tra le cose da prendere!»*). Con **«💡 Aiuto / Prossimo»** il computer pesca per te uno degli elementi mancanti.
### 6.3. Domino (`.SCR` — 30 partite)
* **Scopo**: rimettere nella sequenza logica, cronologica o argomentativa corretta i blocchi di un testo che sono stati mescolati nella colonna di sinistra.
* **Uso**:
* Fai doppio clic su un blocco a sinistra (oppure selezionalo e premi **«Prendi! →»**) per spostarlo nella colonna ordinata di destra.
* Usa **«↑ Sposta su»**, **«↓ Sposta giù»** o **«← Togli»** per modificare l'ordine a destra.
* Premi **«✓ Controlla!»** per verificare quali blocchi sono nella posizione esatta (bordo verde) e quali fuori posto (bordo rosso), oppure **«💡 Allora faccio io! (Soluzione)»**.
### 6.4. Senza tasto / Lipogramma (`.LPG` — 4 partite + lettera libera)
* **Scopo**: riscrivere nella finestra di destra il testo mostrato a sinistra mantenendone il significato, ma **senza mai usare una lettera proibita** (es. la lettera `A` in `COSA.LPG`).
* **Blocco fisico del tasto**: mentre digiti nella finestra di destra, **il tasto della lettera proibita (comprese le sue varianti accentate) è realmente bloccato sulla tastiera**! Se provi a premerlo, il campo lampeggia in rosso e incrementa il contatore dei tentativi vietati; se provi a incollare un testo che contiene la lettera vietata, scatta l'avviso storico *«Imbroglione! C'è la lettera proibita nel testo incollato!»*.
* Con **«🔤 Cambia lettera proibita!»** puoi scegliere qualsiasi lettera tra `A` e `Z` per trasformare qualunque brano in una sfida di parafrasi e ricerca di sinonimi.
### 6.5. Slalom (`.SLM` — 10 partite)
* **Scopo**: scrivere liberamente un testo sul tema proposto (es. *Approccio in discoteca*, *Giornata storta*, *Connettivi*), con il vincolo di integrare in modo sensato i connettivi o le espressioni «sparate» dal computer.
* **Uso**: mentre scrivi nella finestra di destra, premi il pulsante **«💥 Spara!»**. Il computer inietterà nel tuo testo il prossimo vincolo e lo registrerà nella colonna di sinistra (indicando con `✓` verde o `✗` rosso se è effettivamente presente nel tuo brano). A fine stesura, premi **«✓ Controlla!»**.
### 6.6. Arredamento (`.ARR` — 7 partite)
* **Scopo**: comporre un testo su un tema assegnato utilizzando obbligatoriamente un «arredamento» lessicale fornito dal computer (celebre l'esercizio `BUROCRAZ.ARR`: *scrivere una lettera d'amore usando 28 espressioni del gergo burocratico come «io sottoscritto», «in data odierna», «espletamento», «rose 18 di colore rosso»*).
* **Uso**: premi **«💥 Spara!»** per far comparire nel testo le voci da impiegare (ogni voce va a capo, salvo quelle che nel file sorgente terminano con `\`) e verifica il risultato con **«✓ Controlla!»**.
---
## 7. Anima 5 — Il Sistema Autore (`🛠️ Autore & Liste`)
Riproduce integralmente le funzioni dell'eseguibile storico [`AUTORE.EXE`](file:///c:/Users/guast/Documents/wordprof/AUTORE.EXE), permettendo al docente (o allo studente) di espandere i materiali di WordProf.
### 7.1. «Preparo nuovi giochi»
1. Nella colonna di sinistra scegli quale dei 6 giochi vuoi progettare (*Cloze, Pesca, Domino, Senza tasto, Slalom, Arredamento*): nel riquadro giallo sottostante compaiono le **istruzioni originali per l'autore** (`CLOZISTR.IST`, `PESCISTR.IST`, `DOMIISTR.IST`, `SENZISTR.IST`, `SLALISTR.IST`, `ARREISTR.IST`).
2. Compila:
* **Nome file** (es. `MIOGIOCO.CLZ`);
* **Titolo del tema** (o **Lettera proibita** `A-Z` per *Senza tasto*);
* **Consegna / Spiegazione per lo studente**;
* **Contenuto dell'esercizio**:
* per **Cloze (`.CLZ`)** e **Pesca (`.FSH`)**: scrivi il testo racchiudendo tra parentesi quadre `[così]` le parole da bucare o le porzioni da pescare;
* per **Domino (`.SCR`)**: scrivi il testo ordinato separando con un *A capo* i singoli blocchi (almeno 4 blocchi);
* per **Slalom (`.SLM`)** e **Arredamento (`.ARR`)**: scrivi una locuzione o parola per riga.
3. **Validazione automatica**: prima di salvare, il Sistema Autore esegue gli stessi controlli sintattici di `AUTORE.EXE` (es. verifica parentesi quadre mancanti, invertite `][` o annidate `[[`, o numero minimo di 4 blocchi nel Domino).
4. Clicca su **«➕ Aggiungi alla Palestra e Gioca»** per provarlo immediatamente nella Palestra, oppure su **«💾 Registra file»** per salvarlo su disco nel formato originale di WordProf.
### 7.2. Gestione delle «Liste di parole (`.LST`)»
Selezionando la scheda **«Liste di parole (.LST)»** puoi:
* Ispezionare e modificare ciascuna delle **11 liste linguistiche** (`BUROCRAT.LST`, `CNTIVI.LST`, `DEITTICI.LST`, `DIMOSTRA.LST`, `ESAGERAZ.LST`, `NONGERUN.LST`, `PREPOSIZ.LST`, `SOSPETTE.LST`, `STOPWORD.LST`, `TEMINWDS.LST`, `WRDGRPS.LST`).
* Creare una **Nuova lista `.LST`** personalizzata per la tua classe.
* Premere **«✓ Aggiorna lista in memoria»** per applicare subito le modifiche al *Grillo Pedante* e al menu *Strumenti*, **«🔎 Cerca questa lista nel testo»** per testarla sull'editor, oppure **«💾 Esporta .LST»**.
---
## 8. Riferimento tecnico: Mappa dei formati originali di WordProf 1.5
Per chi desidera ispezionare o modificare manualmente i file nella cartella storica [`c:/Users/guast/Documents/wordprof`](file:///c:/Users/guast/Documents/wordprof) o rieseguire lo script di importazione [`scripts/import_corpus.py`](file:///C:/Users/guast/.gemini/antigravity/scratch/wordprof-studio/scripts/import_corpus.py):
| Estensione | Modulo | Sintassi interna del formato originale |
| :---: | :--- | :--- |
| `.IND` / `INDICE.*` | Indici di navigazione | `+Categoria` (1° livello), `-Voce` o `--Sottovoce` (2° livello), `$nomefile.ext` (puntatore al file), `#` (chiusura gruppo). |
| `.INT`, `.STI`, `.TES`, `.FIG`, `.SCE` | Schede Biblioteca | Righe iniziali con `\metadato` (nascoste all'utente), seguite dal corpo del testo. |
| `.PRO`, `.PAR`, `.ESP`, `.RIA` | Dialoghi Assistente | Prima riga `\A` (solo consigli) oppure `\B`, `\C`, `\D`, `\E`; `$Testo di partenza`; triplette `-Domanda` / `^<Segnaposto>` / `\Risposta d'esempio`; una o più `@Struttura finale con segnaposto #0, #1...` (`&` = andata a capo). |
| `.REV` | Revisione guidata | Sequenza di fasi con `+TITOLO FASE`, `\|Testo del suggerimento (& = a capo)`, `@Etichetta pulsante`, `#comandoActor(Sam,...)`. |
| `.NTZ` | Testi commentati | Corpo del testo con passaggi annotati racchiusi tra i byte `0xD8` (`Ø`) e `0xF8` (`ø`); in calce al file, righe che iniziano con `\|` contenenti nell'ordine l'eventuale giudizio generale e le note corrispondenti a ciascuno span. |
| `.CLZ`, `.FSH` | Palestra: Cloze e Pesca | Righe iniziali `%Consegna per lo studente`, seguite dal brano con gli elementi bersaglio tra parentesi quadre `[...]`. |
| `.SCR` | Palestra: Domino | Righe iniziali `%Consegna`, seguite dai blocchi del testo ordinato separati da andata a capo (minimo 4). |
| `.LPG` | Palestra: Senza tasto | Prima riga `*LetteraProibita` (es. `*A`), righe `%Consegna`, seguite dal brano da riscrivere. |
| `.SLM`, `.ARR` | Palestra: Slalom / Arred. | Prima riga `?Titolo del tema`, seconda riga `*nil` (sequenziale) o `*cas` (casuale), righe `%Consegna`, seguite dall'elenco di parole/locuzioni da «sparare» (una per riga). |
| `.LST` | Liste linguistiche | Elenco di parole o locuzioni (una per riga) usate dal motore di ricerca e dal Grillo Pedante. |
| `.AIU`, `.AIT` | Schede di Aiuto | Prima riga `\A`, seguita dal testo della scheda di aiuto di WordProf (`.AIU`) o di Autore (`.AIT`). |
---
## 9. Il Laboratorio IA di Manipolazione del Testo (`🤖 IA Manipolazione`)
Il menu **IA Manipolazione** (e il pulsante **«🤖 Manipolazione IA»** nella barra degli strumenti dell'Editor) integra un motore di Intelligenza Artificiale progettato specificamente intorno alla metodologia didattica di WordProf.
### 9.1. Motori supportati e Rilevamento automatico di Ollama
* **Ollama Locale (`http://localhost:11434`)**: all'avvio WordProf Studio interroga automaticamente il server Ollama locale, rileva tutti i modelli installati sul computer (escludendo i modelli di solo embedding) e popola il menu a tendina direttamente nel pannello laterale.
* **API OpenAI-compatibili e Google Gemini**: cliccando su **«⚙️»** (o da **IA Manipolazione → Configura Motore IA...**) è possibile collegare **LM Studio** (`http://localhost:1234/v1`), **OpenAI**, **OpenRouter**, **Groq** o **Google Gemini API**, regolando anche la temperatura creativa.
### 9.2. Ambito operativo: Selezione vs Intero Testo
* Se evidenzi con il mouse una frase o un paragrafo nell'Editor, il Laboratorio IA opera **esclusivamente sulla porzione selezionata** (*Ambito: Selezione attiva*).
* Se non c'è testo selezionato, opera sull'**intero foglio di lavoro**.
### 9.3. Le operazioni di manipolazione del testo
1. **✂️ Sfoltisci parole superflue (`.RIA`)**: applica le regole di riduzione di WordProf (`ACCOINFO.RIA`), eliminando aggettivi esornativi, avverbi ridondanti, incisi secondari e perifrasi.
2. **📉 Riassumi per generalizzazione (`.RIA`)**: riduce il testo al 35-45% sostituendo elenchi e dettagli con iperonimi e azioni generalizzate (`ACCOSOST.RIA`).
3. **🔍 Esplodi e dettaglia (`.ESP`)**: espande un testo scarno esplicitando passaggi sottintesi, dettagliando azioni concrete e aggiungendo precisazioni causali o esempi (`ALLAZION.ESP`).
4. **⚖️ Sviluppa struttura argomentativa (`.PAR` / `.PRO`)**: articola il testo secondo lo schema *Tesi → Argomenti a favore → Possibile obiezione → Confutazione e conclusione* (`ARGOCONF.PAR`).
5. **⚡ Sciogli i gerundi (`-ando` / `-endo`)**: trasforma i gerundi impliciti in proposizioni esplicite coordinate o subordinate (temporali, causali, ipotetiche), rendendo trasparente il nesso logico.
6. **🧹 Deburocratizza / Plain Language**: sostituisce i burocratismi (`BUROCRAT.LST`), le forme impersonali/passive e i periodi oltre le 25 parole con lessico comune e sintassi attiva.
7. **🔗 Rafforza coesione e riferimenti pronominali**: calibra i connettivi (`CNTIVI.LST`) ed esplicita i pronomi/deittici ambigui (`DEITTICI.LST`).
8. **🔁 Elimina ripetizioni e parole generiche**: sostituisce ripetizioni ravvicinate e verbi/nomi generici (*cosa, fatto, fare, dire*) con termini precisi.
9. **🎭 Riscrittura Stilistica (Queneau / Repertorio `.STI`)**: riscrive il brano adottando uno dei 14 registri del Repertorio di Stili (*Conciso, Burocratico, Arcaico, Giornalistico, Medico, Notarile, Hemingway, Giallo, Fiaba, Discorso indiretto, Narrativo a ritroso, Colloquiale, Pignolo, Comico*).
10. **🎯 Cambio di Intento Comunicativo (Repertorio `.INT`)**: riscrive il testo orientandolo a un diverso scopo pragmatico (*Convincere, Confutare, Giustificare, Ironizzare, Minimizzare, Esagerare, Analizzare oggettivamente, Confortare, Protestare*).
11. **🚫 Lipogramma Automatico («Senza tasto» `.LPG`)**: riscrive il testo evitando completamente una lettera proibita a scelta (`A-Z`), verificando automaticamente il numero di eventuali occorrenze residue.
12. **✍️ Manipolazione su istruzione libera**: permette di impartire qualsiasi consegna libera di trasformazione linguistica.
### 9.4. Confronto metriche Prima/Dopo e Applicazione non distruttiva
Per ogni trasformazione, il pannello mostra il confronto immediato di **Numero di parole**, **Indice Flesch-Vacca** e **Indice Gulpease** (*Prima → Dopo*), offrendo tre modalità di inserimento:
* **✓ Sostituisci nell'Editor** (con salvataggio automatico nello storico: nella barra degli strumenti compare il pulsante **«↩ Annulla IA»** per ripristinare il testo precedente in qualsiasi momento);
* **⬅ Affianca in Doppio Testo**: invia il risultato nella finestra di sinistra in modalità *Doppio Testo*, permettendo di confrontare riga per riga l'originale e la versione manipolata;
* **➕ Accoda sotto il testo corrente**.
### 9.5. Funzioni didattiche speciali (`.NTZ` e `Palestra`)
* **📝 Annota come Docente (genera vista `.NTZ`)**: l'IA analizza l'elaborato secondo la tassonomia ufficiale di WordProf (*Ortografia, Morfo-sintassi, Punteggiatura, Significato, Stile, Coerenza, Struttura*), formula il *Giudizio complessivo* e apre direttamente la modalità **Leggi testo commentato (`.NTZ`)** con i passaggi sottolineati cliccabili.
* **🎲 Crea Partita Palestra (`.CLZ` / `.FSH` / `.SCR`) dal testo**: trasforma automaticamente il testo presente nell'Editor in una nuova partita interattiva di **Cloze**, **Pesca** o **Domino** pronta da svolgere nella Palestra.