Put a string between two other strings

Create an XML opening tag, e.g., p

Create an XML closing tag, e.g., /p

Put something between opening and closing XML tags, specifying text of opening tag, contents, and closing tag: > xmlWrap "p" "text" "p" => ptext/p

Put something between XML tags, with the same text for opening and closing: > xmlWrapBasic "p" "text" => ptext/p

Create an XML element (which may contain other elements). If you need attributes, use elementAttr.

Create an XML attribute

Create an XML element that has attributes, e.g., class="foo"bar/p

Create an MEI note element from our Note datatype, converting the attributes as needed. If the Note actually contains a rest (Pitch with only a Dur in the rest range), then produce a rest element.

Convert Pnum to MEI pname

Just print the octave number

Convert Dur to MEI dur (base value of duration) and @dots (if any; omit if not)

Convert our Accid to MEI accid (omit if natural)

TODO Verovio will display the accidental if the accid attribute or element is present, regardless of the key signature. We would need to check the tone/key and then use accid.ges for accidentals that are in the key signature.

If a word is a single syllable, we do not need to include @con or @wordpos; if it is more than one syllable, we include these attributes. We use a dash connector by default, and get the word position from the data in the Syllable type.

Where is this item in the list that contains it?

Given a function that takes a ListPosition argument and a list, apply the function to the list. This allows you to treat the first and last items in the list differently.

Mark a list with the positions of the items: first, body, and last. Output a list of pairs with the ListPosition and the original list item.

Make an XML string containing a list of note elements out of a MusicPhrase; end each phrase with barline, except for last in the list.

Leave the barline of the last phrase up to the next-higher function (end of sentence gets regular bar; end of sentence, double bar; end of section, final bar).

Make an XML string containing all the contents of one layer out of a MusicSentence. If this is the last sentence in the section, omit the bar so the higher function calling this one can add it. Sentence ends with regular barline.

A MusicSection contains all the music for one section, /for a single voice/: so combine all subdivisions into one staff and layer so this can be made part of an MEI section in chorus2mei. Include MEI 1-indexed staff number derived from VoiceName enum Put a double bar at the end of sections and a final bar at the end of the piece.

TODO: you could put more than one layer per staff if you wanted a 2-staff choirstaff (e.g., SA on one, TB on the other)

Take a list of sections, one per SATB voice, and create a single MEI section including all the voices. Add a final bar at the end.

Create an MEI key signature (all naturals or one flat) based on tone (key.sig attribute for use in scoreDef/staffDef)

MEI key signature as an attribute (for use in staffDef)

Value for MEI key.sig: one flat if tone is mollis, no signature otherwise

Switch to select which kind of meter to use as an element

Switch to select which kind of meter to use as an attribute

Create an MEI meter signature (using modern equivalents of Kircher's C, C3, cutC3). (meterSig with meter.count and meter.unit attributes for use in scoreDef/staffDef@)

Mensural version of meiMeter. We want either "cut C", C3, or "cutC3". Verovio does not render these correctly as of 2021/07 when using the proport element (or proport.num attribute) for the number, which is the correct encoding. But putting num directly inside mensur works with Verovio.

Mensural meter with proportion as a string of attributes (for use in staffDef, where the correct encoding also works with Verovio).

MEI tempo element for MIDI speed: quarter-note (semiminim) beats per minute, different tempi for each mensuration

MEI midi.bpm attribute appropriate for each mensuration This is how it should work, but Verovio does not accept a tempo element within staff, so I do not know how to do a tempo change mid-piece.

Extract a simple list of MusicSentence from the four members of a MusicChorus

Convert a whole MusicScore to MEI XML. Include meter and key of first section in top-level scoreDef (TODO ?) Pass on the position in the list to the next function down.

Make an MEI double barline

Make an MEI final barline

Make an MEI barLine element

Default XML header

MEI version number

The "composer" (that is, the ark itself)

The "inventor"

MEI project description text

MEI element for MIDI instrument number (1-indexed)

MIDI instrument for playback

Plug in variables and musical content needed to boilerplate MEI document in all its baroque verbosity