• Kopieren Sie die Datei ekmel.ily in einen geeigneten Ordner, z.B. "LILYPOND/usr/share/lilypond/current/ly", wobei mit LILYPOND der Installationsordner von LilyPond gemeint ist.
• Kopieren Sie eine oder beide der Sprachdateien in den selben Ordner wie oben:
  ekmel-de.ily für deutsche Notennamen, ekmel-en.ily für englische Notennamen; siehe Notennamen.
• Installieren Sie die Ekmelos Schriftart, wenn sie für die Versetzungs­zeichen in Ekmelily verwendet werden soll; siehe Schriftarten.

Fügen Sie folgendes am Anfang Ihrer LilyPond-Eingabedatei ein:

\include "ekmel.ily"

und optional danach einen oder beide der folgenden \ekmelic*Style-Befehle.

Vordefinierter Notationsstil

\ekmelicStyle STILNAME

Dies setzt den Notationsstil STILNAME. Die Voreinstellung ist arrow oder der mit der Kommandozeilenoption

-dekmelic-style=STILNAME

angegebene Stil 1.

Die folgenden Stile sind vordefiniert (siehe Versetzungen für Einzelheiten zu den Versetzungszeichen):

arrow	Pfeil-Notation	          
rhm	Richter Herf / Maedel-Notation	          
sims	Sims-Notation	          
sag	Sagittal-Notation	                         ' ' '
msag	Gemischte Sagittal-Notation	          
wys	Wyschnegradsky-Notation	           ' ' '            ' ' '
go	Gould-Notation für Vierteltöne	                  
gos	Gould-Notation für Sechsteltöne	                  
gost	Gould + Stein / Zimmermann-Notation	         ' ' '          ' ' '
stz	Stein / Zimmermann-Notation	      
stc	Stein / Couper-Notation	      
stvt	Stein / Van Blankenburg / Tartini-Notation	      
bos	Bosanquet Komma-Notation	  
four	Ziffer-4-Notation	  
fern	Ferneyhough-Notation	          

Benutzerdefinierter Notationsstil

\ekmelicUserStyle MEINNAME #'((VERSETZUNG ZEICHEN …) …)

Dies erzeugt einen benutzerdefinierten Notationsstil, ausgehend vom aktuellen Stil, mit dem Namen MEINNAME. Für jede angegebene VERSETZUNG wird ein neues Versetzungs­zeichen, bestehend aus ein oder mehreren ZEICHEN, definiert. Für alle anderen Versetzungen, bei denen das bisherige Versetzungs­zeichen von VERSETZUNG in Kombination mit weiteren Zeichen vorkommt, wird dieses ebenfalls durch das neue Versetzungs­zeichen ersetzt.

VERSETZUNG muss eine Rationalzahl oder eines der vordefinierten Scheme-Symbole sein.
ZEICHEN muss entweder ein Unicode Codepunkt als Ganzzahl, ein Zeichen-Literal oder ein String sein. Anm.: Die von der Ekmelos Schriftart unterstützten Codepunkte finden Sie in Ekmelos.pdf.
Wenn MEINNAME ein Leerstring ist (""), wird der Name des aktuellen Stils, erweitert mit -user, verwendet.

Beispiel

Das folgende Beispiel setzt die vordefinierte Stein / Couper-Notation (stc) und ändert diese dann in eine benutzerdefinierte Notation mit neuen Versetzungs­zeichen für die Vierteltonstufen: Kreuz-Zeichen mit Schweif (Codepunkt U+E475) und ausgefülltes umgedrehtes Be-Zeichen (Codepunkt U+E480).

