1.6 Über das Handbuch

Das Handbuch ist in folgende Kapitel gegliedert:

• Die Übung stellt eine einfache Einführung in den Musiksatz dar. Neulinge sollten hiermit beginnen.
• Alles zusammenfügen erklärt generelle Konzepte des LilyPond-Dateiformates. Wenn Sie sich nicht sicher sind, wohin ein Befehl gesetzt werden soll, lesen Sie hier nach.
• An LilyPond-Projekten arbeiten zeigt den wirklichen Einsatz von LilyPond und gibt Hinweise, wie einige Probleme vermieden werden können.
• Die Ausgabe verändern stellt dar, wie die Standardeinstellungen von LilyPond verändert werden können.
• Grundlegende Notation erklärt alles über die grundlegenden Notationskonstruktionen. Dieses Kapitel ist für fast jedes Notationsprojekt nützlich.
• Instrumentenspezifische Notation erklärt spezifische Schwierigkeiten, die sich bei bestimmten Notationstypen ergeben. Dieses Kapitel ist nur in entsprechenden Fällen bestimmter Instrumente oder bei Gesang zu konsultieren.
• Fortgeschrittene Notationstechniken erklärt komplizierte oder unübliche Anwendungen nach Notationsgegenstand geordnet.
• Standardeinstellungen verändern erklärt, wie des Layout getrimmt werden kann.
• Nichtmusikalische Notation zeigt alles, was nicht direkt mit den Noten zu tun hat wie Titel, mehrere Sätze oder wie man ein MIDI-Instrument auswählt.
• Abstände befasst sich mit globalen Fragen wie der Definition von Papierformaten oder wie man Seitenumbrüche definiert.
• Schnittstellen für Programmierer demonstriert die Erstellung von musikalischen Funktionen.
• LilyPond starten zeigt, wie LilyPond und die Hilfsprogramme gestartet werden. Zusätzlich wird hier gezeigt, wie Quelldateien von älteren LilyPond-Versionen aktualisiert werden können.
• LilyPond-book zeigt die Details der Integration von Noten in Texte wie etwa dieses Handbuch.
• Von anderen Formaten konvertieren erklärt die Funktionsweise der Konvertierungsprogramme. Diese Programme sind im LilyPond-Paket enthalten und können ein ganze Anzahl von Formaten in das .ly-Format umwandeln.
• Die Literatur enthält einige wichtige Quellen für alle, die mehr über Notation und den Notensatz erfahren wollen.
• Das Scheme-Übung stellt eine kurze Einleitung in die Scheme-Sprache dar, mit dem die musikalischen Funktionen gebildet werden.
• Notationsübersicht sind Tabellen, in denen Akkordbezeichnungen, MIDI-Instrumente, Farbbezeichnungen und die Zeichen der Feta-Schriftart gesammelt sind.
• Vorlagen von LilyPond-Stücken. Kopieren Sie einfach hier, fügen Sie in ihre Datei ein und schreiben Sie noch die Noten dazu. Das ist alles!
• Die Befehlsübersicht zeigt die wichtigsten LilyPond-Befehle.
• Der Index der LilyPond-Befehle listet alle Befehle auf, die mit \ anfangen.
• Der LilyPond-Index ist ein vollständiger Index.

Wenn Sie etwas Erfahrung gesammelt haben, können Sie das Handbuch als Referenz benutzen, denn es hat einen sehr guten Index¹, aber es ist auch als eine große Seite, erhältlich, die einfach mit der Suchfunktion des Browsers durchsucht werden kann. Wenn Sie auf musikalische Begriffen stoßen, die Ihnen nicht geläufig sind, kann vielleicht das Glossar helfen.

Im Glossar musikalischer Begriffe werden die wichtigsten Begriffe auf englisch erklärt und in eine Reihe von Sprachen übersetzt, sodass sie auch auf deutsch gefunden werden. Es gibt es auch als PDF. Dieses Handbuch ist ohne eine Reihe anderer Dokumente nicht vollständig. Sie sind nicht in gedruckter Form erhältlich, aber sollten in dem Dokumentationspaket für Ihr Betriebssystem enthalten sein:

• Programmreferenz.

  Die Programmreferenz ist eine Sammlung intensiv verlinkter HTML-Seiten, die alle Details jeder einzelnen LilyPond-Klasse, jedes Objektes und jeder Funktion erklären. Sie wird direkt aus den Satzdefinitionen produziert.

  So gut wie alle Formatierungsmöglichkeiten, die intern verwendet werden, sind auch direkt für den Benutzer zugänglich. Alle Variablen z. B., die Dicke-Werte, Entfernungen usw. kontrollieren, können in den Eingabe-Dateien verändert werden. Es gibt eine riesige Anzahl von Formatierungsoptionen, und alle haben einen ‚See also‘-Abschnitt, der auf die Dokumentation verweist. Im HTML-Handbuch haben diese Abschnitte klickbare Links.

  Die Programmreferenz ist nur auf englisch erhältlich.

• Verschiedene Quelltextbeispiele.

  Diese Dateisammlung zeigt einige Tricks und ist als eine große HTML-Datei herunterladbar. Notenbilder und Erklärungen sind enthalten.

• Die Regressionstests.

  Diese Dateisammlung testet jede Notations- und Satzeigenschaft von LilyPond in einer besonderen Datei. Die Sammlung ist vor allem da, um die Fehlersuche zu vereinfachen, aber sie kann sehr informativ sein, um zu sehen, wie wir das Programm entwickeln. Das Format entspricht dem der Tipps-Seite.

Auf allen HTML-Seiten, die Noten eingebettet haben, deren Ausgabe mit LilyPond vorgenommen wurde, kann die originale Quelldatei durch einen Klick auf das Bild betrachtet werden.

Der Speicherort der Dokumentationsdateien unterscheidet sich evtl. je nach Betriebssystem. Manchmal wird hier auf Initialisierungs- oder Beispieldateien verwiesen. Das Handbuch nimmt dabei an, dass diese Dateien sich relativ zum Quellverzeichnis befinden. Zum Beispiel würde der Pfad input/test/bla.ly etwa auf die Datei lilypond2.x.y/input/test/bla.ly verweisen. In den Binärpaketen für Unix-Plattformen sind Dokumentation und Beispiele üblicherweise in einem Verzeichnis wie /usr/share/doc/lilypond/ gespeichert. Initialisierungsdateien, etwa scm/lily.scm, oder ly/engraver-init.ly, befinden sich normalerweise im Verzeichnis /usr/share/lilypond/.

Dieses Handbuch (so wie alle anderen) ist als PDF- oder HTML-Datei von LilyPonds Internetseite http://www.lilypond.org/ herunterladbar.

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