Write

Write est l'éditeur avec lequel vous écrivez les partitions en neumaRk, avec l'aperçu de la partition qui se met à jour en temps réel à mesure que vous tapez.

Les trois acteurs à ne pas confondre

Pour utiliser Write sereinement, il est utile de garder en tête qui fait quoi. Ce sont trois choses différentes :

	Ce que c'est	Ce que ça fait
neumaRk (NRK)	la langue : le texte que vous écrivez est la chanson	persiste, indépendant de l'app
l'éditeur	l'environnement d'écriture	colore le texte, signale les erreurs dans la console, explique via l'aide ? ; laisse votre texte exactement tel que vous l'avez tapé
Speedy Entry	l'assistant de frappe	transforme ce que vous tapez à mesure que vous tapez (espaces automatiques, Tab ferme la mesure…) ; il est optionnel et s'éteint d'un clic

Speedy Entry ne produit que du NRK ordinaire, le même que vous pourriez taper à la main. S'il vous gêne, éteignez-le depuis la barre d'outils et continuez à taper ; votre chanson reste telle quelle. Détails dans Speedy Entry.

L'écran

Write se divise en deux moitiés : à gauche l'éditeur où vous écrivez le texte NRK, à droite l'aperçu de la partition. Au-dessus de l'éditeur, une barre d'outils ; en haut de la page, la topbar avec le menu fichier et le titre de la chanson. En bas apparaît au besoin la console.

La barre d'outils de l'éditeur

Commande	Ce que ça fait
Titre · Tonalité · Mesure	en cliquant dessus, ouvre les Propriétés du document (modifier titre, auteur, tonalité, tempo, mesure sans écrire dans le texte)
▶ Play	joue la mélodie ; appui long pour ouvrir le panneau des contrôles de lecture
EXTEND / COMPACT	deux transformations textuelles de la source (voir ci-dessous) ; appui long pour les options
Speedy Entry	active/désactive l'assistant (appui long pour les réglages)
? Aide	ouvre le panneau d'aide neumaRk (aussi F1)
Console	ouvre/ferme la console de traitement

L'éditeur

L'éditeur met en évidence la syntaxe, relie texte et partition (survoler une mesure la met en évidence des deux côtés) et permet de sélectionner les mesures. Un clic droit sur une mesure ouvre un menu contextuel : couper/copier/coller, insérer, supprimer, transposer, isoler dans une nouvelle ligne, déplacer vers la ligne précédente/suivante, fusionner en une seule.

Les modificateurs de sélection : Shift étend la sélection du texte, Cmd/Ctrl+Shift étend la sélection des mesures.

L'aperçu de la partition

Il se met à jour à chaque modification. Depuis son menu vous réglez le rendu, l'ajustement, le zoom, la densité, page/papyrus, et lancez l'export PDF (toujours en noir pur, quelle que soit l'encre à l'écran). Parmi les options de rendu il y a aussi les contrôles des ligatures : le groupement dans les mesures à dénominateur 4 (par bloc 2/4·3/4 ou par temps 1/4) et la ligature par-dessus les silences (par bloc, par temps, désactivée). Pour forcer un cas isolé vous pouvez utiliser les marques / (coupe) et - (unit) directement dans le texte.

EXTEND et COMPACT

La même chanson peut s'écrire sous deux formes textuelles, et ces deux boutons convertissent la source de l'une à l'autre :

• COMPACT — exploite l'héritage de durée et d'octave pour retirer les répétitions (texte plus court, rapide à taper à la main).
• EXTEND — rend tout explicite sur chaque note (plus lisible d'un coup d'œil).

Mêmes notes, même partition : seul l'aspect du texte change. Depuis le menu EXTEND/COMPACT options vous choisissez précisément quels détails développer ou compacter (marqueurs de ligne, durées, hauteurs, raccourcis, signes de flux, accords), avec des presets None / Default / All.

Jouer

Le bouton Play joue la mélodie (aussi Shift+Espace). Un appui long ouvre le panneau des contrôles de lecture :

• lecture/pause/stop et retour au début ;
• le tempo en BPM (de 30 à 400), avec le curseur ou les boutons −/+ (un BPM par clic, cinq avec Shift), et un bouton qui revient au tempo de la chanson. Si la chanson ne déclare pas de BPM dans son en-tête, le tempo est déduit du style et le panneau l'indique. Changer le tempo ici ne vaut que pour la lecture : le document n'est pas modifié ;
• le swing (ratio et accent sur le contretemps) ;
• le métronome avec son volume, et le count-in ;
• les accords (les jouer ou non, et leur volume) et l'exécution des ornements.

La console de traitement

Pendant que vous écrivez, la console affiche les éventuels avertissements (W…, non bloquants) et erreurs (E…, bloquantes). Elle s'ouvre d'elle-même quand il le faut et se ferme dès que vous corrigez ; vous pouvez aussi la garder ouverte en cliquant son icône. Cliquer un message pour sauter à la ligne à laquelle il se réfère — la console vous indique seulement quoi revoir.

L'aide ?

Le panneau ? (aussi F1) est la référence rapide à neumaRk : cherchable, organisée par sujet (notes, accords, reprises, articulations, nuances, paroles, voix, versions…). Pour la référence complète il y a la documentation du langage sur neumark.dev.

