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.

La toolbar dell'editor

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 (sempre in nero puro, qualunque inchiostro usi a schermo). Tra le opzioni di resa ci sono anche i controlli delle travature: il raggruppamento nei metri con denominatore 4 (per blocco 2/4·3/4 oppure per movimento 1/4) e la travatura sulle pause (per gruppo, per movimento, off). Per forzare un singolo caso puoi usare le marche / (spezza) e - (unisce) direttamente nel testo.

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 (anche Shift+Spazio). Tenendolo premuto apri il pannello dei controlli di riproduzione:

• play/pausa/stop e ritorno all'inizio;
• il tempo in BPM (da 30 a 400), con lo slider o con i pulsanti −/+ (un BPM per clic, cinque con Shift), e il pulsante che torna al tempo del brano. Se il brano non dichiara un BPM nell'header, il tempo è dedotto dallo stile e il pannello lo segnala. Cambiare il tempo qui vale solo per la riproduzione: il documento non viene modificato;
• lo swing (rapporto e accento sul levare);
• il metronomo con il suo volume e il count-in;
• gli accordi (suonarli o no, e il loro volume) e l'esecuzione degli ornamenti.

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.

Il pannello include anche la sezione Tastiera e scorciatoie: scegli il layout della tua tastiera (italiano o US) e vedi come digitare sul tuo sistema i caratteri speciali di neumaRk (|, [ ], { }, < >, #, @, ~, ^, $, %…), insieme all'elenco delle scorciatoie riportato qui sotto.

Scorciatoie da tastiera

Cmd vale su Mac, Ctrl sugli altri sistemi. Le scorciatoie di Speedy Entry (con Z tenuto premuto) sono descritte in Speedy Entry.

Generale

Tasti	Cosa fa
F1	apre / chiude il pannello di aiuto (Esc lo chiude)
Cmd/Ctrl+S	salva (nel file .nrk d'origine se il documento viene da un file, altrimenti nel cloud)
Cmd/Ctrl+O	apre un documento
Cmd/Ctrl+N	nuovo documento
Cmd/Ctrl+Z · Cmd/Ctrl+Shift+Z	annulla · ripeti
Shift+Spazio	avvia / ferma la riproduzione
Spazio o Esc	durante la riproduzione, la fermano
doppio clic su una misura	la seleziona (nell'editor o sullo spartito)

Editor di testo

Tasti	Cosa fa
Shift+Enter	EXTEND
Cmd/Ctrl+Shift+Enter	COMPACT
Tab	inserisce una barra di misura (con Speedy Entry acceso)
Tab o Enter	accetta il suggerimento in grigio; Esc lo scarta
Cmd/Ctrl+Shift+clic (o trascina)	seleziona un intervallo di misure
Cmd/Ctrl+Shift+frecce	estende l'intervallo di misure da tastiera
Shift+frecce · Shift+clic	selezione di testo
Esc	annulla la selezione di misure
Alt+clic (⌥+clic su Mac)	aggiunge un cursore

Spartito (dopo un clic sullo spartito). I tasti singoli agiscono solo senza Cmd/Ctrl/Alt: Cmd/Ctrl+P resta la stampa del browser e Cmd/Ctrl+F la ricerca.

Tasti	Cosa fa
clic	seleziona una nota
Shift+clic	estende la selezione di misure
W · H	adatta alla larghezza · all'altezza
F	cambia il font musicale
P	cambia la modalità di visualizzazione
+ · −	ingrandisce · riduce
Cmd/Ctrl + + · −	aumenta · riduce la densità (anche Cmd/Ctrl+=; vale anche con una nota selezionata)
← · →	pagina precedente · successiva (in modalità pagina)
↑ · ↓	scorre su · giù
frecce, con misure selezionate	spostano la selezione (con Shift la estendono; Esc la toglie)

Nota selezionata sullo spartito

Tasti	Cosa fa
← · →	nota precedente · successiva (e la suona)
↑ · ↓	alza · abbassa di un grado (secondo la tonalità)
+ · −	alza · abbassa di un semitono
' · ,	alza · abbassa di un'ottava
!	mostra / nasconde l'alterazione forzata
E	cambio enarmonico
Shift+↑ · Shift+↓	in un accordo, passa da una nota all'altra
Esc	deseleziona la nota

Il menu file

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, MusicXML o Lilypond.
• 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.