2.1.3 Arbeiten an Text-Dateien

LilyPonds Quelldateien werden wie Dateien in den meisten Programmiersprachen behandelt: Es ist auf Groß- und Kleinschreibung zu achten, Ausdrücke werden mit geschweiften Klammern { } eingeklammert und Kommentare mit dem Prozentzeichen % auskommentiert oder mit %{ ... %} umgeben.

Wenn das jetzt unverständlich erscheint, sind hier die Erklärungen:

• Groß- und Kleinschreibung: Die Bedeutung eines Zeichens verändert sich, je nachdem, ob es groß (A, B, S, T) oder klein (a, b, s, t) geschrieben wird. Noten müssen immer klein geschrieben werden, { c d e } funktioniert, während { C D E } einen Fehler produziert.
• Leerzeichen: Es spielt keine Rolle, wie viele Leerzeichen oder leere Zeilen sich zwischen den Zeichen der Quelldatei befinden. { c d e } bedeutet das Gleiche wie { c d e } oder

                 {
       c                        d
         e }
  

  Natürlich ist das letzte Beispiel etwas schwer zu lesen. Eine gute Daumenregel ist es, Code-Blöcke mit der Tab-Taste oder zwei Leerzeichen einzurücken,

       {
         c d e
       }.
  

• Ausdrücke: Auch der kleinste Abschnitt an LilyPond-Code muss in { geschweifte Klammern } eingeschlossen werden. Diese Klammern zeigen LilyPond an, dass es sich um einen zusammengehörenden musikalischen Ausdruck handelt, genauso wie Klammern ‚()‘ in der Mathematik. Die Klammern sollten von jeweils einem Leerzeichen umgeben sein, um Zweideutigkeiten auszuschließen, es sei denn, sie befinden sich am Anfang oder Ende einer Zeile. Eine Funktion (wie etwa \relative { }) wird auch als ein einzelner Musikausdruck gewertet.

• Kommentare: Ein Kommentar ist eine Bemerkung für den menschlichen Leser einer Quelldatei, es wird bei der Dateianalyse durch das Programm ignoriert, so dass es also keine Auswirkung auf die Druckausgabe der Noten hat. Es gibt zwei verschiedene Typen von Kommentaren. Das Prozentzeichen ‚%‘ geht einem Zeilen-Kommentar voraus: Alles nach diesem Zeichen wird in dieser Zeile ignoriert. Ein Block-Kommentar ist ein ganzer Abschnitt mit einem Kommentar. Alles, was von %{ und %} umgeben ist, wird ignoriert. Das folgende Beispiel zeigt mögliche Anwendung von Kommentaren:

       % Noten für twinkle twinkle hier
         c4 c g' g a a g2
       
       %{
           Diese Zeilen, und die Noten unten werden
           ignoriert, weil sie sich in einem Block-Kommentar
           befinden.
       
           g g f f e e d d c2
       %}
  

Weitere Vorschläge zur Konstruktion von Quelldateien finden sich in Verschläge, wie LilyPond-Dateien geschrieben werden sollen.

Andere Sprachen: English, français, español.