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.
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. Un appui long ouvre le panneau des contrôles de lecture : lecture/pause/stop et retour au début, vitesse (0.5×–2×), swing (ratio et accent sur le contretemps), count-in et les volumes.
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 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
.nrkou XML (MusicXML). - Export — exporter la chanson en fichier
.nrk(export XML/Lilypond à venir). - 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.