Le panneau comprend aussi la section Clavier et raccourcis : choisissez la disposition de votre clavier (italienne ou US) et voyez comment taper sur votre système les caractères spéciaux de neumaRk (|, [ ], { }, < >, #, @, ~, ^, $, %…), avec la liste des raccourcis reprise ci-dessous.

Raccourcis clavier

Cmd vaut sur Mac, Ctrl sur les autres systèmes. Les raccourcis de Speedy Entry (avec Z maintenu) sont décrits dans Speedy Entry.

Général

Touches	Ce que ça fait
F1	ouvre / ferme le panneau d'aide (Esc le ferme)
Cmd/Ctrl+S	enregistre (dans le fichier .nrk d'origine si le document vient d'un fichier, sinon dans le cloud)
Cmd/Ctrl+O	ouvre un document
Cmd/Ctrl+N	nouveau document
Cmd/Ctrl+Z · Cmd/Ctrl+Shift+Z	annuler · rétablir
Shift+Espace	lance / arrête la lecture
Espace ou Esc	pendant la lecture, l'arrêtent
double-clic sur une mesure	la sélectionne (dans l'éditeur ou sur la partition)

Éditeur de texte

Touches	Ce que ça fait
Shift+Enter	EXTEND
Cmd/Ctrl+Shift+Enter	COMPACT
Tab	insère une barre de mesure (avec Speedy Entry actif)
Tab ou Enter	accepte la suggestion grisée ; Esc l'ignore
Cmd/Ctrl+Shift+clic (ou glisser)	sélectionne une plage de mesures
Cmd/Ctrl+Shift+flèches	étend la plage de mesures au clavier
Shift+flèches · Shift+clic	sélection de texte
Esc	efface la sélection de mesures
Alt+clic (⌥+clic sur Mac)	ajoute un curseur

Partition (après un clic sur la partition). Les touches seules n'agissent que sans Cmd/Ctrl/Alt : Cmd/Ctrl+P reste l'impression du navigateur et Cmd/Ctrl+F sa recherche.

Touches	Ce que ça fait
clic	sélectionne une note
Shift+clic	étend la sélection de mesures
W · H	ajuster à la largeur · à la hauteur
F	change la police musicale
P	change le mode d'affichage
+ · −	zoom avant · arrière
Cmd/Ctrl + + · −	augmente · réduit la densité (aussi Cmd/Ctrl+= ; vaut aussi avec une note sélectionnée)
← · →	page précédente · suivante (en mode page)
↑ · ↓	défile vers le haut · le bas
flèches, avec des mesures sélectionnées	déplacent la sélection (Shift l'étend ; Esc l'efface)

Note sélectionnée sur la partition

Touches	Ce que ça fait
← · →	note précédente · suivante (et la joue)
↑ · ↓	monte · descend d'un degré (dans la tonalité)
+ · −	monte · descend d'un demi-ton
' · ,	monte · descend d'une octave
!	affiche / masque l'altération forcée
E	changement enharmonique
Shift+↑ · Shift+↓	dans un accord, passe d'une note à l'autre
Esc	désélectionne la note

Le menu fichier

Depuis la topbar :

• New — un nouveau document vide.
• Open… — ouvrir une de vos chansons (avec recherche par nom, titre et crédits).
• Import — importer un fichier .nrk ou XML (MusicXML).
• Export — exporter la chanson en fichier .nrk, MusicXML ou Lilypond.
• Save (Cmd/Ctrl+S) — rappelez-vous qu'il n'y a pas d'écrasement : chaque enregistrement ajoute une version à votre chanson. Fonctionne aussi hors ligne (enregistre en local et synchronise dès le retour en ligne ; un indicateur montre l'état de synchronisation).
• Save as new — crée une nouvelle chanson à partir de l'actuelle (utile pour partir de la chanson d'autrui ou créer une variante).
• Revert to saved — abandonne les modifications locales et recharge la dernière version enregistrée.
• Manage document… — renommer le document (créateur uniquement, en ligne), gérer les étiquettes, voir rôle/dates, ouvrir dans Library ou supprimer le document (avec toutes ses versions).
• Tutorial… et Guided tour — voir ci-dessous.

Versions et Release

Une chanson évolue par versions (chaque enregistrement en ajoute une). Depuis la topbar vous voyez la version courante et ses états wip / stable, vous pouvez revoir les versions précédentes et faire une Release : elle crée une nouvelle version stable et supprime définitivement les versions travail en cours intermédiaires.

Partager

Générez un fly link (autonome) et ouvrez la chanson dans View. Vous pouvez transposer la chanson depuis la fenêtre dédiée (notes, accords ou les deux). Les types de liens et leurs implications sont dans Liens et partage.

Mode réactif et Lead

En ouvrant un reactive link, Write passe en mode lié et en lecture seule : il suit en direct les modifications de celui qui a la main. Celui qui a les droits de modification peut prendre la main (take lead) : à partir de là, chacun de ses enregistrements apparaît en temps réel chez ceux qui regardent dans View ; release rend la main. C'est la base des répétitions et des cours en temps réel (voir le reactive link dans Liens et partage).

Tutoriels intégrés

Depuis le menu fichier vous ouvrez les tutoriels pas à pas (choisis dans une liste, avec un décompte des étapes) : en haut apparaissent les contrôles précédent / suivant / réinitialiser l'étape. Il y a aussi une visite guidée de l'interface (driver.js), lancée depuis le logo en haut à gauche.