Punti Codex/custom, strade, regioni, livelli, mappe collegate, scala e tempi di viaggio, export PNG/JPG e .sylvamap.
Nessun risultato
Prova con un termine diverso.
Prova con un termine diverso.
01
PRIMA DI TUTTO
Accesso e modalità d’uso
Sylva è local-first: puoi scrivere senza account. L’account Google serve quando vuoi usare le funzioni cloud.
Continua senza accesso
Sylva autosalva il lavoro nel database locale del browser sul dispositivo che stai usando. È comodo e può funzionare senza Sync Online, ma lo storage del browser non è un backup indipendente.
- Writer, Codex, Timeline, Progettazione e revisioni comparate locali funzionano.
- Il salvataggio principale usa IndexedDB; Sylva usa anche localStorage per fallback/recovery e sessionStorage per lo stato della sessione ospite.
- Per avere una copia davvero tua, fuori dal browser, esporta periodicamente un .mmbook.
Accedi con Google
Abilita l’identità necessaria per Sync Online e cronologia revisioni Firebase. L’account non viene usato per advertising o profilazione.
- Sincronizzazione fra dispositivi.
- Copia Firestore del progetto.
- Fino a 10 revisioni cloud per libro, create con la sincronizzazione manuale.
IMPORTANTE · MODALITÀ SENZA ACCESSO
Senza un .mmbook esportato non hai una garanzia di conservazione indipendente dal browser.
L’autosalvataggio locale protegge dalle normali chiusure della pagina, ma i dati possono essere rimossi se cancelli i dati del sito / dati dell’app / cookie e dati dei siti, azzeri Sylva dalle Impostazioni, resetti o reinstalli il browser/PWA, usi una modalità privata che elimina i dati alla chiusura oppure se il browser/OS rimuove lo storage locale. La sola voce “cache immagini e file” normalmente riguarda soprattutto le risorse dell’app, ma le schermate di pulizia dei browser cambiano: prima di cancellare dati, crea comunque un backup.
IndexedDBÈ il deposito principale dei libri locali.
localStorageFallback e recovery di emergenza.
Cache PWAServe soprattutto per i file dell’app/offline, non è il backup del manoscritto.
.mmbookÈ la copia portatile da conservare in Download, File, Drive o altro spazio scelto da te.
📱
Su tablet: vale esattamente la stessa regola. Anche se Sylva è installata come PWA e sembra una normale app, i progetti locali dipendono ancora dallo storage del browser/PWA. Per un libro importante, esporta il .mmbook in una cartella del dispositivo o in uno spazio esterno che sai ritrovare.
Prezzi: l’uso locale è gratuito. Il piano Sync Online previsto è 3,99 €/mese oppure 25,99 €/anno. Nelle build beta il pagamento può non essere ancora applicato dal client.
02
IL PUNTO DI PARTENZA
Home e libreria
Dopo l’accesso, Sylva apre sempre la Home. Da qui gestisci libri, saghe, copertine, versioni ed esportazioni.
I miei libri
Ogni card mostra copertina, titolo, saga di appartenenza, versione, capitoli, parole e stato di sincronizzazione.
Le mie saghe
Raggruppa i libri in collezioni. Puoi creare una saga e spostare successivamente un libro dentro o fuori dalla saga senza modificarne il contenuto.
Modifica libro
Dal pulsante matita puoi cambiare titolo, versione, saga, copertina e ampiezza predefinita della zona di scrittura.
Nuovo libroTitolo, versione e saga
CopertinaImmagine utente o placeholder
ApriEntri direttamente in Scrivi
BackupEsporta quando vuoi
Esportazioni: il menu Esporta di ogni libro agisce su quel libro. Il gruppo Esporta libro attivo riporta il titolo del progetto aperto e raccoglie Markdown, EPUB, Word e backup completo. Sincronizza resta accanto al gruppo. Le informazioni secondarie si aprono da Informazioni e supporto.
Versione del libro: viene salvata nel progetto e nel file .mmbook. Quando importi un .mmbook, Sylva recupera anche la versione contenuta nel file.
04
IL CUORE DELL’APP
Scrivi
L’ambiente di scrittura mette al centro il foglio. Gli strumenti di progetto restano disponibili senza occupare il manoscritto.
Ambito
Puoi lavorare su Scena, Capitolo, Atto o Libro. L’ambito cambia quanta parte del manoscritto viene mostrata insieme.
Carta
Il testo vive su un foglio chiaro con effetto carta. Tema chiaro e scuro cambiano l’ambiente, non la leggibilità del manoscritto.
BARRA PROGETTO
Non sincronizzato
Sincronizzazione in corso
Sincronizzato
Codex nel testo: se l’evidenziazione Codex è attiva, i nomi riconosciuti diventano cliccabili. Un click apre una scheda rapida in sola lettura senza costringerti a lasciare il Writer.
04B
SCRIVANIA TEMPORANEA
Taccuino
Uno spazio separato dal manoscritto per parcheggiare, spezzare e riscrivere testo senza creare scene o capitoli.
Fino a 5 fogli
I fogli si selezionano dalle linguette in alto. Puoi crearne fino a 5, rinominarli dal menu … ed eliminarli quando non servono più.
Strumenti di scrittura
Il Taccuino usa la stessa grammatica visiva del Writer: grassetto, corsivo, sottolineato, barrato, titoli, font, evidenziazioni e virgolette. Gli incolli esterni vengono comunque ripuliti.
Indipendente, ma dentro il backup
Non contiene scene, capitoli o struttura e resta separato dai libri. Quando esporti un .mmbook, Sylva include anche uno snapshot dei fogli del Taccuino; all’importazione vengono recuperati senza sostituire una copia locale più recente.
Solo dal menu laterale
Apri Taccuino dal menu laterale di Sylva. Si apre in una pagina separata e può restare accanto al Writer su PC o tablet. Premi Torna a Sylva in alto a sinistra: il testo viene salvato prima di aprire l’app nella stessa scheda. Anche il logo esegue questo ritorno.
Ritorno e sincronizzazione: Torna a Sylva aspetta il salvataggio locale e prova a completare la sync quando sei collegato. Se la rete è lenta o assente, i fogli restano sul dispositivo. Prima di passare a un altro dispositivo, riapri il Taccuino e attendi la conferma Cloud · sincronizzato. In caso di errore locale il foglio resta aperto per permetterti di conservare il testo e riprovare.
Schede e browser: due schede o finestre dello stesso browser condividono il database locale del Taccuino. Un browser diverso (per esempio Chrome ed Edge) ha invece il proprio archivio locale: per ritrovare gli stessi fogli fra browser o dispositivi usa Sync Online.
Copie recuperabili: se due dispositivi modificano lo stesso foglio, trovi la versione locale in Recuperi. Da lì puoi scaricarla con la formattazione; anche i fogli eliminati vengono conservati tra i recuperi di questo dispositivo.
COME SI SALVA
Locale sempre, Cloud quando sei collegato
01ScriviIl foglio viene salvato automaticamente nel database locale del browser.
02SyncCon account Google il Taccuino sincronizza dopo una breve pausa dalle modifiche, al ritorno online e con il pulsante Sync. Finché è visibile, controlla anche ogni 15 minuti.
03CopiaUsa la selezione normale o “Copia tutto” e incolla il testo nella scena definitiva.
04EliminaQuando non serve più, cancella il foglio: gli altri restano indipendenti.
05
FORMATTAZIONE
Toolbar del testo
La toolbar resta discreta quando non la usi e torna pienamente visibile quando la tocchi o ci passi sopra con il mouse.
STRUMENTI PRINCIPALI
Testo e titoli
Grassetto, corsivo, sottolineato, barrato e blocchi Testo/H1/H2/H3.
Tipografia
Cambia font, dimensione, interlinea, rientro, spaziatura dei paragrafi e altri parametri della pagina.
3 ampiezze
Standard, Largo, Extra largo. Su tablet Sylva limita automaticamente l’ampiezza allo spazio disponibile.
Evidenziatori
Prima seleziona il testo, poi scegli giallo, rosa, verde, blu o viola. Per cancellare un colore, seleziona il passaggio evidenziato e usa la gomma.
Virgolette
Seleziona una frase e premi “ ” oppure « »: Sylva racchiude la selezione. Puoi anche mettere il cursore in un punto vuoto e inserire la coppia prima di scrivere.
Segnalibro
Il pulsante nella toolbar non salva semplicemente la scena: prima devi selezionare il passaggio a cui vuoi ancorare nota e segnalibro.
Prima devo selezionare il testo?Riferimento rapido per gli strumenti del manoscritto.
| Strumento | Selezione | Come usarlo |
|---|---|---|
| Grassetto / Corsivo / Sottolineato / Barrato | OPZIONALE | Seleziona testo già scritto oppure attiva il comando e continua a digitare. |
| Evidenziatore | SÌ | Seleziona il passaggio, poi premi il colore. |
| Rimuovi evidenziazione | SÌ | Seleziona la parte già colorata e premi la gomma. |
| Virgolette / Caporali | CONSIGLIATA | Seleziona la frase da racchiudere. Senza selezione inserisce la coppia nel punto del cursore. |
| Segnalibro / Nota | SÌ | Seleziona il passaggio prima di premere il segnalibro. |
| Preview Codex | NO | Clicca direttamente un nome che Sylva ha riconosciuto ed evidenziato. |
| Ricerca globale | NO | Apri Cerca o usa Ctrl/⌘ K e digita il termine. |
☝️
Su tablet: tieni premuto sul testo finché compaiono le maniglie di selezione, trascinale fino a comprendere il passaggio desiderato e solo dopo tocca evidenziatore, nota o segnalibro. Sylva cerca di conservare la selezione quando tocchi la toolbar.
06
RITROVARE TUTTO
Ricerca globale e segnalibri
La ricerca non si limita al manoscritto: può attraversare titoli, Codex, Timeline e note.
Ricerca globale
- Filtri: Tutto, Manoscritto, Titoli, Codex, Timeline, Note.
- Click sul risultato per saltare direttamente al punto corretto.
- Scorciatoia Ctrl K / ⌘ K.
Trova e sostituisci
Può lavorare sull’intero libro, sull’atto o sul capitolo corrente. Durante una revisione comparata viene sospeso per evitare modifiche parallele incoerenti.
PROCEDURA · SEGNALIBRO CON NOTA
Come salvare un passaggio preciso
01SelezionaEvidenzia con il mouse o con le maniglie touch le parole/frasi che vuoi ricordare.
02Premi 🔖Usa il segnalibro della toolbar del testo, non il pulsante Segnalibri della barra progetto.
03DescriviInserisci titolo, nota facoltativa e colore del segnalibro.
04AggiungiIl passaggio resta marcato nel manoscritto e viene salvato nella scena.
05RitrovaloApri Segnalibri nella barra progetto e premi Vai per tornare esattamente lì.
Importante: il pulsante Segnalibri nella barra progetto apre l’elenco dei segnalibri già creati. Per crearne uno nuovo devi invece selezionare il testo → premere 🔖 nella toolbar. Non puoi sovrapporre due note sullo stesso tratto già annotato.
PROCEDURA · TROVA E SOSTITUISCI
Modificare una parola in più punti
01Apri CercaUsa il pulsante Cerca oppure Ctrl K/⌘ K.
02Apri sostituzioneEspandi “Trova e sostituisci nel manoscritto”.
03CompilaScrivi testo da trovare e testo sostitutivo.
04Scegli ambitoLibro intero, atto corrente oppure capitolo corrente.
05ConfermaAvvia Sostituisci tutto. In revisione comparata la funzione resta sospesa per sicurezza.
07
RITMO DI SCRITTURA
Obiettivi e sessioni
Il traguardo del libro misura il manoscritto; il target giornaliero si basa sulle sessioni registrate.
Obiettivo del libro
Imposta, per esempio, 120.000 parole. Sylva mostra il progresso rispetto al totale corrente.
Obiettivo giornaliero
Imposta un target, per esempio 1.000 parole. Lo storico registra giorni riusciti, mancati, serie attuale e serie migliore.
Avvia sessioneSalva parole iniziali
Scrivi / revisionaConta anche le revisioni applicate
TerminaRegistra tempo e saldo parole
AnalisiGrafici e storico giornaliero
PROCEDURA · GIORNATA DI SCRITTURA
Far finire correttamente le parole nelle statistiche
01Imposta i targetApri Obiettivi e indica traguardo del libro e obiettivo giornaliero.
02Avvia SessionePrima di scrivere premi Sessione: Sylva memorizza il punto di partenza.
03LavoraScrivi normalmente. Puoi muoverti fra scene durante la stessa sessione.
04TerminaChiudi la sessione per registrare durata e saldo parole.
05Controlla AnalisiLo storico giornaliero mostra target raggiunti, mancati e serie.
Sessioni: misurano durata, saldo parole, scene toccate, media per sessione e parole/ora. Per uno storico giornaliero affidabile, avvia e termina una sessione quando scrivi. Le sessioni concluse viaggiano nel progetto, nel .mmbook e nel cloud quando il sync è attivo.
08
REVISIONE COMPARATA
Originale e modifica affiancati
Puoi congelare una scena o un intero capitolo e lavorare su una copia senza modificare subito l’originale.
1. Crea revisione
Scegli Scena oppure Capitolo dalla barra progetto.
2. Modifica la copia
L’originale resta a sinistra; la versione modificabile sta a destra.
3. Decidi
Salva per dopo oppure applica le modifiche al manoscritto quando sei soddisfatto.
PROCEDURA · REVISIONE COMPARATA
Da manoscritto a confronto affiancato
01Scegli cosa revisionareApri Ambito e imposta Scena o Capitolo.
02Premi RevisioneCrea una nuova revisione dell’ambito corrente.
03Scrivi a destraLa colonna sinistra è l’originale congelato; modifica solo la copia a destra.
04ConfrontaSylva aggiorna differenze e variazione parole mentre lavori.
05Salva o applicaSalva per continuare più tardi oppure applica la versione rivista al manoscritto.
Revisioni in sospeso: non devi finire tutto in una volta. La Revisione comparata del Writer viene conservata nel progetto locale/.mmbook. È diversa dalla sezione Revisioni del menu, che mostra invece la cronologia Firebase e richiede l’accesso Google. Finché una comparazione è attiva, alcune operazioni globali vengono limitate per non modificare contemporaneamente originale e copia.
09
RILETTURA
Modalità Lettura
Testo in sola lettura, spazi più ariosi e lo stesso menu generale delle altre sezioni. Per intervenire sul manoscritto apri Strumenti → Modifica testo: si apre Scrivi sulla scena selezionata.
Indice e Note
Indice raccoglie atti, capitoli e scene del libro. Tocca una scena per leggerla. Strumenti → Note apre i segnalibri della lettura nello stesso pannello laterale, che puoi chiudere per liberare spazio.
Visualizzazione
Apri il menu a comparsa per scegliere scena, capitolo, atto o libro intero, vista classica/libro e formato. Nella vista libro testo, margini e numeri si ridimensionano insieme alla pagina. La preferenza classica/libro viene ricordata sul dispositivo.
Annota
Gli evidenziatori e il comando Nota compaiono quando scegli Strumenti → Annota. Puoi chiudere la barra e continuare a leggere senza modificare il testo.
PROCEDURA · ANNOTARE DURANTE LA LETTURA
Evidenziare o aggiungere una nota
01Strumenti → AnnotaMostra gli evidenziatori, poi seleziona il passaggio nel documento.
02AColoreTocca uno dei cinque colori oppure Togli evidenziazione.
02BNotaOppure premi Nota: titolo, testo e colore vengono associati al passaggio selezionato.
03RitrovaApri Note nella Lettura oppure i Segnalibri in Scrivi.
📱
Touch: fai pressione prolungata sul testo e regola le maniglie. Con Annota aperto lo scorrimento orizzontale non sfoglia il libro, per lasciare spazio alla selezione. Restano disponibili i pulsanti per cambiare pagina.
10
ARCHITETTURA DEL LIBRO
Struttura
La gerarchia del manoscritto è Atto → Capitolo → Scena.
Costruisci
- Aggiungi atti, capitoli e scene.
- Rinomina gli elementi.
- Usa tag per classificare parti del manoscritto.
Naviga
La struttura è anche un indice operativo: selezionare una scena porta il Writer esattamente lì.
11
PRIMA E DURANTE LA STESURA
Progettazione
Obiettivo, Conflitto ed Esito restano in primo piano e vengono autosalvati durante la scrittura. Apri Contesto per POV, luogo, data e Timeline; Personaggi e trame per modificare i collegamenti. I riepiloghi restano leggibili anche a sezioni chiuse.
Scene
Le schede scena raccolgono stato, POV, luogo, data, presenze, trame e funzione narrativa. Stato e target parole sono subito disponibili; POV e Luogo mantengono la ricerca. Gli stati delle scene sono personalizzabili.
Trame e archi
È un’area dedicata della Progettazione: ogni filo narrativo può avere tipo, stato personalizzabile, colore, premessa, obiettivo, posta in gioco, voci Codex e scene attraversate.
| Campo | Uso |
|---|---|
| Stato | Segna lo stato della scena nel flusso di lavoro. Puoi creare, rinominare, colorare ed eliminare gli stati. |
| POV | Cerca e collega un personaggio del Codex come punto di vista. |
| Luogo | Cerca e collega una voce luogo del Codex. |
| Data | Usa il Calendario del libro: Era → Anno → Mese → Giorno, più Mattina, Pomeriggio, Sera o Notte. Può restare non definita. |
| Target parole | Obiettivo specifico per la singola scena. |
| Personaggi presenti | Seleziona chi partecipa alla scena; l’elenco dispone di ricerca. |
| Trame / archi | Collega una o più trame o archi e apri direttamente la loro area dedicata. |
| Timeline | Collega uno o più eventi esistenti oppure creane di nuovi. Gli eventi restano modificabili singolarmente. |
| Obiettivo / conflitto / esito | Descrive la funzione narrativa della scena. |
12
WORLDBUILDING
Codex
Il Codex raccoglie ciò che appartiene al mondo della storia e può riconoscerlo automaticamente nel manoscritto.
Categorie
Personaggi, Luoghi, Oggetti, Eventi, Fazioni, Creature, Lore, Religioni e categorie personalizzabili.
Nomi riconosciuti
Inserisci varianti e alias separati da virgole. Sylva evidenzia quelle forme nel testo.
Worldbuilding
Ogni tipo di scheda può mostrare campi dedicati; tutti restano facoltativi e puoi aggiungere campi personalizzati.
SimboloScegli un’icona per riconoscere la voce.
ColoreDetermina il colore dell’evidenziazione nel manoscritto.
DescrizioneCiò che vuoi ricordare rapidamente della voce.
GerarchiePer esempio un luogo può appartenere a un altro luogo.
PresenzeSylva può mostrarti dove e quante volte la voce compare nel testo.
CODEX · SCHEDE A BLOCCHI · 0.999 BETA 3
Prima leggi, poi componi
01Apri e leggiLa scheda completa si apre in lettura. Premi Modifica per cambiare tutti i suoi campi.
02Aggiungi un bloccoIn Componi la scheda scegli Testo, Immagine, Citazione, Caratteristiche o Voci collegate.
03RiordinaUsa le frecce sul tablet o trascina la maniglia sul PC. Puoi spostare anche descrizione e sezioni originali.
04SalvaSalva conserva l’intera scheda e torna alla lettura. Annulla scarta la bozza. I dati già presenti restano nei rispettivi campi.
Modelli riutilizzabili
Componi una scheda, dai un nome al modello e premi Salva modello, poi Salva nella scheda. Puoi applicarlo ad altre voci del libro: contiene struttura, titoli ed etichette dei campi, senza testi o immagini personali. I blocchi già compilati vengono conservati.
Immagini e sync
PNG, JPG e WEBP vengono ottimizzati fino a 1600 px e incorporati nel libro. Dopo Salva, con account collegato e sincronizzazione riuscita, passano anche agli altri dispositivi. Sono incluse nei backup .mmbook e .sylvacodex; la prima immagine appare anche sulle schede Codex della Lavagna.
Dal Writer: cliccando un termine Codex evidenziato apri prima una preview in sola lettura. Da lì puoi passare alla scheda completa quando serve.
PROCEDURA · FAR RICONOSCERE UN NOME NEL TESTO
Da una scheda Codex al manoscritto cliccabile
01Crea la voceApri Codex e crea, per esempio, un personaggio o un luogo.
02Aggiungi i nomiNel campo Nomi riconosciuti nel testo inserisci nome, soprannomi e varianti separati da virgole.
03Scegli il coloreImposta il colore con cui quella voce verrà riconosciuta nel manoscritto.
04Attiva CodexNel Writer assicurati che l’evidenziazione Codex sia attiva.
05Clicca il nomeNon devi selezionarlo: clicca il termine evidenziato per aprire la preview sola lettura.
Se un nome non viene riconosciuto: controlla la scheda Codex e aggiungi esattamente la variante che hai usato nel manoscritto fra i “Nomi riconosciuti”. Dalla Beta 0.846 gli alias vengono ripuliti dai duplicati e Sylva segnala quando lo stesso alias appartiene a due schede diverse: finché l’ambiguità non viene risolta, quel nome non viene collegato automaticamente nel Writer.
CODEX AVANZATO · BETA 0.846
Capire dove vive una voce nel romanzo
01Apri CodexIn alto trovi il riepilogo con voci presenti nel manoscritto, menzioni totali e possibili alias ambigui.
02Apri una schedaLa sezione Dove appare mostra prima e ultima apparizione, scene e numero di menzioni.
03Guarda le connessioniIn Contesto narrativo trovi le voci che compaiono nelle stesse scene, i collegamenti dalle Schede Scena e gli eventi Timeline associati.
04Salta al punto giustoTocca una scena, un evento o una voce collegata per aprirla direttamente.
PROCEDURA · SCOPRIRE TERMINI MANCANTI
Dal manoscritto a una nuova voce Codex
01Premi “Scopri termini”Sylva analizza localmente il manoscritto e cerca nomi propri o termini ricorrenti non ancora registrati.
02Valuta il suggerimentoVedi quante volte compare e in quante scene. È solo un suggerimento: Sylva non crea nulla da sola.
03Crea o ignoraCrea voce apre una nuova scheda già precompilata; Ignora nasconde quel suggerimento dalle analisi successive.
04Su tabletI pulsanti funzionano con un normale tocco. La finestra è scorrevole: se non vedi le azioni finali, scorri verticalmente dentro il pannello.
CODEX · BACKUP E RESET · BETA 0.850
Esportare, importare o azzerare il Codex
01EsportaNel riepilogo Codex premi Esporta. Sylva crea un file .sylvacodex con categorie, voci, worldbuilding, blocchi, immagini, modelli, gerarchie, relazioni, alias e suggerimenti ignorati.
02ImportaPremi Importa e scegli un file .sylvacodex. L’import sostituisce il Codex attuale dopo una conferma; il manoscritto non viene modificato.
03ResetReset elimina tutto il Codex: voci, categorie, relazioni e collegamenti Codex di Schede Scena/Timeline. Sylva mostra un avviso e una seconda conferma prima di procedere.
04Prima del resetSe vuoi poter tornare indietro, esporta prima un .sylvacodex oppure un backup completo .mmbook.
Come è fatto un file .sylvacodex
È un normale file JSON UTF-8. Puoi modificarlo con Visual Studio Code, Notepad++, Sublime Text, Blocco note/TextEdit in testo semplice oppure un editor JSON su Android. Evita Word e LibreOffice Writer: sono editor rich-text e possono rendere il JSON non valido.
- Il file deve iniziare con
{e terminare con}. - Chiavi e testi usano virgolette doppie:
"testo". - Gli elementi sono separati da virgole, ma non va messa una virgola dopo l’ultimo elemento.
- JSON non supporta commenti
//o/* ... */. - Ogni categoria, voce e relazione deve avere un
idunivoco. categoriesdentro una voce contiene gli ID delle categorie, non i loro nomi.fromId,toId,parentEntryIde i campi*EntryIddevono riferirsi a voci esistenti oppure essere vuoti.- Gli export attuali usano
format: "SYLVA-CODEX"eformatVersion: 3. Restano importabili anche i file di formato 2, compreso l’esempio scaricabile qui.
Esempio minimo valido
{
"format": "SYLVA-CODEX",
"formatVersion": 3,
"app": "Sylva",
"appVersion": "0.999",
"manifest": {
"categories": 1,
"entries": 1,
"relationships": 0,
"ignoredSuggestions": 0
},
"codex": {
"categories": [
{"id": "characters", "name": "Personaggi", "icon": "person"}
],
"entries": [
{
"id": "entry-ada",
"name": "Ada",
"categories": ["characters"],
"identifiers": ["Ada", "Lady Ada"],
"icon": "person",
"color": "#4c91d8",
"description": "Descrizione libera.",
"worldbuilding": {
"template": "character",
"fields": {"role": "Protagonista", "age": "31 anni"},
"parentEntryId": "",
"customFields": [
{"id": "field-1", "label": "Nota", "value": "Testo libero"}
]
}
}
],
"relationships": [],
"ignoredSuggestions": []
}
}idIdentificatore tecnico univoco. Esempio:
entry-ada.identifiersNome e alias che Sylva riconosce nel manoscritto.
iconSimbolo Sylva: person, map, city, book, tree, star, ecc.
colorColore esadecimale nel formato
#RRGGBB.worldbuilding.templatefree, character, place, faction, species, creature, culture, religion, magic, language, item oppure event.
relationshipsUsa
fromId e toId per collegare due voci esistenti.Consiglio: prima di modificare a mano un Codex reale, esportalo da Sylva e conserva una copia non modificata. Un errore JSON impedirà l’import, ma non sostituirà il Codex attuale finché l’importazione non è valida e non la confermi.
13
CARTOGRAFIA NARRATIVA
Mappe interattive
Carica una tua immagine e trasformala in una mappa del romanzo: i dati restano nel progetto e possono collegarsi direttamente al Codex.
Punti e Codex
Aggiungi punti liberi oppure collegali a una voce Codex. Puoi cambiare colore, forma, dimensione, icona, etichetta, livello e zoom minimo.
Strade e aree
Disegna strade, sentieri, fiumi, confini, itinerari e regioni. Colore, spessore, tratteggio, curve, riempimento e note restano modificabili.
Livelli e mappe collegate
Organizza gli elementi in livelli narrativi e collega un punto a un’altra mappa per passare da mondo → città → edificio senza perdere il contesto.
PROCEDURA · CREARE UNA MAPPA
Dall’immagine alla cartografia narrativa
01Apri MappeDal menu generale entra in Mappe e premi + oppure “Crea la prima mappa”.
02Carica l’immagineScegli PNG, JPG o WEBP. L’immagine diventa il fondo su cui lavorare.
03Aggiungi elementiPremi Modifica mappa, poi scegli Punto per luoghi e riferimenti, Strada per percorsi, Area per regioni. Su touch un tap aggiunge un nodo; due dita restano dedicate a pan e zoom.
04Collega il CodexNel pannello del punto scegli Codex, cerca la voce e salva. Il collegamento usa l’ID della scheda, quindi non dipende dal nome visualizzato.
05OrganizzaUsa Livelli e Visibile da zoom per evitare una mappa affollata. Puoi anche collegare un punto a un’altra mappa.
Prima leggi, poi modifica
Tocca un punto, un percorso o un’area: si apre una scheda di lettura con note complete, dati, collegamenti e dettagli grafici espandibili. Premi Modifica per aprire tutti i campi. Salva conferma la bozza e torna alla lettura; Annulla la scarta.
Strumenti e file
Modifica mappa mostra gli strumenti per aggiungere e spostare elementi. Fine conclude l’editor aperto e torna alla consultazione. Navigazione, misura e livelli rimangono accessibili. Importazione ed esportazione sono nel menu File.
| Strumento | Cosa fa | Nota utile |
|---|---|---|
| Naviga | Pan e zoom della mappa. | Mouse/trackpad su PC; pinch a due dita su tablet. |
| Punto | Crea un marker libero o Codex. | Supporta icone Sylva e immagini custom, colore HEX e collegamento ad altra mappa. |
| Strada | Disegna percorsi a più nodi. | Puoi scegliere tipo, colore, spessore, stile, curva morbida e stima di viaggio. |
| Area | Disegna regioni/poligoni. | Utile per regni, quartieri, boschi, aree di rischio o influenza. |
| Misura | Calibra la scala e misura distanze. | Dopo la calibrazione Sylva può stimare tempi a piedi, cavallo, carro o velocità custom. |
| Livelli | Raggruppa e mostra/nasconde elementi. | Esempi: Politica, Libro II, Guerra del Nord, Viaggio del protagonista. |
Salvataggio
Tutte le mappe del libro vengono conservate nel progetto locale e nel .mmbook. Puoi inoltre esportare la singola mappa come .sylvamap.
Cloud 1/1
Per l’account puoi scegliere una sola mappa da includere nel Cloud. Le altre non vengono cancellate: restano locali e nel .mmbook.
PNG / JPG
L’esportazione immagine include fondo, punti, strade, aree e le etichette abilitate. È pensata per condivisione e riferimento esterno.
Eliminazione sicura
Punti, strade e aree richiedono conferma. Eliminare un punto Codex rimuove il marker dalla mappa, non la voce del Codex.
📱
Su PC e tablet: il pannello Mappe e i menu Strumenti e Azioni si aprono solo quando servono. In Azioni trovi anche Salva / Sync e import/export. Durante il disegno usa un dito per i nodi e due dita per spostare/ingrandire la mappa. Se apri la tastiera, il canvas non deve riadattarsi da solo.
Consiglio: usa il Codex come fonte dei dati e la mappa come piano visivo. Un punto Codex non duplica la scheda: conserva il collegamento e gli eventuali override grafici della mappa.
14
CONNESSIONI
Relazioni
Le stesse relazioni del Codex si consultano come schede, alberi genealogici, gerarchie o rete dei legami.
Legame completo
Ogni relazione può avere tipo, natura, stato, intensità, direzione, fase narrativa, descrizione, colore e date di inizio/fine prese dal Calendario.
Natura e stato
Parti dai valori predefiniti oppure crea, rinomina, colora ed elimina opzioni personalizzate.
Contesto correlato
Aprendo una relazione vedi anche i rapporti delle due voci coinvolte e le relazioni collegate esplicitamente. Natura e Stato sono nel gruppo Filtri. I filtri attivi restano visibili sotto la barra e si rimuovono singolarmente; Azzera filtri torna al registro completo.
RELAZIONI · ALBERI · 0.999 BETA 3
Costruire una genealogia o una gerarchia
01Definisci il legameIn Nuova relazione scegli le voci Da e A, il nome del rapporto e i suoi dettagli.
02Scegli il ruoloGenitore → figlio per la genealogia; Superiore → subordinato per la gerarchia. Da è il genitore o superiore.
03Apri AlberiDopo Salva scegli Alberi e il tipo. Per due genitori crea due legami verso lo stesso figlio.
04EsploraTocca una voce per leggerla o un legame per modificarlo. Usa i filtri, trascina per spostarti e due dita per lo zoom.
Un’unica fonte: Schede, Alberi e Rete usano gli stessi legami salvati nel libro. Le vecchie relazioni restano nella Rete finché non scegli un ruolo; il nome del rapporto non viene interpretato automaticamente. Se scegli una voce, il diagramma conserva la sua componente collegata fra i legami filtrati. I cicli vengono segnalati; non cancellano le relazioni.
15
CRONOLOGIA
Timeline
Costruisci la sequenza degli eventi e collegala agli elementi già presenti nel progetto.
Evento
Titolo, Era → Anno → Mese → Giorno, momento della giornata o momento personalizzato, descrizione e ordine relativo.
Collegamenti
Scena, luogo, personaggi, voci Codex e trame/archi possono essere associati all’evento. Una singola scena può avere più eventi Timeline.
Coerenza
Il controllo di continuità usa le ere e le date disponibili e tiene conto dei collegamenti con le scene.
16
TEMPO DEL MONDO
Calendario
Il Calendario si apre in lettura, con settimana, ere e mesi. Premi Modifica calendario per compilare i campi: le modifiche vengono salvate automaticamente e aggiornano le date collegate. Fine torna alla lettura; non annulla le modifiche.
Base
Definisci nome del calendario, giorni della settimana e mesi con la loro durata.
Ere multiple
Ogni era ha nome completo e suffisso. Puoi ordinarle dalla più antica alla più recente e scegliere se gli anni crescono o decrescono.
Dove si usa
Le date del Calendario alimentano Timeline, Schede Scena e inizio/fine delle Relazioni, mantenendo coerenti Era, anno, mese e giorno.
17
DATI DEL MANOSCRITTO
Analisi
La Panoramica mostra gli indicatori principali e il progresso del libro. Le altre schede raccolgono Scrittura, Struttura, Stile e Codex e coerenza. Tutti i grafici restano disponibili nella loro area.
Dimensioni
Parole, pagine stimate, minuti di lettura, atti, capitoli, scene, voci Codex e parole uniche.
Ritmo
Distribuzione delle parole per capitolo/scena, medie, scena più lunga/corta e andamento cumulativo.
Stile
Media parole per frase, rapporto dialogo/narrazione, frequenze lessicali e parole più usate.
Codex
Presenze, categorie, copertura delle voci e heatmap per capitolo.
Sessioni
Tempo totale, saldo parole, medie, parole/ora e sessione migliore.
Obiettivi
Storico target giornalieri, tasso di riuscita e serie di giorni.
Correttore ortografico: Sylva usa il correttore nativo del browser/OS. Puoi scegliere Italiano (Italia), English (US) oppure disattivare le segnalazioni dalle Impostazioni.
18
MUSICA DI SCRITTURA
Radio Spotify
La radio non è un servizio musicale separato: usa il tuo account Spotify tramite le API ufficiali.
Client IDInserisci il tuo Spotify Client ID
AutorizzaCompleta OAuth su Spotify
CercaTrova brani, artisti o playlist
AscoltaPlay/pausa, precedente, successivo, volume
Requisito: il Web Playback SDK di Spotify richiede un account Premium per il playback nel browser. Se Spotify blocca l’autoplay, interagisci con la pagina e riprova.
19
CLOUD OPZIONALE
Sync Online
Il cloud è un’estensione della modalità locale, non il requisito per usare Sylva.
Da sincronizzare / errore
Sincronizzazione
Sincronizzato
Automatico
Sylva non sincronizza più dopo un periodo di inattività. Restano attivi gli altri trigger automatici già previsti dall’app e il controllo periodico ogni 15 minuti quando sei online.
Manuale
Il pulsante Sync forza il controllo, crea una revisione cloud (max 10 per libro) e, se hai collegato l’Archivio locale, aggiorna alla fine anche il .mmbook fisico.
Conflitti: quando locale e Cloud divergono, Sylva confronta la data del contenuto sincronizzabile: vince la versione più recente; a parità esatta il Cloud è il tie-breaker. Le mappe volutamente locali non vengono interpretate come “mancanti” e quindi non vengono cancellate da un pull Cloud.
ATTENZIONE · STESSO LIBRO SU PIÙ DISPOSITIVI
Evita di scrivere contemporaneamente sullo stesso libro da PC e tablet o da due PC diversi.
Ogni dispositivo ha il proprio archivio locale. Se entrambi modificano lo stesso libro prima della sincronizzazione, Sylva confronta le versioni del progetto e può prevalere quella con data più recente. Per ora il sistema non esegue un merge scena-per-scena fra due dispositivi diversi.
- Puoi tenere Sylva aperta su più dispositivi.
- È sicuro lavorare su libri diversi.
- Per lo stesso libro, termina il lavoro e sincronizza prima di continuare sull’altro dispositivo.
20
PORTA CON TE IL LAVORO
Backup, import ed export
Ogni formato serve a uno scopo diverso.
| Formato | Contiene | Quando usarlo |
|---|---|---|
| .mmbook | Progetto portatile completo: manoscritto, struttura, Codex, worldbuilding, relazioni, Timeline, calendario, note, segnalibri, sessioni, revisioni locali, copertina, tutte le mappe, Taccuino e finalizzazione EPUB locale con media finali. | Backup e trasferimento fra dispositivi/browser. |
| .md | Testo in Markdown. | Interoperabilità, Git, editor esterni, archivio testuale. |
| .epub | EPUB 3 reflowable con metadati, indice, stili, front/back matter, copertina e immagini finali. | Controllo finale e distribuzione su Kindle/Kobo/Apple Books e store compatibili. |
| .docx | Manoscritto modificabile con struttura, paragrafi e formattazione testuale di base. | Passaggio da/verso Word, LibreOffice Writer e altri editor compatibili DOCX. Non sostituisce il backup .mmbook. |
| .sylvamap | Una singola mappa con immagine, punti, collegamenti, livelli, scala, strade e aree. | Scambio o archivio di una mappa senza esportare l’intero libro. |
Archivio locale: nelle Impostazioni/Sync puoi collegare una cartella. Dopo una Sync manuale riuscita Sylva aggiorna lì i .mmbook quando cambia il libro o lo snapshot del Taccuino; la cartella non viene mai letta automaticamente per fare merge. Il Cloud e l’archivio restano due ruoli distinti.
Il .mmbook non contiene: credenziali/token, marker tecnici cloud, preferenze locali del dispositivo e la cronologia revisioni conservata esclusivamente su Firebase. Questi dati restano separati per sicurezza e portabilità.
DOCX · IMPORT / EXPORT · BETA 0.850
Portare un manoscritto Word dentro o fuori Sylva
01Esporta DOCXDalla Home apri Esporta libro attivo e premi Word, oppure usa Esporta → Word sul libro desiderato. Il documento conserva Atto → Capitolo → Scena e la formattazione testuale di base.
02Importa DOCXDalla Home premi Importa un file .docx. Sylva mostra un’anteprima e crea sempre un nuovo libro, senza sovrascrivere quello corrente.
03DOCX genericoPer un DOCX generico usa Titolo per il nome del libro, Titolo 1 / Heading 1 per i Capitoli e Titolo 2 / Heading 2 per le Scene. Se il file proviene da Sylva, la struttura Atto → Capitolo → Scena viene riconosciuta automaticamente.
04TabletImport ed export DOCX sono disponibili dalla Home anche su tablet. Il file viene scelto/salvato tramite il selettore file del browser o della PWA.
Limite intenzionale: commenti Word, revisioni, note a piè di pagina, caselle di testo e impaginazioni complesse non diventano dati Sylva. Usa .mmbook per un backup completo del progetto.
PROCEDURA · BACKUP SICURO
Quando creare un .mmbook
01Durante il lavoroFai copie periodiche, soprattutto dopo sessioni importanti o modifiche strutturali.
02Prima di pulireEsporta prima di cancellare dati del browser, reset locale, reinstallazione, cambio browser o aggiornamenti importanti del dispositivo.
03Prima di spostartiSe passi da PC a tablet o viceversa senza Sync, porta con te il .mmbook.
04Conservalo fuoriLascia almeno una copia in Download/File, disco esterno o cloud personale, non soltanto dentro lo stesso browser.
21
FINALIZZAZIONE · SOLO LOCALE
Editor e export EPUB
Prepara il libro elettronico quando il manoscritto è pronto, senza appesantire il Cloud con copertine e immagini editoriali.
Metadati
Titolo, autore, lingua, editore, identificatore, descrizione, data e diritti finiscono direttamente nel package EPUB.
Contenuto editoriale
Scegli quali capitoli includere e prepara frontespizio, copyright, dedica, epigrafe, ringraziamenti e nota sull’autore senza modificare il Writer.
Stile reflowable
Preset tipografici sobri, rientro o spazio fra paragrafi, allineamento, interlinea, titoli e separatori scena. Nessuna impaginazione rigida che rompa gli e-reader.
PROCEDURA · EPUB PRONTO ALLA DISTRIBUZIONE
Dal manoscritto al file finale
01Apri Finalizza EPUBDalla Home apri Esporta libro attivo → EPUB. È l’unico ingresso all’editor completo; il testo viene letto dalla struttura attuale del libro.
02Completa i metadatiIndica almeno titolo e autore, controlla lingua e identificatore e aggiungi gli eventuali dati editoriali.
03Scegli la copertinaPuoi usare quella locale di Sylva oppure caricarne una finale JPG/PNG dedicata. La copertina EPUB non viene inviata al Cloud.
04Aggiungi immagini finaliJPG/PNG con posizione, larghezza, testo alternativo, didascalia o marcatura decorativa. Vivono solo nel progetto locale e nel .mmbook.
05Controlla e esportaUsa l’anteprima, correggi gli avvisi essenziali e premi Esporta EPUB. La resa resta reflowable e si adatta al dispositivo di lettura.
Contenuti e indice
Puoi escludere capitoli, rinominare il titolo usato nell’EPUB, mostrare o nascondere i titoli scena e aggiungere un indice leggibile oltre alla navigazione tecnica.
Immagini accessibili
Le immagini informative possono avere testo alternativo; quelle puramente decorative possono essere marcate come tali. La larghezza resta relativa, non fissa.
Anteprima
La preview serve a controllare gerarchia, respiro e stile. L’aspetto preciso può cambiare tra Kindle, Kobo e altre app perché il lettore può scegliere font e dimensioni.
Solo locale
Configurazione EPUB, copertina finale e immagini non entrano in Firebase. Sono conservate nel browser e nel .mmbook; un pull Cloud non deve cancellarle.
Importante: l’editor EPUB è una fase finale separata dal manoscritto. Le immagini aggiunte qui non vengono inserite nel Writer e non consumano spazio Cloud. Su tablet l’editor usa un flusso verticale unico: prima configuri il libro e poi controlli l’anteprima, senza pannelli laterali che scorrono separatamente. Prima della pubblicazione è comunque consigliato aprire il file nell’anteprima/validator del distributore scelto.
22
PREFERENZE
Impostazioni e installazione PWA
Generali raccoglie lingua del dispositivo, installazione e supporto; Libro contiene obiettivi, ortografia, tema e tipografia del libro attivo; Sincronizzazione mostra account, archivio e backup; Avanzate contiene diagnostica e reset locale.
Sylva Chiaro
Ambiente luminoso, carta avorio e verde bosco.
Sylva Scuro
Ambiente notturno con manoscritto chiaro per mantenere la leggibilità.
PWA
Installa Sylva su PC, Android o iOS quando il browser lo consente. L’icona e il nome vengono presi dal manifest dell’app.
Lingua UIGestisce la lingua dell’interfaccia dove disponibile.
CorrettoreItaliano, English o disattivato.
TipografiaFont, dimensione, interlinea, rientri, spaziatura e ampiezza pagina.
Diagnostica SylvaControlla IndexedDB, recovery locale, PWA, stato dei salvataggi e sync. Può esportare un .txt tecnico che non contiene manoscritto, Codex, titoli, email o token.
Diagnostica prestazioniMisura FPS, frame time, DOM e memoria quando il browser la espone.
Reset localeCancella la libreria locale di Sylva in questo browser. Esporta prima un .mmbook. I file già scaricati sul dispositivo non vengono cancellati dal reset.
SICUREZZA · SALVATAGGI
Se Sylva è aperta in due finestre
01Scrittura normaleOgni istanza salva in IndexedDB con scritture serializzate.
02Due modifiche diverseSe due finestre modificano lo stesso libro e divergono, Sylva controlla la versione già salvata prima di scrivere.
03Niente sovrascrittura silenziosaIn caso di conflitto la versione già presente resta intatta e la seconda viene conservata come copia conflitto locale.
04ControlloDa Impostazioni → Avanzate → Diagnostica Sylva puoi vedere se sono stati rilevati conflitti o un’altra istanza del libro.
23
RESPONSIVE
PC, tablet e smartphone
Sylva cambia comportamento in base al dispositivo: non prova a comprimere tutto ovunque.
Se Sylva è installata come app: il Tutorial si apre nella stessa finestra standalone e la gesture Indietro riporta a Sylva. Il Taccuino viene invece aperto volutamente in una finestra o scheda separata; su Android il sistema può mostrarlo in Chrome invece che dentro la finestra standalone, ma nello stesso profilo Chrome continua a usare lo stesso storage e lo stesso account. Da lì Torna a Sylva apre l’app nella stessa scheda, senza dipendere dal cambio di finestra del browser. Le sezioni interne di Sylva entrano nella cronologia: la gesture Indietro torna alla sezione visitata prima. Solo quando non esiste più una sezione precedente il sistema può chiudere/uscire dalla PWA.
Desktop
Il menu laterale resta nascosto finché non premi il pulsante Sylva/menu. Quando compare è un drawer sovrapposto e non restringe il Writer.
Tablet
Writer completo. Il menu si nasconde e si riapre dal logo, come su desktop. Toolbar e controlli si compattano ma restano utilizzabili con touch.
Smartphone
La Home resta accessibile per consultare la libreria ed esportare i libri. L’editor completo viene intenzionalmente bloccato perché lo spazio verticale non è sufficiente per lavorare bene.
Rotazione tablet: in portrait la Home deve continuare a funzionare; quando apri un libro, Sylva adatta i controlli allo spazio disponibile.
💾
Tablet e backup: se lavori senza accesso Google, non lasciare l’unica copia del romanzo nella PWA/browser del tablet. Esporta il .mmbook dopo le sessioni importanti e controlla che il file compaia davvero in Download/File o nella destinazione scelta. Installare la PWA non equivale ad aver creato un backup.
24
TRASPARENZA
Privacy, supporto e Roadmap
La pagina Informazioni spiega cosa resta locale, cosa usa servizi esterni e come sostenere il progetto.
Niente advertising o profilazione
Sylva non integra Firebase Analytics, Google Analytics, Meta Pixel o sistemi equivalenti per tracciare il comportamento a fini pubblicitari.
Servizi tecnici dichiarati
Google/Firebase per login e cloud, App Check/reCAPTCHA Enterprise per protezione anti-abuso, Google Fonts per alcune risorse tipografiche e Spotify solo quando attivi la radio.
Dati locali
Libri e autosalvataggi vengono conservati principalmente in IndexedDB; localStorage/sessionStorage e Cache Storage hanno ruoli tecnici separati. Cancellare i dati del sito può rimuovere i progetti locali.
Backup indipendente
Il file .mmbook esportato è separato dal database del browser e resta disponibile finché non elimini tu il file dalla destinazione in cui lo hai salvato.
Sostegno volontario: i contributi tramite PayPal sono facoltativi e separati dal piano Sync Online. Non sbloccano funzioni, priorità o contenuti nascosti.
Roadmap verso Sylva 1.00
Ritaglio e preparazione grafica dentro Sylva.
Media nel manoscritto con allineamento e didascalie.
Editor reflowable con metadati, front/back matter, stili, copertina e immagini finali local-only, anteprima ed export EPUB 3.
Output pronto per lettura e stampa.
Portare manoscritti Word in Sylva e riportarli in un documento modificabile.
Controlli locali su nomi, POV, Timeline, Schede Scena e collegamenti Codex.
Le richieste utili possono entrare nelle patch successive.
25
TASTIERA
Scorciatoie
Su macOS usa ⌘ al posto di Ctrl.
| Tasti | Azione |
|---|---|
| Ctrl S | Salva / esporta il libro attivo in .mmbook. |
| Ctrl K | Ricerca globale. |
| Ctrl / | Apri la guida alle scorciatoie. |
| Ctrl B | Grassetto nel Writer e nella Revisione. |
| Ctrl I | Corsivo. |
| Ctrl U | Sottolineato. |
| Esc | Chiude finestra, menu o pannello aperto. |
26
SE QUALCOSA NON VA
Problemi comuni
Le verifiche più utili prima di pensare a un bug del progetto.
Vedo una UI vecchiaChiudi e riapri la PWA oppure aggiorna la pagina. Se persiste, il service worker/browser potrebbe avere ancora asset in cache.
Sync rossoControlla connessione, account Google e poi usa il pulsante Sync manuale. Tieni comunque un .mmbook locale.
Mappa difficile da toccareSu tablet usa un tap breve per selezionare/aggiungere nodi e due dita per pan/pinch. Se un pannello è aperto, chiudilo prima di disegnare dietro di esso.
Radio non parteVerifica Spotify Premium, Client ID, autorizzazione OAuth e che il browser abbia ricevuto un’interazione utente per sbloccare l’audio.
File importantePrima di reset, test, cambio browser o dispositivo, esporta sempre un .mmbook e verifica che il download sia realmente presente.
Senza accessoSe non hai un .mmbook esportato, la tua unica copia può essere il database locale del browser. Non considerarlo una garanzia permanente.
Pulizia browser“Cancella dati sito/app”, reset del browser/PWA o pulizie equivalenti possono rimuovere IndexedDB e localStorage. Fai prima il backup.
Modalità privataNon usarla come archivio: i dati locali possono essere eliminati quando chiudi la sessione privata.
SmartphoneIl Writer completo non è previsto su telefono: usa la Home per consultare libreria ed esportazioni.
Import .mmbookSe il file viene rifiutato, evita di modificarlo manualmente e prova una copia esportata direttamente da Sylva.