Come lavorano insieme le tre app

Leadsheet.app è fatto di tre app attorno a un unico documento: Write per scrivere, Library per organizzare, versionare e condividere, View per leggere ed eseguire. Un brano è il suo testo neumaRk — le tre app sono semplicemente i modi per scriverlo, conservarlo e leggerlo. Questa pagina segue un brano mentre passa dall'una all'altra, e indica dove vive davvero ogni cosa.

Un brano, tre punti di vista

Lo stesso brano appare diverso a seconda dell'app in cui ti trovi:

App	Cosa ci fai col brano	Il confine
Write	scrivi e modifichi il testo NRK, lo ascolti in riproduzione, lo esporti	l'unico posto in cui si modifica e l'unico con l'audio
Library	lo organizzi, lo tagghi, lo metti in book/playlist, lo condividi, gestisci ruoli e versioni	il posto in cui si condivide e si gestisce chi può fare cosa; si rinomina qui o da Manage document in Write
View	lo leggi, lo trasponi per il tuo strumento, ne esporti un PDF	sola lettura: non cambia mai il brano salvato e non ha audio

Tenere a mente questi confini evita la confusione più comune: per correggere una nota vai in Write, non in View; per premere play sei in Write; per condividere sei in Library (per rinominare anche in Write, da Manage document).

La vita del documento — Write → Library → View

Il percorso tipico di un brano, e dove avviene ogni passo:

1. Scrivi (Write). Scrivi il testo neumaRk e l'anteprima dello spartito si aggiorna mentre digiti. Quando salvi, il brano finisce nel cloud e diventa una voce della tua Library. Write non sovrascrive mai in silenzio una versione salvata — vedi come funzionano salvataggio e versioni in Write.
2. Organizza e condividi (Library). Il brano salvato ora ha un titolo, dei tag e un posto tra i tuoi brani, book e playlist. Qui lo rinomini (si può anche da Write), decidi chi può aprirlo (ruoli) e crei un link di condivisione (Link e condivisione).
3. Leggi ed esegui (View). Chi riceve il link — o apre un brano pubblico, un file .nrk o una raccolta — lo legge in View. Può trasporlo per il proprio strumento o esportarne un PDF senza alterare il brano salvato.

Il cerchio può chiudersi su se stesso: una condivisione reactive permette a chi legge in View di seguire in diretta le tue modifiche in Write (più sotto).

Passare da un'app all'altra

Non cambi app da un menu: clicchi un link, e come lo clicchi decide dove si apre — stessa scheda, scheda nuova, o una scheda già aperta che vuoi riusare. I tre gesti (e perché il modificatore è il tasto Z) sono descritti una volta sola nella panoramica dell'ecosistema.

Un paio di casi quotidiani:

• Tieni un'unica scheda di lettura. Hai View aperta su un leggio. Dalla Library fai Z+click su un altro brano e la stessa scheda di View passa a quello — nessuna seconda scheda, nessun ricaricamento dell'app.
• Correggi qualcosa che stai leggendo. View non modifica: apri il brano in Write (dalla barra di View, oppure Z+click), correggi e salva. Chi ha un hard o un reactive link riceve l'aggiornamento; chi ha un fly link conserva la vecchia istantanea.

Condividere fra le app

Un link di condivisione è il punto in cui un brano ti sfugge di mano, perciò il tipo di link conta più di ogni altra cosa:

• un fly link porta l'intero brano dentro al link (si apre offline, senza account, perfetto per un codice QR) ma è un'istantanea congelata che non puoi richiamare;
• un hard link è un riferimento al brano salvato — sempre aggiornato, con un accesso che puoi concedere o revocare;
• un reactive link è un hard link che si aggiorna in diretta, per prove e lezioni.

Cosa porta ciascuno, come si comporta nel tempo e chi può aprirlo è nella pagina dedicata: Link e condivisione. I link si creano dalla Library (con un codice QR); un fly link può essere generato anche da Write.

I ruoli fra le app

Chi può fare cosa con un brano lo accompagna ovunque. I ruoli si gestiscono nella Library (invito per email, rimozione, trasferimento del ruolo di creatore, e ognuno può rinunciare a un ruolo ricevuto); in Write il ruolo che detieni compare come badge. L'elenco completo — Creator, Owner, Collaborator, Viewer, Subscriber — e come la Library li raggruppa (Creator / Can modify / View only) è nella pagina Ruoli.

Vale la pena ricordare qualche cosa: trasferire il ruolo di creatore è irreversibile per te (perdi ogni controllo sul brano); rinunciare è lasciare il contenuto di qualcun altro, mentre eliminare è il creatore che rimuove il proprio; e iscriversi a un brano pubblico dà accesso in lettura, non il diritto di modifica.

Le versioni, viste da ogni app

"Versione" significa due cose diverse — tienile distinte:

• Cronologia dei salvataggi — le versioni del brano man mano che lo salvi: una bozza di lavoro diventa stabile, e una Release blocca una versione stabile. Appartiene al modello di salvataggio di Write / Library.
• Arrangiamenti nel file — più varianti che vivono dentro un unico brano (le versioni %% del testo neumaRk). Chi legge sceglie quale mostrare; il selettore (il badge v) funziona sia in Write sia in View, e ricorda la tua scelta brano per brano. È una funzione del linguaggio — vedi neumaRk.

Compiti comuni fra le app

Vuoi…	Fai così
Condividere per un concerto senza wi-fi	un fly link + QR: si apre offline e senza account (è un'istantanea, le modifiche successive non lo raggiungono)
Far modificare anche a un compagno di band	Library → Gestisci ruoli → invita come Collaborator (un ruolo, non un link)
Far seguire a tutti le tue modifiche in diretta	un link reactive; in Write prendi la guida (Lead) così i tuoi salvataggi appaiono nella View di tutti
Aprire un brano in View tenendo la View attuale	Z+click sul link
Correggere una nota sbagliata vista in View	aprilo in Write, correggi, salva

In breve

• Write scrive e modifica (ed è l'unica con l'audio); Library organizza, condivide e gestisce ruoli e versioni (ed è dove si rinomina, oltre al Manage document di Write); View legge ed esegue, in sola lettura.
• Ci si sposta fra loro cliccando i link — il gesto decide la scheda.
• Un brano viaggia dentro un link; il tipo di link decide se è una copia congelata, un riferimento controllato o uno dal vivo.
• I ruoli decidono chi può fare cosa, ovunque; le versioni hanno due nature (cronologia dei salvataggi e arrangiamenti %% nel file).