]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/de/notation/input.itely
Docs: Get rid of lilyquote snippet option, replaced by ordinary quote
[lilypond.git] / Documentation / de / notation / input.itely
index 4fbc16448441d36032e8affe38488dedff043040..7ab810733c1aa11950e4f3e728df3c25b8ce62c1 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 
 @ignore
-    Translation of GIT committish: 70aaf0159410169678942abd39eb13c876521437
+    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.13.36"
+@c \version "2.14.0"
 
 @c Translators: Till Paala
 
@@ -33,7 +33,7 @@ Notation mit LilyPond und weniger direkte Fragen der Notation.
 @translationof Input structure
 
 Das hauptsächliche Eingabeformat von LilyPond sind Textdateien.
-Üblicherweise werden diese Dateien mit der Endung @file{@/.ly}
+Üblicherweise werden diese Dateien mit der Endung @file{.ly}
 versehen.
 
 @menu
@@ -113,8 +113,8 @@ 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}.
+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},
@@ -163,7 +163,7 @@ und Texte werden mit einer @code{\markup}-Umgebung geschrieben:
 
 @funindex \book
 
-Alle Sätze und Texte, die in derselben @file{@/.ly}-Datei vorkommen,
+Alle Sätze und Texte, die in derselben @file{.ly}-Datei vorkommen,
 werden normalerweise in eine einzige Ausgabedatei gesetzt.
 
 @example
@@ -241,7 +241,7 @@ einem Titel innerhalb einer @code{\header}-Umgebung beginnen.
 @subsection Mehrere Ausgabedateien aus einer Eingabedatei
 @translationof Multiple output files from one input file
 
-Wenn Sie mehrere Ausgabedateien aus derselben @file{@/.ly}-Datei haben
+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
@@ -280,11 +280,11 @@ produziert also
 
 @itemize
 @item
-@file{eightminiatures@/.pdf},
+@file{eightminiatures.pdf},
 @item
-@file{eightminiatures@/-1@/.pdf} and
+@file{eightminiatures-1.pdf} and
 @item
-@file{eightminiatures@/-2@/.pdf}.
+@file{eightminiatures-2.pdf}.
 @end itemize
 
 
@@ -303,8 +303,8 @@ 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
+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.
 
@@ -352,11 +352,11 @@ Die obige Datei produziert folgene Ausgabedateien:
 
 @itemize
 @item
-@file{Romanze@/.pdf},
+@file{Romanze.pdf},
 @item
-@file{Menuetto@/.pdf} and
+@file{Menuetto.pdf} and
 @item
-@file{Nocturne@/.pdf}.
+@file{Nocturne.pdf}.
 @end itemize
 @node Die Dateistruktur
 @subsection Die Dateistruktur
@@ -375,7 +375,7 @@ Die obige Datei produziert folgene Ausgabedateien:
 @cindex Eingabedatei, Struktur
 @cindex Quelldatei, Struktur
 
-Eine @file{@/.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:
 
@@ -403,7 +403,7 @@ zusammen mit anderen vorkommenden @code{\score}-Umgebungen gesammelt
 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
@@ -419,7 +419,7 @@ muss, wenn mehr als eine @code{\score}- oder @code{\markup}-Umgebung
 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
@@ -458,7 +458,7 @@ beinhaltet, wird übersetzt zu
 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:
@@ -561,7 +561,7 @@ zur Verfügung gestellt.
 
 @menu
 * Titel erstellen::
-* Eigene Titel::
+* Eigene Kopf und Fußzeilen sowie Titel::
 * Verweis auf die Seitenzahlen::
 * Inhaltsverzeichnis::
 @end menu
@@ -763,13 +763,13 @@ falsch gesetzt wird:
 @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
@@ -829,16 +829,46 @@ und auf der letzten Seite die Tag-Zeile gesetzt.
 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
@@ -1014,10 +1044,27 @@ tocAct =
 }
 @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 {
+  \markuplines \table-of-contents
+  \tocItem \markup { Allegro }
+  \tocItem \markup { Largo }
+  \markup \null
+}
+@end lilypond
+
 
 @seealso
 Installierte Dateien:
-@file{@/.@/./@/ly/@/toc@/-init@/.ly}.
+@file{../ly/toc-init.ly}.
 
 @funindex \table-of-contents
 @funindex \tocItem
@@ -1059,7 +1106,7 @@ Um eine andere Datei einzubinden, kann der Befehl
 benutzt werden.
 
 Die Zeile @code{\include "andereDatei.ly"} benimmt sich genauso,
