My quick rundown of how to use
OpenLilyLib's Edition Engraver
(OR I wish I could have read
this instead of having to learn by poking example code
with a stick)
What is it?
In a nutshell, the Edition Engraver provides a convenient
way of storing a tweaks, overrides and other objects that
can later be applied to some musical content.
Why use it?
To keep the "musical source" of a project free from
tweaks, temporary overrides, and tagged material that
needs to be filtered later. This serves to generate code
that is clean, reusable and has clarity of purpose,
meaning it's fast to read and understand.
How is it used?
In summary, by following this four logical steps:
- Load the Edition Engraver into the project.
- Create an edition (a container to store the edits)
- Fill the edition with content.
- Consist the contents of the edition to the musical
contexts to which they apply.
Each step explained [ ............ ]
Hopefully this will be enough to get anyone started. There
is more functionality than this, as far as I know the only
way to get a look into it is by examining the
`usage-examples` folder in the Edition Engraver
repository.