@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 3237f4afc77b528ca92ca6d68664bd80e39d9e76
+ Translation of GIT committish: 718cc970304f6b9a3bb990259a048c06e56f4e48
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
Format dient als die formale Definition eines Musiktextes.
Die Syntax ist gleichzeitig die Benutzerschnittstelle bei LilyPond,
-darum soll sie einfach zu schreiben sein; z. B. bedeutet
+darum soll sie einfach zu schreiben sein; z. B. bedeutet
@example
c'4 d'8
@node About this manual
@section About this manual
-Das Handbuch ist in folgende Kapitel gegliedert:
+Es gibt zwei Handbücher zu LilyPond: das @emph{Benutzerhandbuch} (dieses
+Dokument) und das @emph{Handbuch über die Programmbenutzung}.
+
+
+@subheading User manual
+
+Das Handbuch ist in drei Bücher geteilt.
+
+@subsubheading Learning manual
+
+In diesem Buch wird erklärt, wie man das Programm LilyPond erlernt; mit
+einfachen Begriffen werden einige Schlüsselkonzepte erklärt. Die Kapitel
+sollten hintereinander gelsen werden.
+
@itemize @bullet
@item
@ifhtml
Die
@end ifhtml
-@emph{@ref{Tutorial}}
+@emph{@ref{Tutorial}},
stellt eine einfache Einführung in den Musiksatz dar. Neulinge sollten hiermit
beginnen.
@item
-@emph{@ref{Putting it all together}}
+@emph{@ref{Putting it all together}},
erklärt generelle Konzepte des LilyPond-Dateiformates. Wenn Sie sich nicht
sicher sind, wohin ein Befehl gesetzt werden soll, lesen Sie hier nach.
@item
-@emph{@ref{Working on LilyPond projects}}
+@emph{@ref{Working on LilyPond projects}},
zeigt den wirklichen Einsatz von LilyPond und gibt Hinweise, wie einige
Probleme vermieden werden können.
@item
-@emph{@ref{Tweaking output}}
+@emph{@ref{Tweaking output}},
stellt dar, wie die Standardeinstellungen von LilyPond verändert werden können.
+
+@end itemize
+
+
+@subsubheading 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
+Grundkonzeption des Programmes im Handbuch zum Lernen bekannt gemacht hat.
+
+@itemize @bullet
@item
-@emph{@ref{Basic notation}}
+@emph{@ref{Basic notation}},
erklärt alles über die grundlegenden Notationskonstruktionen. Dieses Kapitel
ist für fast jedes Notationsprojekt nützlich.
@item
-@emph{@ref{Instrument-specific notation}}
+@emph{@ref{Instrument-specific 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.
@item
-@emph{@ref{Advanced notation}}
+@emph{@ref{Advanced notation}},
erklärt komplizierte oder unübliche Anwendungen nach Notationsgegenstand geordnet.
@item
-@emph{@ref{Changing defaults}}
+@emph{@ref{Changing defaults}},
erklärt, wie des Layout getrimmt werden kann.
@item
-@emph{@ref{Non-musical notation}}
+@emph{@ref{Non-musical 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.
@item
-@emph{@ref{Spacing issues}}
+@emph{@ref{Spacing issues}},
befasst sich mit globalen Fragen wie der Definition von Papierformaten
oder wie man Seitenumbrüche definiert.
@item
-@emph{@ref{Interfaces for programmers}}
+@emph{@ref{Interfaces for programmers}},
demonstriert die Erstellung von musikalischen Funktionen.
+@end itemize
-@item
-@emph{@ref{Running LilyPond}}
-zeigt, wie LilyPond und die Hilfsprogramme gestartet werden. Zusätzlich
-wird hier gezeigt, wie Quelldateien von älteren LilyPond-Versionen
-aktualisiert werden können.
-@item
-@emph{@ref{LilyPond-book}}
-zeigt die Details der Integration von Noten in Texte wie etwa dieses
-Handbuch.
+@subsubheading Appendices
-@item
-@emph{@ref{Converting from other formats}}
-erklärt die Funktionsweise der Konvertierungsprogramme. Diese Programme
-sind im LilyPond-Paket enthalten und können ein ganze Anzahl von Formaten
-in das @code{.ly}-Format umwandeln.
+In diesem Buch werden nützliche Referenztabellen gezeigt.
+@itemize @bullet
@item
@ifhtml
Die
@end ifhtml
-@emph{@ref{Literature list}}
+@emph{@ref{Literature list}},
enthält einige wichtige Quellen für alle, die mehr über Notation und
den Notensatz erfahren wollen.
@item
-Das
-@emph{@ref{Scheme tutorial}}
+Die
+@emph{@ref{Scheme tutorial}},
stellt eine kurze Einleitung in die Scheme-Sprache dar, mit dem
die musikalischen Funktionen gebildet werden.
@item
-@emph{@ref{Notation manual tables}}
+@emph{@ref{Notation manual tables}},
sind Tabellen, in denen Akkordbezeichnungen, MIDI-Instrumente,
Farbbezeichnungen und die Zeichen der Feta-Schriftart gesammelt sind.
@item
-@emph{@ref{Templates}}
+@emph{@ref{Templates}},
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!
@item
Die
-@emph{@ref{Cheat sheet}}
+@emph{@ref{Cheat sheet}},
zeigt die wichtigsten LilyPond-Befehle.
@item
Der
-@emph{@ref{LilyPond command index}}
+@emph{@ref{LilyPond command index}},
listet alle Befehle auf, die mit @code{\} anfangen.
@item
Der
-@emph{@ref{LilyPond index}}
+@emph{@ref{LilyPond index}},
ist ein vollständiger Index.
@end itemize
-Wenn Sie etwas Erfahrung gesammelt haben, können Sie das Handbuch als
-Referenz benutzen, denn es hat einen sehr guten Index@footnote{Wenn Sie
-nach etwas suchen und es nicht im Handbuch finden, gilt das als Fehler des
-Handbuches. In diesem Fall geben Sie bitte einen Hinweis!}, aber es ist
-auch als
-@iftex
-eine große HTML-Seite,
-@end iftex
-@ifhtml
-@uref{source/Documentation/user/lilypond.html, eine große Seite},
-@end ifhtml
-erhältlich, die einfach mit der Suchfunktion des Browsers durchsucht werden kann.
-@cindex Suche im Handbuch
-@cindex Benutzung des Handbuchs
-@c FIXME:
-@c add/integrate glossary, put in list above
-Wenn Sie auf musikalische Begriffen stoßen, die Ihnen nicht geläufig sind, kann
-vielleicht das Glossar helfen.
+@subheading Program usage
-@iftex
-Hier werden die wichtigsten Begriffe auf englisch erklärt und in eine Reihe
-von Sprachen übersetzt, sodass sie auch auf deutsch gefunden werden. Es ist ein
-eigenes Dokument, das als HTML- oder PDF-Datei geladen werden kann.
-@end iftex
-@ifnottex
-Im @ref{Top,Glossar musikalischer Begriffe,,music-glossary} 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.
-@end ifnottex
+In diesem Buch wird erklärt, wie das Programm ausgeführt wird und
+wie die Notation von LilyPond in andere Programme integriert werden
+kann.
+
+@itemize @bullet
+
+@item
+@emph{@rprogram{Install}},
+erklärt wie LilyPond installiert wird (inclusive Kompilation, wenn es
+nötig sein sollte).
+
+@item
+@emph{@rprogram{Setup}},
+erklärt wie der Computer eingerichtet wird, damit LilyPond optimal genutzt
+werden kann. Hierzu gehören etwa spezielle Umgebungen für bestimmte
+Texteditoren.
+
+@item
+@emph{@rprogram{Running LilyPond}},
+zeigt, wie LilyPond und seine Hilfprogramme gestartet werden. Zusätzlich
+wird hier erklärt, wie Quelldateien von alten LilyPond-Versionen aktualisiert
+werden können.
+
+@item
+@emph{@rprogram{LilyPond-book}},
+erklärt die Details, um einen Text mit eingefügten Notenbeispielen (wie
+etwa dieses Handbuch) zu
+erstellen.
+
+@item
+@emph{@rprogram{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 @code{.ly}-Format.
+
+@end itemize
+
+
+@subsubheading Other information
+
+Es gibt einige andere Orte, die sehr wertvolle Information enthalten.
+@itemize @bullet
@cindex Dialekt
@cindex Jargon
@cindex Terminologie
@cindex Sprache
@cindex Englische Begriffe
-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:
+@item
+@ifnottex
+Das @ref{Top,Musik-Glossar,,music-glossary}, erklärt musikalische Ausdrücke
+und stellt Übersetzungen für einige Sprachen bereit. Es ist auch als PDF
+erhältlich.
+@end ifnottex
+@iftex
+Das Musik-Glossar erklärt musikalische Ausdrücke
+und stellt Übersetzungen für einige Sprachen bereit. Es ist auch als PDF
+erhältlich.
+@end iftex
+Wenn Sie sich mit der Notation von Musik nicht auskennen (und besonders,
+wenn Englisch nicht Ihre Muttersprache ist), wird dieses Glossar von
+großer Hilfe sein.
+
+@cindex Schnipsel
+@cindex LSR
+@item
+Die
+@ifhtml
+@uref{source/input/lsr/collated-files.html,Schnipsel}
+@end ifhtml
+@ifnothtml
+Schnipsel
+@end ifnothtml
+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
+ @uref{http://lsr.dsi.unimi.it/,LilyPond Schnipsel
+Depot} betrachtet werden. Diese Internetseite verfügt auch über ein
+durchsuchbares LilyPond-Handbuch.
+
-@itemize @bullet
@item
+Die
@iftex
Programmreferenz
@end iftex
@ifnottex
-@ref{Top,Programmreferenz,,lilypond-internals}.
+@ref{Top,Programmreferenz,,lilypond-internals}
@end ifnottex
-
-Die Programmreferenz ist eine Sammlung intensiv verlinkter HTML-Seiten,
+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.
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.
+alle haben einen @qq{Siehe}-Abschnitt, der auf die Dokumentation verweist.
Im HTML-Handbuch haben diese Abschnitte klickbare Links.
Die Programmreferenz ist nur auf englisch erhältlich.
-@cindex Schnipsel
-@item
-@ifnothtml
-Verschiedene Quelltextbeispiele.
-@end ifnothtml
-@ifhtml
-@c Works, but link name is not so nice; so write-out macro
-@c @inputfileref{input/test,Various input examples}.
-@uref{source/input/test/collated-files.html,Verschiedene Quelltextbeispiele}.
-@end ifhtml
-
-Diese Dateisammlung zeigt einige Tricks und ist als eine große
-HTML-Datei herunterladbar. Notenbilder und Erklärungen sind enthalten.
+@end itemize
-@item
-@ifnothtml
-Die Regressionstests.
-@end ifnothtml
+Wenn Sie schon ein erfahrener Benutzer sind, können Sie dieses Handbuch
+als Referenz benutzen: Es enthält einen ausführlichen Index@footnote{Wenn
+Sie nach etwas suchen und es nicht im Handbuch finden, so gilt das als Fehler.
+Bitte schicken Sie in diesem Fall einen Fehlerbericht.}, aber das Dokument
+ist auch als
+@iftex
+große HTML-Seite erhältlich,
+@end iftex
@ifhtml
-@c Works, but link name is not so nice; so write-out macro
-@c @inputfileref{input/regression,The regression tests}.
-@uref{source/input/regression/collated-files.html,Die Regressionstests}.
+@uref{source/Documentation/user/lilypond-big-page.html, eine große Seite
+erhältlich},
@end ifhtml
-
-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.
-@end itemize
+die auf einfache Art mit der Suchfunktion Ihres Browsers durchsucht werden kann.
Auf allen HTML-Seiten, die Noten eingebettet haben, deren Ausgabe mit LilyPond
vorgenommen wurde, kann die originale Quelldatei durch einen Klick auf das
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 @file{input/@/test/@/bla@/.ly} etwa auf die Datei
-@file{lilypond@/2.x.y/@/input/@/test/@/bla@/.ly} verweisen. In den
+der Pfad @file{input/@/lsr/@/Verzeichnis/@/bla@/.ly} etwa auf die Datei
+@file{lilypond@/2.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 @file{/usr/@/share/@/doc/@/lilypond/}
gespeichert. Initialisierungsdateien, etwa @file{scm/@/lily@/.scm},