-also ob der Inhalt der Datei @file{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
@@ -1075,7 +1122,7 @@ Stellen können eingebunden werden, indem entweder ein vollständiger
 Pfad oder ein relativer Pfad zu der Datei angegeben wird.  Hierbei
 sollten die für UNIX typischen Schrägstriche (/) und nicht die
 rückwärtsgeneigten von Windows (\) verwendet werden, um die Verzeichnisse
-zu trennen.  Wenn etwa die Datei @file{kram@/.ly} ein Verzeichnis
+zu trennen.  Wenn etwa die Datei @file{kram.ly} ein Verzeichnis
 höher liegt als das aktuelle Verzeichnis, sollte der Befehl so
 aussehen:
 
@@ -1111,9 +1158,9 @@ Dateien können auch aus einem Verzeichnis eingebunden werden,
 dass im Suchpfad von LilyPond liegt.  Hierzu muss auf der
 Kommandozeile das entsprechende Verzeichnis angegeben werden
 und die Dateien, die eingebunden werden, müssen nur mit ihrem Namen
-notiert sein.  Wenn etwa die Datei @file{Haupt@/.ly} kompiliert
+notiert sein.  Wenn etwa die Datei @file{Haupt.ly} kompiliert
 werden soll, die Dateien aus dem Unterverzeichnis @file{stimmen}
-einbindet, müssen sie sich im Verzeichnis von @file{Haupt@/.ly}
+einbindet, müssen sie sich im Verzeichnis von @file{Haupt.ly}
 befinden und dann LilyPond folgendermaßen aufrufen:
 
 @example
@@ -1121,7 +1168,7 @@ lilypond --include=stimmen Haupt.ly
 @end example
 
 @noindent
-In @file{Haupt@/.ly} steht:
+In @file{Haupt.ly} steht:
 
 @example
 \include "VI.ly"
@@ -1130,11 +1177,11 @@ In @file{Haupt@/.ly} steht:
 @end example
 
 Dateien, die in vielen Partituren verwendet werden sollen, können
-im LilyPond-Verzeichnis @file{@/.@/./@/ly} gespeichert werden.  (Die
+im LilyPond-Verzeichnis @file{../ly} gespeichert werden.  (Die
 Stelle, an der dieses Verzeichnis sich befindet, hängt vom Betriebssystem
 ab, siehe hierzu @rlearning{Mehr Information}).  Dateien
 in diesem Verzeichnis können einfach mit ihrem Namen eingefügt werden.
-So werden auch die Sprachdateien wie etwa @file{deutsch@/.ly} eingefügt.
+So werden auch die Sprachdateien wie etwa @file{deutsch.ly} eingefügt.
 
 LilyPond lädt eine Anzahl an Dateien, wenn das Programm aufgerufen wird.
 Diese Dateien sind für den Benutzer nicht ersichtlich, aber die Dateien
@@ -1181,6 +1228,7 @@ ohne dass man Änderungen an den Noten vornehmen muss.
 @menu
 * Variablen benutzen::
 * Marken benutzen::
+* Globale Einstellungen benutzen::
 @end menu
 
 @node Variablen benutzen
@@ -1418,6 +1466,37 @@ than one tagged section at the same place.
 @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
@@ -1521,7 +1600,7 @@ im Gesangstext und als normaler Text außerhalb der Partitur.
   }
   \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
@@ -1752,6 +1831,10 @@ man sich anhören kann, was man notiert hat.  Das hilft oft sehr gut
 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)
@@ -1765,6 +1848,7 @@ besitzen.  Jedes weitere System bleibt stumm.
 * Wiederholungen im MIDI::
 * MIDI-Lautstärke kontrollieren::
 * Schlagzeug in MIDI::
+* Artikuliere-Skript::
 @end menu
 
 
@@ -1862,7 +1946,7 @@ der Liste entspricht, wird ein Piano-Klang benutzt (@code{"acoustic grand"}).
 
 @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
@@ -1920,7 +2004,7 @@ Kontextdefinitionen des @code{\midi}-Kontextes entsprechen
 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:
@@ -1964,6 +2048,13 @@ in eine Partiturumgebung eingefügt wird, die mit dem Befehl
 @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:
 
@@ -1981,10 +2072,20 @@ Spieler benötigt, der Tonhöhen verändern kann.)
 @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
@@ -2062,7 +2163,7 @@ Dynamikanweisungen werden als ein bestimmter Bruch der insgesamt
 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
@@ -2100,7 +2201,7 @@ Standardanweisungen auf:
 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.
 
@@ -2218,7 +2319,7 @@ nicht vorgegeben werden, nimmt LilyPond standardmäßig einige
 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
@@ -2230,7 +2331,7 @@ auf gleiche Weise vorgenommen, wie es schon für die
 @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
@@ -2313,3 +2414,46 @@ kommt.
 
 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.