GNU LilyPond Handbuch zum Lernen: 1.2 About the documentation

## 1.2 About the documentation

Die Dokumentation zu LilyPond ist unterteilt in mehrere Handbücher.

### About the Learning Manual

Dieses Handbuch erklärt die Grundbegriffe von LilyPond und stellt die fundamentalen Konzepte hinter dem Programm vor. Diese Kapitel sollten in linearer Reihenfolge gelesen werden.

Am Ende jedes Abschnitts findet sich ein Absatz Siehe auch, der Kreuzreferenzen zu anderen Abschnitten enthält. Beim ersten Durchlesen empfiehlt es sich nicht, diesen gleich zu folgen, da meist noch zahlreiche Grundbegriffe zum Verständnis fehlen. Wenn Sie sich durch das Handbuch zum Lernen geackert haben, wollen Sie vielleicht einzelne Abschnitte nochmal durchgehen und dann den Kreuzverweisen zur Vertiefung der Zusammenhänge folgen.

- Introduction: erklärt den Hintergrund und das Ziel von LilyPond.
- Tutorial: liefert eine einfache Einführung in das Setzen von Musik mit LilyPond. Neulinge sollten mit diesem Kapitel beginnen.
- Fundamental concepts: erklärt etliche allgemeine Konzepte hinter dem Dateiformat von LilyPond. Wenn Sie sich nicht sicher sind, an welcher Stelle Sie einen Befehl in die Datei einfügen sollen, ist dieses Kapitel genau das richtige!
- Tweaking output: stellt dar, wie die Standardeinstellungen von LilyPond verändert werden können.
- Working on LilyPond projects: liefert Tipps im praktischen Umgang mit Lilypond und gibt Hinweise, wie gängige Fehler vermieden werden können. Bevor Sie mit einem großen Projekt beginnen, sollten Sie dieses Kapitel unbedingt gelesen haben!

Das Handbuch zum Lernen enthält auch zahlreiche Anhänge, die nicht zum linearen Durchlesen geeignet sind. Sie sind allerdings zur späteren Referenz sehr gut geeignet:

- Templates: zeigt einige fertige Dokumentvorlagen für diverse Stücke mit unterschiedlichen Charakteristika. Kopieren Sie einfach die Vorlagen in Ihre eigene Datei, fügen Sie die Noten hinzu und Sie sind fertig!
- Scheme tutorial: liefert eine kurze Einführung in Scheme, die Programmiersprache, die die Musikfunktionen in LilyPond intern benutzen. Dies stellt tiefgehendes Wissen dar, wenn Sie LilyPond bis ins kleinste Detail konfigurieren möchten. Die meisten Benutzer brauchen dies jedoch selten bis gar nicht.

### About the Music Glossary

Das Glossar erklärt musikalische Fachausdrücke und enthält auch deren Übersetzungen in diverse Sprachen. Wenn Sie mit Musiknotation oder der (englisch-sprachigen) Musikterminologie nicht vertraut sind (vor allem, wenn Englisch nicht Ihre Muttersprache ist), ist es sehr empfehlenswert, das Glossar immer wieder zu Rate zu ziehen.

### About the Notation Reference

In diesem Buch werden alle LilyPond-Befehle erklärt, die Notationszeichen produzieren. Es geht von der Annahme aus, dass der Leser sich mit den Grundkonzepten des Programmes im Handbuch zum Lernen bekannt gemacht hat.

- Musical notation: erklärt alles über die grundlegenden Notationskonstruktionen. Dieses Kapitel ist für fast jedes Notationsprojekt nützlich.
- Specialist 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.
- General input and output: erläutert allgemeine Informationen über die Eingabedateien von Lilypond und wie die Ausgabe gesteuert werden kann.
- Spacing issues: befasst sich mit globalen Fragen wie der Definition von Papierformaten oder wie man Seitenumbrüche definiert.
- Changing defaults: erklärt, wie des Layout getrimmt werden kann um genau zum gewünschten Ergebnis zu kommen.
- Interfaces for programmers: demonstriert die Erstellung von musikalischen Funktionen.

