@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@ignore
- Translation of GIT committish: 5cf864d550e7148412d594cf336841791bff6f76
+ Translation of GIT committish: ebe492ca408fb0d9abf80b94c56197eef8dc2f09
When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
+ 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.25"
+
+@c Translators: Till Paala
@node Allgemeine Eingabe und Ausgabe
@chapter Allgemeine Eingabe und Ausgabe
* Arbeiten an Eingabe-Dateien::
* Ausgabe kontrollieren::
* MIDI-Ausgabe::
+* Musikalische Information extrahieren::
@end menu
@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
Dieser einzelne musikalische Ausdruck kann beliebige Größe annehmen und
andere musikalische Ausdrücke von beliebiger Komplexität beinhalten.
-Alle diese Beispielse sind musikalische Ausdrücke:
+Alle diese Beispiele sind musikalische Ausdrücke:
@example
@{ c'4 c' c' c' @}
@lilypond[verbatim,quote]
{
- { c'4 c' c' c'}
- { d'4 d' d' d'}
+ { c'4 c' c' c' }
+ { d'4 d' d' d' }
}
@end lilypond
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{Die 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{Die 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{Die 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 belibige Anzahl an Ausdrücken
-auf der obersten Ebene beinhalten, wobei ein Ausdrück der obersten
+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
die globalen Einstellungen für das ganze @qq{Buch}. Wenn mehr
-als eine derarte Definition desselben Typs angegeben wird, hat
+als eine derartige Definition desselben Typs angegeben wird, hat
die spätere Vorrang.
@item
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
@{ c'4 d' e'2 @}
@}
@}
+ \layout @{ @}
@}
- \layout @{ @}
- \header @{ @}
+ \paper @{ @}
+ \header @{ @}
@}
@end example
Dieses Verhalten kann verändert werden, indem die Variable
-@code{toplevel-music-handler} auf der oberseten Ebene gesetzt
+@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:
@end example
Sie kann dann später in der Datei eingesetzt werden, indem @code{\foo}
-geschrieben wird. Die Beizeichnung der Variable darf nur aus
+geschrieben wird. Die Bezeichnung der Variable darf nur aus
alphabetischen Zeichen bestehen, keine Zahlen, Unter- oder Bindestriche.
@end itemize
@code{\} beginnt,
@item
nach jeder Einheit, die als Scheme-Ausdruck interpretiert werden,
-also alle Einheiten, die mit @code{#} beginnen.
+also alle Einheiten, die mit@tie{}@code{#} beginnen.
@item
Alle Einheiten von Scheme-Ausdrücken müssen mit Leerzeichen getrennt
werden,
@end itemize
@seealso
-Hanbuch zum Lernen:
+Handbuch zum Lernen:
@rlearning{Wie eine LilyPond-Eingabe-Datei funktioniert}.
zur Verfügung gestellt.
@menu
-* Titel erstellen::
-* Eigene Titel::
+* Titel Kopf und Fußzeilen erstellen::
+* Eigene Kopf und Fußzeilen sowie Titel::
+* Fußnoten erstellen::
* Verweis auf die Seitenzahlen::
* Inhaltsverzeichnis::
@end menu
-@node Titel erstellen
-@subsection Titel erstellen
-@translationof Creating titles
-
-Überschriften können für jede @code{\score}-Umgebung erstellt werden, sowohl
-für die gesamte Datei (oder eine @code{\book}-Umgebung) als auch für
-einzelne Buchabschnitte (innerhalb einer @code{\bookpart}-Umgebung).
+@node Titel Kopf und Fußzeilen erstellen
+@subsection Titel, Kopf- und Fußzeilen erstellen
+@translationof Creating titles headers and footers
-Der Inhalt der Titelei wird aus der @code{\header}-Umgebung übernommen. Die
-@code{\header}-Umgebung eines Buches unterstützt folgende Felder:
+@menu
+* Wie funktioniert die Titel-Umgebung?::
+* Standardlayout von book und Partitur Titelumgebungen::
+* Standardlayout von Kopf und Fußzeilen::
+@end menu
-@table @code
-@funindex dedication
-@item dedication
-Die Widmung der Noten, wird auf oben auf der ersten Seite gesetzt.
-@funindex title
-@item title
-Die Überschrift der Noten, wird unter der Widmung zentriert gesetzt.
+@node Wie funktioniert die Titel-Umgebung?
+@unnumberedsubsubsec Wie funktioniert die Titel-Umgebung?
+@translationof Title blocks explained
-@funindex subtitle
-@item subtitle
-Untertitel, zentriert unter der Überschrift.
+@c TODO: figure out how \bookpart titles work
-@funindex subsubtitle
-@item subsubtitle
-Unteruntertitel, zentriert unter dem Untertitel.
+Es gibt zwei Arten von Titelumgebungen: die Hauptumgebung, die über
+der ersten @code{\score}-Umgebung innerhalb eines @qq{book} notiert
+wird, und individuelle Titelumgebungen, die innerhalb von
+@code{\score} auftreten können. Textfelder für beide Typen werden
+in der @code{\header}-Umgebung eingegeben.
-@funindex poet
-@item poet
-Name des Dichters, linksbündig unter dem Unteruntertitel.
+Wenn in dem @qq{book} nur eine einzelne Partitur vorkommt,
+kann die @code{\header}-Umgebung innheralb oder außerhalb der
+@code{\score}-Umgebung geschrieben werden.
-@funindex instrument
-@item instrument
-Bezeichnung des Instruments, zentriert unter dem Unteruntertitel.
-Auch oben auf der Seite zentriert (andere als erste Seite).
+@warning{Denken Sie daran, dass zuerst ein musikalischer Ausdruck
+notiert werden muss, wenn Sie eine @bs{}@code{header}-Umgebung innheralb
+einer @bs{}@code{score}-Umgebung verwenden wollen.}
-@funindex composer
-@item composer
-Name des Komponisten, rechtsbüngig unter dem Unteruntertitel.
+@lilypond[papersize=a5,quote,verbatim,noragged-right]
+\header {
+ title = "SUITE I."
+ composer = "J. S. Bach."
+}
-@funindex meter
-@item meter
-Metrum, linksbündig unter dem Dichter.
+\score {
+ \new Staff \relative g, {
+ \clef bass
+ \key g \major
+ \repeat unfold 2 { g16( d' b') a b d, b' d, } |
+ \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
+ }
+ \header {
+ piece = "Prélude."
+ }
+}
-@funindex arranger
-@item arranger
-Name des Bearbeiters/Arrangeurs, rechtsbündig unter dem Komponisten.
+\score {
+ \new Staff \relative b {
+ \clef bass
+ \key g \major
+ \partial 16 b16 |
+ <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
+ d16( b g fis) g( e d c) b(c d e) fis( g a b) |
+ }
+ \header {
+ piece = "Allemande."
+ }
+}
+@end lilypond
-@funindex piece
-@item piece
-Bezeichnung des Stückes, linksbündig unter dem Metrum.
+Textfelder der Haupttitelumgebung können in allen @code{\score}-Umgebungen
+gesetzt oder manuell unterdrückt werden:
-@funindex opus
-@item opus
-Bezeichnung des Opus, rechtsbündig unter dem Bearbeiter.
+@lilypond[papersize=a5,quote,verbatim,noragged-right]
+\book {
+ \paper {
+ print-all-headers = ##t
+ }
+ \header {
+ title = "DAS WOHLTEMPERIRTE CLAVIER"
+ subtitle = "TEIL I"
+ % Do not display the tagline for this book
+ tagline = ##f
+ }
+ \markup { \vspace #1 }
+ \score {
+ \new PianoStaff <<
+ \new Staff { s1 }
+ \new Staff { \clef "bass" s1 }
+ >>
+ \header {
+ title = "PRAELUDIUM I"
+ opus = "BWV 846"
+ % Do not display the subtitle for this score
+ subtitle = ##f
+ }
+ }
+ \score {
+ \new PianoStaff <<
+ \new Staff { s1 }
+ \new Staff { \clef "bass" s1 }
+ >>
+ \header {
+ title = "FUGA I"
+ subsubtitle = "A 4 VOCI"
+ opus = "BWV 846"
+ % Do not display the subtitle for this score
+ subtitle = ##f
+ }
+ }
+}
+@end lilypond
-@cindex Seitenumbruch, erzwingen
-@funindex breakbefore
+@seealso
+Notationsreferenz:
+@ref{Die Dateistruktur},
+@ref{Angepasstes Layout für Titelumgebungen}.
+
+
+@node Standardlayout von book und Partitur Titelumgebungen
+@unnumberedsubsubsec Standardlayout von @code{book}- und Partitur-Titelumgebungen
+@translationof Default layout of book and score title blocks
+
+Layout und Formatierung der Titelfelder wird durch zwei
+@code{\paper}-Variablen kontrolliert: @code{bookTitleMarkup} für
+die Hauptumgebung und @code{scoreTitleMarkup} für einzelne
+@code{\header}-Umgebungen innerhalb von einer @code{\score}-Umgebung.
+
+@lilypond[papersize=a6,quote,verbatim,noragged-right]
+\header {
+ % The following fields are centered
+ dedication = "Dedication"
+ title = "Title"
+ subtitle = "Subtitle"
+ subsubtitle = "Subsubtitle"
+ instrument = "Instrument"
+
+ % The following fields are left-aligned on the left side
+ poet = "Poet"
+ meter = "Meter"
+
+ % The following fields are right-aligned on the right side
+ composer = "Composer"
+ arranger = "Arranger"
+}
-@item breakbefore
-Hiermit beginnt der Titel auf einer neuen Steite. (Kann die Werte
-##t (wahr) oder ##f (falsch) haben.)
+\score {
+ { s1 }
+ \header {
+ % The following fields are placed at opposite ends of the same line
+ piece = "Piece"
+ opus = "Opus"
+ }
+}
+@end lilypond
-@funindex copyright
-@item copyright
-Anzeige eines Copyright, zentriert unten auf der ersten Seite. Um das
-Copyright-Symbol zu notieren, siehe @ref{Zeichenkodierung}.
+@c Is the bit about \null markups true? -mp
-@funindex tagline
-@item tagline
-Zentriert unten auf der letzten Seite. Enthält standardmäßig: @qq{Music
-engraving by LilyPond (@var{version})---www.lilypond.org}
+Textfelder, die in einer @code{\header}-Umgebung nicht benutzt werden,
+werden durch @code{\null}-Textbeschriftung ersetzt, sodass sie keinen
+leeren Platz belegen.
-@end table
+Die Standardeinstellungen von @code{scoreTitleMarkup} platzieren
+die Felder @code{piece} (Stück) und @code{opus} zu den gegenüberliegenden
+Seiten der selben Zeile.
-Hier eine Demonstration der möglichen Felder. Beliebige
-Formatierungsbefehle für Textbeschriftung können in der Titelei
-eingesetzt werden. Siehe hierzu auch @ref{Text formatieren}.
+@funindex breakbefore
-@c KEEP LY
-@lilypond[quote,verbatim,line-width=11.0\cm]
-\paper {
- line-width = 9.0\cm
- paper-height = 10.0\cm
-}
+Mit der Variable @code{breakbefore} innerhalb einer @code{\header}-Umgebung,
+die für sich auch eine @code{\score}-Umgebung darstellt, kann man
+die Hauptüberschriften auf der ersten Seite allein ausgeben, sodass die
+Noten (in der @code{score}-Umgebung definiert) erst auf der folgenden
+Seite beginnen.
+@lilypond[papersize=a8landscape,verbatim,noragged-right]
\book {
\header {
- dedication = "mir gewidmet"
- title = \markup \center-column { "Titel erste Zeile" "Titel zweite Zeile, länger" }
- subtitle = "Untertitel"
- subsubtitle = #(string-append "Unteruntertitel LilyPond-Version "
-(lilypond-version))
- poet = "Dichter"
- composer = \markup \center-column { "Komponist" \small "(1847-1973)" }
- texttranslator = "Übersetzer"
- meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "r" \huge
-"um" }
- arranger = \markup { \fontsize #8.5 "Be" \fontsize #2.5 "ar" \fontsize
-#-2.5 "be" \fontsize #-5.3 "i" \fontsize #7.5 "ter" }
- instrument = \markup \bold \italic "Instrument"
- piece = "Stück"
+ title = "This is my Title"
+ subtitle = "This is my Subtitle"
+ copyright = "This is the bottom of the first page"
}
-
\score {
- { c'1 }
+ \repeat unfold 4 { e'' e'' e'' e'' }
\header {
- piece = "Stück zwei"
- opus = "Opus1"
+ piece = "This is the Music"
+ breakbefore = ##t
+ }
+ }
+}
+@end lilypond
+
+@seealso
+Handbuch zum Lernen:
+@rlearning{Wie eine LilyPond-Eingabe-Datei funktioniert},
+
+Notationsreferenz:
+@ref{Die Dateistruktur}.
+
+Installierte Dateien:
+@file{ly/titling-init.ly}.
+
+
+@node Standardlayout von Kopf und Fußzeilen
+@unnumberedsubsubsec Standardlayout von Kopf- und Fußzeilen
+@translationof Default layout of headers and footers
+
+@emph{Kopf-} und @emph{Fußzeilen} sind Textzeilen, die ganz oben
+und ganz unten auf der Seite stehen, unabhängig vom Textbereich eines
+Buches. Sie können mit folgenden @code{\paper}-Variablen kontrolliert
+werden:
+
+@itemize
+@item @code{oddHeaderMarkup}
+@item @code{evenHeaderMarkup}
+@item @code{oddFooterMarkup}
+@item @code{evenFooterMarkup}
+@end itemize
+
+Diese Beschriftungsvariablen können nur auf Textfelder einer
+Haupttitelumgebung (eine @code{\header}-Umgebung auf höchster Ebene, die
+sich auf alle @code{\score}-Umgebungen einer Datei bezieht)
+zugreifen und sind definiert in der Datei @file{ly/titling-init.ly}. In
+den Standardeinstellungen
+
+@itemize
+
+@item
+werden Seitenzahlen automatisch ganz oben links (wenn gerade) oder ganz
+oben rechts (wenn ungerade) gesetzt, beginnend mit der zweiten Seite.
+
+@item
+wird das @code{instrument}-Textfeld auf jeder Seite zentriert, beginnend
+mit der zweiten Seite.
+
+@item
+wird der @code{copyright}-Text unten auf der ersten Zeite zentriert.
+
+@item
+wird der Inhalt von @code{tagline} unten auf der letzten Seite zentriert
+und unterhalb des @code{copyright}-Texts, wenn es sich nur um eine Seite
+handelt.
+
+@end itemize
+
+@lilypond[papersize=a8landscape]
+\book {
+ \score {
+ \relative c' {
+ c4 d e f
}
}
- \markup {
- und jetzt...
+}
+@end lilypond
+
+Die Standardeinstellung von @code{tagline} kann verändert werden,
+indem man ein @code{tagline}-Feld in die @code{\header}-Umgebung auf
+höchster Ebene schreibt.
+
+@lilypond[papersize=a8landscape,verbatim]
+\book {
+ \header {
+ tagline = "... music notation for Everyone"
}
\score {
- { c'1 }
- \header {
- piece = "Stück2"
- opus = "Opus2"
+ \relative c' {
+ c4 d e f
}
}
}
@end lilypond
-Wie schon oben gezeigt, können mehrfache @code{\header}-Umgebungen
-eingesetzt werden. Wenn das gleiche Feld in mehreren
-Umgebungen, wird die letzte vorkommende
-Version benutzt. Hier ein kurzes Beispiel:
+Um die @emph{tagline} ganz zu entfernen, wird ihr Inhalb als @code{##f}
+(falsch) definiert.
+
+
+@node Eigene Kopf und Fußzeilen sowie Titel
+@subsection Eigene Kopf- und Fußzeilen sowie Titel
+@translationof Custom headers footers and titles
+
+@c TODO: somewhere put a link to header spacing info
+@c (you'll have to explain it more in NR 4).
+
+@menu
+* Angepasste Textformatierung für Titelumgebungen::
+* Angepasstes Layout für Titelumgebungen::
+* Angepasstes Layout für Kopf und Fußzeilen::
+@end menu
+
+
+@node Angepasste Textformatierung für Titelumgebungen
+@unnumberedsubsubsec Angepasste Textformatierung für Titelumgebungen
+@translationof Custom text formatting for title blocks
+
+Standard-@code{\markup}-Befehle können eingesetzt werden, um jeglichen
+Text in Titeln, Kopf- und Fußzeilen innerhalb der @code{\header}-Umgebung
+zu verändern.
+
+@lilypond[quote,verbatim,noragged-right]
+\score {
+ { s1 }
+ \header {
+ piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
+ subtitle = \markup { \italic "(Excerpt)" }
+ }
+}
+@end lilypond
+
+@seealso
+Notationsreferenz:
+@ref{Text formatieren}.
+
+
+@node Angepasstes Layout für Titelumgebungen
+@unnumberedsubsubsec Angepasstes Layout für Titelumgebungen
+@translationof Custom layout for title blocks
+
+@code{\markup}-Befehle in der @code{\header}-Umgebung sind sinnvoll
+für einfaches Formatieren von Text, aber sie gewähren keine genaue
+Kontrolle über die Positionierung von Titeln. Um die Positionierung
+von Titeltextfeldern vorzunehmen, eignen sich beide oder eine von
+folgenden Variablen (die man in der @code{\paper}-Umgebung einsetzen muss):
+
+@itemize
+@item @code{bookTitleMarkup}
+@item @code{scoreTitleMarkup}
+@end itemize
+
+Diese Beschriftungsvariablen sind behandelt in
+@ref{Standardlayout von book und Partitur Titelumgebungen}.
+
+Die Standardeinstellungen von @code{scoreTitleMarkup}, wie in der
+Datei @file{ly/titling-init.ly} definiert, sind:
@example
-\header @{
- composer = "Komponist"
-@}
-\header @{
- piece = "Stück"
-@}
-\score @{
- \new Staff @{ c'4 @}
- \header @{
- piece = "Neues Stück" % überschreibt die die vorige Definition
+scoreTitleMarkup = \markup @{ \column @{
+ \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
+ \fill-line @{
+ \fromproperty #'header:piece
+ \fromproperty #'header:opus
@}
@}
+@}
@end example
-Wenn @code{\header} innerhalb der @code{\score}-Umgebung definiert wird,
-wird normalerweise nur die Information von @code{piece} und @code{opus}
-ausgegeben. Musikalische Ausdrücke innerhalb von @code{\score} müssen
-vor @code{\header} gesetzt werden.
+Dadurch werden die Textfelder @code{piece} (Stück) und @code{opus}
+an den gegenüberliegenden Enden der gleichen Zeile platziert:
-@lilypond[quote,verbatim,line-width=11.0\cm]
+@lilypond[quote,verbatim,noragged-right]
\score {
- { c'4 }
+ { s1 }
\header {
- title = "title" % not printed
- piece = "piece"
- opus = "opus"
+ piece = "PRAELUDIUM I"
+ opus = "BWV 846"
}
}
@end lilypond
-@funindex print-all-headers
+Das folgende Beispiel verändert die Einstellungen von
+@code{scoreTitleMarkup}, sodass das Textfeld @code{piece}
+zentriert wird und in fetter, größerer Schrift erscheint.
-@noindent
-Dieses Verhalten kann verändert werden (sodass alle Angaben aus der
-überschrift gesetzt werden, wenn sich @code{\header} innerhalb von
-@code{\score} befindet), indem man schreibt:
+@lilypond[papersize=a5,quote,verbatim,noragged-right]
+\book {
+ \paper {
+ indent = 0\mm
+ scoreTitleMarkup = \markup {
+ \fill-line {
+ \null
+ \fontsize #4 \bold \fromproperty #'header:piece
+ \fromproperty #'header:opus
+ }
+ }
+ }
+ \header { tagline = ##f }
+ \score {
+ { s1 }
+ \header {
+ piece = "PRAELUDIUM I"
+ opus = "BWV 846"
+ }
+ }
+}
+@end lilypond
-@example
-\paper@{
- print-all-headers = ##t
-@}
-@end example
+Textfelder, die normalerweise nur im Haupttitel ausgegeben werden,
+können auch in die Titel einzelner Partituren aufgenommen werden,
+indem man @code{print-all-headers} in die @code{\paper}-Umgebung einfügt.
+Ein Nachteil dieser Methode ist, dass Textfelder, die tatsächlich nur
+im Haupttitel erscheinen sollen, manuell für jede Partitur unterdrückt
+werden müssen. Siehe auch @ref{Wie funktioniert die Titel-Umgebung?}.
-@cindex Copyright
-@cindex Tagline
+Um das zu vermeiden, kann das gewünschte Feld zur Definition von
+@code{scoreTitleMarkup} hinzugefügt werden. Im folgenden Beispiel
+wird das Komponistenfeld (@code{composer}) (normalerweise mit
+@code{bookTitleMarkup} assoziiert) zu @code{scoreTitleMarkup}
+hinzugefügt, sodass jede Partitur einen eigenen Komponisten haben kann.
-Die Standardfußzeile ist leer mit Ausnahme der ersten Seite, auf der
-das @code{copyright}-Feld aus der @code{\header}-Umgebung eingefügt wird,
-und die letzte Seite, auf der das @code{tagline}-Feld eingefügt wird.
-Der Standardinhalt von @code{tagline} ist @qq{Music engraving by
-LilyPond (@var{version})---www.lilypond.org}. Gut gesetzte Noten werben sehr effektiv
-für LilyPond, darum bitten wir darum, diese Zeile stehen zu lassen,
-wenn es möglich ist.
+@lilypond[papersize=a5,quote,verbatim,noragged-right]
+\book {
+ \paper {
+ indent = 0\mm
+ scoreTitleMarkup = \markup {
+ \fill-line {
+ \null
+ \fontsize #4 \bold \fromproperty #'header:piece
+ \fromproperty #'header:composer
+ }
+ }
+ }
+ \header { tagline = ##f }
+ \score {
+ { s1 }
+ \header {
+ piece = "MENUET"
+ composer = "Christian Petzold"
+ }
+ }
+ \score {
+ { s1 }
+ \header {
+ piece = "RONDEAU"
+ composer = "François Couperin"
+ }
+ }
+}
+@end lilypond
-Ein Titelfeld kann vollständig entfernt werden, indem es auf
-falsch gesetzt wird:
+Es ist auch möglich, eigene Textfelder zu erstellen und dann auf sie
+in der Beschriftungsdefinition zu verweisen:
-@example
-\header @{
- tagline = ##f
- composer = ##f
-@}
-@end example
+@lilypond[papersize=a5,quote,verbatim,noragged-right]
+\book {
+ \paper {
+ indent = 0\mm
+ scoreTitleMarkup = \markup {
+ \fill-line {
+ \null
+ \override #`(direction . ,UP) {
+ \dir-column {
+ \center-align \fontsize #-1 \bold
+ \fromproperty #'header:mycustomtext %% User-defined field
+ \center-align \fontsize #4 \bold
+ \fromproperty #'header:piece
+ }
+ }
+ \fromproperty #'header:opus
+ }
+ }
+ }
+ \header { tagline = ##f }
+ \score {
+ { s1 }
+ \header {
+ piece = "FUGA I"
+ mycustomtext = "A 4 VOCI" %% User-defined field
+ opus = "BWV 846"
+ }
+ }
+}
+@end lilypond
+@seealso
+Notationsreferenz:
+@ref{Wie funktioniert die Titel-Umgebung?}.
-@node Eigene Titel
-@subsection Eigene Titel
-@translationof Custom 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
-Standardverhalten.
+@node Angepasstes Layout für Kopf und Fußzeilen
+@unnumberedsubsubsec Angepasstes Layout für Kopf- und Fußzeilen
+@translationof Custom layout for headers and footers
-@table @code
+@c can make-header and make-footer be removed from
+@c paper-defaults-init.ly? -mp
-@funindex bookTitleMarkup
+@code{\markup}-Befehle in der @code{\header}-Umgebung sind nützlich
+um einfachen Text zu formatieren, erlauben aber keine Kontrolle
+über die Positionierung von Kopf- und Fußzeilen. Um die Positionierung
+der Textfelder zu ändern, eignen sich beide oder eine von
+folgenden Variablen (die man in der @code{\paper}-Umgebung einsetzen muss):
+
+@itemize
+@item @code{oddHeaderMarkup}
+@item @code{evenHeaderMarkup}
+@item @code{oddFooterMarkup}
+@item @code{evenFooterMarkup}
+@end itemize
-@item bookTitleMarkup
-Das ist die Überschrift, die für das gesamte Dokument gilt. Üblicherweise
-wird hier der Komponist und die Überschrift des Werkes genannt.
+Das folgende Beispiel zentriert die Seitenzahlen unten auf jeder Seite.
+Zuerst werden die Standardeinstellungen von @code{oddHeaderMarkup} und
+@code{evenHeaderMarkup} entfernt, indem sie als @qq{Null}-Beschriftung
+definiert werden. Dann wird @code{oddFooterMarkup} mit zentrierter
+Seitennummer neu definiert. Schließlich erhält @code{evenFooterMarkup}
+die selbe Layoutdefinition wie @code{\oddFooterMarkup}:
-@funindex scoreTitleMarkup
+@lilypond[papersize=a8,quote,verbatim,noragged-right]
+\book {
+ \paper {
+ print-page-number = ##t
+ print-first-page-number = ##t
+ oddHeaderMarkup = \markup \null
+ evenHeaderMarkup = \markup \null
+ oddFooterMarkup = \markup {
+ \fill-line {
+ \on-the-fly #print-page-number-check-first
+ \fromproperty #'page:page-number-string
+ }
+ }
+ evenFooterMarkup = \oddFooterMarkup
+ }
+ \score {
+ \new Staff { s1 \break s1 \break s1 }
+ }
+}
+@end lilypond
-@item scoreTitleMarkup
-Das ist die Überschrift, die vor jede @code{\score}-Umgebung gesetzt wird.
-Überlicherweise wird hier etwa die Bezeichnung eines Satzes notiert
-(im @code{piece}-Feld).
+@seealso
+Notationsreferenz:
+@ref{Wie funktioniert die Titel-Umgebung?},
+@ref{Standardlayout von book und Partitur Titelumgebungen}.
-@funindex oddHeaderMarkup
-@item oddHeaderMarkup
-Das ist der Seitenkopf für ungerade Seiten.
+@node Fußnoten erstellen
+@subsection Fußnoten erstellen
+@translationof Creating footnotes
-@funindex evenHeaderMarkup
+Zwei Arten an Fußnoten können erstellt werden: automatische und
+manuelle Fußnoten.
-@item evenHeaderMarkup
-Das ist der Seitenkopf für gerade Seiten. Wenn undefiniert, wird der
-ungerade Seitenkopf eingesetzt.
+@menu
+* Übersicht über Fußnoten::
+* Automatische Fußnoten::
+* Manuelle Fußnoten::
+@end menu
-Standardmäßig werden die Kopfzeilen so definiert, dass die Seitennummer
-sich außen befindet und das Instrument zentriert gesetzt wird.
+@node Übersicht über Fußnoten
+@unnumberedsubsubsec Übersicht über Fußnoten
+@translationof Footnotes overview
-@funindex oddFooterMarkup
+Automatische Fußnoten erstellen aufsteigende Zahlenverweise, während
+mit manuellen Fußnoten eigene angepasste Verweise erstellt werden
+können. Alle Grobs, @code{\markup}-Beschriftung auf höchster Ebene
+und zu Akkord zusammengefasste Noten können mit Fußnoten versehen werden.
-@item oddFooterMarkup
-Das ist die Fußzeile für ungerade Seiten.
+Die Reihenfolge, in welcher ein Grob erstellt wird, bestimmt die
+Reihenfolge der Nummerierung automatischer Fußnoten.
-@funindex evenFooterMarkup
-@item evenFooterMarkup
-Das ist die Fußzeile für gerade Seiten. Wenn undefiniert, wird die
-ungerade Fußzeile eingesetzt.
+@node Automatische Fußnoten
+@unnumberedsubsubsec Automatische Fußnoten
+@translationof Automatic footnotes
-Standardmäßig wird in der Fußzeile auf der ersten Seite das Copyright
-und auf der letzten Seite die Tag-Zeile gesetzt.
+@cindex Fußnoten, automatisch
-@end table
+Automatische Fußnoten brauchen drei Argumente: das @var{Layoutobjekt}, das die
+Anmerkung erhalten soll, die @var{(x . y)}-Position des Indikators und
+eine @code{\markup}-Beschriftung, die den Inhalt der Fußnote enthält.
+Der Befehl @code{\footnote} muss @emph{vor} dem Grob geschrieben
+werden, auf den sich die Fußnote bezieht.
-@funindex \paper
-@cindex Kopfzeile
-@cindex Fußzeile
-@cindex Seitenlayout
-@cindex Layout der Seite
-@cindex Titel
-@cindex Überschriften
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ \footnote #'(0.5 . -2) #'NoteHead
+ \markup { Die erste Note }
+ a'4 b8
+ \footnote #'(0.5 . 1) #'NoteHead
+ \markup { Die dritte Note }
+ e c4 d4
+ }
+}
+@end lilypond
-Die folgende Definition setzt die Überschrift linksbündig und
-den Komponisten rechtsbündig auf einer einzelnen Zeile:
+Bei Noten in Akkorden muss der Befehl @code{\footnote} @emph{nach}
+der Note, auf der sie sich bezieht, in Form eines @code{TextScript}
+stehen:
-@verbatim
-\paper {
- bookTitleMarkup = \markup {
- \fill-line {
- \fromproperty #'header:title
- \fromproperty #'header:composer
- }
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ <
+ c-\footnote #'(1 . -1.25) "Hier ein C"
+ es-\footnote #'(2 . -0.25) \markup { \italic "Ein Es" }
+ g-\footnote #'(2 . 3) \markup { \bold "Das ist ein G" }
+ >1
}
}
-@end verbatim
+@end lilypond
+
+@warning {Wenn Fußnoten die selbe vertikale Position haben, werden
+sie von oben nach unten nummeriert.}
+
+Hier noch einige Beispiele von Grobs, die mit Fußnoten
+versehen sind, wobei auch die Position des Fußnotentextes relativ zu
+Tagline und Copyright gezeigt wird.
+
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { copyright = \markup { "Copyright 1970" } }
+ \relative c' {
+ \footnote #'(-3 . 0) #'DynamicText
+ \markup { \bold Forte }
+
+ \footnote #'(0 . 1.5) #'Slur
+ \markup { Ein Bogen }
+ a'4\f(
+
+ \footnote #'(0 . -2) #'Beam
+ \markup { Balken }
+ b8)[ e]
+
+ \footnote #'(1 . -1) #'Stem
+ \markup { \teeny { Das ist ein Hals } }
+ c4
+
+ \footnote #'(0 . 0.5) #'AccidentalCautionary
+ \markup \italic { Ein Warnungsversetzungszeichen }
+
+ \footnote #'(0.5 . -0.5) #'TextScript
+ \markup \italic { Langsamer hier }
+ dis?4_"rit."
+ }
+}
+@end lilypond
+
+Für eine @code{\markup}-Beschriftung auf oberster Ebene braucht man
+den Befehl @code{\auto-footnote}:
+
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \markup { \auto-footnote "Eine einfache Melodie" \italic "Von mir" }
+ \relative c' {
+ a'4 b8 e c4 d
+ }
+}
+@end lilypond
+
+
+@node Manuelle Fußnoten
+@unnumberedsubsubsec Manuelle Fußnoten
+@translationof Manual footnotes
+
+@cindex Fußnoten, manuell
+
+Manuell erstellte Fußnoten brauchen vier Argumente: das @var{Layoutobjekt},
+das die Anmerkung erhalten soll, die @var{(x . y)}-Position des
+Indikators und zwei @code{\markup}-Beschriftungen; die erste ist der
+Indikator, der an die Note oder den Grob gehängt wird, die zweite
+der Inhalt der Fußnote unten auf der Seite.
+
+Wie auch bei automatischen Fußnoten muss der Befehl @code{\footnote}
+@emph{nach} dem Grob kommen, an den die Fußnote gehängt wird und als
+@code{TextScript} geschrieben werden:
+
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ a'4-\footnote
+ "1" #'(0.5 . -2) #'NoteHead \markup { \italic "1. Die erste Note" }
+ b8
+ e-\footnote
+ \markup { \bold "2" } #'(0.5 . 1) #'NoteHead "2. Die zweite Note"
+ c4
+ d\p-\footnote "3" #'(0.5 . -1) #'DynamicText "3. Piano"
+ }
+}
+@end lilypond
+
+Fußnoten für Akkordnoten werden wie folgt notiert:
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ <
+ c-\footnote "1" #'(1 . -1.25) "1. C"
+ es-\footnote
+ \markup { \bold "b" } #'(2 . -0.25) "b. E-flat"
+ g-\footnote "3" #'(2 . 3) \markup { \italic "iii. G" }
+ >1
+ }
+}
+@end lilypond
+
+@warning {Wenn Fußnoten die selbe vertikale Position haben, werden
+sie von oben nach unten nummeriert.}
+
+Hier einige Beispiele manueller Fußnoten, die auch die relative
+Position der Fußnotentexte zu Tagline und Copyright anzeigen:
+
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ \footnote
+ \markup { \teeny 1 } #'(-3 . 0) #'DynamicText
+ \markup { 1. \bold Forte }
+
+ \footnote
+ \markup { \teeny b } #'(0 . 1.5) #'Slur
+ \markup { b. Ein Bogen }
+ a'4\f(
+
+ \footnote
+ \markup { \teeny 3 } #'(0 . -2) #'Beam
+ \markup { 3. Balken }
+ b8)[ e]
+
+ \footnote
+ \markup { 4 } #'(1 . -1) #'Stem
+ \markup { \bold 4. { Das ist ein Hals } }
+ c4
+
+ \footnote
+ \markup \concat \teeny { "sharp (v)" } #'(0 . 0.5) #'AccidentalCautionary
+ \markup \italic { v. Ein Warnungsversetzungszeichen }
+
+ \footnote
+ \markup \concat \teeny { "a" } #'(0.5 . -0.5) #'TextScript
+ \markup \italic { a. Langsamer hier }
+ dis?4_"rit."
+
+ \breathe
+ \footnote
+ \markup { \teeny \musicglyph #"rests.4" } #'(1.5 . -0.25) #'BreathingSign
+ \markup { \null }
+ }
+}
+@end lilypond
+
+Eine @code{\markup}-Beschriftung der höchsten Ebene wird wie folgt
+annotiert:
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \markup { "Eine einfache Melodie" \footnote "*" \italic "* Von mir" }
+ \relative c' {
+ a'4 b8 e c4 d4
+ }
+}
+@end lilypond
+
+@seealso
+Handbuch zum Lernen:
+@rlearning{Objekte und Schnittstellen}.
+
+Notationsreferenz:
+@ref{Erklärungen in Ballonform},
+@ref{Seitenlayout},
+@ref{Textartige Zeichen},
+@ref{Textarten},
+@ref{Titel}.
+
+Referenz der Interna:
+@rinternals{FootnoteEvent},
+@rinternals{FootnoteItem},
+@rinternals{FootnoteSpanner},
+@rinternals{Footnote_engraver}.
+
+@knownissues
+Mehrere Fußnoten auf einer Seite können ausschließlich übereinander
+gedruckt werden und nicht auf der gleiche Zeile gesetzt werden.
+Fußnoten können nicht an @code{MultiMeasureRests} (mehrtaktige Pause)
+angehängt werden und können mit @code{Staff}-(Notensystem)-,
+@code{\markup}-(Beschriftungs)-Objekten und anderen Fußnoten
+zusammenstoßen. Wenn man den manuellen Fußnotenbefehl einsetzt,
+braucht man in der @code{\paper}-Umgebung den Eintrag
+@code{footnote-auto-number = ##f}.
@node Verweis auf die Seitenzahlen
von @code{\markup}).
@c KEEP LY
-@lilypond[verbatim,line-width=11.0\cm]
+@lilypond[verbatim]
\header { tagline = ##f }
\book {
\label #'ErstePartitur
{
c'1
\pageBreak \mark A \label #'ZeichenA
- c'
+ c'1
}
}
-
- \markup { Die erste Partitur fäng auf Seite \page-ref #'ErstePartitur "0" "?" an.}
- \markup { Zeichen A befindet sich auf Seite \page-ref #'ZeichenA "0" "?". }
+ \markup { Die erste Partitur fängt auf
+ Seite \page-ref #'ErstePartitur "0" "?" an.}
+ \markup { Zeichen A befindet sich auf Seite
+ \concat { \page-ref #'ZeichenA "0" "?" . } }
}
@end lilypond
@item die Marke, ein Scheme-Symbol, etwa @code{#'ErstePartitur},
@item eine Beschriftung, die als Platzhalter benutzt wird, um die Breite des Verweisen zu schätzen,
-@item eine Beschriftung, die anstelle der Seitenzahl gesetzt wird, wenn die Marke unbekann ist.
+@item eine Beschriftung, die anstelle der Seitenzahl gesetzt wird, wenn die Marke unbekannt ist.
@end enumerate
Der Grund, warum ein Platzhalter benötigt wird, ist dass zu dem Zeitpunkt,
@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"
\score {
{
- c' % ...
+ c'4 % ...
\tocItem \markup "Ein bestimmter Punkt innerhalb der ersten Partitur"
- d' % ...
+ d'4 % ...
}
}
\tocItem \markup "zweite Partitur"
\score {
{
- e' % ...
+ e'4 % ...
}
}
@end verbatim
(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
@menu
* LilyPond-Dateien einfügen::
* Verschiedene Editionen aus einer Quelldatei::
-* Zeichenkodierung::
-* LilyPond-Notation anzeigen::
+* Sonderzeichen::
@end menu
@cindex einfügen von Dateien
@cindex Dateien einfügen
-Ein größeres Projekt kann in einzelne Dateien aufteteilt werden.
+Ein größeres Projekt kann in einzelne Dateien aufgeteilt werden.
Um eine andere Datei einzubinden, kann der Befehl
@example
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
sodass die Pfadangaben hier nicht relativ zur eingebundenen Datei,
sondern relativ zur Hauptdatei gesetzt werden müssen. Dieses Verhalten
kann jedoch auch verändert werden, indem man lilypond die Option
-@code{-drelative-includes} auf der Kommandozeile zuweist (oder indem
+@option{-drelative-includes} auf der Kommandozeile zuweist (oder indem
man den Befehl @code{#(ly:set-option 'relative-includes #t)} an den
Beginn der Quelldatei schreibt). Mit @code{relative-includes} wird
der Pfad jedes @code{\include}-Befehls als relativ zu der Datei angenommen,
LilyPond lädt eine Anzahl an Dateien, wenn das Programm aufgerufen wird.
Diese Dateien sind für den Benutzer nicht ersichtlich, aber die Dateien
-können identifiziert werden, indem LilyPond auf der Komandozeile mit
+können identifiziert werden, indem LilyPond auf der Kommandozeile mit
Option aufgerufen wird: @code{lilypond --verbose}. Hiermit wird
-neben anderer Information auch eine Liste and Pfaden und Dateien
+neben anderer Information auch eine Liste von Pfaden und Dateien
aufgeführt, die LilyPond benutzt. Die wichtigeren Dateien werden
im Abschnitt @rlearning{Mehr Information} besprochen.
Diese Dateien können verändert werden, aber Änderungen gehen verloren,
wenn eine neue LilyPond-Version installiert wird.
-Eine einfache Beispiele, die die Benutzung von @code{\include} demonstrieren,
+Einige einfache Beispiele, die die Benutzung von @code{\include} demonstrieren,
sind dargestellt in
@rlearning{Partituren und Stimmen}.
@rlearning{Partituren und Stimmen}.
@knownissues
-
Wenn eine Datei eingebunden wird, deren Name einer Datei aus
dem Installationsverzeichnis von LilyPond entspricht, wird die
installierte Datei anstelle der eigenen verwendet.
Notenpassagen und/oder Anmerkungen/Textmarken miteinander auf
verschiedene Weise zu kombinieren. Tag-Marken dagegen werden am
besten eingesetzt, wenn eine von mehreren kurzen alternativen
-Notenabschnitten ausgewählt werden soll. Egal welche Methode am
+Notenabschnitten ausgewählt werden soll und können auch eingesetzt
+werden, um Musikabschnitte an unterschiedlichen Stellen zusammenzufügen.
+
+Egal welche Methode am
Ende eingesetzt wird: Es erleichtert die Arbeit in jedem Fall, wenn
-die eigentlichen Noten und die Struktur der Paritur voneinander
+die eigentlichen Noten und die Struktur der Partitur voneinander
getrennt notiert werden -- so kann die Struktur geändert werden,
ohne dass man Änderungen an den Noten vornehmen muss.
@menu
* Variablen benutzen::
* Marken benutzen::
+* Globale Einstellungen benutzen::
@end menu
@node Variablen benutzen
Hier ein Beispiel:
@lilypond[verbatim,quote]
-sopranoMusic = \relative c'' { a4 b c b8( a)}
+sopranoMusic = \relative c'' { a4 b c b8( a) }
altoMusic = \relative g' { e4 e e f }
tenorMusic = \relative c' { c4 b e d8( c) }
bassMusic = \relative c' { a4 gis a d, }
@cindex Marke
@cindex markierte Noten entfernen
@cindex markierte Noten behalten
+@cindex in markierte Noten einfügen
@funindex \tag
@funindex \keepWithTag
@funindex \removeWithTag
+@funindex \pushToTag
+@funindex \appendToTag
@funindex tag
@funindex keepWithTag
@funindex removeWithTag
+
Der @code{\tag #'@var{TeilA}}-Befehl markiert einen musikalischen
Ausdruck mit der Bezeichnung @var{TeilA}. Ausdrücke, die auf diese
Weise markiert werden, können mit ihrer Bezeichnung später ausgewählt
@lilypond[verbatim,quote]
music = \relative g' {
g8. c32 d
- \tag #'trills {d8.\trill }
- \tag #'expand {\repeat unfold 3 {e32 d} }
+ \tag #'trills { d8.\trill }
+ \tag #'expand { \repeat unfold 3 { e32 d } }
c32 d
}
@lilypond[verbatim,quote]
music = \relative g' {
g8. c32 d
- \tag #'trills {d8.\trill }
- \tag #'expand {\repeat unfold 3 {e32 d} }
+ \tag #'trills { d8.\trill }
+ \tag #'expand {\repeat unfold 3 { e32 d } }
c32 d
}
@lilypond[quote,verbatim]
music = \relative c'' {
- \tag #'a \tag #'both { a a a a }
- \tag #'b \tag #'both { b b b b }
+ \tag #'a \tag #'both { a4 a a a }
+ \tag #'b \tag #'both { b4 b b b }
}
<<
\keepWithTag #'a \music
@lilypond[verbatim,quote]
music = \relative c'' {
-\tag #'A { a a a a }
-\tag #'B { b b b b }
-\tag #'C { c c c c }
-\tag #'D { d d d d }
+\tag #'A { a4 a a a }
+\tag #'B { b4 b b b }
+\tag #'C { c4 c c c }
+\tag #'D { d4 d d d }
}
{
\removeWithTag #'B
im Befehl genannten wegfiltert und der zweite Befehl dann auch diesen
eben genannten zusätzlich entfernt.
+Manchmal will man Noten an einem bestimmen Platz in existierenden
+Noten einfügen. Dafür kann entweder @code{\pushToTag} oder
+@code{\appendToTag} benutzt werden, um Material hinter bzw. vor den
+Elementen (@code{elements}) der existierenden Noten einzufügen. Nicht
+alle musikalischen Konstruktionen haben Elemente, aber sequentielle und
+simultane Noten sind ziemlich gute Kandidaten:
+
+@lilypond[verbatim,quote]
+test = { \tag #'here { \tag #'here <<c''>> } }
+
+{
+ \pushToTag #'here c'
+ \pushToTag #'here e'
+ \pushToTag #'here g' \test
+ \appendToTag #'here c'
+ \appendToTag #'here e'
+ \appendToTag #'here g' \test
+}
+@end lilypond
+
+Beide Befehle erhalten einen Tag, das Material, das bei jedem Auftreten
+des Tags eingefügt werden soll und den Ausdruck, der mit dem Tag versehen
+ist. Der Befehl stellt sicher, dass alle Änderungen kopiert werden, sodass
+das ursprüngliche @code{\test} seine Bedeutung behält.
@seealso
Handbuch zum Lernen:
@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 Sonderzeichen
+@subsection sonderzeichen
+@translationof Special characters
+
+@cindex Sonderzeichen
+@cindex Nicht-ASCII-Zeichen
+
+@menu
+* Zeichenkodierung::
+* Unicode::
+* ASCII-Aliase::
+@end menu
+
+
@node Zeichenkodierung
-@subsection Zeichenkodierung
+@unnumberedsubsubsec Zeichenkodierung
@translationof Text encoding
-@cindex Unicode
+
@cindex UTF-8
-@cindex Nicht-ASCII-Zeichen
LilyPond benutzt alle Zeichen, die durch das Unicode-Konsortium
und ISO/IEC 10646 definiert sind. Hiermit wird den Zeichen
à vo -- cê uma can -- ção legal
}
-\relative {
+\relative c' {
c2 d e f g f e
}
\addlyrics { \bulgarian }
\addlyrics { \portuguese }
@end lilypond
+
+@node Unicode
+@unnumberedsubsubsec Unicode
+@translationof Unicode
+
+@cindex Unicode
+
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
notiert. (Achten Sie darauf, dass Sie @emph{nicht} UTF-8-Codepunkte
-einsetzen, weil UTF-8 zusätzliche Bits enthält, die die Nummer der Oktets bezeichnet.)
+einsetzen, weil UTF-8 zusätzliche Bits enthält, die die Nummer der Oktets bezeichnet.) Unicode-Tabellen und ein Verzeichnis der Zeichenbezeichnungen
+mit einer hexadezimalen Verweiszahl finden sich auf der Internetseite
+des Unicode Consortiums: @uref{http://www.unicode.org/}.
Mit @code{\char ##x03BE} und @code{\char #958} wird
beispielsweise das Unicode-Zeichen U+03BE notiert, welches die
c1 \mark \markup { \char ##x03EE }
c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
}
- \addlyrics { O \markup { \concat{ Ph \char ##x0153 be! } } }
+ \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
}
-\markup { "Copyright 2008--2009" \char ##x00A9 }
+\markup { "Copyright 2008--2012" \char ##x00A9 }
@end lilypond
@cindex Copyright-Zeichen
@end example
-@node LilyPond-Notation anzeigen
-@subsection LilyPond-Notation anzeigen
-@translationof Displaying LilyPond notation
+@node ASCII-Aliase
+@unnumberedsubsubsec ASCII-Aliase
+@translationof ASCII aliases
-@funindex \displayLilyMusic
+Eine Liste von ASCII-Befehlen für Sonderzeichen kann
+eingefügt werden:
-Ein musikalischer Ausdruck in LilyPond-Notation kann mit der Funktion
-@code{\displayMusic} angezeigt werden. Der Code
+@lilypond[quote,verbatim]
+\paper {
+ #(include-special-characters)
+}
-@example
-@{
- \displayLilyMusic \transpose c a, @{ c e g a bes @}
-@}
-@end example
+\markup "&flqq; – &OE;uvre incomplète… &frqq;"
-@noindent
-etwa wird ausgeben:
+\score {
+ \new Staff { \repeat unfold 9 a'4 }
+ \addlyrics {
+ This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
+ }
+}
-@example
-@{ a, cis e fis g @}
-@end example
+\markup \column {
+ "The replacement can be disabled:"
+ "– &OE; …"
+ \override #'(replacement-alist . ()) "– &OE; …"
+}
+@end lilypond
-Normalerweise werden diese Zeilen zusammen mit allen anderen
-Nachrichten auf der Kommandozeile ausgegeben. Um sie separat zu
-speichern und das Ergebnis von @code{\displayMusic} weiterzubenutzen,
-kann die Ausgabe mit folgendem Befehl in eine Datei umgeleitet werden:
+Man kann auch eigen Aliase erstellen, entweder global:
+
+@lilypond[quote,verbatim]
+\paper {
+ #(add-text-replacements!
+ '(("100" . "hundred")
+ ("dpi" . "dots per inch")))
+}
+\markup "A 100 dpi."
+@end lilypond
-@c TODO What happens under Windows?
+@noindent
+oder lokal:
-@example
-lilypond file.ly >display.txt
-@end example
+@lilypond[quote,verbatim]
+\markup \replace #'(("100" . "hundred")
+ ("dpi" . "dots per inch")) "A 100 dpi."
+@end lilypond
+
+@seealso
+Notationsreferenz:
+@ref{Liste der Sonderzeichen}.
+Installierte Dateien:
+@file{ly/text-replacements.ly}.
@node Ausgabe kontrollieren
@menu
* Notationsfragmente extrahieren::
* Korrigierte Musik überspringen::
+* Alternative Ausgabeformate::
+* Die Notationsschriftart verändern::
@end menu
Es wird erreicht, indem man die Takte, die ausgeschnitten werden sollen
(engl. to clip = ausschneiden), extra definiert. Mit folgender
-Defintion beispielsweise
+Definition beispielsweise
@verbatim
\layout {
werden, indem mehrere derartige Paare definiert werden.
Um diese Funktion auch nutzen zu können, muss LilyPond mit dem
-Parameter @code{-dclip-systems} aufgerufen werden. Die Schnipsel
+Parameter @option{-dclip-systems} aufgerufen werden. Die Schnipsel
werden als EPS ausgegeben und dann zu PDF und PNG konvertiert, wenn
diese Formate auch als Parameter angegeben werden.
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
- e e e e e e e e
- \set Score.skipTypesetting = ##f
- c 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
Übersetzung der Datei gespart wird.
+@node Alternative Ausgabeformate
+@subsection Alternative Ausgabeformate
+@translationof Alternative output formats
+
+@cindex scalable vector graphics output
+@cindex skalierbare Vektorgraphik-Ausgabe
+@cindex SVG-Ausgabe
+@cindex encapsulated postscript output
+@cindex EPS-Ausgabe
+@cindex PNG-Ausgabe
+
+Das Standardausgabeformat für gedruckte Partituren ist PDF (Portable
+Document Forma) und PS (PostScript). SVG (Scalable Vector
+Graphics), EPS (Encapsulated PostScript) und PNG (Portable
+Network Graphics) gibt es auch als Ausgabeformate über die
+Kommandozeile. Siehe @rprogram{Optionen auf der Kommandozeile für lilypond}.
+
+
+@node Die Notationsschriftart verändern
+@subsection Die Notationsschriftart verändern
+@translationof Replacing the notation font
+
+Gonville ist eine Alternative zu der Feta-Schriftart, die in LilyPond
+eingesetzt wird und kann unter der Adresse
+@example
+@uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
+@end example
+
+@noindent
+heruntergeladen werden. Hier einige Takte Noten mit der Gonville-Schriftart:
+
+@c NOTE: these images are a bit big, but that's important
+@c for the font comparison. -gp
+@sourceimage{Gonville_after,,,}
+
+Und hier einige Beispieltakte in der Feta-Schriftart:
+
+@sourceimage{Gonville_before,,,}
+
+@subsubheading Installationsanweisungen für MacOS
+
+Laden Sie die Datei herunter und entpacken Sie die ZIP-Datei.
+Kopieren Sie das @code{lilyfonts}-Verzeichnis nach
+@file{@var{SHARE_DIR}/lilypond/current}; für mehr Information
+siehe @rlearning{Mehr Information}.
+Benennen Sie das existierende @code{fonts}-Verzeichnis in
+@code{fonts_orig} um und benennen Sie das Verzeichnis
+@code{lilyfonts} in @code{fonts}. Das alte Verzeichnis
+@code{fonts_orig} können Sie einfach in @code{fonts}
+zurückbenennen, um wieder nach Feta zu wechseln.
+
+@seealso
+Handbuch zum Lernen: @rlearning{Mehr Information}.
+
+@knownissues
+
+Gonville kann nicht verwendet werden, um Alte Notation zu setzen und es
+ist wahrscheinlich, dass neuere Glyphen in späteren Versionen von
+LilyPond nicht in Gonville enthalten sein werden.
+Bitte lesen Sie die Webseite des Autoren zu mehr Information hierzu
+und zu anderen Einzelheiten, wie auch der Lizenz von Gonville.
+
+
@node MIDI-Ausgabe
@section MIDI-Ausgabe
@translationof MIDI output
bei der Überprüfung: falsche Oktaven oder falsche Versetzungszeichen
lassen sich meist sehr gut hören.
-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)
-besitzen. Jedes weitere System bleibt stumm.
+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 reserviert
+Kanala 10 für Schlagzeug. Es gibt nur 16 MIDI-Kanäle pro Gerät,
+sodass MIDI-Kanäle mehrfach benutzt werden, wenn eine Partitur mehr
+als 15 Notensysteme hat.
@menu
* MIDI-Dateien erstellen::
* Wiederholungen im MIDI::
* MIDI-Lautstärke kontrollieren::
* Schlagzeug in MIDI::
+* Artikuliere-Skript::
@end menu
bewirkt Tempoänderungen auch in der MIDI-Datei. Der Befehl setzt
gleichzeitig auch eine Tempobezeichnung in die Noten, welches aber
auch unterdrückt werden kann, siehe @ref{Metronomangabe}. Eine
-andere möglichkeit, ein eigenes MIDI-Tempo anzugeben, wird weiter
+andere Möglichkeit, ein eigenes MIDI-Tempo anzugeben, wird weiter
unten gezeigt, siehe @ref{Der MIDI-Block}.
Aufgrund einiger Einschränkungen auf Windows ist auf Windows-Systemen
lilypond … -dmidi-extension=midi lilyDatei.ly
@end example
-@unnumberedsubsubsec Instrumentenbezeichnungn
+@unnumberedsubsubsec Instrumentenbezeichnungen
@cindex Instrumentbezeichnungen
@end example
Wenn die Schreibweise nicht genau einem definierten Instrument aus
-der Liste entpsricht, wird ein Piano-Klang benutzt (@code{"acoustic grand"}).
+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
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 einbeozogen:
+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
@item Tempoveränderungen, die als Anmerkung ohne Tempobezeichnung notiert werden
-@item Staccato und andere Artikultationen und Ornamente
+@item Staccato und andere Artikulationen und Ornamente
@item Legato- und Phrasierungsbögen
@item Crescendi, decrescendi zu einer einzelnen Note
@item Tremolo, notiert mit @q{@code{:}[@var{number}]}
@funindex \unfoldRepeats
-Mit einigen Veränderungungen im Notentext können alle Wiederholungstypen
+Mit einigen Veränderungen im Notentext können alle Wiederholungstypen
auch in der MIDI-Ausgabe wiedergegeben werden. Das wird erreicht, indem
die @code{\unfoldRepeats}-Funktion eingesetzt wird. Diese Funktion
verändert alle Wiederholungen in ausgeschriebene Noten.
@lilypond[quote,verbatim]
\unfoldRepeats {
- \repeat tremolo 8 {c'32 e' }
+ \repeat tremolo 8 { c'32 e' }
\repeat percent 2 { c''8 d'' }
- \repeat volta 2 {c'4 d' e' f'}
+ \repeat volta 2 { c'4 d' e' f' }
\alternative {
{ g' a' a' g' }
- {f' e' d' c' }
+ { f' e' d' c' }
}
}
\bar "|."
@end lilypond
-Wenn eine Partitur mit diesem Befehl erstellt wird, ist er notwendig,
+In Parituren mit mehreren Stimmen funktioniert das Ausschreiben der
+Wiederholungen im MIDI nur richtig, wenn @emph{jede} Stimme vollständig
+notierte Wiederholungsanweisungen enthält.
+
+Wenn eine Partitur mit diesem @code{\unfoldRepeats}-Befehl erstellt
+wird, ist er notwendig,
zwei @code{\score}-Umgebungen einzurichten: in der einen werden die
Wiederholungen ausgeschrieben und nur eine MIDI-Ausgabe produziert,
in der anderen werden die Wiederholungen notiert und als Partitur
@unnumberedsubsubsec Dynamik-Zeichen
-
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
\set Staff.midiInstrument = #"cello"
\set Score.dynamicAbsoluteVolumeFunction = #myDynamics
\new Voice {
- \relative c'' {
- a\pp b c-\rfz
- }
+ \relative c'' {
+ a4\pp b c-\rfz
+ }
}
}
\layout {}
Die generellen Mindest- und Höchstwerte für die Lautstärke der MIDI-Datei
wird kontrolliert, indem die Eigenschaften @code{midiMinimumVolume}
-unde @code{midiMaximumVolume} auf der @code{Score}-Ebene gesetzt
+und @code{midiMaximumVolume} auf der @code{Score}-Ebene gesetzt
werden. Diese Eigenschaften haben nur Einfluss auf Dynamikzeichen, sodass
ein Dynamikzeichen direkt an den Anfang der Partitur gestellt werden muss,
wenn diese Einstellung von Anfang an Wirkung zeigen soll. Der Bruch,
\time 2/2
\set Staff.midiInstrument = #"flute"
\new Voice \relative c''' {
- r2 g\mp g fis ~
- fis4 g8 fis e2 ~
+ r2 g\mp g fis~
+ fis4 g8 fis e2~
e4 d8 cis d2
}
}
}
}
>>
- \layout { }
+ \layout {}
\midi {
\context {
\Score
\set Staff.midiMinimumVolume = #0.7
\set Staff.midiMaximumVolume = #0.9
\new Voice \relative c''' {
- r2 g\mp g fis ~
- fis4 g8 fis e2 ~
+ r2 g\mp g fis~
+ fis4 g8 fis e2~
e4 d8 cis d2
}
}
}
}
>>
- \layout { }
+ \layout {}
\midi {
\context {
\Score
@end lilypond
-@unnumberedsubsubsec Verschidene Instrumente angleichen (ii)
+@unnumberedsubsubsec Verschiedene Instrumente angleichen (ii)
Wenn Mindest- und Höchstwerte für die Lautstärke der MIDI-Datei
nicht vorgegeben werden, nimmt LilyPond standardmäßig einige
Funktion @code{instrumentEqualizer} im @code{Score}-Kontext auf
eine neue Scheme-Funktion gesetzt wird, die MIDI-Instrumentbezeichnungen
als einziges Argument akzeptiert und ein Zahlenpaar ausgibt, das
-den Höchst- und Mindestwert für die Lautstärke des entpsrechenden
+den Höchst- und Mindestwert für die Lautstärke des entsprechenden
Instruments darstellt. Die Ersetzung der Standardfunktion wird
auf gleiche Weise vorgenommen, wie es schon für die
@code{dynamicAbsoluteVolumeFunction} zu Beginn dieses Abschnittes
\set Score.instrumentEqualizer = #my-instrument-equalizer
\set Staff.midiInstrument = #"flute"
\new Voice \relative c''' {
- r2 g\mp g fis ~
- fis4 g8 fis e2 ~
+ r2 g\mp g fis~
+ fis4 g8 fis e2~
e4 d8 cis d2
}
}
Einige Instrumente, die keine diskreten Tonhöhen haben, können nicht
über den MIDI-Kanal@tie{}10 erreicht werden und müssen deshalb in
-einem normalen @code{Staff}-Kontext notiert werden. Es handelt sich
-um @code{melodic tom, taiko drum, synth drum} usw.
+einem normalen @code{Staff}-Kontext mit passenden normalen Tonhöhen
+notiert werden. Es handelt sich
+um @code{melodic tom, taiko drum, synth drum} u. A.
-Viele Schlagzeuginstrumnete sind nicht in den MIDI-Standard aufgenommen,
+Viele Schlagzeuginstrumente sind nicht in den MIDI-Standard aufgenommen,
z. B. Kastagnetten. Die einfachste Methode, derartige Instrumente
zu ersetzen, ist, einen Klang auszuwählen, der ihnen halbwegs ähnlich
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.
+
+
+
+@node Musikalische Information extrahieren
+@section Musikalische Information extrahieren
+@translationof Extracting musical information
+
+Neben graphischer Ausgabe und MIDI kann LilyPond auch die musikalische
+Information als Text anzeigen:
+
+@menu
+* LilyPond-Notation anzeigen::
+* Musikalische Scheme-Ausdrücke anzeigen::
+* Musikalische Ereignisse in einer Datei speichern::
+@end menu
+
+@node LilyPond-Notation anzeigen
+@subsection LilyPond-Notation anzeigen
+@translationof Displaying LilyPond notation
+
+@funindex \displayLilyMusic
+
+Mit der musikalischen Funktion @code{\displayLilyMusic} kann
+man einen musikalischen Ausdruck anzeigen. Um die Ausgabe zu
+sehen, wird LilyPond üblicherweise auf der Kommandozeile
+aufgerufen. Beispielsweise
+
+@example
+@{
+ \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
+@}
+@end example
+
+@noindent
+zeigt an:
+
+@example
+@{ a,4 cis e fis g @}
+@end example
+
+Standardmäßig gibt LilyPond diese Nachrichten auf die Kommandozeile
+aus, zusammen mit all den anderen LilyPond-Nachrichten über die
+Kompilation. Um die Nachrichten zu speichern, kann man die Ausgabe
+in eine Datei umleiten:
+
+@example
+lilypond file.ly >display.txt
+@end example
+
+@funindex \void
+
+LilyPond zeit nicht nur die musikalischen Ausdrücke an, sondern
+interpretiert sie auch (weil @code{\displayLilyMusic} sie an das
+Programm zurückgibt, zusätzlich zur Anzeige). Das ist sehr
+praktisch, denn man kann einfach @code{\displayLilyMusic}
+in vorhandene Noten einfügen, um Informationen darüber zu erhalten.
+Wenn Sie nicht wollen, dass LilyPond die angezeigten
+musikalischen Ausdrücke auch interpretiert, muss @code{\void}
+eingesetzt werden, damit der Ausdruck für die Interpretation ignoriert wird:
+
+@example
+@{
+ \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
+@}
+@end example
+
+
+@node Musikalische Scheme-Ausdrücke anzeigen
+@subsection Musikalische Scheme-Ausdrücke anzeigen
+@translationof Displaying scheme music expressions
+
+Siehe @rextend{Musikalische Funktionen darstellen}.
+
+
+@node Musikalische Ereignisse in einer Datei speichern
+@subsection Musikalische Ereignisse in einer Datei speichern
+@translationof Saving music events to a file
+
+Musikereignisse können in einer Datei Notensystem für Notensystem
+gespeichert werden, indem eine Datei in die Paritur eingefügt
+wird:
+
+@example
+\include "event-listener.ly"
+@end example
+
+Das erstellt Dateien mit der Bezeichnung @file{DATEINAME-SYSTEMNAME.notes} oder
+@file{DATEINAME-unnamed-staff.notes} für jedes Notensystem.
+Wenn mehrere Systeme ohne Bezeichnung auftreten, werden die
+Ereignisse aller Notensysteme zusammen in der selben Datei
+gemischt. Die Ausgabe sieht folgendermaßen aus:
+
+@example
+0.000 note 57 4 p-c 2 12
+0.000 dynamic f
+0.250 note 62 4 p-c 7 12
+0.500 note 66 8 p-c 9 12
+0.625 note 69 8 p-c 14 12
+0.750 rest 4
+0.750 breathe
+@end example
+
+Die Syntax ist eine durch Tabulatoren getrennte Zeile mit zwei
+festen Zellen, gefolgt von optionalen Parametern.
+
+@example
+@var{time} @var{type} @var{...params...}
+@end example
+
+Diese Information kann einfach ein ein anderes Programm wie
+etwa ein Python-Skript eingelsen werden und kann nützlich für
+Forscher sein, die musikalische Analyse- oder Wiedergabeexperimente
+mit LilyPond machen wollen.
+
+@knownissues
+
+Nicht alle musikalischen Ereignisse werden von
+@file{event-listener.ly} unterstützt. Es handelt sich eher um ein
+gut gemachtes @qq{proof of concept}. Wenn Ereignisse, die Sie
+brauchen, nicht in enthalten sind, können Sie @file{event-listener.ly}
+in Ihr LilyPond-Verzeichnis kopieren und die Datei verändern,
+sodass sie die benötigte Information ausgibt.
projects / lilypond.git / blobdiff