\ekmelicStyle stc
\ekmelicUserStyle MeinName #'(
  (1/4 #xE475)
  (-1/4 #xE480))

oder unter Verwendung der entsprechenden Scheme-Symbole:

\ekmelicStyle stc
\ekmelicUserStyle MeinName #`(
  (,SEMI-SHARP #xE475)
  (,SEMI-FLAT #xE480))

Weitere Beispiele finden Sie in der Datei user-styles.ly.

\ekmelicOutputSuffix

Setzt den Namen des aktuellen Notationsstils als Suffix des Ausgabedateinamens für den aktuellen \book-Abschnitt.

\ekmelic-style-name

Zeichnet den Namen des aktuellen Notationsstils als Markup.

\ekmelic-char #VERSETZUNG

Zeichnet ein Versetzungszeichen entsprechend dem aktuellen Notationsstil als Markup. VERSETZUNG muss eine Rationalzahl oder eines der vordefinierten Scheme-Symbole sein.

\ekmelic-fraction #VERSETZUNG

Zeichnet VERSETZUNG als Bruchzahl (vertikal angeordnet, nicht einfach ein String z/n), oder als Ganzzahl, wenn ihr Nenner 1 ist, mit einem separaten Minuszeichen für einen negativen Wert. VERSETZUNG muss eine Rationalzahl oder eines der vordefinierten Scheme-Symbole sein.

Ekmelily definiert Notennamen (Tonhöhennamen) für alle Zwölfteltonstufen, basierend auf den in LilyPond vorgegebenen deutschen und englischen Namen für Halbtöne und Vierteltöne; siehe Tabelle aller Notennamen. Die verwendete Sprachversion hängt davon ab, welche Sprachdatei vorhanden ist, oder wenn beide vorhanden sind, welche Sprache in LilyPond ausgewählt ist: Mit \language english werden die englischen, sonst die deutschen Notennamen verwendet.

Deutsche Notennamen

Sprachdatei ekmel-de.ily: Jeder Name besteht aus einem der Buchstaben c d e f g a h mit einer Endung für die Versetzung; z.B. c cir cil cih ciseh cisel ciser cis cisir cisil cisih cisiseh cisisel cisiser cisis …. 2

Englische Notennamen

Sprachdatei ekmel-en.ily: Jeder Name besteht aus einem der Buchstaben c d e f g a b 3 mit einer Endung für die Versetzung; z.B. c cts cxs cqs csaqf crs cfts cs csts ctrs ctqs cssaqf cfxs cets css ….

Enharmonisch äquivalente Notennamen

Die Ein-Viertel- und Drei-Viertel-Tonstufen haben in einigen Notationsstilen wie arrow, rhm und sims zwei unterschiedliche, enharmonisch äquivalente Versetzungs­zeichen. Ekmelily definiert daher jeweils zwei Notennamen, z.B. cih und ciseh (deutsch) oder cqs und csaqf (englisch). LilyPond unterstützt jedoch nicht mehrere Versetzungs­zeichen für dieselbe Versetzung. Als provisorische Lösung haben die kombinierten Notennamen (z.B. ciseh oder csaqf) geringfügig abweichende Versetzungen und sind daher für Transponierung und MIDI-Ausgabe ungeeignet.

Ekmelily verwendet voreingestellt die Ekmelos Schriftart für die Versetzungs­zeichen. Eine andere Schriftart kann gewählt werden: entweder in der LilyPond-Eingabedatei vor dem Einfügen von ekmel.ily mit der Variable

ekmelicFont = SCHRIFTARTNAME

oder mit der Kommandozeilenoption 1

-dekmelic-font=SCHRIFTARTNAME

Bei Verwendung eines vordefinierten Notationsstils sollte die Schriftart konform zu SMuFL4 sein; z.B. Bravura.

• Version 1.10: Erweiterung der Ferneyhough-Notation (fern) mit Viertelton Versetzungs­zeichen.
  Austausch von Einzel-Versetzungszeichen für "kombinierte" Vierteltonstufen durch zusammengesetzte Zeichen in den Notationsstilen gost, stz, stc, und stvt.
• Version 1.9: Unterstützung für Notennamen in verschiedenen Sprachen durch separate Sprachdateien ekmel-*.ily. Verfügbar sind Deutsch und Englisch.
  Neue Kommandozeilenoption ekmelic-font zur Auswahl einer Schriftart.
  Ekmelos Schriftart als eigenständiges Projekt.
• Version 1.8: Unterstützung für andere Schriftarten als Ekmelos mit der Variable ekmelicFont.
• Version 1.7: Entfernung der in Version 1.2 eingeführten vordefinierten Notationsstile (pers, bus, wstc, stp, stg, xen), außer four und fern, da sie lediglich frei erfundene Kombinationen einzelner Versetzungs­zeichen darstellem.
• Version 1.6: Neue und korrigierte Notennamen (Suffixe) für abwärts Versetzungen von A und E, z.B. `ases` und `aeses` für `asas`.
• Version 1.5: Überarbeitete Unterstützung für benutzerdefinierte Notationsstile mit dem neuen Befehl \ekmelicUserStyle.
  Entfernung der Befehle \extraNatural und \omitAccidental.
• Version 1.4: Unterstützung für benutzerdefinierte Notationsstile.
• Version 1.3: Unterstützung für warnende Versetzungs­zeichen in Klammern (cautionary Stile).
• Version 1.2: Acht neue Notationsstile für Viertel- und Dritteltöne (24-,18-EDO): pers, bus, wstc, stp, four, stg, xen, fern.
  Neue Kommandozeilenoption ekmelic-style für die Voreinstellung des Notationsstils.
• Version 1.1: Zehn neue Notationsstile für Zwölftel-, Sechstel-, und Vierteltöne (72-,36-,24-EDO): sag, msag, wys, go, gos, gost, stz, stc, stvt, bos.
• Version 1.0: Erste SMuFL-konforme Ausgabe mit drei Notationsstilen für Zwölfteltöne (72-EDO): arrow, rhm, sims.

Andere Erweiterungen für LilyPond zur Notation mikrotonaler Musik, welche auch Anregungen für Ekmelily gaben:

• microlily: von Graham Breed für Just Intonation u.a. mit der Sagittal-Notation.
• HE-Lily: von Torsten Anders für die Helmholtz-Ellis Notation.