Ds Benutzerhandbuch enthält auch Anhänge mit nützlichen Referenztabellen.

- Die Literature list enthält einige wichtige Quellen für alle, die mehr über Notation und den Notensatz erfahren wollen.
- Notation manual tables sind Tabellen, in denen Akkordbezeichnungen, MIDI-Instrumente, Farbbezeichnungen und die Zeichen der Feta-Schriftart gesammelt sind.
- Die Cheat sheet zeigt die wichtigsten LilyPond-Befehle.
- Der LilyPond command index listet alle Befehle auf, die mit `\` anfangen.
- Der LilyPond index ist ein vollständiger Index.

### About the Application Usage

In diesem Buch wird erklärt, wie das Programm ausgeführt wird und wie die Notation von LilyPond in andere Programme integriert werden kann.

- Install: erklärt wie LilyPond installiert wird (inklusive Kompilation, wenn es nötig sein sollte).
- Setup: erklärt wie der Computer eingerichtet wird, damit LilyPond optimal genutzt werden kann. Hierzu gehören etwa spezielle Umgebungen für bestimmte Texteditoren.
- Running LilyPond: zeigt, wie LilyPond und seine Hilfsprogramme gestartet werden. Zusätzlich wird hier erklärt, wie Quelldateien von alten LilyPond-Versionen aktualisiert werden können.
- LilyPond-book: erklärt die Details, um einen Text mit eingefügten Notenbeispielen (wie etwa dieses Handbuch) zu erstellen.
- Converting from other formats: erklärt, wie die Konvertierungsprogramme aufgerufen werden. Diese Programme kommen mit LilyPond zusammen und konvertieren eine Vielzahl von Notensatzformaten in das `.ly`-Format.

### About the Snippet List

Die LilyPond-Schnipsel sind eine ausführliche Sammlung kurzer Beispiele, anhand derer Tricks, Tipps und Spezialfunktionen von LilyPond demonstriert werden. Die meisten dieser Schnipsel können auch im LilyPond-Schnipsel-Depot betrachtet werden. Diese Internetseite verfügt auch über ein durchsuchbares LilyPond-Handbuch.

Die Liste der Schnipsel zu einem Abschnitt des Benutzerhandbuchs ist auch dort jeweils im Abschnitt Siehe auch verlinkt.

### About the Internals Reference

Die Referenz der Interna 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 im Quellcode 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 „Siehe“-Abschnitt, der auf die Dokumentation verweist. Im HTML-Handbuch haben diese Abschnitte klickbare Links.

Die Programmreferenz ist nur auf englisch verfügbar.

### Other documentation

Es gibt noch eine Reihe weiterer wertvoller Informationsquellen zu LilyPond:

- Neuigkeiten: eine Zusammenfassung der Änderungen in LilyPond seit der letzten Version.
- Das Archiv der lilypond-user Mailing-Liste: enthält alle bisher an die Liste gesendeten Mails. Viele Fragen werden immer wieder gestellt und auch beantwortet. Die Chance, dass Ihre Frage auch schon mal aufgetaucht ist, ist also relativ groß. In diesem Fall finden Sie die Antwort in diesem Archiv.
- Das Archiv der lilypond-devel Mailing-Liste: enthält alle bisher an die Entwicklerliste gesendeten Mails. Diese Diskussionen sind dementsprechend technisch gehalten. Wenn Sie eine tiefergehende Frage zu den Interna von LilyPond haben, finden Sie die Antwort vielleicht in diesem Archiv.
- Eingebettete Musikbeispiele: Auf allen HTML-Seiten mit Notenbeispielen, die von LilyPond erzeugt wurden, kann die originale Quelldatei durch einen Klick auf das Bild betrachtet werden.
- Initialisierungsdateien von LilyPond:

  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/lsr/Verzeichnis/bla.ly`’ etwa auf die Datei ‘`lilypond2.x.y/input/lsr/Verzeichnis/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/`’.

  Weiterführende Informationen finden Sie unter Other sources of information.

Other languages: English, français, español.

#### Handbuch zum Lernen