1.1 Eine Quelldatei übersetzen

@translationof Compiling a file

Dieser Abschnitt führt in die „Kompilation“ ein – den Bearbeitungsprozess von LilyPond-Eingabedateien (die Sie geschrieben haben) um eine Ausgabedatei zu erstellen.

1.1.1 Noten eingeben

@translationof Entering input

„Kompilation“ ist der Begriff, der benutzt wird, um eine LilyPond-Eingabedatei mit dem Programm LilyPond in eine Notenausgabe umzuwandeln. Ausgabedateien sind in erster Linie PDF-Dateien (zum Anschauen und Drucken), MIDI (zum Abspielen) und PNG (für die Benutzung auf Internetseiten). Die Eingabedateien von LilyPond sind einfache Textdateien.

Das erste Beispiel zeigt, wie solch eine einfache Eingabedatei ausschauen kann.

{
  c' e' g' e'
}

Die graphische Ausgabe ist:

Zusätzlich unterscheidet LilyPond Groß- und Kleinschreibung. ‘ { c d e }’ ist zulässiger Code, ‘ { C D E }’ dagegen resultiert in einer Fehlermeldung.

Ausgabe erzeugen

@translationof Producing output

Das Erstellen der Notenausgabe hängt davon ab, welches Betriebssystem und welche Programme Sie benutzen.

• MacOS X (graphisch)
• Microsoft Windows (graphisch)
• Alle Betriebssysteme (Kommandozeile)

Beachten Sie, dass es eine Reihe an Texteditoren mit besserer Unterstützung für LilyPond gibt. Mehr dazu im Abschnitt (web)Leichteres Editieren in Abschnitt ‘Leichteres Editieren’ in Allgemeine Information.

1.1.2 MacOS X

@translationof MacOS X

1. Schritt: Erstellen Sie eine ‘.ly’-Datei

Wenn Sie das LilyPond.app-Symbol doppelt klicken, öffnet sich eine Beispiel-Datei.

Wählen Sie aus den Menüs oben links auf Ihrem Bildschirm File > Save.

Wählen Sie einen Namen für die Datei, etwa ‘test.ly’.

2. Schritt: Kompilieren (mit LilyPad)

Aus den selben Menüs wählen Sie jetzt Compile > Typeset.

Ein neues Fenster öffnet sich, in dem ein Fortschrittslog der Kompilation der von ihnen gerade gespeicherten Datei gezeigt wird.

3. Schritt: Ausgabe anschauen

Wenn die Kompilation fertig ist, wird ein PDF mit dem gleichen Namen wie das Original erstellt und automatisch mit dem Standard-PDF-Programm geöffnet und angezeigt.

Andere Befehle

Um neue LilyPond-Dateien zu erstellen beginnen sie mit File > New

oder File > Open um eine schon existierende Datei zu öffnen und zu editieren.

Sie müssen alle Änderungen an der Datei zuerst speichern, bevor Sie wieder Compile > Tyepset wählen. Wenn das PDF nicht erscheint, schauen Sie im Fortschrittslog nach Fehlern.

Wenn Sie nicht das Standard-PDF-Programm benutzen, das automatisch bei Mac OS X dabei ist, und Sie die PDF-Datei noch von einer vorigen Kompilation geöffnet haben, können weitere Kompilationen fehlschlagen, bis Sie das Original-PDF schließen.

1.1.3 Windows

@translationof Windows

1. Schritt: Erstellen Sie eine ‘.ly’-Datei

Wenn sie auf das LilyPond-Symbol auf dem Desktop doppelklicken, öffnet sich ein einfacher Texteditor mit einer Beispieldatei.

Aus dem Menü über der Beispieldatei wählen Sie File > Save as. Benutzen Sie nicht File > Save für die Beispieldatei, weil die Datei nicht funktioniert, bis Sie sie mit einem eigenen Namen gespeichert haben.

Wählen Sie einen Namen für Ihre Datei, etwa ‘test.ly’.

Schritt 2a: Kompilieren (mit drag-and-drop)

Sie können nach Belieben die Kompilation starten, indem Sie entweder:

Die Datei auf das LilyPond-Symbol ziehen.

Oder Sie klicken mit der rechten Maustaste auf die Datei und wählen Sie aus dem Menü Open with > LilyPond.

Schritt 2b: Kompilieren (mit Doppelklick)

Sie können auch einfach die Datei ‘test.ly’ doppelt anklicken.

3. Schritt: Ausgabe anschauen

Während der Kompilation von ‘test.ly’ öffnet sich ein Kommandofenster sehr schnell und schließt sich wieder. Drei zusätzliche Dateien werden in diesem Schritt erstellt.

Das PDF enthält den Notensatz aus der Datei ‘test.ly’.

Andere Befehle

Um eine neue Datei zu erstellen, wählen Sie File > New aus irgendeiner schon erstellten Datei oder File > Open, um eine Datei zu öffnen und zu bearbeiten, die Sie schon vorher gespeichert hatten.

Sie müssen jede neue Änderung erst speichern, bevor Sie die Datei kompilieren. Wenn kein PDF erstellt wird, öffnen Sie die Log-Datei und schauen Sie nach Fehlern.

Die Log-Datei wird jedes Mal überschrieben, wenn Sie Ihre LilyPond-Datei kompilieren.

Die PS-Datei wird intern von LilyPond benutzt um das PDF zu erstellen und kann ignoriert werden. Sie wird auch jedes Mal neu überschrieben.

Wenn Sie das PDF in einem PDF-Programm anschauen, müssen Sie es zuerst schließen, bevor Sie eine neue Kompilation durchführen können, denn es kann einen Fehler bei der Erstellung des neuen PDFs geben, wenn das alte noch geöffnet ist.

1.1.4 Kommandozeile

@translationof Command-line

Schritt 1: Erstellen Sie eine ‘.ly’-Datei

Erstellen Sie eine Text-Datei mit dem Namen ‘test.ly’ und geben Sie folgenden Text ein:

\version "2.20.0"
{
  c' e' g' e'
}

Schritt 2: Kompilieren (auf der Kommandozeile)

Um die Datei zu kompilieren, geben sie an der Konsole bzw. Kommandozeile

lilypond test.ly

ein. Sie werden ungefähr folgende Meldungen sehen:

lilypond test.ly
GNU LilyPond  2.20.0
»test.ly« wird verarbeitet
Analysieren...
Interpretation der Musik...
Vorverarbeitung der grafischen Elemente...
Ideale Seitenanzahl wird gefunden...
Musik wird auf eine Seite angepasst...
Systeme erstellen...
Layout nach »test.ps« ausgeben...
Konvertierung nach »test.pdf«...
Erfolg: Kompilation erfolgreich beendet

3. Schritt: Ausgabe anschauen

Als Ergebnis erhalten Sie ein ‘test.pdf’, das Sie mit den Standardprogrammen Ihres Betriebssystemes anschauen können.

Dieses Dokument wurde erzeugt von gub am 13. Juli 2020 durch texi2html 1.82.

Andere Sprachen: English, català, česky, español, français, magyar, italiano, 日本語, nederlands.
Über die automatische Sprachauswahl.