@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@ignore
- Translation of GIT committish: 4f7427e7a314a71bde16559247885544256b8213
+ Translation of GIT committish: 70aaf0159410169678942abd39eb13c876521437
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.12.0"
+@c \version "2.13.36"
@c Translators: Till Paala
@translationof Input structure
Das hauptsächliche Eingabeformat von LilyPond sind Textdateien.
-Üblicherweise werden diese Dateien mit der Endung @code{.ly}
+Üblicherweise werden diese Dateien mit der Endung @file{.ly}
versehen.
@menu
* Struktur einer Partitur::
* Mehrere Partituren in einem Buch::
+* Mehrere Ausgabedateien aus einer Eingabedatei::
+* Dateinamen der Ausgabedateien::
* Die Dateistruktur::
@end menu
und innerhalb oder außerhalb des einzelnen musikalischen Ausdrucks
innerhalb der @code{\score}-Umgebung.
+Denken Sie daran, dass auch eine Datei, die nur eine @code{\score}-Umgebung
+enhält, implizit in eine @code{\book}-Umgebung eingeschlossen wird. Eine
+@code{\book}-Umgebung in einer Eingabdatei produziert wenigstens eine
+Ausgabedatei, und standardmäßig wird der Name der Ausagabedatei aus dem
+Namen der Eingabedatei abgeleitet. @file{fandangoforelephants.ly} produziert
+also @file{fandangoforelephants.pdf}.
+
+Zu weiteren Einzelheiten zu @code{\book}-Umgebungen siehe
+@ref{Mehrere Partituren in einem Buch},
+@ref{Mehrere Ausgabedateien aus einer Eingabedatei} und
+@ref{Dateistruktur}.
+
@seealso
Handbuch zum Lernen:
@rlearning{Musikalische Ausdrücke erklärt},
@rlearning{Score ist ein (einziger) zusammengesetzter musikalischer Ausdruck}.
+Notationsreferenz:
+@ref{Mehrere Partituren in einem Buch},
+@ref{Mehrere Ausgabedateien aus einer Eingabedatei} und
+@ref{Dateistruktur}.
+
@node Mehrere Partituren in einem Buch
@subsection Mehrere Partituren in einem Buch
@funindex \book
-Alle Sätze und Texte, die in derselben @code{.ly}-Datei vorkommen,
+Alle Sätze und Texte, die in derselben @file{.ly}-Datei vorkommen,
werden normalerweise in eine einzige Ausgabedatei gesetzt.
@example
@}
@end example
-Wenn Sie aber mehrere Ausgabedateien aus einer einzigen @code{.ly}-Datei
-erstellen wollen, können Sie mehrere @code{\book}-Umgebungen notieren.
-Wenn Sie keine @code{\book}-Umgebung in Ihrer Datei angeben, interpretiert
-LilyPond die gesamte Datei als eine große @code{\book}-Umgebung (siehe
-auch @ref{Die Dateistruktur}. Eine wichtige Ausnahme stellen Dokumente dar,
+Eine wichtige Ausnahme stellen Dokumente dar,
die mit lilypond-book erstellt werden, für die Sie explizit
@code{\book}-Umgebungen notieren müssen, weil sonst nur die erste
@code{\score}- bzw. @code{\markup}-Umgebung angezeigt wird.
@}
@end example
+
+@node Mehrere Ausgabedateien aus einer Eingabedatei
+@subsection Mehrere Ausgabedateien aus einer Eingabedatei
+@translationof Multiple output files from one input file
+
+Wenn Sie mehrere Ausgabedateien aus derselben @file{.ly}-Datei haben
+wollen, können Sie mehrere @code{\book}-Umgebungen hinzufügen, wobei
+jede Umgebung eine neue Ausgabedatei produziert. Wenn Sie keine
+@code{\book}-Umgebung in der Eingabedatei angeben, wird die Datei von
+LilyPond implizit als eine große @code{\book}-Umgebung behandelt, siehe
+auch @ref{Dateistruktur}.
+
+Wenn man mehrere Dateien aus einer einzigen Eingabedatei erstellt, stellt
+LilyPond sicher, dass keine der Ausgabedateien der vorhandenen
+@code{\book}-Umgebungen eine andere Ausgabedatei, etwa von der vorherigen
+@code{\book}-Umgebung, überschreibt.
+
+Dies geschieht, indem ein Suffix an den Ausgabenamen für jede
+@code{\book}-Umgebung gehängt wird, die den Dateinamen der Eingabdatei
+als Grundlage nimmt.
+
+Das Standardverhalten ist es, einen Zahlen-Suffix für die Namen hinzuzufügen,
+die in Konflikt stehen. Der Code
+
+@example
+\book @{
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+@end example
+
+@noindent
+produziert also
+
+@itemize
+@item
+@file{eightminiatures.pdf},
+@item
+@file{eightminiatures-1.pdf} and
+@item
+@file{eightminiatures-2.pdf}.
+@end itemize
+
+
+@node Dateinamen der Ausgabedateien
+@subsection Dateinamen der Ausgabedateien
+@translationof Output file names
+
+@funindex \bookOutputSuffix
+@funindex \bookOutputName
+
+LilyPond stellt die Möglichkeit zur Verfügung zu kontrollieren, welche
+Dateinamen für welche Back-ends benutzt werden sollen, wenn die Ausgabedateien
+erstellt werden.
+
+Im vorhergehenden Abschnitt wurde gezeigt, wir LilyPond gleichnamige
+Ausgabedateien verhindert, wenn mehrere Ausgabedateien aus derselben
+Eingabedatei erstellt werden. Es gibt auch die Möglichkeit, eigene
+Suffixe für jeden @code{\book}-Abschnitt zu definieren, sodass man etwa
+Dateinamen wie @file{eightminiatures-Romanze.pdf}, @file{eightminiatures-Menuetto.pdf}
+und @file{eightminiatures-Nocturne.pdf} produzieren kann, indem man
+eine @code{\bookOutputSuffix}-Angabe in jede @code{\book}-Umgebung
+einfügt.
+
+@example
+\book @{
+ \bookOutputSuffix "Romanze"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputSuffix "Menuetto"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputSuffix "Nocturne"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+@end example
+
+Man kann auch einen anderen Dateinamen für die Ausgabedatei einer
+@code{\book}-Umgebung erstellen, indem man @code{\bookOutputName}-Angabe
+macht:
+
+@example
+\book @{
+ \bookOutputName "Romanze"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputName "Menuetto"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputName "Nocturne"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+@end example
+
+Die obige Datei produziert folgene Ausgabedateien:
+
+@itemize
+@item
+@file{Romanze.pdf},
+@item
+@file{Menuetto.pdf} and
+@item
+@file{Nocturne.pdf}.
+@end itemize
@node Die Dateistruktur
@subsection Die Dateistruktur
@translationof File structure
@cindex Eingabedatei, Struktur
@cindex Quelldatei, Struktur
-Eine @code{.ly}-Datei kann eine beliebige Anzahl an Ausdrücken
+Eine @file{.ly}-Datei kann eine beliebige Anzahl an Ausdrücken
auf der obersten Ebene beinhalten, wobei ein Ausdruck der obersten
Ebene einer der folgenden sein kann:
-@itemize @bullet
+@itemize
@item
Eine Ausgabedefinition, wie @code{\paper}, @code{\midi} und
@code{\layout}. Derartige Definitionen auf oberster Ebene verändern
und in ein @code{\book} zusammengefasst. Dieses Verhalten kann
verändert werden, indem die Variable @code{toplevel-score-handler}
auf höchster Ebene gesetzt wird. Die Definition des Standards findet sich
-in der Datei @file{../@/scm/@/lily@/.scm}.
+in der Datei @file{../scm/lily.scm}.
@item
Eine @code{\book}-Umgebung fasst mehrere Sätze (d. h. mehrere
im gleichen Beispiel angezeigt werden soll. Dieses Verhalten
kann verändert werden, indem die Variable @code{toplevel-book-handler}
auf höchster Ebene gesetzt wird. Die Definition des Standards
-findet sich in der Datei @file{../@/scm/@/lily@/.scm}.
+findet sich in der Datei @file{../scm/lily.scm}.
@item
Eine @code{\bookpart}-Umgebung. Ein Buch (@code{\book}) kann in
Dieses Verhalten kann verändert werden, indem die Variable
@code{toplevel-music-handler} auf der obersten Ebene gesetzt
wird. Die Definition des Standards findet sich in der Datei
-@file{../@/scm/@/lily@/.scm}.
+@file{../scm/lily.scm}.
@item
Eine Textbeschriftung, eine Strophe etwa:
Kompliziertere Anpassungen können vorgenommen werden, indem die
folgenden Variablen innerhalb der @code{\paper}-Umgebung geändert
-werden. Die Init-Datei @file{../@/ly/@/titling@/-init@/.ly} enthält das
+werden. Die Init-Datei @file{../ly/titling-init.ly} enthält das
Standardverhalten.
@table @code
@seealso
-Installierte Dateien: @file{../@/ly/@/toc@/-init@/.ly}.
+Installierte Dateien:
+@file{../ly/toc-init.ly}.
@funindex \table-of-contents
@funindex \tocItem
benutzt werden.
Die Zeile @code{\include "andereDatei.ly"} benimmt sich genauso,
-also ob der Inhalt der Datei @code{andereDatei.ly} komplett in die
+also ob der Inhalt der Datei @file{andereDatei.ly} komplett in die
Hauptdatei eingefügt werden würde. So kann man für ein größeres
Projekt die einzelnen Stimmen der Instrumente getrennt notieren
und sie dann in einer Partitur-Datei benutzen. Meistens werden
music = \relative g' {
g8. c32 d
\tag #'trills { d8.\trill }
- \tag #'expand { \repeat unfold 3 { e32 d } }
+ \tag #'expand {\repeat unfold 3 { e32 d } }
c32 d
}
Um einen einzelnen Buchstaben zu notieren, für den die Unicode-Ziffernfolge
bekannt ist, der aber nicht auf der Tastatur zu finden ist, kann
der Befehl @code{\char ##xhhhh} oder @code{\char #dddd} innerhalb einer
-@code{\markup}-Umgebung benutzt werden. Hierbei bedeutet @code{hhhh} die
+@code{\markup}-Umgebung benutzt werden. Hierbei bedeutet @code{hhhh} die
hexadezimale Zahl und @code{ddd} die entsprechende dezimale Zahl
für das erforderliche Zeichen. Nullen zu Beginn können ausgelassen werden,
aber normalerweise werden alle vier Zeichen der hexadezimalen Notation
Instrumentenwechsel ausgelassen. Man muss also sehr genau darauf
achten, dass nichts unerwartetes geschieht.
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
- c8 d
- \set Score.skipTypesetting = ##t
- e8 e e e e e e e
- \set Score.skipTypesetting = ##f
- c8 d b bes a g c2
-}
+@lilypond[quote,relative=2,ragged-right,verbatim]
+c8 d
+\set Score.skipTypesetting = ##t
+e8 e e e e e e e
+\set Score.skipTypesetting = ##f
+c8 d b bes a g c2
@end lilypond
In polyphoner Notation wirkt sich @code{Score.skipTypesetting} auf
der Syntax, wie sie in der @code{\layout}-Umgebung benutzt
wird. Klangübersetzungsmodule werden @code{performer}
genannt. Die Kontexte für die MIDI-Ausgabe sind in der
-Datei @file{../@/ly/@/performer@/-init@/.ly} definiert, siehe
+Datei @file{../ly/performer-init.ly} definiert, siehe
@rlearning{Mehr Information}. Um beispielsweise
die Auswirkung von Dynamikzeichen aus der MIDI-Ausgabe zu
entfernen, müssen folgende Zeilen eingefügt werden:
Eine MIDI-Ausgabe wird nur erstellt, wenn die @code{\midi}-Umgebung
in eine Partiturumgebung eingefügt wird, die mit dem Befehl
-@code{\score} beginnt. Wenn eine Partitur explizit etwa mit
-@code{\new Score} begonnen wird, und sich die MIDI-Umgebung hierin
-befindet, wird keine Ausgabe produziert. Eine Lösung ist es, sowohl
-die @code{\new Score}- als auch die @code{\midi}-Umgebungen in eine
-@code{\score}-Umgebung einzuschließen.
+@code{\score} beginnt.
@example
\score @{
- \new Score @{ @dots{}Noten@dots{} @}
+ @{ @dots{}Noten@dots{} @}
\midi @{ @}
@}
@end example
zur Verfügung stehenden MIDI-Lautstärke notiert. Die Standardbrüche
reichen von 0,25 für @notation{ppppp} bis hin zu 0,95 für
@notation{fffff}. Diese Anweisung befinden sich in der Datei
-@file{../@/scm/@/midi.scm}, siehe auch @rlearning{Mehr Information}.
+@file{../scm/midi.scm}, siehe auch @rlearning{Mehr Information}.
Diese Brüche können nach Belieben geändert oder erweitert werden, indem
eine Funktion erstellt wird, die ein Dynamikzeichen als Argument
nimmt und den erforderlichen Bruch ausgibt; schließlich muss noch
Alternativ, insbesondere wenn die gesamte Tabelle der MIDI-Lautstärken
umdefiniert werden soll, ist es besser, die
@notation{default-dynamic-absolute-volume}-Prozedur in der Datei
-@file{../@/scm/@/midi.scm} und die hiermit verknüpfte Tabelle als Modell
+@file{../scm/midi.scm} und die hiermit verknüpfte Tabelle als Modell
zu benutzen. Das letzte Beispiel dieses Abschnittes zeigt, wie das
gemacht werden kann.
Anpassungen für die Lautstärken bestimmter Instrumente vor.
Diese Instrumente und ihre entsprechende Veränderung lassen
sich aus der Tabelle @notation{instrument-equalizer-alist}
-in der Datei @file{../@/scm/@/midi.scm} entnehmen.
+in der Datei @file{../scm/midi.scm} entnehmen.
Dieser grundlegende Equalizer kann ersetzt werden, indem die
Funktion @code{instrumentEqualizer} im @code{Score}-Kontext auf
@code{dynamicAbsoluteVolumeFunction} zu Beginn dieses Abschnittes
gezeigt wurde. Der Standard-Equalizer,
@notation{default-instrument-equalizer} in der Datei
-@file{../@/scm/@/midi.scm} zeigt, wie solche eine Funktion erstellt werden
+@file{../scm/midi.scm} zeigt, wie solche eine Funktion erstellt werden
kann.
Das folgende Beispiel definiert für die Flöte und Klarinette relative