Ricetta numero 167

Ricettario · Capitolo 7 · Figure e immagini

Una partitura per pianoforte da MusicXML su più pagine

Due minuetti per tastiera incisi da file MusicXML su doppio pentagramma, spezzati tra un sistema e l’altro perché ogni brano occupi una doppia pagina.

In questa pagina
Output
Canvas · PDF
Livello
Intermedio
Postext
Provata con Postext 1.54.0
Richiede ≥ 1.54.0 · postext-pdf ≥ 1.54.0
Licenza
Aggiornata il 22 ott 2026
Codice MIT · Testo CC BY 4.0

pp. 2–3 di 5

Leggi questa ricetta come testo →
  • Esempio in inglese: non c’è ancora un’edizione italiana
  • Formato 230 × 305 mm
  • 1 colonna
  • Libre Caslon Text 10/14,5
  • Archivo Narrow
  • Bodoni Moda
  • 5 pagine
  • Livello
  • Postext 1.54.0
  • Impaginato in 511 ms
  • 165 righe di codice

In breve

Una piccola edizione di due minuetti per pianoforte molto noti. Mostra come prendere un file esportato da un programma di notazione e comporlo come partitura che prosegue da una pagina all’altra, pronta da suonare.

Che cosa comporrai

Un’edizione per esecutori dei due minuetti del Quaderno di Anna Magdalena Bach del 1725: quello in sol maggiore, che ogni allievo di pianoforte impara, e il suo compagno in sol minore, oggi attribuiti a Christian Petzold. La pagina misura 230 × 305 mm, il formato di un album di spartiti. Una pagina dispari presenta i brani su due colonne di Libre Caslon sotto un titolo di 52 pt in Bodoni. Poi ogni minuetto comincia su una pagina pari e occupa la doppia pagina su un doppio pentagramma di 7 mm, inciso in Bravura da un file MusicXML: quattro battute per sistema, le battute 1–16 a sinistra e 17–32 a destra, così il pianista non gira pagina dentro un brano.

Questa ricetta risponde a

  • Come compongo una partitura per pianoforte da un file MusicXML su più pagine?

La risposta breve

script.js · righe 36–61nel codice completo
const scoreStyle = {
  staffSize: mm(7), // the rastral of a performing edition: read at arm's length
  musicFont: 'Bravura', // the engraved plate look
  barNumbers: 'system', // a number at the head of each system, as editions print them
  spacing: 1.7, // about four bars to a system, eight systems to a piece
  systemGap: mm(14), // room for the ledger lines above and below the grand staff
  marginTop: pt(LEAD),
  marginBottom: pt(0),
  minSystemsAtBreak: 2, // never one system alone at a foot or the head of a page
  color: col('ink'),
};
// A fence breaks between systems, so a piece runs on over pages; a score resource is kept
// whole. The file is what notation software exports: the Markdown keeps a placeholder
// line in each fence and the pen puts the fetched file there.
const SCORES = {
  'bwv-anh-114': asset('bwv-anh-114.musicxml'),
  'bwv-anh-115': asset('bwv-anh-115.musicxml'),
};
async function withScores(text) {
  const files = await Promise.all(Object.entries(SCORES).map(async ([id, url]) => {
    const res = await fetch(url);
    if (!res.ok) throw new Error(`Score not found (${res.status}): ${url}`);
    return [id, (await res.text()).trim()];
  }));
  return files.reduce((md, [id, xml]) => md.replace(`{{${id}}}`, () => xml), text);
}

Ingredienti

Tipo
Libre Caslon Text, Bodoni Moda, Archivo Narrow (SIL OFL 1.1)
Risorse
  • bwv-anh-114.musicxml
  • bwv-anh-115.musicxml
  • Menuet in G major, BWV Anh. 114: the notes of the Bach-Gesellschaft edition as entered for the Mutopia Project (Mutopia-2017/01/19-75), converted to MusicXML 4.0 and proofread bar by bar for this edition (Christian Petzold; Allen Garvin (Mutopia Project), pubblico dominio)
  • Menuet in G minor, BWV Anh. 115: the notes of the Bach-Gesellschaft edition as entered for the Mutopia Project (Mutopia-2015/08/21-76), converted to MusicXML 4.0 and proofread bar by bar for this edition (Christian Petzold; Allen Garvin (Mutopia Project), pubblico dominio)

Preparazione

#1 · Porta il brano in MusicXML

I due file in assets/ sono semplice MusicXML 4.0, il formato che Dorico, Sibelius, Finale e MuseScore scrivono quando esporti una partitura (scegli il .musicxml non compresso, non il .mxl). Contengono una parte su due pentagrammi, con chiavi, armatura, travature, direzione dei gambi nelle battute a due voci, abbellimenti e stanghette di ritornello. Il nome della parte ha print-object="no": un’etichetta «Piano» stampata spingerebbe ogni sistema verso destra. Il titolo in <work-title> non si stampa, serve solo da descrizione della partitura, perciò il Markdown dà a ogni brano un titolo proprio.

