ScoreScript Language wiki

Normalization option reference

Generated from the native formatter menu built with this wiki. Read consolidation and normalization for recipes, refusal conditions, comment handling, and the difference between compact spacing and musical reuse. Check your installed build with scorescript format --list.

pitch

concert or written source: convert notes, keys and transpose maps together; sound unchanged.

GroupValuesAvailabilityDefault on
spellingconcert, writtenImplementedNo

arrange

part streams, measure systems, system breaks or rehearsal sections.

GroupValuesAvailabilityDefault on
orientationparts, measures, systems, rehearsalsImplementedNo

maps

meter/key/tempo/transpose: header maps, or at mN { … } in place; system/page cuts are separate.

GroupValuesAvailabilityDefault on
mapstop, inlineImplementedNo

opening-key

a movement's opening key: stated with the movement's facts, or in the reader head that opens it for every player.

GroupValuesAvailabilityDefault on
mapsmovement, headsImplementedNo

beams-unit

write out the note value a bare beam grouping counts in, so it survives a change of default.

GroupValuesAvailabilityDefault on
mapsBare switchImplementedNo

hoist-breaks

replace matching per-part system/page maps with ONE score-level map.

GroupValuesAvailabilityDefault on
mapsBare switchImplementedNo

labels

written headings as a map at the top, or on the bars they head.

GroupValuesAvailabilityDefault on
mapstop, inlineImplementedNo

exercises

the collection as a header index, or each exercise owning its music from m1.

GroupValuesAvailabilityDefault on
mapstop, inlineImplementedNo

lyrics

the sung line as a map at the head of the part, or as rows under the music it sings.

GroupValuesAvailabilityDefault on
mapstop, inlineImplementedNo

sections

the book's sections as a map at the top, or holding their exercises.

GroupValuesAvailabilityDefault on
mapstop, inlineImplementedNo

expand

one line the rest read -> every reader's part written out (consolidate, backwards).

GroupValuesAvailabilityDefault on
consolidationBare switchImplementedNo

chapters

a chapter in another key: written out in full, or movement =id = source in Key where one equals an earlier chapter.

GroupValuesAvailabilityDefault on
consolidationexplicit, instancesImplementedNo

page-turns

who turns the page before an exercise: \p in the reader heads, one page before line per exercise, or one line per list of readers.

GroupValuesAvailabilityDefault on
consolidationheads, lines, combinedImplementedNo

setup

set-up every movement repeats (credits, title, subtitle, directives, roster): once in the book's head, or written in each movement.

GroupValuesAvailabilityDefault on
consolidationshared, explicitImplementedNo

setup-quorum

what setup=shared hoists: what every movement states, or a credit or subtitle most state (the rest say none).

GroupValuesAvailabilityDefault on
consolidationevery, mostImplementedNo

numbers

movement numbers: left out where they equal the movement's place in the book, or written on every movement.

GroupValuesAvailabilityDefault on
consolidationderived, explicitImplementedNo

readers

a head holding a reader set's readers: written as the set's name, or spelled out.

GroupValuesAvailabilityDefault on
consolidationnamed, explicitImplementedNo

consolidate

identical, transposed or octave-translated part bodies -> one line the rest read.

GroupValuesAvailabilityDefault on
consolidationBare switchImplementedNo

named-spans

a repeated bar range written once and named.

GroupValuesAvailabilityDefault on
consolidationBare switchComingNo

Not available: consolidate writes them inside a head; spans have no door outside one.

durations

how a duration is written: 4Eb or qEb.

GroupValuesAvailabilityDefault on
spellingnumbers, lettersImplementedYes

key

decide the file's key spelling: no signature, or the one it implies.

GroupValuesAvailabilityDefault on
spellingopen, signature, autoImplementedNo

chromatic

inside a chromatic run: sharps ascending, flats descending.

GroupValuesAvailabilityDefault on
spellingBare switchImplementedNo

octaves

the octave digit: only where the ladder needs it, or pinned on every note.

GroupValuesAvailabilityDefault on
spellingminimal, explicitComingNo

Not available: the octave ladder runs unconditionally inside emit; needs a Style axis.

preset

a PRESET: one word for a whole selection (see the presets below).

GroupValuesAvailabilityDefault on
compressionreadable, condensed, maxImplementedNo

align

pad grid cells so the barlines line up down the page.

GroupValuesAvailabilityDefault on
compressionon, offImplementedYes

bar-blocks

how many bars a part-first block holds: one, eight (a landmark every eight bars), or a whole run.

GroupValuesAvailabilityDefault on
compressionone, eight, wholeImplementedYes

head-facts

a movement's short head facts (title, subtitle, meter, key, tempo, partial): one a line, or together on the movement's first line.

GroupValuesAvailabilityDefault on
compressionlines, lineImplementedYes

lists

short lists (a roster, a reader set, page before readers): standard (roster one a line, the rest on one line), all on one line, or one entry a line.

GroupValuesAvailabilityDefault on
compressionstandard, line, linesImplementedYes

strip-dev-text

remove header text that is dev jargon, never a name or a real subtitle.

GroupValuesAvailabilityDefault on
lintBare switchImplementedNo

strip-comments

remove every // comment, so a score can be made comment-free by the tool.

GroupValuesAvailabilityDefault on
lintBare switchImplementedNo

jargon-lint

report (never rewrite) student-facing text carrying internal jargon.

GroupValuesAvailabilityDefault on
lintBare switchImplementedNo

Presets

SelectorExact expansion
preset=readablealign=on, maps=top
preset=condensedalign=off, hoist-breaks, maps=top, durations=numbers
preset=maxalign=off, hoist-breaks, maps=top, durations=numbers, strip-dev-text, consolidate

The named-spans entry being marked coming does not mean named reuse is missing: consolidate already writes named ranges inside shared reader heads. Write a named exercise.

Machine-readable menu