@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@ignore
- Translation of GIT committish: 354f8ea159bb5216202e5815685fca8bd7e6919c
+ Translation of GIT committish: 8819d7cb0ba2ab359e4aa2276695afb9c1957c42
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.13.4"
-@c Translators: Till Paala, Reinhold Kainhofer
+@include included/generating-output.itexi
+
+@c \version "2.19.21"
+@c Translators: Till Paala, Reinhold Kainhofer, Michael Gerdau
@c Translation checkers: Hajo Bäß
-@node Übung
-@chapter Übung
+@node Tutorium
+@chapter Tutorium
@translationof Tutorial
Dieses Kapitel stellt dem Leser das grundlegende Arbeiten mit LilyPond
@menu
* Eine Quelldatei übersetzen::
-* Arbeiten an Eingabe-Dateien::
-* Wie soll das Handbuch gelesen werden::
+* Wie werden Eingabe-Dateien geschrieben::
+* Fehlerbehandlung::
+* Wie die Handbücher gelesen werden sollten::
@end menu
-
@node Eine Quelldatei übersetzen
-@subsection Eine Quelldatei übersetzen
+@section Eine Quelldatei übersetzen
@translationof Compiling a file
Dieser Abschnitt führt in die @qq{Kompilation} ein -- den
haben) um eine Ausgabedatei zu erstellen.
@menu
-* Noten eingeben::
-* MacOS X::
-* Windows::
-* Kommandozeile::
+* Noten eingeben::
+* MacOS X::
+* Windows::
+* Kommandozeile::
@end menu
@node Noten eingeben
@cindex Großbuchstaben
@cindex Kleinbuchstaben
+@menu
+* Ausgabe erzeugen::
+@end menu
+
@qq{Kompilation} ist der Begriff, der benutzt wird, um eine
-Lilypond-Eingabedatei mit dem Programm LilyPond in 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
die Klammern in manchen Beispielen fehlen, aber man sollte
immer daran denken, sie in den eigenen Dateien zu benutzen!
Mehr Informationen zu der Darstellung der Beispiele in diesem
-Handbuch gibt der Abschnitt @ref{Wie soll das Handbuch gelesen werden}.}
+Handbuch gibt der Abschnitt @ref{Wie die Handbücher gelesen werden sollten}.}
Zusätzlich unterscheidet LilyPond @strong{Groß- und Kleinschreibung}.
-@w{@code{ @{ c d e @}}} ist zulässiger Code,
-@w{@code{ @{ C D E @}}} dagegen resultiert in einer Fehlermeldung.
+@w{@samp{ @{ c d e @}}} ist zulässiger Code,
+@w{@samp{ @{ C D E @}}} dagegen resultiert in einer Fehlermeldung.
@smallspace
-@subheading Ansicht des Ergebnisses
+@node Ausgabe erzeugen
+@unnumberedsubsubsec Ausgabe erzeugen
+@translationof Producing output
@cindex PDF-Datei
@cindex Noten anzeigen
@end itemize
-Beachten Sie, dass es eine Reihe an Texteditoren mit besserer
+Beachten Sie, dass es eine Reihe an Texteditoren mit besserer
Unterstützung für LilyPond gibt. Mehr dazu im Abschnitt
-@rprogram{Unterstützung von Texteditoren}.
-@c FIXME: link to @rweb{Alternate input}
+@rweb{Leichteres Editieren}.
-@warning{Das erste Mal, wenn Sie LilyPond benutzen, kann es eine
+@warning{Das erste Mal, wenn Sie LilyPond benutzen, kann es eine
Minute oder länger dauern, weil das Programm zuerst alle Schriftarten,
-die auf dem System zur Verfügung stehen, untersucht. Aber nach
+die auf dem System zur Verfügung stehen, untersucht. Aber nach
diesem ersten Mal läuft LilyPond sehr viel schneller.}
+
@node MacOS X
@subsection MacOS X
@translationof MacOS X
-@warning{Diese Anweisungen gehen davon aus, dass Sie die
-LilyPond-Application benutzen. Wenn Sie eins der Programme benutzen, die in @rweb{Leichteres Editieren} beschrieben sind, schauen
-Sie bitte in der Dokumentation nach, wenn Sie Probleme damit haben,
-eine Datei zu kompilieren.}
-
-
-@subsubheading 1. Schritt: Erstellen Sie eine @file{.ly}-Datei
-
-Wenn Sie das @command{LilyPond.app}-Symbol doppelt klicken, öffnet
-sich eine Beispiel-Datei.
-
-@sourceimage{Learning_Macos_welcome,,,}
-
-Wählen Sie aus den Menüs oben links auf Ihrem Bildschirm
-@w{@code{File > Save}}.
-
-@sourceimage{Learning_Macos_Save_menu,,,}
-
-Wählen Sie einen Namen für die Datei, etwa @file{test.ly}.
-
-@sourceimage{Learning_Macos_Save_file_with_name,,,}
-
-
-@subsubheading 2. Schritt: Kompilieren (mit LilyPad)
-
-Aus den selben Menüs wählen Sie jetzt @w{@code{Compile > Tyepset}}.
-
-@sourceimage{Learning_Macos_Typeset_menu,,,}
-
-Ein neues Fenster öffnet sich, in dem ein Forschrittslog der
-Kompilation der von ihnen gerade gespeicherten Datei gezeigt
-wird.
-
-@sourceimage{Learning_Macos_Compiling_log,,,}
-
-@subsubheading 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.
-
-@sourceimage{Learning_Macos_pdf_output,,,}
-
-
-@subsubheading Andere Befehle
-
-Um neue LilyPond-Dateien zu erstellen beginnen sie mit
-@w{@code{File > New}}
-
-@sourceimage{Learning_Macos_New_menu,,,}
-
-@noindent
-oder @w{@code{File > Open}} um eine schon existierende Datei zu
-öffnen und zu editieren.
-
-@sourceimage{Learning_Macos_Open_menu,,,}
-
-Sie müssen alle Änderungen an der Datei zuerst speichern, bevor Sie
-wieder @w{@code{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.
+@cindex Starten des Programms, MacOS X
+@cindex MacOS X, LilyPond starten
+@lilypadOSX
-@cindex Windows, LilyPond starten
@node Windows
@subsection Windows
@translationof Windows
-@warning{Diese Anweisungen gehen davon aus, dass Sie den installierten
-LilyPad-Editor benutzen. Wenn Sie eins der Programme benutzen, die in @rweb{Alternate input} beschrieben sind, schauen
-Sie bitte in der Dokumentation nach, wenn Sie Probleme damit haben,
-eine Datei zu kompilieren.}
-
-@subsubheading 1. Schritt: Erstellen Sie eine @file{.ly}-Datei
-
-Wenn sie auf das LilyPond-Symbol auf dem Desktop doppelklicken,
-öffnet sich ein einfacher Texteditor mit einer Beispieldatei.
-
-@sourceimage{Learning_Win7_Welcome_File_Whole,,,}
-
-Aus dem Menü über der Beispieldatei wählen Sie @w{@code{File > Save as}}.
-Benutzen Sie nicht @w{@code{File > Save}} für die Beispieldatei,
-weil die Datei nicht funktioniert, bis Sie sie mit einem eigenen
-Namen gespeichert haben.
-
-@sourceimage{Learning_Win7_Save_Menu,,,}
-
-Wählen Sie einen Namen für Ihre Datei, etwa @file{test.ly}.
-
-@sourceimage{Learning_Win7_Save_File_With_Name,,,}
-
-
-@subsubheading 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.
-
-@sourceimage{Learning_Win7_Open_Dragndrop,,,}
-
-Klicken Sie mit der rechten Maustaste auf die Datei und wählen
-Sie aus dem Menü @w{@code{Open with > LilyPond}}.
-
-@sourceimage{Learning_Win7_Open_Context_Menu,,,}
-
-
-@subsubheading Schritt 2b: Kompilieren (mit Doppelklick)
-
-Oder klicken Sie einfach die Datei @file{test.ly} doppelt an.
-
-
-@subsubheading 3. Schritt: Ausgabe anschauen
-
-Während der Kompilation von @file{test.ly} öffnet sich ein
-Kommandofenster sehr schnell und schließt sich wieder. Drei
-zusätzliche Dateien werden in diesem Schritt erstellt.
-
-@sourceimage{Learning_Win7_All_Files_Created,,,}
-
-Das PDF enthält den Notensatz aus der Datei @file{test.ly}.
-
-@sourceimage{Learning_Win7_Pdf_Output,,,}
-
-
-@subsubheading Andere Befehle
-
-Um eine neue Datei zu erstellen, wählen Sie @w{@code{File > New}}
-aus irgendeiner schon erstellten Datei.
-
-@sourceimage{Learning_Win7_New_Menu,,,}
-
-@noindent
-oder @w{@code{File > Open}}, um eine Datei zu öffnen und zu
-bearbeiten, die Sie schon vorher gespeichert hatten.
-
-@sourceimage{Learning_Win7_Open_Menu,,,}
-
-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.
-
-@sourceimage{Learning_Win7_Log_File,,,}
-
-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.
+@cindex Windows, LilyPond starten
+@lilypadWindows
-@cindex Unix, LilyPond starten
@node Kommandozeile
@subsection Kommandozeile
@translationof Command-line
-@warning{Diese Anweisungen gehen davon aus, dass Sie den installierten
-LilyPad-Editor benutzen. Wenn Sie eins der Programme benutzen, die in @rweb{Alternate input} beschrieben sind, schauen
-Sie bitte in der Dokumentation nach, wenn Sie Probleme damit haben,
-eine Datei zu kompilieren.}
-
-@subsubheading Schritt 1: Erstellen Sie eine @file{.ly}-Datei
-
-
-Erstellen Sie eine Text-Datei mit dem Namen @file{test.ly} und
-geben Sie folgenden Text ein:
-
-@example
-@{
- c' e' g' e'
-@}
-@end example
-
-@subsubheading Schritt 2: Kompilieren (auf der Kommandozeile)
-
-Um die Datei zu kompilieren, geben sie an der Konsole bzw. Kommandozeile
-
-@example
-lilypond test.ly
-@end example
-
-@noindent
-ein.
-Sie werden ungefähr folgende Meldungen sehen:
-
-
-@example
-lilypond test.ly
-GNU LilyPond @version{}
-»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«...
-@end example
-
-@subsubheading 3. Schritt: Ausgabe anschauen
-
-Als Ergebnis erhalten Sie ein @file{test.pdf}, das Sie mit den
-Standardprogrammen Ihres Betriebssystemes anschauen können.
+@cindex Unix, LilyPond starten
+@lilypadCommandLine
@node Wie werden Eingabe-Dateien geschrieben
bei den ersten Anfängen, eine LilyPond-Eingabedatei zu schreiben.
@menu
-* Einfache Notation::
-* Arbeiten an Eingabe-Dateien::
+* Einfache Notation::
+* Arbeiten an Eingabe-Dateien::
@end menu
-
@node Einfache Notation
@subsection Einfache Notation
@translationof Simple notation
@cindex einfache Notation
@cindex Notation, einfach
+@menu
+* Tonhöhen::
+* Tondauern (Rhythmen)::
+* Pausen::
+* Taktartangabe::
+* Tempobezeichnung::
+* Notenschlüssel::
+* Alles zusammen::
+@end menu
+
LilyPond fügt einige Bestandteile des Notenbildes automatisch hinzu. Im
nächsten Beispiel sind nur vier Tonhöhen angegeben, aber LilyPond setzt
trotzdem einen Schlüssel, eine Taktangabe und Notendauern.
Diese Einstellungen können verändert werden, aber in den meisten Fällen
sind die automatischen Werte durchaus brauchbar.
-@subheading Tonhöhen
+
+@node Tonhöhen
+@unnumberedsubsubsec Tonhöhen
+@translationof Pitches
@cindex Tonhöhen
@cindex relativer Modus
@cindex relativer Modus und Versetzungszeichen
@funindex \relative
-@funindex relative
@funindex '
@funindex ,
@rglos{scale}, @rglos{middle C}, @rglos{octave},
@rglos{accidental}.
+In LilyPond werden Tonhöhen generell mit Kleinbuchstaben eingegeben.
+Die Buchstaben @code{c} bis@tie{}@code{b} bezeichnen Tonhöhen in der
+@q{Oktave} unterhalb des @notation{mittleren C}. Das Anhängen von
+@code{'} oder@tie{}@code{,} an die Noten markieren eine höhere oder
+niedrigere Oktave.
+Hier ist eine Tonleiter, beginnend auf dem @notation{mittleren C},
+gefolgt von einem Arpeggio:
+
+@lilypond[verbatim,quote]
+{ c' d' e' f' g' a' b' c'' g c' e' g' c'' e'' g'' c''' }
+@end lilypond
+
@c Addition for German users about pitch naming conventions
-Die Tonhöhen werden mit Kleinbuchstaben eingegeben, die den Notennamen
-entsprechen. Es ist jedoch wichtig zu wissen, dass LilyPond in seiner
-Standardeinstellung die englischen Notennamen verwendet. Bis auf eine
-Ausnahme entsprechen sie den deutschen, deshalb wird die Voreinstellung
-von LilyPond für diese Übung beibehalten. Die @emph{Ausnahme} ist das h -- in
-LilyPond muss man anstelle dessen b schreiben! Das deutsche b dagegen
-wird als bes notiert, ein his dagegen würde bis geschrieben. Siehe auch
-@ruser{Versetzungszeichen} und @ruser{Notenbezeichnungen in anderen Sprachen}, hier
-wird beschrieben,
+Wie oben beschrieben werden Tonhöhen werden mit Kleinbuchstaben eingegeben,
+die den Notennamen entsprechen. Es ist jedoch wichtig zu wissen, dass
+LilyPond in seiner Standardeinstellung die englischen Notennamen verwendet.
+Bis auf eine Ausnahme entsprechen sie den deutschen, deshalb wird die
+Voreinstellung von LilyPond für dieses Tutorium beibehalten. Die @emph{Ausnahme}
+ist das h -- in LilyPond muss man anstelle dessen b schreiben! Das
+deutsche b dagegen wird als bes notiert, ein his dagegen würde bis
+geschrieben. Siehe auch @ruser{Versetzungszeichen} und
+@ruser{Notenbezeichnungen in anderen Sprachen}, hier wird beschrieben,
wie sich die deutschen Notennamen benutzen lassen.
@c end addition
Am einfachsten können Noten im @code{\relative}-Modus
eingegeben werden. In diesem Modus wird die Oktave der Note automatisch
-gewählt, indem angenommen wird, dass die folgende Note immer so nah
-wie möglich in Bezug auf die vorhergehende gesetzt wird, d. h. sie
-wird höchstens drei Notenzeilen höher oder tiefer als die vorhergehende
+gewählt, indem angenommen wird, dass die folgende Note immer so nah
+wie möglich in Bezug auf die vorhergehende gesetzt wird, d. h. sie
+wird höchstens drei Notenzeilen höher oder tiefer als die vorhergehende
Note gesetzt. Fangen
wir unser erstes Notationsbeispiel mit einer @notation{Tonleiter} an, wo also
die nächste Note immer nur eine Notenlinie über der vorherigen steht.
-@c KEEP LY
@lilypond[verbatim,quote]
-% Beginnpunkt auf das mittlere C setzen
-\relative c' {
- c d e f
+\relative {
+ c' d e f
g a b c
}
@end lilypond
Die erste Note ist ein @notation{eingestrichenes C}. Jede folgende Note
-befindet sich so nah wie möglich bei der vorherigen -- das erste
+befindet sich so nah wie möglich bei der vorherigen -- das erste
@q{C} ist also das nächste C vom
eingestrichenen C aus gerechnet. Darauf folgt das nächstmögliche
D in Bezug auf die vorhergehende Note. Mit diesen Regeln können
gebildet werden:
@lilypond[verbatim,quote]
-\relative c' {
- d f a g
+\relative {
+ d' f a g
c b f d
}
@end lilypond
@noindent
-Es ist nicht notwendig, dass die erste Note der Melodie mit der
-Note beginnt, die die erste Tonhöhe angibt.
-Die erste Note (das @q{D}) des vorigen Beispiels ist das nächste D
-vom eingestrichenen C aus gerechnet.
+Die erste Note des vorherigen Beispiels -- das @code{d'} mit einem
+angehängten @code{'} -- ist das D in der Oktave beginnend beim mittleren
+C bis hin zum darüber liegenden H.
-Indem man Apostrophe @code{'} (Taste Shift+#) oder Kommata @code{,}
-zu dem @w{@code{\relative c' @{}} hinzufügt oder entfernt, kann die
-Oktave der ersten Tonhöhe verändert werden:
+Indem man Apostrophe @code{'} (Taste Shift+#) oder Kommata @code{,}
+zur ersten Note hinzufügt (oder entfernt), kann die Oktave der ersten
+Note verändert werden:
-@c KEEP LY
@lilypond[verbatim,quote]
-% zweigestrichenes C
-\relative c'' {
- e c a c
+\relative {
+ e'' c a c
}
@end lilypond
-Der relative Modus kann zunächst verwirrend erscheinen, aber es ist die
-einfachste Art, die meisten Melodien zu notieren. Schauen wir uns an,
-wie diese relative Berechnung in der Praxis funktioniert. Wenn wir mit
-einem H beginnen (@code{b} in der LilyPond-Syntax), welches sich auf der
-mittleren Linie im Violinschlüssel befindet, können wir C, D und E
-aufwärts notieren, und A, G und F unter dem H. Wenn also die Note, die
-auf das H folgt, ein C, D oder E ist, setzt LilyPond es oberhalb des
+Der relative Modus kann zunächst verwirrend erscheinen, aber es ist die
+einfachste Art, die meisten Melodien zu notieren. Schauen wir uns an,
+wie diese relative Berechnung in der Praxis funktioniert. Wenn wir mit
+einem H beginnen (@code{b} in der LilyPond-Syntax), welches sich auf der
+mittleren Linie im Violinschlüssel befindet, können wir C, D und E
+aufwärts notieren, und A, G und F unter dem H. Wenn also die Note, die
+auf das H folgt, ein C, D oder E ist, setzt LilyPond es oberhalb des
Hs, wenn es ein A, G oder F ist, wird es darunter gesetzt.
@c KEEP LY
@lilypond[verbatim,quote]
-\relative c'' {
- b c % c ist 1 Zeile aufwärts, also c über dem b
+\relative {
+ b' c % c ist 1 Zeile aufwärts, also c über dem b
b d % d ist 2 Zeilen aufwärts, oder 5 runter, also d über dem b
b e % e ist 3 aufwärts oder 4 runter, also e über dem b
b a % a ist 6 aufwärts oder 1 runter, also a unter dem b
}
@end lilypond
-Die gleiche Berechnung findet auch statt, wenn eine der Noten erhöht
-oder erniedrigt ist. @notation{Versetzungszeichen} werden
-@strong{vollständig ignoriert} bei der Berechnung. Genau die
-gleiche Berechnung wird analog von jeder folgenden Tonhöhe aus
+Die gleiche Berechnung findet auch statt, wenn eine der Noten erhöht
+oder erniedrigt ist. @notation{Versetzungszeichen} werden
+@strong{vollständig ignoriert} bei der Berechnung. Genau die
+gleiche Berechnung wird analog von jeder folgenden Tonhöhe aus
für die nächste Tonhöhe neu ausgeführt.
Um Intervalle zu notieren, die größer als drei Notenzeilen sind, kann man die Oktave verändern. Mit einem Apostroph @code{'} (Taste Shift+#)
direkt hinter dem Notennamen wird die Oktave um eins erhöht, mit einem Komma @code{,} um eins erniedrigt.
@lilypond[verbatim,quote]
-\relative c'' {
- a a, c' f,
+\relative {
+ a' a, c' f,
g g'' a,, f'
}
@end lilypond
@noindent
-Um eine Notenhöhe um zwei (oder mehr!) Oktaven zu verändern,
-werden sukzessive @code{''} oder @code{,,} benutzt -- es muss
+Um eine Tonhöhe um zwei (oder mehr!) Oktaven zu verändern,
+werden mehrfache @code{''} oder @code{,,} benutzt -- es muss
sich dabei wirklich um zwei einzelne Apostrophen und nicht um das
-Anführungszeichen @code{"}@tie{} (Taste Shift+2) handeln! Auch
-die Anfangsoktave für einen @code{@w{\relative c'}}-Abschnitt kann so
-verändert werden.
+Anführungszeichen @code{"}@tie{} (Taste Shift+2) handeln!
+@node Tondauern (Rhythmen)
+@unnumberedsubsubsec Tondauern (Rhythmen)
+@translationof Durations (rhythms)
-@subheading Tondauern (Rhythmen)
-
-@cindex Notendauern
+@cindex Tondauer
+@cindex Notendauer
@cindex Dauern
@cindex Rhythmus
@cindex Ganze Noten
Die @notation{Dauer} einer Note wird durch eine Zahl bezeichnet,
die direkt auf den Notennamen folgend eingegeben wird.
-@code{1} für eine @notation{ganze Note}, @code{2} für eine
-@notation{halbe Note}, @code{4} für eine @notation{Viertelnote}
+@code{1} für eine @notation{ganze Note}, @code{2} für eine
+@notation{halbe Note}, @code{4} für eine @notation{Viertelnote}
und so weiter. @notation{Notenhälse} und @notation{Balken} werden
automatisch hinzugefügt.
verwendet. Für die erste Note ist eine Viertel als Standard definiert.
@lilypond[verbatim,quote]
-\relative c'' {
- a1
+\relative {
+ a'1
a2 a4 a8 a
a16 a a a a32 a a a a64 a a a a a a a a2
}
@end lilypond
-Um @notation{punktierte Noten} zu erzeugen, wird einfach ein Punkt
-@code{.} hinter die Notendauer geschrieben. Die Dauer einer
-punktierten Note muss explizit, also inklusive der Nummer,
+Um @notation{punktierte Noten} zu erzeugen, wird einfach ein Punkt
+@code{.} hinter die Notendauer geschrieben. Die Dauer einer
+punktierten Note muss explizit, also inklusive der Nummer,
angegeben werden.
@lilypond[verbatim,quote]
-\relative c'' {
- a a a4. a8
+\relative {
+ a'4 a a4. a8
a8. a16 a a8. a8 a4.
}
@end lilypond
-
-@subheading Pausen
+@node Pausen
+@unnumberedsubsubsec Pausen
+@translationof Rests
@cindex Pausen
@cindex schreiben von Pausen
Bezeichnung ist @code{r}@tie{}:
@lilypond[verbatim,quote]
-\relative c'' {
- a r r2
+\relative {
+ a'4 r r2
r8 a r4 r4. r8
}
@end lilypond
-@subheading Taktangabe
+@node Taktartangabe
+@unnumberedsubsubsec Taktartangabe
+@translationof Time signature
@cindex Taktart
@funindex \time
-@funindex time
Glossar: @rglos{time signature}.
-Die @notation{Taktart} kann mit dem
-@code{\time}-Befehl definiert werden:
+Die @notation{Taktart} wird mit dem
+@code{\time}-Befehl gesetzt:
+
+@lilypond[verbatim,quote]
+\relative {
+ \time 3/4
+ a'4 a a
+ \time 6/8
+ a4. a
+ \time 4/4
+ a4 a a a
+}
+@end lilypond
+
+@node Tempobezeichnung
+@unnumberedsubsubsec Tempobezeichnung
+@translationof Tempo marks
+
+@cindex Tempobezeichnung
+@cindex Metronom-Angabe
+
+@funindex \tempo
+
+Glossar: @rglos{tempo indication}, @rglos{metronome}.
+
+Die @notation{Tempobezeichnung} und die @notation{Metronom-Angabe} werden
+mit dem @code{\tempo}-Befehl gesetzt:
@lilypond[verbatim,quote]
-\relative c'' {
+\relative {
\time 3/4
- a4 a a
+ \tempo "Andante"
+ a'4 a a
\time 6/8
+ \tempo 4. = 96
a4. a
\time 4/4
+ \tempo "Presto" 4 = 120
a4 a a a
}
@end lilypond
-@subheading Notenschlüssel
+@node Notenschlüssel
+@unnumberedsubsubsec Notenschlüssel
+@translationof Clef
@cindex Schlüssel
@cindex Alt
@cindex Bass
@funindex \clef
-@funindex clef
Glossar: @rglos{clef}.
-Der @notation{Notenschlüssel} kann mit dem @code{\clef}-Befehl
-gesetzt werden:
+Der @notation{Notenschlüssel} wird mit dem @code{\clef}-Befehl
+gesetzt:
@lilypond[verbatim,quote]
-\relative c' {
- \clef treble
- c1
- \clef alto
+\relative {
+ \clef "treble"
+ c'1
+ \clef "alto"
c1
- \clef tenor
+ \clef "tenor"
c1
- \clef bass
+ \clef "bass"
c1
}
@end lilypond
-@subheading Alles zusammen
+@node Alles zusammen
+@unnumberedsubsubsec Alles zusammen
+@translationof All together
Hier ist ein kleines Beispiel, dass all diese Definitionen beinhaltet:
@lilypond[verbatim,quote]
-\relative c, {
+\relative {
+ \clef "bass"
\time 3/4
- \clef bass
- c2 e8 c' g'2.
- f4 e d c4 c, r4
+ \tempo "Andante" 4 = 120
+ c,2 e8 c'
+ g'2.
+ f4 e d
+ c4 c, r4
}
@end lilypond
@cindex Ausdrücke
@cindex Großbuchstaben
@cindex Kleinbuchstaben
+@cindex Versionierung
+@cindex Version
+@cindex Versionsnummer
+@funindex \version
@funindex { ... }
@funindex %
@funindex %@{ ... %@}
LilyPonds Quelldateien ähneln Dateien in den meisten
-Programmiersprachen: Sie enthalten eine Versionsbezeichnung,
+Programmiersprachen: Sie enthalten eine Versionsbezeichnung,
es ist auf Groß- und Kleinschreibung
-zu achten und Leerzeichen werden ignoriert. Ausdrücke werden
-mit geschweiften Klammern @{ @} eingeklammert und Kommentare
+zu achten und Leerzeichen werden ignoriert. Ausdrücke werden
+mit geschweiften Klammern @w{@code{@{ @}}} eingeklammert und
mit dem Prozentzeichen @code{%} auskommentiert
-oder mit @code{%@{ ... %@}} umgeben.
+oder mit @w{@code{%@{ @dots{} %@}}} umgeben.
-Wenn das jetzt unverständlich erscheint, sind hier die Erklärungen:
+Wenn das jetzt unverständlich erscheint, sind hier die Erklärungen:
@itemize
@item
\version "@w{@version{}}"
@end example
-Üblicherweise wird die Versionsbezeichnung oben in die Datei
+Üblicherweise wird die Versionsbezeichnung ganz oben in die Datei
geschrieben.
-Die Versionsbezeichnung ist aus zwei Gründen sehr wichtig: 1. kann
+Die Versionsbezeichnung ist aus zwei Gründen wichtig: 1. kann
man mit ihrer Hilfe automatische Aktualisierungen der Eingabedateien
-vornehmen, wenn sich die LilyPond-Syntax ändern sollte. 2. wird
+vornehmen, wenn sich die LilyPond-Syntax ändern sollte. 2. wird
hier die Version von LilyPond beschrieben, die nötig ist, um die
Datei zu kompilieren.
Die Bedeutung eines Zeichens verändert sich, je
nachdem, ob es groß (@w{@code{A, B, S, T}}) oder klein
(@w{@code{a, b, s, t}}) geschrieben wird. Noten müssen
-immer klein geschrieben werden, @w{@code{@{ c d e @}}} funktioniert,
-während @w{@code{@{ C D E @}}} einen Fehler produziert.
+immer klein geschrieben werden, @w{@samp{@{ c d e @}}} funktioniert,
+während @w{@samp{@{ C D E @}}} einen Fehler produziert.
@item @strong{Leerzeichen:}
Es spielt keine Rolle, wie viele Leerzeichen oder Tabulatoren oder
leere Zeilen sich zwischen den Zeichen der Quelldatei befinden.
-@w{@code{@{ c d e @}}} bedeutet das Gleiche wie
-@w{@code{@{ c @ @ @ @ @ d e @}}} oder
+@w{@samp{@{ c d e @}}} bedeutet das Gleiche wie
+@w{@samp{@{ c @ @ @ @ @ d e @}}} oder
@example
-@{ c d
+@{ c4 d
e @}
@end example
@noindent
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:
+ist es, Code-Blöcke mit zwei Leerzeichen einzurücken:
@example
@{
- c d e
+ c4 d e
@}
@end example
Leerzeichen @emph{sind} jedoch nötig, um viele syntaktische Elemente
voneinander zu trennen. Leerzeichen können also immer @emph{hinzugefügt}
werden, aber sie dürfen nicht @emph{entfernt} werden. Da fehlende
-Leerzeichen sehr seltsame Fehlermeldungen hervorrrufen können, wird
-es nahe gelegt, immer ein Leerzeichen vor und nach jedem syntaktischen
-Element, etwa vor und nach geschweiften Kklammern, einzufügen.
+Leerzeichen sehr seltsame Fehlermeldungen hervorrufen können, wird
+es nahe gelegt, immer ein Leerzeichen vor und nach jedem syntaktischen
+Element, etwa vor und nach geschweiften Klammern, einzufügen.
@item @strong{Ausdrücke:}
Auch der kleinste Abschnitt an LilyPond-Code muss in
-@strong{@{ geschweifte Klammern @}} eingeschlossen werden. Diese
+@strong{@{@tie{}geschweifte@tie{}Klammern@tie{}@}} eingeschlossen werden. Diese
Klammern zeigen LilyPond an, dass es sich um einen zusammengehörenden
musikalischen Ausdruck handelt, genauso wie Klammern @q{()} 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.
+
Ein LilyPond-Befehl gefolgt von einem einfachen Ausdruck
-in Klammern (wie etwa @code{\relative @{ @}})
+in Klammern (wie etwa @q{@w{@code{@bs{}relative c' @{ @dots{} @}}}})
wird auch als ein einzelner Musikausdruck gewertet.
@cindex Kommentare
@cindex Zeilenkommentare
@cindex Blockkommentare
-@item
+@item
@strong{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 @q{%} geht einem Zeilen-Kommentar voraus: Alles
-nach diesem Zeichen wird in dieser Zeile ignoriert.
+nach diesem Zeichen wird in dieser Zeile ignoriert.
Üblicherweise wird ein Kommentar @emph{über} dem Code gesetzt,
auf den es sich bezieht.
und @code{%@}} umgeben ist, wird ignoriert. Das heißt,
dass sich ein Block-Kommentar nicht ein einem anderen
Blockkommentar befinden kann. Wenn Sie das versuchen sollten,
-beendet schon das erste @code{%@}} @emph{beide}
+beendet schon das erste @code{%@}} @emph{beide}
Block-Kommentare. Das folgende Beispiel zeigt eine
mögliche Anwendung von Kommentaren:
ignoriert, weil sie sich in einem Block-Kommentar
befinden.
- f f e e d d c2
+ f4 f e e d d c2
%@}
@end example
@end itemize
+@node Fehlerbehandlung
+@section Fehlerbehandlung
+@translationof Dealing with errors
-@node Wie die Handbücher gelesen werden sollen
-@section Wie die Handbücher gelesen werden sollen
+@cindex Fehlerbehandlung
+
+Manchmal erstellt LilyPond nicht das Notenbild, das Sie erwarten. Dieser
+Abschnitt stellt einige Links zur Verfügung, um Ihnen bei der Problemlösung
+möglicher Schwierigkeiten zu helfen.
+
+
+@menu
+* Allgemeine Fehlerbehandlungstipps::
+* Einige häufige Fehler::
+@end menu
+
+@node Allgemeine Fehlerbehandlungstipps
+@subsection Allgemeine Fehlerbehandlungstipps
+@translationof General troubleshooting tips
+
+Fehlerbehandlung für LilyPond-Probleme kann eine große Herausforderung für Menschen
+darstellen, die an eine graphische Benutzeroberfläche gewohnt sind, weil
+ungültige Eingabedateien erstellt werden können. Wenn das geschieht, ist
+eine logische Herangehensweise der beste Weg, das Problem zu identifizieren
+und zu Lösen. Einige Richtlinien, wie Sie diese Problemlösung erlernen
+können, finden sich in @rprogram{Troubleshooting}.
+
+
+@node Einige häufige Fehler
+@subsection Einige häufige Fehler
+@translationof Some common errors
+
+@cindex häufige Fehler
+@cindex Fehler, häufige
+
+Es gibt einige übliche Fehler, die schwierig zu lösen sind, wenn man nur die
+Fehlermeldungen der Log-Datei hat. Sie werden näher erklärt in
+@rprogram{Common errors}.
+
+
+
+@node Wie die Handbücher gelesen werden sollten
+@section Wie die Handbücher gelesen werden sollten
@translationof How to read the manuals
-Dieser Abschnitt zeigt, wie die Dokumenation effizient gelesen
-werden kann und erklärt auch einige nützliche Interaktionseigenschaften
+Dieser Abschnitt erklärt, wie die Dokumentation effizient gelesen
+werden kann und behandelt auch einige nützliche Interaktionseigenschaften
der Online-Version.
@menu
-* Ausgelassenes Material::
-* Anklickbare Beispiele::
-* Navigation mit der Tastatur::
-* Überblick über die Handbücher::
+* Ausgelassenes Material::
+* Anklickbare Beispiele::
+* Überblick über die Handbücher::
@end menu
@subsection Ausgelassenes Material
@translationof Omitted material
+
@cindex Handbuch, Lesen
@cindex Wie soll das Handbuch gelesen werden
@cindex Lesen des Handbuchs
@cindex Konstruieren von Dateien, Hinweise
@cindex Hinweise zur Konstruktion von Dateien
-LilyPond-Code muss immer von @{ @} Zeichen oder einem
-@code{@w{\relative c'' @{ ... @}}} umgeben sein, wie
-gezeigt in @ref{Arbeiten an Eingabe-Dateien}.
+LilyPond-Code muss immer von @code{@{ @}} Zeichen oder einem
+@q{@w{@code{@bs{}relative @{ @dots{} @}}}} umgeben sein, wie
+in @ref{Arbeiten an Eingabe-Dateien} gezeigt.
Im Rest dieses Handbuchs werden die meisten Beispiel allerdings darauf
-verzichten. Um sie zu reproduzieren, können Sie den entsprechenden
-Quellcode kopieren und in eine Textdatei einfügen, aber Sie
-@strong{müssen} dabei
-@code{@w{\relative c'' @{ @}}} einfügen, wie hier gezeigt:
+verzichten. Um sie zu reproduzieren, können Sie den entsprechenden
+Quellcode kopieren und in eine Textdatei zwischen @code{@{}
+und @code{@}} einfügen.
@example
-\relative c'' @{
- ... hier das Beispiel ...
+@{
+ @dots{}hier das Beispiel@dots{}
@}
@end example
-Warum werden die Klammern hier meist weggelassen? Die meisten
-der Beispiele können in ein längeres Musikstück hineinkopiert
-werden, und dann ist es natürlich nicht sinnvoll, wenn auch noch
-@code{@w{\relative c'' @{ @}}} dazukommt; ein @code{\relative} darf
-nicht innerhalb eines anderen @code{\relative} gesetzt werden,
-deshalb wird es hier weggelassen, damit die Beispiele auch innerhalb
-eines anderen Kontextes funktionieren. Wenn bei jedem
-Beispiel @code{@w{\relative c'' @{ @}}} eingesetzt würde,
-könnten Sie die kleinen Beispiele der Dokumentation
-nicht einfach zu Ihrem eigenen Notentext hinzufügen.
-Die meisten Benutzer wollen
-Noten zu einer schon bestehenden Datei irgendwo in der Mitte
-hinzufügen, deshalb wurde der relative Modus für die Beispiele
-im Handbuch weggelassen.
-
Denken Sie auch daran, dass jede LilyPond-Datei eine Versionsbezeichnung
-haben sollte. Weil die Beispiele in den Handbüchern Schnipsel
-und keine vollständigen Dateien sind, fehlt hier die Versionsbezeichnung.
-Sie sollten sie aber immer in Ihre eigenen Dateien einfügen.
+mit dem @code{\version}-Befehl haben sollte. Weil die Beispiele in den
+Handbüchern Schnipsel und keine vollständigen Dateien sind, fehlt hier
+die Versionsbezeichnung. Sie sollten sie aber immer in Ihre eigenen
+Dateien einfügen.
@node Anklickbare Beispiele
@c no verbatim here
@c KEEP LY
@lilypond[quote]
-\relative c'' {
- c-\markup { \bold \huge { Hier klicken! } }
+\relative {
+ c''4-\markup { \bold \huge { Hier klicken! } }
}
@end lilypond
Wenn Sie einfach alles kopieren, was im
@qq{ly snippet}-Abschnitt steht, und in eine Text-Datei
einfügen, haben Sie schon eine fertige Vorlage für weitere
-Experimente. Damit Sie genau das gleiche Erscheinungsbild wie
-bei dem Beispiel selber erreichen, müssen Sie alles kopieren ab der
+Experimente. Damit Sie genau das gleiche Erscheinungsbild wie
+bei dem Beispiel selber erreichen, müssen Sie alles kopieren ab der
Zeile @qq{Start
cut-&-pastable section} bis ganz zum Ende der Datei.
-@node Navigation mit der Tastatur
-@subsection Navigation mit der Tastatur
-@translationof Keyboard navigation
+@ignore
+This is item 825
+
+@n ode Navigation mit der Tastatur
+@s ubsection Navigation mit der Tastatur
+@t ranslationof Keyboard navigation
@warning{Diese Funktion gibt es nur für die HTML-Version der Handbücher.}
@c TODO: once this is figured out, insert it here.
Es wird gegenwärtig an dieser Funktion gearbeitet.
-
+@end ignore
@node Überblick über die Handbücher
Es gibt sehr viele Dokumentation für LilyPond. Neue Benutzer sind
oft verwirrt, welche Teile davon sie lesen sollen, und so kommt
-es vor, dass machnmal wichtige Abschnitte nicht gelesen werden.
+es vor, dass manchmal wichtige Abschnitte nicht gelesen werden.
@warning{Bitte überspringen Sie keine wichtigen Teile der
Dokumentation. Sonst wird es Ihnen später sehr viel schwerer
@item
@strong{Bevor Sie @emph{irgendetwas} ausprobieren}: Lesen Sie die
-Abschnitte @ref{Übung} und @ref{Übliche Notation}. Wenn
+Abschnitte @ref{Tutorium} und @ref{Übliche Notation}. Wenn
Sie auf musikalische Fachbegriffen stoßen, die Sie nicht kennen,
schauen Sie diese im @rglosnamed{Top, Glossar} nach.
@item
@strong{Bevor Sie versuchen, die Standardnotation zu verändern}:
-Lesen Sie @ref{Die Ausgabe verändern} im Handbuch zum Lernen.
+Lesen Sie @ref{Die Ausgabe verbessern} im Handbuch zum Lernen.
@item
@strong{Bevor Sie sich an ein größeres Projekt machen}: Lesen
in der Programmbenutzung.
@end itemize
-
projects / lilypond.git / blobdiff