#2 · Componilo in un blocco di codice, non come risorsa

La risposta breve scarica ogni file e lo scrive in un blocco ```musicxml, dove il Markdown tiene una riga segnaposto. Un blocco viene inciso alla larghezza della colonna e tagliato in sistemi, e ogni sistema si colloca come una riga di paragrafo: il brano prosegue alla pagina successiva tra due sistemi. Una risorsa score resta intera e non potrebbe attraversare una pagina. minSystemsAtBreak: 2 evita che un sistema resti da solo al piede di una pagina o passi da solo in cima alla successiva.

#3 · Dimensiona il pentagramma per chi suona

Il pentagramma è alto 7 mm, quanto in un album per pianoforte stampato che si legge dal leggio. spacing: 1.7 allarga le note finché un sistema di 186 mm di giustezza contiene quattro battute, così ogni metà di un minuetto occupa quattro sistemi. systemGap: 14 mm lascia spazio ai tagli addizionali tra le due mani, e con questa distanza stanno quattro sistemi sotto il titolo della prima pagina e quattro su quella a fronte: la doppia stanghetta cade al passaggio da una pagina all’altra della doppia pagina.

#4 · Apri ogni brano su una pagina pari

script.js · righe 65–103nel codice completo
const label = (id, content, edge, x, y, extra = {}) => ({
  kind: 'text', id, content, fontFamily: LABEL, fontSize: pt(9), fontWeight: 500,
  color: col('ink'), align: edge.endsWith('right') ? 'right' : 'left',
  placement: { anchor: { to: 'container', edge }, offset: { x: mm(x), y: mm(y) } }, ...extra,
});
const kicker = { fontSize: pt(8.5), fontWeight: 700, letterSpacing: pt(1.6),
  textTransform: 'uppercase', color: col('accent'), align: 'center' };
const centred = (to, y) => ({ anchor: { to, edge: to === 'container' ? 'top' : 'below' },
  offset: { x: mm(0), y: mm(y) }, size: { width: 'fill' } });
const pieceOpener = {
  enabled: true,
  minHeight: mm(34),
  slot: { elements: [
    label('kicker', '{attr.kicker}', 'top', 0, 2,
      { ...kicker, placement: centred('container', 2) }),
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, fontSize: pt(26),
      fontWeight: 500, color: col('ink'), align: 'center',
      placement: centred('#kicker', 2.5) },
    label('catalogue', '{attr.catalogue}', 'bottom-left', 0, -3),
    label('composer', '{attr.composer}', 'bottom-right', 0, -3, { italic: true }),
  ] },
};
const frontOpener = {
  enabled: true,
  minHeight: mm(78),
  slot: { elements: [
    label('kicker', '{attr.kicker}', 'top', 0, 14,
      { ...kicker, placement: centred('container', 14) }),
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: DISPLAY, fontSize: pt(52),
      fontWeight: 500, color: col('ink'), align: 'center',
      placement: centred('#kicker', 5) },
    { kind: 'text', id: 'composer', content: '{attr.composer}', fontFamily: SERIF,
      fontSize: pt(13), italic: true, color: col('ink'), align: 'center',
      placement: centred('#title', 4) },
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.75), color: col('accent'),
      placement: { anchor: { to: '#composer', edge: 'below', at: 'center' }, offset: { y: mm(8) },
        size: { width: mm(24) } } },
  ] },
};

breakBefore: { parity: 'even' } fa cominciare ogni brano su una pagina di sinistra, e il frontespizio dell’editore usa uno stile di titolo che apre su pagina dispari senza testatine. Il numero di catalogo e il compositore vengono dagli attributi del titolo e stanno agli angoli inferiori dell’apertura, dove le edizioni incise li stampano.

#5 · Nomina il brano nella testatina di destra

script.js · righe 107–120nel codice completo
const head = (id, content, parity, edge, x, extra = {}) => ({
  kind: 'text', id, content, parity, pages: 'body',
  fontFamily: LABEL, fontSize: pt(8), fontWeight: 600, letterSpacing: pt(1.2),
  textTransform: 'uppercase', color: col('muted'),
  placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(12) } }, ...extra,
});
const folio = { fontWeight: 700, color: col('ink'), letterSpacing: pt(0) };
const header = { elements: [
  head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
  head('verso-title', '{chapterTitle}', 'even', 'top-left', OUTER + 9),
  head('recto-title', '{chapterTitle}', 'odd', 'top-right', -(OUTER + 9)),
  head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folio),
] };
const footer = { elements: [] };

La prima pagina di un brano porta già il suo titolo, quindi le testatine restano per le pagine seguenti (pages: 'body'). La pagina dispari stampa il titolo del brano e il folio sul margine esterno, nel carattere delle etichette a 8 pt.

La ricetta completa

Sandbox
// ═══ Postext Cookbook · Nº 167 · A piano score from MusicXML over several pages ═══════
// https://postext.dev/en/cookbook/piano-score-from-musicxml
// Code: MIT · Text: original (CC BY 4.0) · Music: Mutopia Project (public domain)
// Fonts: Libre Caslon Text, Bodoni Moda, Archivo Narrow (SIL OFL 1.1) · Needs postext ≥ 1.54.0
import {
  buildDocumentWithFonts, renderPageToCanvas, initMusicEngine,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'piano-score-from-musicxml';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a plate-black ink, one deep green accent, every colour linked by id
const palette = {
  ink: '#1b1a18', // the notes and the text: a warm near-black
  accent: '#2f5a46', // titles' kickers, rules: the green of an old music-shop wrapper
  tint: '#eef2ee',
  rule: '#b9c4bc', // hairlines
  muted: '#625f59', // running heads, the colophon
  paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  { id: 'main-color', name: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
// #endregion
const SERIF = 'Libre Caslon Text';
const DISPLAY = 'Bodoni Moda';
const LABEL = 'Archivo Narrow';
const OUTER = 20; // outer margin in mm: the running heads align to it
const LEAD = 14.5; // body leading in pt

// #region answer: the score style of a performing edition, and a MusicXML file in a fence
const scoreStyle = {
  staffSize: mm(7), // the rastral of a performing edition: read at arm's length
  musicFont: 'Bravura', // the engraved plate look
  barNumbers: 'system', // a number at the head of each system, as editions print them
  spacing: 1.7, // about four bars to a system, eight systems to a piece
  systemGap: mm(14), // room for the ledger lines above and below the grand staff
  marginTop: pt(LEAD),
  marginBottom: pt(0),
  minSystemsAtBreak: 2, // never one system alone at a foot or the head of a page
  color: col('ink'),
};
// A fence breaks between systems, so a piece runs on over pages; a score resource is kept
// whole. The file is what notation software exports: the Markdown keeps a placeholder

Lo script.js composto funziona così com’è: incollalo nello script modulo di qualsiasi pagina, oppure apri la ricetta su CodePen. Cartella della ricetta su GitHub ↗ (si apre in una nuova scheda)

Varianti

#Fai un’edizione di studio con un pentagramma più piccolo

Un pentagramma di 6 mm con la spaziatura propria dell’incisore tiene sette o otto battute per sistema, così ogni minuetto sta nella sua prima pagina.

-  staffSize: mm(7),
+  staffSize: mm(6),
-  spacing: 1.7,
+  spacing: 1,

#Numera gli esempi brevi

Quando la musica è fatta di brevi esempi citati nel testo, va meglio una risorsa score numerata: corali a quattro voci come esempi numerati.

Errori frequenti

  • Gli a capo di sistema scritti nel file (<print new-system="yes">) non vengono mantenuti: i sistemi riempiono la larghezza della colonna, quindi regola spacing e staffSize finché contengono le battute che vuoi.
  • L’incisore non distribuisce le battute tra i sistemi, e l’ultimo sistema si compone alla sua larghezza naturale: a 6 mm e con spacing: 1, la battuta 32 resta sola in un sistema. Cambia spacing finché l’ultimo sistema ha più di una battuta.
  • Un .mxl compresso è un archivio zip: decomprimilo, o esporta il formato non compresso, prima di scaricarlo.

Crediti

Testo
  • The introduction and performance notes, written for this edition · Ignacio Ferro · CC BY 4.0
Immagini
Font
Libre Caslon Text (SIL OFL 1.1) · Bodoni Moda (SIL OFL 1.1) · Archivo Narrow (SIL OFL 1.1)

Modifica questo testo ↗ (si apre in una nuova scheda)Cartella della ricetta su GitHub ↗ (si apre in una nuova scheda)

Un manuale di armonia con esempi musicali in ABC

Nº 163PDF

Libri di testo

Un capitolo sulle cadenze i cui esempi sono blocchi ABC nel Markdown, incisi alla larghezza della colonna; uno di essi prosegue su due pagine.

Livello 2 di 3: IntermedioLibri di testo4 pp.

Un canzoniere con melodia, parole e accordi

Nº 164PDF

Pubblicazioni complete

Ogni canzone è un blocco ABC: la melodia, gli accordi sul pentagramma e la prima strofa sotto le note, incisi alla larghezza di colonna da un unico stile.

Livello 2 di 3: IntermedioPoesia6 pp.

Esempi musicali in MEI con apparato critico nelle note

Nº 165PDF

Riquadri e note

Blocchi MEI 5 incisi nel testo su un rigo di 5 mm, varianti codificate con app, lem e rdg, e l’apparato per battuta e nota nelle note a piè di pagina.

Livello 2 di 3: IntermedioArticoli scientifici e testi accademici5 pp.

SandboxPDF