Write¶

Write è l'editor con cui scrivi le partiture in neumaRk, con l'anteprima dello spartito che si aggiorna in tempo reale mentre digiti.

I tre attori da non confondere¶

Per usare Write con serenità conviene tenere a mente chi fa cosa. Sono tre cose diverse:

	Cos'è	Cosa fa
neumaRk (NRK)	la lingua: il testo che scrivi è il brano	persiste, è indipendente dall'app
l'editor	l'ambiente di scrittura	colora il testo, segnala errori nella console, spiega con l'help `?`; lascia il tuo testo esattamente come l'hai scritto
Speedy Entry	l'assistente di battitura	trasforma ciò che digiti mentre digiti (spazi automatici, `Tab` chiude la misura…); è opzionale e si spegne con un click

Speedy Entry produce solo NRK normale, lo stesso che potresti scrivere a mano. Se ti intralcia, spegnilo dalla toolbar e continua a scrivere; il tuo brano resta com'è. Dettagli in Speedy Entry.

La schermata¶

Write si divide in due metà: a sinistra l'editor dove scrivi il testo NRK, a destra l'anteprima dello spartito. Sopra l'editor c'è una toolbar; in cima alla pagina la topbar con il menu dei file e il titolo del brano. In basso compare all'occorrenza la console.

Comando	Cosa fa
Titolo · Tonalità · Metro	cliccandoli apri le Proprietà del documento (modifichi titolo, autore, tonalità, tempo, metro senza scrivere nel testo)
▶ Play	riproduce la melodia; tenendolo premuto apri il pannello dei controlli di riproduzione
EXTEND / COMPACT	due trasformazioni testuali del sorgente (vedi sotto); long-press per le opzioni
Speedy Entry	accende/spegne l'assistente (long-press per le impostazioni)
`?` Help	apre il pannello di aiuto su neumaRk (anche `F1`)
Console	apre/chiude la console di processing

L'editor¶

L'editor evidenzia la sintassi, collega testo e spartito (passando il mouse su una misura la evidenzia da entrambe le parti) e permette di selezionare le misure. Con il tasto destro su una misura si apre un menu contestuale: taglia/copia/incolla, inserisci, elimina, trasponi, isola in una nuova riga, sposta alla riga precedente/successiva, unisci in una sola.

I modificatori di selezione: Shift estende la selezione del testo, Cmd/Ctrl+Shift estende la selezione delle misure.

L'anteprima dello spartito¶

Si aggiorna a ogni modifica. Dal suo menu regoli impostazioni di resa, adattamento, zoom, densità, pagina/papyrus, e avvii l'esportazione in PDF.

EXTEND e COMPACT¶

Lo stesso brano si può scrivere in due forme testuali, e questi due pulsanti convertono il sorgente dall'una all'altra:

COMPACT — sfrutta l'eredità di durata e ottava per togliere ripetizioni (testo più breve, veloce da scrivere a mano).
EXTEND — rende tutto esplicito su ogni nota (più leggibile a colpo d'occhio).

Stesse note, stesso spartito: cambia solo l'aspetto del testo. Dal menu EXTEND/COMPACT options scegli con precisione quali dettagli espandere o compattare (marker di riga, durate, altezze, scorciatoie, segni di flusso, accordi), con preset None / Default / All.

Riprodurre¶

Il pulsante Play riproduce la melodia. Tenendolo premuto apri il pannello dei controlli di riproduzione: play/pausa/stop e ritorno all'inizio, velocità (0.5×–2×), swing (rapporto e accento sul levare), count-in e i volumi.

La console di processing¶

Mentre scrivi, la console mostra eventuali warning (W…, non bloccanti) ed errori (E…, bloccanti). Si apre da sola quando serve e si chiude appena risolvi; puoi anche tenerla aperta cliccando la sua icona. Clicca un messaggio per saltare alla riga a cui si riferisce — la console ti indica soltanto cosa rivedere.

L'help `?`¶

Il pannello ? (anche F1) è il riferimento rapido a neumaRk: ricercabile, organizzato per argomento (note, accordi, ripetizioni, articolazioni, dinamiche, testo, voci, versioni…). Per il riferimento completo c'è la documentazione del linguaggio su neumark.dev.

Dalla topbar:

New — nuovo documento vuoto.
Open… — apri un tuo brano (con ricerca per nome, titolo e crediti).
Import — importa un file .nrk o XML (MusicXML).
Export — esporta il brano come file .nrk (export XML/Lilypond in arrivo).
Save (Cmd/Ctrl+S) — ricorda che non c'è sovrascrittura: ogni salvataggio aggiunge una versione al tuo brano. Funziona anche offline (salva in locale e sincronizza appena torni online; un indicatore mostra lo stato di sincronizzazione).
Save as new — crea un nuovo brano a partire da quello corrente (utile per partire da un brano altrui o creare una variante).
Revert to saved — scarta le modifiche locali e ricarica l'ultima versione salvata.
Manage document… — rinomina il documento (solo il creatore, online), gestisci le etichette, vedi ruolo/date, apri in Library o elimina il documento (con tutte le sue versioni).
Tutorial… e Guided tour — vedi sotto.

Versioni e Release¶

Un brano evolve per versioni (ogni salvataggio ne aggiunge una). Dalla topbar vedi la versione corrente e i suoi stati wip / stable, puoi rivedere le versioni precedenti e fare una Release: crea una nuova versione stable ed elimina definitivamente le work in progress intermedie.

Condividere¶

Genera un fly link (autosufficiente) e apri il brano in View. Puoi trasporre il brano dalla dialog dedicata (note, accordi o entrambi). I tipi di link e le loro implicazioni sono in Link e condivisione.

Modalità reattiva e Lead¶

Aprendo un reactive link, Write entra in modalità collegata e in sola lettura: segue in diretta le modifiche di chi ha la guida. Chi ha i diritti di modifica può prendere la guida (take lead): da quel momento, ogni suo salvataggio appare in tempo reale a chi sta guardando in View; con release restituisce la guida. È la base di prove e lezioni in tempo reale (vedi il reactive link in Link e condivisione).

Tutorial integrati¶

Dal menu file apri i tutorial passo-passo (scelti da un elenco, con conteggio dei passi): in alto compaiono i comandi avanti / indietro / ripristina passo. C'è anche un giro guidato dell'interfaccia (driver.js), avviabile dal logo in alto a sinistra.