File	Date	Author	Commit
examples	2025-01-25	mlepper	[484a5b] lablog entries added
src	2025-02-04	mlepper	[b6a2e5] Makefile cp-rules made generic
README	2025-02-03	mlepper	[66efbf] README linked to the journal article
lablog.d2d	2025-02-03	mlepper	[3713e8] lablog todo-list

Read Me

bandm.eu/multinotes/README

The text structures of notes and publications in music theory and
musical analysis bring challenging requirements: how to include music
notation excerpts, graphics, and even combinations thereof, into the
typeset flow of paragraphs and into the work-flow, and how to
integrate navigable references to these and to single domain entities
into running text.

Furthermore, dynamic interactive documents can be useful for
presenting complicated interdependencies to the reader more clearly,
far beyond conventional paper publication.

D2d is a text format definition and compiler based implementation to
allow domain experts and novelists to write texts in the flow of
authoring, with minimal technical interference, which are nevertheless
valid XML documents.

The multiNotes text architecture and processing pipeline is based on
d2d and standard technologies (XSLT, ECMAScript. LilyPond, PostScript,
etc.) and addresses these issues.

An overview about the software architecture and its operation is
given in

Journal of the Text Encoding Initiative, Open Issue 18/2024:
"Using d2d for Writing XML ---
The multiNotes Text Architecture for Musical Analysis"
Markus Lepper and Baltasar Trancón y Widemann
https://doi.org/10.4000/132ex

For operating the system, download a ".jar" file of bandm metatools and
follow the instructions in "src/Makefile".
An example is given in "examples".

REQUIREMENTS:

Posix OS
gnu make
bash (other shells may work)
java jre (min 1.17)
metatools.jar
lilypond (currently only version 2.16.0 is known to be supported.)
netpbm

For details see src/Makefile.

// eof