• Kopieren Sie die Datei ekmel.ily in ein geeignetes Verzeichnis, z.B. das aktuelle Arbeitsverzeichnis, oder "LILYPOND/usr/share/lilypond/current/ly", wobei LILYPOND das Installationsverzeichnis von LilyPond ist.
• Kopieren Sie eine oder beide der Sprachdateien, ekmel-de.ily für deutsche Notennamen, ekmel-en.ily für englische Notennamen, in das selbe Verzeichnis wie oben (siehe Notennamen).
• Installieren Sie optional die Ekmelos Schriftart auf Ihrem System (siehe Schriftarten):
  - Auf Windows ziehen Sie die Datei Ekmelos.otf nach "C:\Windows\Fonts".
  - Auf MacOS kopieren Sie die Datei EkmelosMac.otf nach "/Library/Fonts".
  Normalerweise muss der LilyPond Font-Cache, d.h. das Verzeichnis "~/.lilypond-fonts.cache-2" (oder "%HOMEPATH%\.lilypond-fonts.cache-2" in Windows) gelöscht werden. So wird der Cache beim nächsten Lauf von Grund auf neu erzeugt, einschließlich der neuen Schriftart.

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.

Neu in 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.

Neu in 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.

Neu in Version 1.8

Unterstützung für andere Schriftarten als Ekmelos mit der Variable ekmelicFont.

Neu in Version 1.7

Die in Version 1.2 eingeführten vordefinierten Notationsstile (pers, bus, wstc, stp, stg, xen; außer four und fern) wurden wieder entfernt, da sie lediglich frei erfundene Kombinationen einzelner Versetzungs­zeichen darstellem.

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

microlily

bitbucket.org/x31eq/microlily , von Graham Breed für Just Intonation und andere Systeme mit der Sagittal-Notation.

HE-Lily

www.torsten-anders.de , von Torsten Anders für die Helmholtz-Ellis Notation.