@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@ignore
- Translation of GIT committish: 5cf864d550e7148412d594cf336841791bff6f76
+ Translation of GIT committish: ac3dd3ad38528113d97f6a8a7b81751c328f1c36
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.17"
@c Translators: Till Paala
@translationof Input structure
Das hauptsächliche Eingabeformat von LilyPond sind Textdateien.
-Üblicherweise werden diese Dateien mit der Endung @code{.ly}
+Üblicherweise werden diese Dateien mit der Endung @file{.ly}
versehen.
@menu
* Struktur einer Partitur::
* Mehrere Partituren in einem Buch::
+* Mehrere Ausgabedateien aus einer Eingabedatei::
+* Dateinamen der Ausgabedateien::
* Die Dateistruktur::
@end menu
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{Dateistruktur}.
+
@seealso
Handbuch zum Lernen:
@rlearning{Musikalische Ausdrücke erklärt},
@rlearning{Score ist ein (einziger) zusammengesetzter musikalischer Ausdruck}.
+Notationsreferenz:
+@ref{Mehrere Partituren in einem Buch},
+@ref{Mehrere Ausgabedateien aus einer Eingabedatei} und
+@ref{Dateistruktur}.
+
@node Mehrere Partituren in einem Buch
@subsection Mehrere Partituren in einem Buch
@funindex \book
-Alle Sätze und Texte, die in derselben @code{.ly}-Datei vorkommen,
+Alle Sätze und Texte, die in derselben @file{.ly}-Datei vorkommen,
werden normalerweise in eine einzige Ausgabedatei gesetzt.
@example
@}
@end example
-Wenn Sie aber mehrere Ausgabedateien aus einer einzigen @code{.ly}-Datei
-erstellen wollen, können Sie mehrere @code{\book}-Umgebungen notieren.
-Wenn Sie keine @code{\book}-Umgebung in Ihrer Datei angeben, interpretiert
-LilyPond die gesamte Datei als eine große @code{\book}-Umgebung (siehe
-auch @ref{Die Dateistruktur}. Eine wichtige Ausnahme stellen Dokumente dar,
+Eine wichtige Ausnahme stellen Dokumente dar,
die mit lilypond-book erstellt werden, für die Sie explizit
@code{\book}-Umgebungen notieren müssen, weil sonst nur die erste
@code{\score}- bzw. @code{\markup}-Umgebung angezeigt wird.
@}
@end example
+
+@node Mehrere Ausgabedateien aus einer Eingabedatei
+@subsection Mehrere Ausgabedateien aus einer Eingabedatei
+@translationof Multiple output files from one input file
+
+Wenn Sie mehrere Ausgabedateien aus derselben @file{.ly}-Datei haben
+wollen, können Sie mehrere @code{\book}-Umgebungen hinzufügen, wobei
+jede Umgebung eine neue Ausgabedatei produziert. Wenn Sie keine
+@code{\book}-Umgebung in der Eingabedatei angeben, wird die Datei von
+LilyPond implizit als eine große @code{\book}-Umgebung behandelt, siehe
+auch @ref{Dateistruktur}.
+
+Wenn man mehrere Dateien aus einer einzigen Eingabedatei erstellt, stellt
+LilyPond sicher, dass keine der Ausgabedateien der vorhandenen
+@code{\book}-Umgebungen eine andere Ausgabedatei, etwa von der vorherigen
+@code{\book}-Umgebung, überschreibt.
+
+Dies geschieht, indem ein Suffix an den Ausgabenamen für jede
+@code{\book}-Umgebung gehängt wird, die den Dateinamen der Eingabdatei
+als Grundlage nimmt.
+
+Das Standardverhalten ist es, einen Zahlen-Suffix für die Namen hinzuzufügen,
+die in Konflikt stehen. Der Code
+
+@example
+\book @{
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+@end example
+
+@noindent
+produziert also
+
+@itemize
+@item
+@file{eightminiatures.pdf},
+@item
+@file{eightminiatures-1.pdf} and
+@item
+@file{eightminiatures-2.pdf}.
+@end itemize
+
+
+@node Dateinamen der Ausgabedateien
+@subsection Dateinamen der Ausgabedateien
+@translationof Output file names
+
+@funindex \bookOutputSuffix
+@funindex \bookOutputName
+
+LilyPond stellt die Möglichkeit zur Verfügung zu kontrollieren, welche
+Dateinamen für welche Back-ends benutzt werden sollen, wenn die Ausgabedateien
+erstellt werden.
+
+Im vorhergehenden Abschnitt wurde gezeigt, wir LilyPond gleichnamige
+Ausgabedateien verhindert, wenn mehrere Ausgabedateien aus derselben
+Eingabedatei erstellt werden. Es gibt auch die Möglichkeit, eigene
+Suffixe für jeden @code{\book}-Abschnitt zu definieren, sodass man etwa
+Dateinamen wie @file{eightminiatures-Romanze.pdf}, @file{eightminiatures-Menuetto.pdf}
+und @file{eightminiatures-Nocturne.pdf} produzieren kann, indem man
+eine @code{\bookOutputSuffix}-Angabe in jede @code{\book}-Umgebung
+einfügt.
+
+@example
+\book @{
+ \bookOutputSuffix "Romanze"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputSuffix "Menuetto"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputSuffix "Nocturne"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+@end example
+
+Man kann auch einen anderen Dateinamen für die Ausgabedatei einer
+@code{\book}-Umgebung erstellen, indem man @code{\bookOutputName}-Angabe
+macht:
+
+@example
+\book @{
+ \bookOutputName "Romanze"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputName "Menuetto"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+\book @{
+ \bookOutputName "Nocturne"
+ \score @{ @dots{} @}
+ \layout @{ @dots{} @}
+@}
+@end example
+
+Die obige Datei produziert folgene Ausgabedateien:
+
+@itemize
+@item
+@file{Romanze.pdf},
+@item
+@file{Menuetto.pdf} and
+@item
+@file{Nocturne.pdf}.
+@end itemize
@node Die Dateistruktur
@subsection Die Dateistruktur
@translationof File structure
@cindex Eingabedatei, Struktur
@cindex Quelldatei, Struktur
-Eine @code{.ly}-Datei kann eine 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
@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
@seealso
-Hanbuch zum Lernen:
+Handbuch zum Lernen:
@rlearning{Wie eine LilyPond-Eingabe-Datei funktioniert}.
@menu
* Titel erstellen::
-* Eigene Titel::
+* Eigene Kopf und Fußzeilen sowie Titel::
* Verweis auf die Seitenzahlen::
* Inhaltsverzeichnis::
@end menu
@funindex composer
@item composer
-Name des Komponisten, rechtsbüngig unter dem Unteruntertitel.
+Name des Komponisten, rechtsbündig unter dem Unteruntertitel.
@funindex meter
@item meter
@funindex breakbefore
@item breakbefore
-Hiermit beginnt der Titel auf einer neuen Steite. (Kann die Werte
+Hiermit beginnt der Titel auf einer neuen Seite. (Kann die Werte
##t (wahr) oder ##f (falsch) haben.)
@funindex copyright
@noindent
Dieses Verhalten kann verändert werden (sodass alle Angaben aus der
-überschrift gesetzt werden, wenn sich @code{\header} innerhalb von
+Ã\9cberschrift gesetzt werden, wenn sich @code{\header} innerhalb von
@code{\score} befindet), indem man schreibt:
@example
@end example
-@node Eigene Titel
-@subsection Eigene Titel
-@translationof Custom titles
+@node Eigene Kopf und Fußzeilen sowie Titel
+@subsection Eigene Kopf- und Fußzeilen sowie Titel
+@translationof Custom headers footers and titles
Kompliziertere Anpassungen können vorgenommen werden, indem die
folgenden Variablen innerhalb der @code{\paper}-Umgebung geändert
@item scoreTitleMarkup
Das ist die Überschrift, die vor jede @code{\score}-Umgebung gesetzt wird.
-Überlicherweise wird hier etwa die Bezeichnung eines Satzes notiert
+Üblicherweise wird hier etwa die Bezeichnung eines Satzes notiert
(im @code{piece}-Feld).
@funindex oddHeaderMarkup
Die folgende Definition setzt die Überschrift linksbündig und
den Komponisten rechtsbündig auf einer einzelnen Zeile:
-@verbatim
-\paper {
- bookTitleMarkup = \markup {
- \fill-line {
+@example
+\paper @{
+ bookTitleMarkup = \markup @{
+ \fill-line @{
\fromproperty #'header:title
\fromproperty #'header:composer
- }
- }
-}
-@end verbatim
+ @}
+ @}
+@}
+@end example
+
+Kopf- und Fußzeile werden mit den Funktionen @code{make-header} und
+@code{make-footer} erstellt, welche in @code{\paper} definiert werden.
+Die Standardimplementationen finden sich in @file{ly/paper-defaults-init.ly} und
+@file{ly/titling-init.ly}.
+
+Dieses Beispiel zentriert die Seitenzahlen unten auf jeder Seite:
+
+@example
+\paper @{
+ print-page-number = ##t
+ print-first-page-number = ##t
+ oddHeaderMarkup = \markup \fill-line @{ " " @}
+ evenHeaderMarkup = \markup \fill-line @{ " " @}
+ oddFooterMarkup = \markup @{
+ \fill-line @{
+ \bold \fontsize #3
+ \on-the-fly #print-page-number-check-first
+ \fromproperty #'page:page-number-string
+ @}
+ @}
+ evenFooterMarkup = \markup @{
+ \fill-line @{
+ \bold \fontsize #3
+ \on-the-fly #print-page-number-check-first
+ \fromproperty #'page:page-number-string
+ @}
+ @}
+@}
+@end example
@node Verweis auf die Seitenzahlen
{
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
@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
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,
besten eingesetzt, wenn eine von mehreren kurzen alternativen
Notenabschnitten ausgewählt werden soll. 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, }
@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
@end ignore
+@node Globale Einstellungen benutzen
+@unnumberedsubsubsec Globale Einstellungen benutzen
+@translationof Using global settings
+
+@funindex include-settings
+
+Man kann globale Einstellungen aus einer externen Datei einfügen:
+
+@example
+lilypond -dinclude-settings=MY_SETTINGS.ly MY_SCORE.ly
+@end example
+
+
+Einstellungsgruppen, wie etwa Seitengröße, Schriftart oder Schriftschnitt, können
+in eigenen Dateien gespeichert werden. Das ermöglicht es, aus der gleichen
+Partitur unterschiedliche Editionen zu erstellen bzw. Standardeinstellungen
+für eine ganze Anzahl von Partituren wiederzuverwenden, indem man einfach
+die entsprechende Einstellungsdatei angibt.
+
+Diese Technik funktioniert auch gut für globale Formatierungen, wie behandelt
+in @rlearning{Globale Formatierung}.
+
+@seealso
+Handbuch zum Lernen:
+@rlearning{Stücke durch Bezeichner organisieren},
+@rlearning{Globale Formatierung}.
+
+Notationsreferenz:
+@ref{LilyPond-Dateien einfügen}.
+
+
@node Zeichenkodierung
@subsection Zeichenkodierung
@translationof Text encoding
à vo -- cê uma can -- ção legal
}
-\relative {
+\relative c' {
c2 d e f g f e
}
\addlyrics { \bulgarian }
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--2011" \char ##x00A9 }
@end lilypond
@cindex Copyright-Zeichen
@funindex \displayLilyMusic
Ein musikalischer Ausdruck in LilyPond-Notation kann mit der Funktion
-@code{\displayMusic} angezeigt werden. Der Code
+@code{\displayLilyMusic} angezeigt werden. Der Code
@example
@{
- \displayLilyMusic \transpose c a, @{ c e g a bes @}
+ \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
@}
@end example
etwa wird ausgeben:
@example
-@{ a, cis e fis g @}
+@{ a,4 cis e fis g @}
@end example
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,
+Kompilations-Nachrichten auf der Kommandozeile ausgegeben.
+Um sie separat zu speichern und das Ergebnis von @code{\displayLilyMusic}
+weiterzubenutzen,
kann die Ausgabe mit folgendem Befehl in eine Datei umgeleitet werden:
-@c TODO What happens under Windows?
-
@example
lilypond file.ly >display.txt
@end example
@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 {
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 von lilypond auf der Kommandozeile}.
+
+
+@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.
+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.
+Normale MIDI-Ausgabe ist etwas roh; optional kann eine verbesserte und
+realistischere MIDI-Ausgabe mit einem @ref{Artikuliere-Skript}
+erzeugt werden.
+
Die MIDI-Ausgabe benötigt einen Kanal für jedes System und einen für
globale Einstellungen. Darum sollte die Quelldatei für eine MIDI-Datei
nicht mehr als 15 Systeme (oder 14 wenn kein Schlagzeug benützt wird)
* Wiederholungen im MIDI::
* MIDI-Lautstärke kontrollieren::
* Schlagzeug in MIDI::
+* Artikuliere-Skript::
@end menu
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,
+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.
projects / lilypond.git / blobdiff