@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@ignore
- Translation of GIT committish: 5131c3292d30cabdf08839daa02a006e4d3c96c5
+ Translation of GIT committish: e5a609e373eae846857f9a6d70a402a3d42b7d94
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.16.0"
-@node General input and output
-@chapter General input and output
+@c Translators: Till Paala
+
+@node Allgemeine Eingabe und Ausgabe
+@chapter Allgemeine Eingabe und Ausgabe
+@translationof General input and output
Dieses Kapitel erklärt allgemeine Fragen zur Eingabe und Ausgabe von
Notation mit LilyPond und weniger direkte Fragen der Notation.
@menu
-* Input structure::
-* Titles and headers::
-* Working with input files::
-* Controlling output::
-* MIDI output::
+* Eingabestruktur::
+* Titel::
+* Arbeiten an Eingabe-Dateien::
+* Ausgabe kontrollieren::
+* MIDI-Ausgabe::
+* Musikalische Information extrahieren::
@end menu
-@node Input structure
-@section Input structure
+@node Eingabestruktur
+@section Eingabestruktur
+@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
-* Structure of a score::
-* Multiple scores in a book::
-* File structure::
+* Struktur einer Partitur::
+* Mehrere Partituren in einem Buch::
+* Mehrere Ausgabedateien aus einer Eingabedatei::
+* Dateinamen der Ausgabedateien::
+* Die Dateistruktur::
@end menu
-@node Structure of a score
-@subsection Structure of a score
+@node Struktur einer Partitur
+@subsection Struktur einer Partitur
+@translationof Structure of a score
@funindex \score
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
@end example
Kommentare bilden eine Ausnahme dieser Regel. (Andere Ausnahmen
-siehe @ref{File structure}.) Sowohl einzeilige als auch
+siehe @ref{Die Dateistruktur}.) Sowohl einzeilige als auch
Blockkommentare (eingegrenzt durch @code{%@{ .. %@}}) können
an beliebiger Stelle einer Eingabedatei geschrieben werden. Sie
können innerhalb oder außerhalb der @code{\score}-Umgebung vorkommen,
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{Working on input files},
-@rlearning{Music expressions explained},
-@rlearning{Score is a (single) compound musical expression}.
+@rlearning{Arbeiten an Eingabe-Dateien},
+@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 Multiple scores in a book
-@subsection Multiple scores in a book
+@node Mehrere Partituren in einem Buch
+@subsection Mehrere Partituren in einem Buch
+@translationof Multiple scores in a book
@funindex \book
@cindex Sätze, mehrere
@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{File structure}. 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 File structure
-@subsection File structure
+
+@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
@funindex \paper
@funindex \midi
@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
-die spätere Vorrang.
+als eine derartige Definition desselben Typs auf oberster Ebene
+angegeben wird, hat die spätere Vorrang. Für Einzelheiten, wie dadurch
+die @code{\layout}-Umgebung beeinflusst wird, siehe
+@ref{Die \layout-Umgebung}.
@item
Ein direkter Scheme-Ausdruck, wie etwa
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
@end itemize
+@cindex Leerzeichen
+
+Leerzeichen zwischen Einheiten in der Eingabe werden generell ignoriert
+und können nach Belieben weggelassen werden oder hinzugefügt werden,
+um die Lesbarkeit des Codes zu verbessern. Mindestens ein Leerzeichen
+sollte jedoch unter folgenden Umständen immer eingesetzt werden, um
+Fehler zu vermeiden:
+
+@itemize
+@item
+Vor und hinter jeder schließenden oder öffnenden Klammer,
+@item
+nach jedem Befehl oder jeder Variable, also jeder Einheit, die mit
+@code{\} beginnt,
+@item
+nach jeder Einheit, die als Scheme-Ausdruck interpretiert werden,
+also alle Einheiten, die mit@tie{}@code{#} beginnen.
+@item
+Alle Einheiten von Scheme-Ausdrücken müssen mit Leerzeichen getrennt
+werden,
+@item
+in Gesangstextabschnitten (@code{lyricmode}) müssen Leerzeichen
+zwischen alle Ausdrücke in @code{\override}- und @code{\set}-Befehlen
+gesetzt werden. Insbesondere müssen um Punkte und Gleichzeitszeichen
+in Befehlen wie @code{\override Score . LyricTex #'font-size = #5)}
+und vor dem gesamten Befehl geschrieben werden.
+
+@end itemize
+
@seealso
-Hanbuch zum Lernen:
-@rlearning{How LilyPond input files work}.
+Handbuch zum Lernen:
+@rlearning{Wie eine LilyPond-Eingabe-Datei funktioniert}.
+
+Notationsreferenz:
+@ref{The \layout block}.
-@node Titles and headers
-@section Titles and headers
+@node Titel
+@section Titel
+@translationof Titles and headers
Fast alle gedruckten Noten beinhalten einen Titel und den Namen
des Komponisten, teilweise wird auch noch sehr viel mehr Information
zur Verfügung gestellt.
@menu
-* Creating titles::
-* Custom titles::
-* Reference to page numbers::
-* Table of contents::
+* 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 Kopf und Fußzeilen erstellen
+@subsection Titel, Kopf- und Fußzeilen erstellen
+@translationof Creating titles headers and footers
+
+@menu
+* Wie funktioniert die Titel-Umgebung?::
+* Standardlayout von book und Partitur Titelumgebungen::
+* Standardlayout von Kopf und Fußzeilen::
@end menu
-@node Creating titles
-@subsection Creating titles
+@node Wie funktioniert die Titel-Umgebung?
+@unnumberedsubsubsec Wie funktioniert die Titel-Umgebung?
+@translationof Title blocks explained
-Ü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).
+@c TODO: figure out how \bookpart titles work
-Der Inhalt der Titelei wird aus der @code{\header}-Umgebung übernommen. Die
-@code{\header}-Umgebung eines Buches unterstützt folgende Felder:
+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.
-@table @code
-@funindex dedication
-@item dedication
-Die Widmung der Noten, wird auf oben auf der ersten Seite gesetzt.
+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 title
-@item title
-Die Überschrift der Noten, wird unter der Widmung zentriert gesetzt.
+@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 subtitle
-@item subtitle
-Untertitel, zentriert unter der Überschrift.
+@lilypond[papersize=a5,quote,verbatim,noragged-right]
+\header {
+ title = "SUITE I."
+ composer = "J. S. Bach."
+}
-@funindex subsubtitle
-@item subsubtitle
-Unteruntertitel, zentriert unter dem Untertitel.
+\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 poet
-@item poet
-Name des Dichters, linksbündig unter dem Unteruntertitel.
+\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 instrument
-@item instrument
-Bezeichnung des Instruments, zentriert unter dem Unteruntertitel.
-Auch oben auf der Seite zentriert (andere als erste Seite).
+Textfelder der Haupttitelumgebung können in allen @code{\score}-Umgebungen
+gesetzt oder manuell unterdrückt werden:
-@funindex composer
-@item composer
-Name des Komponisten, rechtsbüngig unter dem Unteruntertitel.
+@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
-@funindex meter
-@item meter
-Metrum, linksbündig unter dem Dichter.
+@seealso
+Notationsreferenz:
+@ref{Die Dateistruktur},
+@ref{Angepasstes Layout für Titelumgebungen}.
-@funindex arranger
-@item arranger
-Name des Bearbeiters/Arrangeurs, rechtsbündig unter dem Komponisten.
-@funindex piece
-@item piece
-Bezeichnung des Stückes, linksbündig unter dem Metrum.
+@node Standardlayout von book und Partitur Titelumgebungen
+@unnumberedsubsubsec Standardlayout von @code{book}- und Partitur-Titelumgebungen
+@translationof Default layout of book and score title blocks
-@funindex opus
-@item opus
-Bezeichnung des Opus, rechtsbündig unter dem Bearbeiter.
+Dieses Beispiel zeigt alle @code{\header}-(Überschrifen)-Variablen:
+
+@lilypond[papersize=a7,quote,verbatim,noragged-right]
+\book {
+ \header {
+ % The following fields are centered
+ dedication = "Dedication"
+ title = "Title"
+ subtitle = "Subtitle"
+ subsubtitle = "Subsubtitle"
+ % The following fields are evenly spread on one line
+ % the field "instrument" also appears on following pages
+ instrument = \markup \with-color #green "Instrument"
+ poet = "Poet"
+ composer = "Composer"
+ % The following fields are placed at opposite ends of the same line
+ meter = "Meter"
+ arranger = "Arranger"
+ % The following fields are centered at the bottom
+ tagline = "tagline goes at the bottom of the last page"
+ copyright = "copyright goes at the bottom of the first page"
+ }
+ \score {
+ { s1 }
+ \header {
+ % The following fields are placed at opposite ends of the same line
+ piece = "Piece 1"
+ opus = "Opus 1"
+ }
+ }
+ \score {
+ { s1 }
+ \header {
+ % The following fields are placed at opposite ends of the same line
+ piece = "Piece 2 on the same page"
+ opus = "Opus 2"
+ }
+ }
+ \pageBreak
+ \score {
+ { s1 }
+ \header {
+ % The following fields are placed at opposite ends of the same line
+ piece = "Piece 3 on a new page"
+ opus = "Opus 3"
+ }
+ }
+}
+@end lilypond
+
+Beachten Sie:
+
+@itemize
+@item
+Die Instrumentenbezeichnung wird auf jeder Seite wiederholt.
+
+@item
+Nur @code{piece} (Stück)uand @code{opus} werden für eine Partitur
+(@code{\score}) gesetzt, wenn die @code{\paper}-Variable
+@code{print-all-headers} auf @code{##f} gesetzt ist (Standardeinstellung).
+
+@item
+@c Is the bit about \null markups true? -mp
+Textfelder, die in einer @code{\header}-Umgebung nicht benutzt werden,
+werden durch @code{\null}-Textbeschriftung ersetzt, sodass sie keinen
+leeren Platz belegen.
+
+@item
+Die Standardeinstellungen von @code{scoreTitleMarkup} platzieren
+die Felder @code{piece} (Stück) und @code{opus} zu den gegenüberliegenden
+Seiten der selben Zeile.
+
+@end itemize
+
+Um die Standardeinstellungen des Layouts zu ändern, siehe
+@ref{Angepasstes Layout für Titelumgebungen}.
-@cindex Seitenumbruch, erzwingen
@funindex breakbefore
-@item breakbefore
-Hiermit beginnt der Titel auf einer neuen Steite. (Kann die Werte
-##t (wahr) oder ##f (falsch) haben.)
+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 {
+ title = "This is my Title"
+ subtitle = "This is my Subtitle"
+ copyright = "This is the bottom of the first page"
+ }
+ \score {
+ \repeat unfold 4 { e'' e'' e'' e'' }
+ \header {
+ piece = "This is the Music"
+ breakbefore = ##t
+ }
+ }
+}
+@end lilypond
+
+@seealso
+Handbuch zum Lernen:
+@rlearning{Wie eine LilyPond-Eingabe-Datei funktioniert},
-@funindex copyright
-@item copyright
-Anzeige eines Copyright, zentriert unten auf der ersten Seite. Um das
-Copyright-Symbol zu notieren, siehe @ref{Text encoding}.
+Notationsreferenz:
+@ref{Die Dateistruktur},
+@ref{Angepasstes Layout für Titelumgebungen}.
-@funindex tagline
-@item tagline
-Zentriert unten auf der letzten Seite. Enthält standardmäßig: @qq{Music
-engraving by LilyPond (@var{version})---www.lilypond.org}
+Installierte Dateien:
+@file{ly/titling-init.ly}.
-@end table
-Hier eine Demonstration der möglichen Felder. Beliebige
-Formatierungsbefehle für Textbeschriftung können in der Titelei
-eingesetzt werden. Siehe hierzu auch @ref{Formatting text}.
+@node Standardlayout von Kopf und Fußzeilen
+@unnumberedsubsubsec Standardlayout von Kopf- und Fußzeilen
+@translationof Default layout of headers and footers
-@c KEEP LY
-@lilypond[quote,verbatim,line-width=11.0\cm]
-\paper {
- line-width = 9.0\cm
- paper-height = 10.0\cm
+@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
+ }
+ }
}
+@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 {
- 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"
+ tagline = "... music notation for Everyone"
+ }
+ \score {
+ \relative c' {
+ c4 d e f
+ }
+ }
+}
+@end lilypond
+
+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
+
+@cindex bookTitleMarkup
+@cindex scoreTitleMarkup
+@funindex bookTitleMarkup
+@funindex scoreTitleMarkup
+
+@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
+
+Die Positionierung von Titeln, wenn die Standardeinstellung dieser
+Variablen benützt werden, wird anhand einem Beispiel gezeigt 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
+scoreTitleMarkup = \markup @{ \column @{
+ \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
+ \fill-line @{
+ \fromproperty #'header:piece
+ \fromproperty #'header:opus
+ @}
+@}
+@}
+@end example
+
+Dadurch werden die Textfelder @code{piece} (Stück) und @code{opus}
+an den gegenüberliegenden Enden der gleichen Zeile platziert:
+
+@lilypond[quote,verbatim,noragged-right]
+\score {
+ { s1 }
+ \header {
+ piece = "PRAELUDIUM I"
+ opus = "BWV 846"
+ }
+}
+@end lilypond
+
+Das folgende Beispiel verändert die Einstellungen von
+@code{scoreTitleMarkup}, sodass das Textfeld @code{piece}
+zentriert wird und in fetter, größerer Schrift erscheint.
+
+@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
+
+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?}.
+
+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.
+@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 {
- { c'1 }
+ { s1 }
\header {
- piece = "Stück zwei"
- opus = "Opus1"
+ piece = "RONDEAU"
+ composer = "François Couperin"
}
}
- \markup {
- und jetzt...
+}
+@end lilypond
+
+Es ist auch möglich, eigene Textfelder zu erstellen und dann auf sie
+in der Beschriftungsdefinition zu verweisen:
+
+@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 {
- { c'1 }
+ { s1 }
\header {
- piece = "Stück2"
- opus = "Opus2"
+ piece = "FUGA I"
+ mycustomtext = "A 4 VOCI" %% User-defined field
+ opus = "BWV 846"
}
}
}
@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:
+@seealso
+Notationsreferenz:
+@ref{Wie funktioniert die Titel-Umgebung?}.
+
+
+@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
+
+@c can make-header and make-footer be removed from
+@c paper-defaults-init.ly? -mp
+
+@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
+
+@cindex Beschriftung mit Bedingung
+@cindex on-the-fly
+@funindex \on-the-fly
+
+Der @code{\markup}-Befehl @code{\on-the-fly} kann eingesetzt werden,
+um Beschriftung anhand einer Bedingung zu Kopf- und Fußzeilentext
+innerhalb der @code{\paper}-Umgebung hinzuzufügen. Hierzu wird folgende
+Syntax eingesetzt:
@example
-\header @{
- composer = "Komponist"
-@}
-\header @{
- piece = "Stück"
-@}
-\score @{
- \new Staff @{ c'4 @}
- \header @{
- piece = "Neues Stück" % überschreibt die die vorige Definition
- @}
+@code{Variable} = @code{\markup} @{
+ ...
+ @code{\on-the-fly} #@var{Prozedur} @var{Beschriftung}
+ ...
@}
@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.
+Die @var{Prozedur} wird jedes mal aufgerufen, wenn dar
+@code{\markup}-Befehl, auf den sie sich auswirkt, ausgewertet wird.
+Die @var{Prozedur} sollte nach einer bestimmten Bedingung fragen und
+das @var{Beschriftung}-Argument ausführen (also setzen), wenn diese
+Bedinung wahr ist.
-@lilypond[quote,verbatim,line-width=11.0\cm]
-\score {
- { c'4 }
- \header {
- title = "title" % not printed
- piece = "piece"
- opus = "opus"
+Eine Anzahl von fertigen Prozeduren, um verschiedene Bedinungen zu testen,
+werden bereitgestellt:
+
+@quotation
+@multitable {print-page-number-check-first-----} {should this page be printed-----}
+
+@headitem Prozedurbezeichnung @tab Getestete Bedinung
+
+@item print-page-number-check-first @tab sollte diese Seitenzahl gesetzt werden?
+@item create-page-number-stencil @tab 'print-page-numbers wahr?
+@item print-all-headers @tab 'print-all-headers wahr?
+@item first-page @tab erste Seite im Buch?
+@item (on-page nmbr) @tab Seitenzahl = nmbr?
+@item last-page @tab letzte Seite im Buch?
+@item not-first-page @tab nicht erste Seite im Buch?
+@item part-first-page @tab erste Seite im book part?
+@item part-last-page @tab letzte Seite im book part?
+@item not-single-page @tab Seiten im book part > 1?
+
+@end multitable
+@end quotation
+
+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}:
+
+@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
-@funindex print-all-headers
+Verschiedene @code{\on-the-fly}-Bedingungen können mit dem Operator
+@qq{UND} verknüpft werden, beispielsweise bestimmt
+
+@example
+ @code{\on-the-fly #first-page}
+ @code{\on-the-fly #last-page}
+ @code{@{ \markup ... \fromproperty #'header: ... @}}
+@end example
+
+@noindent
+ob es sich um eine einzelne Seite bei der Ausgabe handelt.
+
+@seealso
+Notationsreferenz:
+@ref{Wie funktioniert die Titel-Umgebung?},
+@ref{Standardlayout von book und Partitur Titelumgebungen}.
+
+Installierte Dateien:
+@file{../ly/titling-init.ly}.
+
+
+@node Fußnoten erstellen
+@subsection Fußnoten erstellen
+@translationof Creating footnotes
+
+Zwei Arten an Fußnoten können erstellt werden: automatische und
+manuelle Fußnoten.
+
+@menu
+* Übersicht über Fußnoten::
+* Automatische Fußnoten::
+* Manuelle Fußnoten::
+@end menu
+
+@node Übersicht über Fußnoten
+@unnumberedsubsubsec Übersicht über Fußnoten
+@translationof Footnotes overview
+
+Automatische Fußnoten erstellen aufsteigende Zahlenverweise, während
+mit manuellen Fußnoten eigene angepasste Verweise erstellt werden
+können. Fußnoten werden normalerweise wie ein @code{\tweak}-Befehl
+an Noten gehängt und können deshalb auch direkt mit den Grobs
+(graphischen Objekten) verknüpft werden, die von den meisten
+musikalischen Elementen und Postelementen erstellt werden. In Fällen, wo
+das nicht funktioniert (etwa bei Taktstrichen und Taktartänderungen, wo
+die Grobs als Folge einer Eigenschaftsänderung erstellt werden), können
+Fußnoten als einzelnstehendes musikalisches Ereigenis ersetllt werden,
+das sich auf alle Grobs eines bestimmten Typs zu einer bestimmten Zeit
+bezieht.
-@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:
+Der vollständige Befehl ist:
@example
-\paper@{
- print-all-headers = ##t
-@}
+\footnote @var{Zeichen} @var{Verschiebung} @var{Grob-Bezeichnung} @var{Fußnote}
+@var{Noten}
@end example
-@cindex Copyright
-@cindex Tagline
+Die Elemente sind folgende:
-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.
+@table @var
+@item
+Zeichen
+ist eine Beschriftung oder Zeichenkette, die das Fußnotenzeichen
+angbit, welches für den Referenzpunkt als auch für die Fußnote
+unten auf der Seite benützt wird. Es kann ausgelassen werden
+(oder durch @code{\default} ersetzt werden); in diesem Fall wird
+eine aufsteigende Zahlenfolge erstellt.
+
+@item Verschiebung (offset)
+ist ein Zahlenpaar wie etwa @samp{#(2 . 1)}, das die X- und Y-Verschiebung
+vom Referenzpunkt aus angibt, wo das Zeichen gesetzt werden soll.
+
+@item Grob-Bezeichnung
+gibt die Grob-Art an, der ein Fußnotenzeichen hinzugefügt werden soll
+(wie etwa @samp{#'Flag}). Wenn sie angegeben wird, wird der entsprechende
+Grob als Referenzpunkt eingesetzt, auch wenn das referenzierte Element
+nicht die @var{Noten} selber sind, sondern ein Grob, der durch sie
+erstellt wird. Das Element kann ausgelassen werden (oder durch
+@code{\default} ersetzt werden); dann wird nur ein direkt erstellter Grob
+mit Fußnote versehen.
+
+@item Fußnote
+Diese Beschriftung oder Zeichenkette bezeichnet den Fußnotentext, der
+am unteren Seitenrand gesetzt werden soll.
+
+@item Noten
+Das ist das Element, ein musikalisches Ereignis oder eine Akkordkonstruktion
+oder ein Post-Ereignis, das die Fußnote erhält. Man kann es nicht auslassen,
+aber man @emph{kann} es durch @code{\default} ersetzten. In diesem Fall
+wird die Fußnote aber nicht an einen bestimmten musikalischen Ausdruck
+angehänt, sondern an einen zeitlichen Moment. In diesem Fall muss man
+zwingend die @var{Grob-Bezeichnung} angeben, um den Grob-Typ auszuwählen, auf
+den sich die Fußnote bezieht (etwa @samp{#'TimeSignature}).
+@end table
-Ein Titelfeld kann vollständig entfernt werden, indem es auf
-falsch gesetzt wird:
+Wie auch mit @code{\tweak} muss dem @code{\footnote}-Befehl @code{-}
+vorangestellt werde,n wenn er an ein Post-Ereignis oder eine
+Artikulation angehängt werden soll, damit der Parser das Ergebnis
+der vorherigen Note oder Pause zuordnen kann.
-@example
-\header @{
- tagline = ##f
- composer = ##f
-@}
-@end example
+@node Automatische Fußnoten
+@unnumberedsubsubsec Automatische Fußnoten
+@translationof Automatic footnotes
-@node Custom titles
-@subsection Custom titles
+@cindex Fußnoten, automatisch
-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.
+Automatische Fußnoten haben vier Argumente: die @var{(x . y)}-Position des Indikators,
+die optionale @var{Grob-Bezeichnung}, die die Anmerkung erhalten soll,
+die @var{Fußnote}-Beschriftung, die den Inhalt der Fußnote enthält, und
+natürlich die @var{Noten}, welche mit einer Fußnote versehen werden sollen.
-@table @code
+Der Befehl @code{\footnote} muss @emph{vor} dem Grob geschrieben
+werden, auf den sich die Fußnote bezieht.
-@funindex bookTitleMarkup
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ \footnote #'(0.5 . -2)
+ \markup { Die erste Note } \default
+ a'4 b8
+ \footnote #'(0.5 . 1) #'Flag
+ \markup { Die dritte Note } \default
+ e\noBeam c4 d4
+ }
+}
+@end lilypond
-@item bookTitleMarkup
-Das ist die Überschrift, die für das gesamte Dokument gilt. Üblicherweise
-wird hier der Komponist und die Überschrift des Werkes genannt.
+Noten in Akkorden stellen keine Schwierigkeit dar:
-@funindex scoreTitleMarkup
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ <
+ \footnote #'(1 . -1.25) "Hier ein C" c
+ \footnote #'(2 . -0.25) \markup { \italic "Ein Es" } es
+ \footnote #'(2 . 3) \markup { \bold "Das ist ein G" } g
+ >1
+ }
+}
+@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).
+@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' {
+ a'4-\footnote #'(-3 . 0) \markup { \bold Forte } \f
+ -\footnote #'(0 . 1.5) \markup { Ein Bogen } (
+ b8)-\footnote #'(0 . -2) \markup { Balken } [ e]
+ \footnote #'(1 . -1) #'Stem
+ \markup { \teeny { Das ist ein Hals } }
+ c4
+ \footnote #'(0 . 0.5) #'AccidentalCautionary
+ \markup \italic { Ein warnendes Versetzungszeichen }
+ \footnote #'(1 . 1) "Die Note selber"
+ dis?4-\footnote #'(0.5 . -0.5) \markup \italic { langsamer werden }
+ _"rit."
+ }
+}
+@end lilypond
-@funindex oddHeaderMarkup
+Für eine @code{\markup}-Beschriftung auf oberster Ebene braucht man
+den Befehl @code{\auto-footnote}:
-@item oddHeaderMarkup
-Das ist der Seitenkopf für ungerade Seiten.
+@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
-@funindex evenHeaderMarkup
-@item evenHeaderMarkup
-Das ist der Seitenkopf für gerade Seiten. Wenn undefiniert, wird der
-ungerade Seitenkopf eingesetzt.
+@node Manuelle Fußnoten
+@unnumberedsubsubsec Manuelle Fußnoten
+@translationof Manual footnotes
-Standardmäßig werden die Kopfzeilen so definiert, dass die Seitennummer
-sich außen befindet und das Instrument zentriert gesetzt wird.
+@cindex Fußnoten, manuell
-@funindex oddFooterMarkup
+Manuell erstellte Fußnoten haben ein zusätzliches erstes Argument
+@var{Zeichen}, das das Fußnotenzeichen erstellt. Im Gegensatz zu
+automatisch erstellten Fußnotenzeichen erscheinen sie nicht unbedingt
+vor dem Fußnotentext unten auf der Seite -- das Herstellen eines visualen
+Zusammenhanges ist dem Setzer überlassen. LilyPond stellt nur ischer, dass
+der zugehörige Text unten auf der selben Seite erscheint.
-@item oddFooterMarkup
-Das ist die Fußzeile für ungerade Seiten.
+Davon abgesehen ist die Benutzung identisch mit automatischen Fußnoten.
-@funindex evenFooterMarkup
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ \footnote
+ "1" #'(0.5 . -2)
+ \markup { \italic "1. Die erste Note" }
+ a'4
+ b8
+ \footnote
+ \markup { \bold "2" } #'(0.5 . 1)
+ "2. Die zweite Note"
+ e
+ c4
+ d-\footnote "3" #'(0.5 . -1) "3. Piano" \p
+ }
+}
+@end lilypond
-@item evenFooterMarkup
-Das ist die Fußzeile für gerade Seiten. Wenn undefiniert, wird die
-ungerade Fußzeile eingesetzt.
+Fußnoten für Akkordnoten werden wie folgt notiert:
-Standardmäßig wird in der Fußzeile auf der ersten Seite das Copyright
-und auf der letzten Seite die Tag-Zeile gesetzt.
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ <
+ \footnote "1" #'(1 . -1.25) "1. C" c
+ \footnote
+ \markup { \bold "b" } #'(2 . -0.25) "b. E-flat" es
+ \footnote "3" #'(2 . 3) \markup { \italic "iii. G" } g
+ >1
+ }
+}
+@end lilypond
-@end table
+@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:
-@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' {
+ a'4-\footnote
+ \markup { \teeny 1 } #'(-3 . 0)
+ \markup { 1. \bold Forte } \f
+ -\footnote
+ \markup { \teeny b } #'(0 . 1.5)
+ \markup { b. Ein Bogen } (
+ b8)-\footnote
+ \markup { \teeny 3 } #'(0 . -2)
+ \markup { 3. Balken } [
+ 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 warndendes Versetzungszeichen }
+ dis?4-\footnote
+ \markup \concat \teeny { "a" } #'(0.5 . -0.5)
+ \markup \italic { a. Langsamer werden } _"rit."
+ \footnote
+ \markup { \teeny \musicglyph #"rests.4" }
+ #'(1.5 . -0.25)
+ \markup { \null } \breathe
+ }
+}
+@end lilypond
-Die folgende Definition setzt die Überschrift linksbündig und
-den Komponisten rechtsbündig auf einer einzelnen Zeile:
+Eine @code{\markup}-Beschriftung der höchsten Ebene wird wie folgt
+annotiert:
-@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 }
+ \markup { "Eine einfache Melodie" \footnote "*" \italic "* Von mir" }
+ \relative c' {
+ a'4 b8 e c4 d4
}
}
-@end verbatim
+@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 Reference to page numbers
-@subsection Reference to page numbers
+@node Verweis auf die Seitenzahlen
+@subsection Verweis auf die Seitenzahlen
+@translationof Reference to page numbers
Eine bestimmte Stelle der Partitur kann mit einem @code{\label}-Befehl
markiert werden, sowohl auf oberster Ebene als auch innerhalb eines
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,
@endpredefined
-@node Table of contents
-@subsection Table of contents
+@node Inhaltsverzeichnis
+@subsection Inhaltsverzeichnis
+@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))
@end verbatim
-@lilypond[line-width=11.0\cm]
+@lilypond[line-width=10.0\cm]
\header { tagline = ##f }
\paper {
tocActMarkup = \markup \large \column {
(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,line-width=10.0\cm]
+\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
@endpredefined
-@node Working with input files
-@section Working with input files
+@node Arbeiten an Eingabe-Dateien
+@section Arbeiten an Eingabe-Dateien
+@translationof Working with input files
@menu
-* Including LilyPond files::
-* Different editions from one source::
-* Text encoding::
-* Displaying LilyPond notation::
+* LilyPond-Dateien einfügen::
+* Verschiedene Editionen aus einer Quelldatei::
+* Sonderzeichen::
@end menu
-@node Including LilyPond files
-@subsection Including LilyPond files
+@node LilyPond-Dateien einfügen
+@subsection LilyPond-Dateien einfügen
+@translationof Including LilyPond files
@funindex \include
@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
auch in der Hauptdatei eingesetzt werden können. Mit Marken (Tags)
gekennzeichnete Abschnitte können eingesetzt werden, um die
entsprechenden Noten etc. an verschiedenen Stellen in der Datei
-zur Verfügung zu stellen. Siehe auch @ref{Different editions from
-one source}.
+zur Verfügung zu stellen. Siehe auch @ref{Verschiedene Editionen aus einer Quelldatei}.
Auf Dateien im aktuellen Verzeichnis kann einfach mit dem Dateinamen
nach dem @code{\include}-Befehl verwiesen werden. Dateien an anderen
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,
Dateien, die in vielen Partituren verwendet werden sollen, können
im LilyPond-Verzeichnis @file{../ly} gespeichert werden. (Die
Stelle, an der dieses Verzeichnis sich befindet, hängt vom Betriebssystem
-ab, siehe hierzu @rlearning{Other sources of information}). Dateien
+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.
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{Other sources of information} besprochen.
+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{Scores and parts}.
+@rlearning{Partituren und Stimmen}.
@seealso
Handbuch zum Lernen:
-@rlearning{Other sources of information},
-@rlearning{Scores and parts}.
+@rlearning{Mehr Information},
+@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.
-@node Different editions from one source
-@subsection Different editions from one source
+@node Verschiedene Editionen aus einer Quelldatei
+@subsection Verschiedene Editionen aus einer Quelldatei
+@translationof Different editions from one source
Es gibt verschiedene Funktionen, die es möglich machen, unterschiedliche
Versionen einer Partitur aus der gleichen Quelldatei zu produzieren.
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
-* Using variables::
-* Using tags::
+* Variablen benutzen::
+* Marken benutzen::
+* Globale Einstellungen benutzen::
@end menu
-@node Using variables
-@unnumberedsubsubsec Using variables
+@node Variablen benutzen
+@unnumberedsubsubsec Variablen benutzen
+@translationof Using variables
@cindex Variablen, Benutzung
Wenn Notenabschnitt in Variablen definiert werden, können sie
an unterschiedlichen Stellen in der Partitur eingesetzt werden,
-siehe auch @rlearning{Organizing pieces with variables}. Zum
+siehe auch @rlearning{Stücke durch Bezeichner organisieren}. Zum
Beispiel enthält eine Vokalpartitur für ein @notation{a cappella}
Stück oft einen Klavierauszug, der das Einüben einfacher macht.
Der Klavierauszug enthält die gleichen Noten, sodass man sie nur
einmal notieren muss. Noten aus zwei Variablen können auf einem
-System kombiniert werden, siehe @ref{Automatic part combining}.
+System kombiniert werden, siehe @ref{Automatische Kombination von Stimmen}.
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, }
verändert wird; die Noten müssen dazu nicht verändert werden.
Für längere Partituren können Variablen in eigene Dateien notiert
-werden, die dann eingebunden werden, siehe @ref{Including
-LilyPond files}.
+werden, die dann eingebunden werden, siehe @ref{LilyPond-Dateien einfügen}.
-@node Using tags
-@unnumberedsubsubsec Using tags
+@node Marken benutzen
+@unnumberedsubsubsec Marken benutzen
+@translationof Using tags
@cindex Tag
@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:
-@rlearning{Organizing pieces with variables}.
+@rlearning{Stücke durch Bezeichner organisieren}.
Notationsreferenz:
-@ref{Automatic part combining},
-@ref{Including LilyPond files}.
+@ref{Automatische Kombination von Stimmen},
+@ref{LilyPond-Dateien einfügen}.
@ignore
@end ignore
-@node Text encoding
-@subsection Text encoding
+@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
+@unnumberedsubsubsec Zeichenkodierung
+@translationof Text encoding
+
+
+@cindex UTF-8
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
+
Um das Copyright-Zeichen zu notieren, kann folgender Code eingesetzt werden:
@example
@end example
-@node Displaying LilyPond notation
-@subsection 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:
+
+@lilypond[quote,verbatim]
+\paper {
+ #(include-special-characters)
+}
-Ein musikalischer Ausdruck in LilyPond-Notation kann mit der Funktion
-@code{\displayMusic} angezeigt werden. Der Code
+\markup "&flqq; – &OE;uvre incomplète… &frqq;"
-@example
-@{
- \displayLilyMusic \transpose c a, @{ c e g a bes @}
-@}
-@end example
+\score {
+ \new Staff { \repeat unfold 9 a'4 }
+ \addlyrics {
+ This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
+ }
+}
-@noindent
-etwa wird ausgeben:
+\markup \column {
+ "The replacement can be disabled:"
+ "– &OE; …"
+ \override #'(replacement-alist . ()) "– &OE; …"
+}
+@end lilypond
-@example
-@{ a, cis e fis g @}
-@end example
+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
-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:
+@noindent
+oder lokal:
-@c TODO What happens under Windows?
+@lilypond[quote,verbatim]
+\markup \replace #'(("100" . "hundred")
+ ("dpi" . "dots per inch")) "A 100 dpi."
+@end lilypond
-@example
-lilypond file.ly >display.txt
-@end example
+@seealso
+Notationsreferenz:
+@ref{Liste der Sonderzeichen}.
+Installierte Dateien:
+@file{ly/text-replacements.ly}.
-@node Controlling output
-@section Controlling output
+@node Ausgabe kontrollieren
+@section Ausgabe kontrollieren
+@translationof Controlling output
@menu
-* Extracting fragments of music::
-* Skipping corrected music::
+* Notationsfragmente extrahieren::
+* Korrigierte Musik überspringen::
+* Alternative Ausgabeformate::
+* Die Notationsschriftart verändern::
@end menu
-@node Extracting fragments of music
-@subsection Extracting fragments of music
+@node Notationsfragmente extrahieren
+@subsection Notationsfragmente extrahieren
+@translationof Extracting fragments of music
Es ist möglich, kleine Abschnitte einer großen Partitur direkt aus der
Quelldatei zu erzeugen. Das kann damit verglichen werden, dass man
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.
-Zu mehr Information über Ausgabeformate siehe @rprogram{Invoking lilypond}.
+Zu mehr Information über Ausgabeformate siehe @rprogram{lilypond aufrufen}.
-@node Skipping corrected music
-@subsection Skipping corrected music
+@node Korrigierte Musik überspringen
+@subsection Korrigierte Musik überspringen
+@translationof Skipping corrected music
@funindex skipTypesetting
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 MIDI output
-@section MIDI output
+@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
@cindex Klang
@cindex MIDI
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
-* Creating MIDI files::
-* MIDI block::
-* What goes into the MIDI output?::
-* Repeats in MIDI::
-* Controlling MIDI dynamics::
-* Percussion in MIDI::
+* MIDI-Dateien erstellen::
+* Der MIDI-Block::
+* Was geht in die MIDI-Ausgabe::
+* Wiederholungen im MIDI::
+* MIDI-Lautstärke kontrollieren::
+* Schlagzeug in MIDI::
+* Artikuliere-Skript::
@end menu
-@node Creating MIDI files
-@subsection Creating MIDI files
+@node MIDI-Dateien erstellen
+@subsection MIDI-Dateien erstellen
+@translationof Creating MIDI files
Um eine MIDI-Datei aus einer LilyPond-Quelldatei zu erstellen, muss
eine @code{\midi}-Umgebung zu der @code{\score}-Umgebung hinzugefügt
werden in einen bestimmten Lautstärkenwert übersetzt, Crescendo und
Decrescendo erreichen einen Übergang zwischen Lautstärkewerten.
Die Wirkung von Dynamikzeichen kann auch aus der MIDI-Datei entfernt
-werden. Siehe hierzu @ref{MIDI block}.
+werden. Siehe hierzu @ref{Der MIDI-Block}.
Das Anfangstempo und spätere Tempoänderungen können mit dem
@code{\tempo}-Befehl innerhalb der Notation notiert werden. Er
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{Metronome marks}. Eine
-andere möglichkeit, ein eigenes MIDI-Tempo anzugeben, wird weiter
-unten gezeigt, siehe @ref{MIDI block}.
+auch unterdrückt werden kann, siehe @ref{Metronomangabe}. Eine
+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
die Standarddateierweiterung von MIDI-Dateien @code{.mid}. Andere
lilypond … -dmidi-extension=midi lilyDatei.ly
@end example
-@unnumberedsubsubsec Instrument names
+@unnumberedsubsubsec Instrumentenbezeichnungen
@cindex Instrumentbezeichnungen
Das MIDI-Instrument, mit dem ein bestimmtes System wiedergegeben
werden soll, wird durch die @code{Staff.midiInstrument}-Eigenschaft
bestimmt, die auf eine Instrumentenbezeichnung gesetzt werden muss.
-Die Bezeichnungen sind aufgelistet in @ref{MIDI instruments} und müssen
+Die Bezeichnungen sind aufgelistet in @ref{MIDI-Instrumente} und müssen
in der dort definierten Schreibweise notiert werden.
@example
@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
Player und @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
-@node MIDI block
-@subsection MIDI block
+@node Der MIDI-Block
+@subsection Der MIDI-Block
+@translationof MIDI block
@cindex MIDI-Umgebung
\score @{
@var{...Noten...}
\midi @{
- \context @{
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 4)
- @}
+ \tempo 4 = 72
@}
@}
@end example
-Hier wird das Tempo auf 72 Viertelnoten pro Minute definiert. Wenn
-das Tempo auf diese Weise definiert wird, kann keine punktierte
-Note als Einheit angegeben werden. Wenn sie benötigt wird, muss
-man sie in kleinere Einheiten auflösen. Ein Tempo von 90 punktierten
-Viertelnoten pro Minute kann beispielsweise dargestellt werden
-als 270 Achtelnoten pro Minute:
-
-@example
-tempoWholesPerMinute = #(ly:make-moment 270 8)
-@end example
+Hier wird das Tempo auf 72 Viertelnoten pro Minute definiert. @code{\tempo}
+ist eigentlich ein Musikbefehl, der die Eigenschaften während der Interpretation
+der Musik einstellt: im Kontext von Ausgabedefinitionen wie etwa einem
+@code{\midi}-Kontext werden sie neu interpretiert, als ob es sich um
+Kontextmodifikatoren handelte.
@cindex MIDI-Kontextdefinitionen
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
-@rlearning{Other sources of information}. Um beispielsweise
+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
-@node What goes into the MIDI output?
-@subsection What goes into the MIDI output?
+@node Was geht in die MIDI-Ausgabe
+@subsection Was geht in die MIDI-Ausgabe
+@translationof What goes into the MIDI output?
-@unnumberedsubsubsec Supported in MIDI
+@unnumberedsubsubsec In MIDI unterstützt
@cindex Tonhöhen in MIDI
@cindex MIDI, Tonhöhen
@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:
@itemize
@item Tonhöhen
-@item Mikrotöne (siehe @ref{Accidentals}. Für die Ausgabe wird ein
+@item Mikrotöne (siehe @ref{Versetzungszeichen}. Für die Ausgabe wird ein
Spieler benötigt, der Tonhöhen verändern kann.)
@item Akkorde, die als Symbole notiert werden
@item Rhythmen, die als Dauern notiert sind, inklusive N-tolen
@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 Unsupported in MIDI
+@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}]}
@end itemize
-@node Repeats in MIDI
-@subsection Repeats in MIDI
+@node Wiederholungen im MIDI
+@subsection Wiederholungen im MIDI
+@translationof Repeats in MIDI
@cindex Wiederholungen in MIDI
@cindex MIDI und Wiederholungen
@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
@end example
-@node Controlling MIDI dynamics
-@subsection Controlling MIDI dynamics
+@node MIDI-Lautstärke kontrollieren
+@subsection MIDI-Lautstärke kontrollieren
+@translationof Controlling MIDI dynamics
Dynamik in der MIDI-Ausgabe wird durch den Dynamic_performer
erstellt, welcher sich in einem @code{Voice}-Kontext befindet.
relative Lautstärke von einzelnen Instrumenten einzustellen.
-@unnumberedsubsubsec Dynamic marks
-
+@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
@notation{fffff}. Diese Anweisung befinden sich in der Datei
-@file{../scm/midi.scm}, siehe auch @rlearning{Other sources of 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
\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 {}
gemacht werden kann.
-@unnumberedsubsubsec Overall MIDI volume
+@unnumberedsubsubsec MIDI-Lautstärke
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 {
+ \tempo 2 = 72
\context {
\Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
midiMinimumVolume = #0.2
midiMaximumVolume = #0.5
}
@end lilypond
-@unnumberedsubsubsec Equalizing different instruments (i)
+@unnumberedsubsubsec Verschiedene Instrumente angleichen (i)
Wenn die Mindest- und Höchstwerte für die MIDI-Lautstärke
innerhalb eines @code{Staff}-Kontextes gesetzt werden,
\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
- tempoWholesPerMinute = #(ly:make-moment 72 2)
- }
+ \tempo 2 = 72
}
}
@end lilypond
-@unnumberedsubsubsec Equalizing different instruments (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
}
}
>>
\layout { }
\midi {
- \context {
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
- }
+ \tempo 2 = 72
}
}
@end lilypond
-@node Percussion in MIDI
-@subsection Percussion in MIDI
+@node Schlagzeug in MIDI
+@subsection Schlagzeug in MIDI
+@translationof Percussion in MIDI
Schlagzeuginstrumente werden üblicherweise in einem @code{DrumStaff}-Kontext
notiert. Aus diese Weise werden sie korrekt in den MIDI-Kanal@tie{}10
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