@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@ignore
- Translation of GIT committish: 4f7427e7a314a71bde16559247885544256b8213
+ Translation of GIT committish: ac3dd3ad38528113d97f6a8a7b81751c328f1c36
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.15.17"
@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:
@menu
* Titel erstellen::
-* Eigene Titel::
+* Eigene Kopf und Fußzeilen sowie Titel::
* Verweis auf die Seitenzahlen::
* Inhaltsverzeichnis::
@end menu
@end example
-@node Eigene Titel
-@subsection Eigene Titel
-@translationof Custom titles
+@node Eigene Kopf und Fußzeilen sowie Titel
+@subsection Eigene Kopf- und Fußzeilen sowie Titel
+@translationof Custom headers footers and titles
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
Die folgende Definition setzt die Überschrift linksbündig und
den Komponisten rechtsbündig auf einer einzelnen Zeile:
-@verbatim
-\paper {
- bookTitleMarkup = \markup {
- \fill-line {
+@example
+\paper @{
+ bookTitleMarkup = \markup @{
+ \fill-line @{
\fromproperty #'header:title
\fromproperty #'header:composer
- }
- }
-}
-@end verbatim
+ @}
+ @}
+@}
+@end example
+
+Kopf- und Fußzeile werden mit den Funktionen @code{make-header} und
+@code{make-footer} erstellt, welche in @code{\paper} definiert werden.
+Die Standardimplementationen finden sich in @file{ly/paper-defaults-init.ly} und
+@file{ly/titling-init.ly}.
+
+Dieses Beispiel zentriert die Seitenzahlen unten auf jeder Seite:
+
+@example
+\paper @{
+ print-page-number = ##t
+ print-first-page-number = ##t
+ oddHeaderMarkup = \markup \fill-line @{ " " @}
+ evenHeaderMarkup = \markup \fill-line @{ " " @}
+ oddFooterMarkup = \markup @{
+ \fill-line @{
+ \bold \fontsize #3
+ \on-the-fly #print-page-number-check-first
+ \fromproperty #'page:page-number-string
+ @}
+ @}
+ evenFooterMarkup = \markup @{
+ \fill-line @{
+ \bold \fontsize #3
+ \on-the-fly #print-page-number-check-first
+ \fromproperty #'page:page-number-string
+ @}
+ @}
+@}
+@end example
@node Verweis auf die Seitenzahlen
@translationof Table of contents
Ein Inhaltsverzeichnis kann eingefügt werden mit dem Befehl
-@code{\markuplines \table-of-contents}. Die Elemente, die im
+@code{\markuplist \table-of-contents}. Die Elemente, die im
Inhaltsverzeichnis aufgelistet werden sollen, werden mit dem
@code{\tocItem}-Befehl markiert, welches sowohl auf höchster
Ebene als auch in einem musikalischen Ausdruck verwendet werden
kann.
@verbatim
-\markuplines \table-of-contents
+\markuplist \table-of-contents
\pageBreak
\tocItem \markup "Erste Partitur"
(add-toc-item! 'tocActMarkup text))
\book {
- \markuplines \table-of-contents
+ \markuplist \table-of-contents
\tocAct \markup { Atto Primo }
\tocItem \markup { Coro. Viva il nostro Alcide }
\tocItem \markup { Cesare. Presti omai l'Egizzia terra }
}
@end lilypond
+Die Zeile zwischen dem Inhalt und der Seitenzahl kann mit einer gepunkteten
+Linie gefüllt werden:
+
+@lilypond[verbatim,quote]
+\header { tagline = ##f }
+\paper {
+ tocItemMarkup = \tocItemWithDotsMarkup
+}
+
+\book {
+ \markuplist \table-of-contents
+ \tocItem \markup { Allegro }
+ \tocItem \markup { Largo }
+ \markup \null
+}
+@end lilypond
+
@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
@menu
* Variablen benutzen::
* Marken benutzen::
+* Globale Einstellungen benutzen::
@end menu
@node Variablen benutzen
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
}
@end ignore
+@node Globale Einstellungen benutzen
+@unnumberedsubsubsec Globale Einstellungen benutzen
+@translationof Using global settings
+
+@funindex include-settings
+
+Man kann globale Einstellungen aus einer externen Datei einfügen:
+
+@example
+lilypond -dinclude-settings=MY_SETTINGS.ly MY_SCORE.ly
+@end example
+
+
+Einstellungsgruppen, wie etwa Seitengröße, Schriftart oder Schriftschnitt, können
+in eigenen Dateien gespeichert werden. Das ermöglicht es, aus der gleichen
+Partitur unterschiedliche Editionen zu erstellen bzw. Standardeinstellungen
+für eine ganze Anzahl von Partituren wiederzuverwenden, indem man einfach
+die entsprechende Einstellungsdatei angibt.
+
+Diese Technik funktioniert auch gut für globale Formatierungen, wie behandelt
+in @rlearning{Globale Formatierung}.
+
+@seealso
+Handbuch zum Lernen:
+@rlearning{Stücke durch Bezeichner organisieren},
+@rlearning{Globale Formatierung}.
+
+Notationsreferenz:
+@ref{LilyPond-Dateien einfügen}.
+
+
@node Zeichenkodierung
@subsection Zeichenkodierung
@translationof Text encoding
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
}
\addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
}
-\markup { "Copyright 2008--2010" \char ##x00A9 }
+\markup { "Copyright 2008--2011" \char ##x00A9 }
@end lilypond
@cindex Copyright-Zeichen
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
bei der Überprüfung: falsche Oktaven oder falsche Versetzungszeichen
lassen sich meist sehr gut hören.
+Normale MIDI-Ausgabe ist etwas roh; optional kann eine verbesserte und
+realistischere MIDI-Ausgabe mit einem @ref{Artikuliere-Skript}
+erzeugt werden.
+
Die MIDI-Ausgabe benötigt einen Kanal für jedes System und einen für
globale Einstellungen. Darum sollte die Quelldatei für eine MIDI-Datei
nicht mehr als 15 Systeme (oder 14 wenn kein Schlagzeug benützt wird)
* Wiederholungen im MIDI::
* MIDI-Lautstärke kontrollieren::
* Schlagzeug in MIDI::
+* Artikuliere-Skript::
@end menu
@snippets
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{changing-midi-output-to-one-channel-per-voice.ly}
@knownissues
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
@cindex MIDI, Akkordsymbole
@cindex Rhythmen in MIDI
@cindex MIDI, Rhythmen
+@cindex Artikuliere-Skript
+@cindex MIDI, Artikuliere-Skript
+@cindex MIDI, Artikulationen
+@cindex Triller in MIDI
+@cindex Verzierungen in MIDI
+@cindex Rallantando in MIDI
+@cindex Accelerando in MIDI
Die folgenden Notationselemente werden in die MIDI-Ausgabe aufgenommen:
@item Gesangstext
@end itemize
+Durch Einsatz vom @ref{Artikuliere-Skript} können noch einige Elemente
+zu der Liste hinzugefügt werden:
+
+@itemize
+@item Artikulationen (Bögen, Staccato usw.)
+@item Triller usw.
+@item Rallentando und accelerando
+@end itemize
+
@unnumberedsubsubsec In MIDI nicht unterstützt
-Folgende Notationselemente werden nicht in die MIDI-Ausgabe einbezogen:
+Folgende Notationselemente werden nicht in die MIDI-Ausgabe einbezogen,
+außer am setzt das @ref{Artikuliere-Skript} ein:
@itemize
@item Rhythmus, der als Anmerkung notiert wird, bspw. Swing
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
Weil der MIDI-Standard keine Peitschenschläge kennt, wird ein
Schlagstock (sidestick) für diesen Zweck eingesetzt.
+
+
+@node Artikuliere-Skript
+@subsection Artikuliere-Skript
+@translationof The Articulate script
+
+Eine realistischere MIDI-Ausgabe ist möglich, wenn man das
+Artikuliere-Skript einsetzt. Es versucht, Artikulationen
+(Bögen, Staccato) mit einzubeziehen, indem Noten mit
+sequentieller Musik von passender Verlängerung oder Verkürzung
+mit entprechenden Skips ersetzt werden. Es versucht auch,
+Triller usw. klingen zu lassen und rallantando und
+accelerando wahrzunehmen.
+
+Um das Artikuliere-Skript einzusetzen, muss oben in der
+Eingabedatei
+
+@example
+\include "articulate.ly"
+@end example
+
+@noindent
+eingefügt werden. Im @code{\score}-Abschnitt schreibt man
+
+@example
+\unfoldRepeats \articulate <<
+ der Rest der Partitur...
+>>
+@end example
+
+Wenn die Eingabedatei auf diese Art verändert wurd, wird die
+Notenausgabe stark verändert, aber die MIDI-Ausgabe produziert
+ein besseres Ergebnis.
+
+Wenn auch nicht unbedingt notwendig, damit das Artikuliere-Skript
+funktioniert, bietet es sich an, @code{\unfoldRepeats} wie im
+Beispiel oben zu verwenden, weil dadurch Abkürzungen wie etwa
+Triller ausgeführt werden.
+
+@knownissues
+
+Articulate verkürzt Akkorde und manche Musik (besonders Orgelmusik)
+kann schlechter klingen.
projects / lilypond.git / blobdiff