• 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 folgende Zeile am Anfang Ihrer LilyPond-Eingabedatei ein:

\include "ekmel.ily"

und optional danach einen der \ekmelic*Style-Befehle (oder auch beide) für einen vordefinierten oder benutzerdefinierten Notationsstil.

Vordefinierter Notationsstil

\ekmelicStyle STILNAME

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

-dekmelic-style=STILNAME

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

• arrowPfeil-Notation
• rhmRichter Herf / Maedel-Notation
• simsSims-Notation  
• sagSagittal-Notation' ' '
• msagGemischte Sagittal-Notation
• wysWyschnegradsky-Notation' ' '' ' '
• goGould-Notation für Vierteltöne
• gosGould-Notation für Sechsteltöne
• gostGould + Stein / Zimmermann-Notation
• stzStein / Zimmermann-Notation
• stcStein / Couper-Notation
• stvtStein / Van Blankenburg / Tartini-Notation
• bosBosanquet Komma-Notation
• fourZiffer-4-Notation
• fernFerneyhough-Notation

Benutzerdefinierter Notationsstil

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

Dies erzeugt einen benutzerdefinierten Notationsstil mit dem Namen MEINNAME, abgeleitet vom aktuellen Stil (üblicherweise ein vordefinierter Notationsstil).

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.
  Die Ekmelos Schriftart ist jetzt ein 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.