# Manuale Utente - StorieAccoglienti **StorieAccoglienti** è un'applicazione web universale (file HTML singolo) progettata per assistere nella scrittura di storie focalizzate sui temi dell'accoglienza, dell'integrazione, dell'incontro tra culture e dell'umanità. ## 1. Avvio Rapido Non è necessaria alcuna installazione. 1. Individua il file `StorieAccoglienti.html` sul tuo computer. 2. Fai doppio clic per aprirlo nel tuo browser preferito (Chrome, Edge, Firefox, ecc.). ## 2. Struttura dell'Applicazione L'applicazione è suddivisa in tre "Ambienti" di lavoro, navigabili tramite i pulsanti in alto a destra. ### A. Ambiente Stesura (Home) È lo spazio principale di scrittura. - **Area di Testo**: Un editor centrale dove scrivere la tua storia. - **Pannello AI (Ollama)**: In basso, trovi i controlli per interagire con l'intelligenza artificiale (vedi sezione 4). - **Pulsanti Azione**: - **ARCHIVIA**: Scarica il testo scritto come file `.md` (Markdown) sul tuo computer. - **STAMPA**: Apre la finestra di stampa del browser per stampare la storia su carta o PDF. ### B. Ambiente Scalette (Struttura) Qui trovi l'ispirazione per la trama. - **Indice**: Scegli tra **SCALETTE NARRATIVE** (trame complete) o **SITUAZIONI NARRATIVE** (scene singole). - **Visualizzazione**: Cliccando su una categoria, vedrai la lista dei titoli. Cliccando su un titolo, vedrai i dettagli. - **Funzione PRENDI**: Seleziona del testo o apri una scaletta e premi "PRENDI" in alto. Il contenuto verrà copiato automaticamente in fondo al tuo testo nell'Ambiente Stesura. - **Modifiche**: Puoi usare i tasti **CORREGGI**, **AGGIUNGI** (per creare nuovi elementi) o **COPIA** per gestire i contenuti. Le modifiche vengono salvate nella memoria del browser. ### C. Ambiente Materiali (Dettagli) Qui trovi gli elementi per arricchire la narrazione. - **Categorie**: - **AMBIENTI**: Luoghi suggestivi (es. "Banchine affollate", "Cucine popolari"). - **OGGETTI**: Elementi fisici carichi di significato (es. "Valigia di cartone", "Coperta termica"). - **PERSONAGGI**: Archetipi e figure umane (es. "Il medico senza confini", "La mediatrice culturale"). - **Funzionamento**: Identico all'Ambiente Scalette. Scegli, esplora e usa "PRENDI" per portare gli elementi nella tua storia. ## 3. Flusso di Lavoro Consigliato 1. Vai in **SCALETTE** e scegli una traccia (es. "4. Due Lingue, Un Pane"). 2. Premi **PRENDI** per importarla nella Stesura. 3. Vai in **MATERIALI** -> **PERSONAGGI** e scegline due o tre adatti. Premi **PRENDI**. 4. Fai lo stesso con **AMBIENTI** e **OGGETTI** per dare colore alla scena. 5. Torna in **STESURA**. Ora hai una traccia e degli ingredienti. Inizia a scrivere collegando i punti. 6. Se ti blocchi, chiedi aiuto a Ollama. ## 4. Integrazione Intelligenza Artificiale (Ollama) L'applicazione può collegarsi a **Ollama**, un programma per eseguire intelligenza artificiale sul tuo computer, garantendo privacy totale (nessun dato va su internet). **Prerequisiti:** - Avere [Ollama](https://ollama.com/) installato. - Aver scaricato un modello (es. `ollama run mistral` o `ollama run llama3`). - **Importante**: Per far comunicare il browser con Ollama, devi avviare Ollama con un comando specifico per abilitare le origini esterne (CORS), oppure usare un'estensione browser per CORS (più semplice per utenti non tecnici). - *Comando avanzato (Windows PowerShell)*: `$env:OLLAMA_ORIGINS="*"; ollama serve` **Utilizzo:** 1. Nel pannello in basso in Stesura, seleziona il modello dal menu a tendina (se Ollama è attivo, apparirà la lista). 2. Scrivi l'inizio della tua storia o lascia gli appunti importati. 3. Clicca su **✨ Chiedi a Ollama di continuare**. 4. L'AI leggerà il testo e scriverà un proseguimento coerente con il tema dell'accoglienza. ## 5. Salvataggio - **Testo**: Clicca su **ARCHIVIA** per salvare il file `StorieAccoglienti_Stesura.md`. - **Liste Personalizzate**: Se aggiungi nuove scalette o personaggi tramite il tasto "AGGIUNGI", questi vengono salvati nella "Local Storage" del tuo browser. Non andranno persi chiudendo la pagina (a meno che non cancelli i dati del browser).