<html>
<!--
- Translation of GIT committish: 90fd19c1e2a433d6657cf7270cf0d1932cb4934a
+ Translation of GIT committish: b54fc6953a8d70a3c51e8c3d0cbf9b3fe9652d78
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
<td class="left-column">
<ul>
<li>
- <a class="title" href="user/lilypond-learning/index.de.html">Handbuch zum Lernen (LM)</a>
+ <a class="title" href="user/lilypond-learning/index.de.html">Handbuch zum Lernen</a>
<br>(Für den ersten Anfang.)
<li><a class="title" href="user/music-glossary/index.html">Glossar</a>
- (auf <a class="title" href="user/music-glossary-big-page.html">einer großen Seite</a> ~ 1 Mb,
+ (auf <a class="title" href="user/music-glossary-big-page.html">einer großen Seite</a> ~ 500 kB,
als <a class="title" href="user/music-glossary.pdf">PDF</a>)
<br>(Übersetzung von musikalischen Begriffen aus dem Englischen in andere Sprachen.)
<ul>
<li>
-<a class="title" href="user/lilypond/index.de.html">Benutzerhandbuch (NR)</a>
- (auf <a class="title" href="user/lilypond-big-page.html">einer großen Seite</a> ~ 4 Mb,
+<a class="title" href="user/lilypond/index.de.html">Benutzerhandbuch</a>
+ (auf <a class="title" href="user/lilypond-big-page.html">einer großen Seite</a> ~ 4 MB,
als <a class="title" href="user/lilypond.de.pdf">PDF</a>)
<br>(Notation mit LilyPond setzen.)
<li>
- <a class="title" href="user/lilypond-internals/index.html">Programmreferenz (IR)</a>
+ <a class="title" href="user/lilypond-internals/index.html">Programmreferenz</a>
(auf <a class="title" href="user/lilypond-internals-big-page.html">einer großen Seite</a> ~ 1 Mb)
<br>(Definitionen, wie die Standardeinstellungen verändert können.)
<ul>
<li>
- <a class="title" href="user/lilypond-program/index.de.html">Programmbenutzung (AU)</a>
+ <a class="title" href="user/lilypond-program/index.de.html">Programmbenutzung</a>
(auf <a class="title" href="user/lilypond-program-big-page.html">einer großen Seite</a>,
als <a class="title" href="user/lilypond-program.de.pdf">PDF</a>)
<br>(Wie das Programm installiert und gestartet wird.)
</ul>
</td><td class="right-column">
-<!-- TODO
- <ul>
- <li><a class="title" href="translations.html">Translations status</a>
- <br>(see translations progress)
- </ul>
--->
+ <ul>
+ <li><a class="title" href="translations.html">Übersetzungsstatus</a>
+ <br>(siehe Fortschritt der Übersetzungen)
+ </ul>
</td>
</tr>
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: fc6469f52dc27d4b5c22067367878a5c2ff5fb45
+ Translation of GIT committish: b54fc6953a8d70a3c51e8c3d0cbf9b3fe9652d78
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 3237f4afc77b528ca92ca6d68664bd80e39d9e76
+ Translation of GIT committish: b54fc6953a8d70a3c51e8c3d0cbf9b3fe9652d78
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-learning.tely
@ignore
- Translation of GIT committish: c60d0f3c72164f384ec8f7af90fdd8a66ab32b91
+ Translation of GIT committish: a8c28adaf60e575fa101c93b4fda7557741bfb86
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
@c \version "2.11.51"
-
+@c Translators: Till Rettig, Reinhold Kainhofer
@node Fundamental concepts
@chapter Fundamental concepts
-Dieses Kapitel behandelt das allgemeine Konzept von LilyPond
-und wie man @code{\score}-Blöcke erstellt.
+Nachdem im Tutorial gezeigt wurde, wie aus einfachen Text-Dateien
+wunderschön formatierte Musiknoten erzeugt werden können, stellt
+dieses Kapitel die Konzepte und Techniken vor, wie auch komplexere
+Partituren erstellt werden können.
@menu
* How LilyPond files work::
}
@end lilypond
-Jetzt kommt noch eine Ebene dazu: LilyPond-Code in der obigen Form
-ist in Wirklichkeit auch wieder eine Abkürzung. Auch wenn man so
-Dateien schreiben kann und sie auch korrekt gesetzt werden, heißt
-der wirkliche Code, der hier gemeint ist, eigentlich:
+Eine komplette Definition des Eingabeformats findet sich
+im Kapitel @ruser{File structure}.
+
+@menu
+* Introduction to the LilyPond file structure::
+* Score is a (single) compound musical expression::
+* Nesting music expressions::
+* On the un-nestedness of brackets and ties::
+@end menu
+
+@node Introduction to the LilyPond file structure
+@subsection Introduction to the LilyPond file structure
+
+@cindex Eingabeformat
+@cindex Dateistruktur
+
+Ein grundlegendes Beispiel einer Eingabedatei für LilyPond lautet:
@example
+\version @w{"@version{}"}
+\header @{ @}
\score @{
- \relative c'' @{
- c4 a b c
+ @var{...zusammengesetzter Musik-Austruck...} % Die gesamte Musik kommt hier!
+ \layout @{ @}
+ \midi @{ @}
+@}
+@end example
+
+@noindent
+Aufgrund der Flexibilität von LilyPond gibt es viele Variationen dieses
+Schemas, aber dieses Beispiel dient als einfacher Ausgangspunkt.
+
+@funindex \book
+@funindex \score
+@cindex book
+@cindex score
+
+Bisher hat noch keines der Beispiele den @code{\score@{@}}-Befehl
+benutzt, da Lilypond derartige zusätzliche Befehle automatisch
+bei Bedarf einfügt, wenn die Eingabedatei eine einfache Struktur
+hat.
+
+Sehen wir uns als ein solches einfaches Beispiel an:
+
+@example
+\relative c'' @{
+ c4 a d c
+@}
+@end example
+
+@noindent
+Im Hintergrund kommen hier noch einige Ebenen dazu: LilyPond-Code
+in der obigen Form ist in Wirklichkeit eine Abkürzung. Auch wenn man so
+Dateien schreiben kann und sie auch korrekt gesetzt werden, heißt
+der vollständige Code, der hier gemeint ist, eigentlich:
+
+@example
+\book @{
+ \score @{
+ \new Staff @{
+ \new Voice @{
+ \relative c'' @{
+ c4 a b c
+ @}
+ @}
+ @}
+ \layout @{ @}
@}
@}
@end example
+@noindent
+Mit anderen Worten: Wenn die Eingabedatei einen einfachen Musik-Ausdruck
+enthält, wird LilyPond die Datei so interpretieren, als ob dieser
+Ausdruck in den oben gezeigten Befehlen eingegeben wurde. Diese nötige
+Stuktur wird automatisch im Speicher beim Aufruf von LilyPond erzeugt,
+ohne dass der Benutzer davon etwas bemerkt.
+
+@cindex implicit contexts
+
+@strong{Ein Wort der Warnung ist jedoch angebracht!} Viele der Beispiele
+in der Dokumentation von LilyPond lassen die @code{\new Staff} und @code{\new Voice}
+Befehle zur Erzeugung einer Notenzeile und einer Stimme (beides ist in
+LilyPond ein sogenannter Kontext) bewusst aus,
+damit sie implizit von LilyPond im Speicher erzeugt werden.
+Für einfache Dokumente funktioniert das im Allgemeinen sehr gut, für
+komplexere Partituren können dadurch aber unerwartete Ergebnisse
+entstehen, teilweise sogar unerwartete leere Notenzeilen. Um
+die entsprechenden Kontexte in diesem Fall explizit zu erzeugen,
+siehe @ref{Contexts and engravers}.
+
+@warning{Wenn mehr als ein paar Zeilen an Musik eingegeben werden,
+empfielt es sich, die Notenzeilen und die Stimmen immer explizit
+mit @code{\new Staff} und @code{\new Voice} zu erzeugen.}
+
+Im Moment wollen wir aber zu unserem ersten Beispiel zurückkehren und
+nur den @code{\score}-Befehl näher betrachten.
+
Eine Partitur (@code{\score}) muss immer mit einem musikalischen Ausdruck
beginnen. Das ist letztendlich alle Musik, angefangen bei einer
einzelnen
@example
@{
\new GrandStaff <<
- hier die gesamte Partitur
+ @var{...hier die gesamte Partitur...}
>>
@}
@end example
@}
@end example
+@funindex \header
+@funindex \layout
+@funindex \midi
+@cindex header
+@cindex layout
+@cindex midi
+
@noindent
-Viele setzen einige dieser Befehle außerhalb des
-@code{\score}-Blocks, zum Beispiel wird der @code{\header}
-sehr oft oberhalb der @code{\score}-Umgebung gesetzt. Das
+
+@noindent
+Wie man sieht sind die drei Befehle @code{\header}, @code{\layout} und
+@code{\midi} von spezieller Natur: Im Gegensatz zu vielen Anderen Befehlen,
+die auch mit einem @code{\} beginnen, liefern sie @emph{keinen} Musikausdruck
+und sind auch nicht Teil eines musikalischen Ausdrucks. Daher können sie
+sowohl innerhalb eines @code{\score}-Blocks als auch außerhalb plaziert
+werden. Tatsächlich werden einige dieser Befehle meist außerhalb des
+@code{\score}-Blocksgesetzt, zum Beispiel findet sich der @code{\header}
+sehr oft oberhalb der @code{\score}-Umgebung. Das
funktioniert genauso gut.
+
+Zwei bisher noch nicht aufgetauchte Befehle sind
+@code{\layout @{ @}} und @code{\midi @{@}}. Wenn sie in einer
+Datei vorkommen, führt dies dazu, dass Lilypond eine druckfähige PDF-Datei
+bzw. eine MIDI-Datei erzeugt. Genauer beschrieben werden sie im
+Benutzerhandbuch -- @ruser{Score layout}, and
+@ruser{Creating MIDI files}.
+
+@cindex Partituren, mehrfache
+
+Ihr LilyPond Code kann auch mehrere @code{\score}-Blöcke enthalten.
+Jeder davon wird als eigenständige Partitur interpretiert, die
+allerdings alle in dieselbe Ausgabedatei plaziert weden.
+Ein @code{\book}-Befehl ist nicht explizit notwendig -- er wird
+implizit erzeugt. Wenn jedoch für jeden @code{\score}-Block in einer
+einzigen @code{.ly}-Datei eine eigene Ausgabe-Datei erzeugt werden soll,
+dann muss jeder dieser Blöcke in einen eigenen @code{\book}-Block
+gesetzt werden: Jeder @code{\book}-Block erzeugt dann eine
+eigene Ausgabedatei.
+
+Zusammenfassung:
+
+Jeder @code{\book}-Block erzeugt eine eigene Ausgabedatei (z.B. eine
+PDF-Datei). Wenn Sie keinen derartigen Block explizit angegeben haben,
+setzt LilyPond den gesamten Dateiinhalt innerhalb eines einzigen
+impliziten @code{\book}-Blocks.
+
+Jeder @code{\score}-Block beschreibt ein eigenständiges Musikstück
+innerhalb des @code{\book}-Blocks.
+
+Jeder @code{\layout}-Block wirkt sich auf den @code{\score}- oder
+@code{\book}-Block aus, in dem er auftritt. So wirkt z.B. ein
+@code{\layout}-Block innerhalb eines @code{\score}-Blocks nur auf
+diesen einen Block und seinen gesamten Inhalt, ein @code{\layout}-Block
+außerhalb eines @code{\score}-Blocks (und daher innerhalb des implizit
+erzeugten oder explizit angegebenen @code{\book}-Blocks) jedoch auf
+alle @code{\score}-Blocks innerhalb dieses @code{\book}-Blocks.
+
+Nähere Details finden sich im Abschnitt @ruser{Multiple scores in a book}.
+
+
@cindex Variablen
@cindex Bezeichner
@end example
Wenn LilyPond diese Datei analysiert, nimmt es den Inhalt
-von @code{melodie} (alles, was nach dem Gleichheitszeichen
-kommt) und fügt ihn immer dann ein, wenn ein @code{\melodie}
+von @code{melodie} (alles nach dem Gleichheitszeichen) und
+fügt ihn immer dann ein, wenn ein @code{\melodie}
vorkommt. Die Namen sind frei wählbar, die Variable kann genauso
gut @code{melodie}, @code{GLOBAL},
@code{rechteHandklavier}, oder @code{foofoobarbaz} heißen. Für mehr
Information siehe
@ref{Saving typing with variables and functions}.
+Als Variablenname kann fast jeder beliebige Name benutzt werden,
+allerdings dürfen nur Buchstaben vorkommen (also keine Zahlen, Unterstriche,
+Sonderzeichen, etc.) und er darf nicht wie ein LilyPond-Befehl
+lauten. Die genauen Einschränkungen sind beschrieben in
+@ruser{File structure}.
-Eine komplette Definition des Eingabeformats findet sich
-im Kapitel @ruser{File structure}.
+@seealso
-@menu
-* Introduction to the LilyPond file structure::
-* Score is a (single) compound musical expression::
-* Nesting music expressions::
-* On the un-nestedness of brackets and ties::
-@end menu
+Eine vollständige Definition des Eingabeformats findet sich in
+@ruser{File structure}.
-@node Introduction to the LilyPond file structure
-@subsection Introduction to the LilyPond file structure
-@untranslated
@node Score is a (single) compound musical expression
@subsection Score is a (single) compound musical expression
-Im vorigen Kapitel, @ref{How LilyPond files work},
+@funindex \score
+@cindex score
+@cindex Partitur
+@cindex Musikstück
+@cindex zusammengesetzter Musikausdruck
+@cindex Musikausdruck, zusammengesetzter
+
+
+Im vorigen Kapitel, @ref{Introduction to the LilyPond file structure},
wurde die allgemeine Struktur einer LilyPond-Quelldatei
beschrieben. Aber anscheinend haben wir die wichtigste
Frage ausgelassen, nämlich wie man herausfindet, was nach
\score @{
@{ % diese Klammer startet den großen mus. Ausdruck
\new GrandStaff <<
- hier eine ganze Wagner-Oper einfügen
+ @var{...hier eine ganze Wagner-Oper einfügen...}
>>
@} % diese Klammer beendet den Ausdruck
\layout @{ @}
Zur Erinnerung: mit @code{<<} und @code{>>} werden Noten gleichzeitig
gesetzt; wir wollen ja auch Klavier- und Sängerstimme gleichzeitig
-haben.
-
-@example
-\score @{
- @{
- <<
- \new Staff = "Sänger" <<
- \new Voice = "vocal" @{ @}
- >>
- \new Lyrics \lyricsto vocal \new Lyrics @{ @}
- \new PianoStaff = "piano" <<
- \new Staff = "upper" @{ @}
- \new Staff = "lower" @{ @}
- >>
+und nicht hintereinander haben. Bei genauerem Hinsehen fällt auf, dass
+die @code{<< ... >>}-Konstruktion für die Notenzeile des Sängers eigentlich
+nicht unbedingt nötig wäre, da sie ja nur einen (sequenzielle) musikalischen
+Ausdruck enthält, nämlich alle Noten des Sängers hintereinander. Daher
+könnte an sich auch einfach ein @code{@{...@}} benutzt werden. Die
+Spitzklammern sind allerdings notwendig, sobald die Notenzeile mehrere
+parallelle Ausdrücke -- wie etwa zwei parallele Stimmen oder eine Stimme
+mit zugehörigem Text -- enthält.
+Wir werden die Musik später in das Beispiel einfügen, im Moment begnügen
+wir uns mit einigen Platzhalter-Noten und -Texten.
+
+@lilypond[verbatim,quote,ragged-right]
+\score {
+ <<
+ \new Staff = "Sänger" <<
+ \new Voice = "Singstimme" { c'1 }
+ \addlyrics { And }
>>
- @}
- \layout @{ @}
-@}
-@end example
+ \new PianoStaff = "Klavier" <<
+ \new Staff = "oben" { }
+ \new Staff = "unten" { }
+ >>
+ >>
+ \layout { }
+}
+@end lilypond
Jetzt haben wir viel mehr Details. Wir haben ein System (engl. staff)
für einen Sänger, in dem sich wieder eine Stimme (engl. voice)
@example
\relative c'' @{
- a4 b c d
+ r4 d8\noBeam g, c4 r
@}
@end example
(oder Variablen) zu verwenden.
-@example
-melodie = @{ @}
-text = @{ @}
-upper = @{ @}
-lower = @{ @}
-\score @{
- @{
- <<
- \new Staff = "Sänger" <<
- \new Voice = "vocal" @{ \melodie @}
- >>
- \new Lyrics \lyricsto vocal \new Lyrics @{ \text @}
- \new PianoStaff = "piano" <<
- \new Staff = "upper" @{ \upper @}
- \new Staff = "lower" @{ \lower @}
- >>
+@lilypond[verbatim,quote,ragged-right]
+melodie = \relative c'' { r4 d8\noBeam g, c4 r }
+text = \lyricmode { And God said, }
+oben = \relative c'' { <g d g,>2~ <g d g,> }
+unten = \relative c { b2 e2 }
+
+\score {
+ <<
+ \new Staff = "Sänger" <<
+ \new Voice = "Singstimme" { \melodie }
+ \addlyrics { \text }
>>
- @}
- \layout @{ @}
-@}
-@end example
+ \new PianoStaff = "Klavier" <<
+ \new Staff = "oben" { \oben }
+ \new Staff = "unten" {
+ \clef "bass"
+ \unten
+ }
+ >>
+ >>
+ \layout { }
+}
+@end lilypond
-@noindent
-Nochmal: der Bezeichner kann aller möglicher Text sein. Die
-Einschränkungen sind in
-@ruser{File structure} genau aufgelistet.
+Achten Sie auf den Unterschied zwischen Noten, die mit @code{\relative}
+oder direkt in einem musikalischen Ausruck eingegeben werden, und
+dem Text des Lieds, der innerhalb @code{\lyricmode} angegeben
+werden muss. Diese Unterscheidung ist für LilyPond essentiell,
+um zu entscheiden, ob der folgende Inhalt als Musik oder Text
+interpretiert werden soll. Wie könnte LilyPond sonst entscheiden,
+ob @code{@{a b c@}} die drei Noten a, b und c darstellen soll oder
+den Text eines Lieds über das Alphabet!
Beim Schreiben (oder Lesen) einer @code{\score}-Umgebung
sollte man langsam und sorgfältig vorgehen. Am besten fängt
der gleichen Ebene angehört, wirklich horizontal an der
gleichen Stelle beginnt.
+@seealso
+
+Benutzerhandbuch: @ruser{Structure of a score}.
+
@node Nesting music expressions
@subsection Nesting music expressions
-@untranslated
+@cindex Notenzeilen, temporäre
+@cindex Ossia
+
+Notenzeilen (die @q{Staff}-Kontexte) müssen nicht unbedingt gleib
+zu Beginn erzeugt werden -- sie können auch zu einem späteren
+Zeitpunkt eingeführt weden. Das ist vor allem nützlichm um
+@rglosnamed{ossia,Ossias} zu erzeugen. Hier folgt ein kures Beispiel,
+wie eine zusätzliche temporäre Notenzeile für nur drei Noten erzeugt
+werden kann:
+
+@lilypond[verbatim,quote,ragged-right]
+\new Staff {
+ \relative g' {
+ r4 g8 g c4 c8 d |
+ e4 r8
+ <<
+ { f c c }
+ \new Staff {
+ f8 f c
+ }
+ >>
+ r4 |
+ }
+}
+@end lilypond
+
+@noindent
+Wie man sieht ist die Größe des Notenschlüssels dieselbe wie sie
+auch bei einer Schlüsseländerung auftritt -- etwas kleiner als
+der Schlüssel am Beginn einer Notenzeile. Dies ist normal für
+Notenschlüssel, die innerhalb einer Notenzeile gesetzt werden.
+
+@cindex Notenzeile, Positionierung
+
+Der Ossia-Abschnitt kann auch oberhalb der Hauptnotenzeile
+gesetzt werden:
+
+@lilypond[verbatim,quote,ragged-right]
+\new Staff = "Hauptzeile" {
+ \relative g' {
+ r4 g8 g c4 c8 d |
+ e4 r8
+ <<
+ { f c c }
+ \new Staff \with {
+ alignAboveContext = "Hauptzeile" }
+ { f8 f c }
+ >>
+ r4 |
+ }
+}
+@end lilypond
+
+Dieses Beispiel benutzt den @code{\with}-Befehl, der später noch
+genauer erklärt wird. Damit kann das Standardverhalten einer
+einzelnen Notenzeile geändert werden: Hier wird einfach angegeben,
+dass die neue Notenzeile oberhalb der bereits existierenden Zeile
+mit Namen @qq{Hauptzeile} plaziert werden soll, anstatt
+standardmäßig unterhalb.
+
+@seealso
+
+Ossia werden oft ohne Notenschlüssel und Taktangabe gedruck, meist
+auch etwas kleiner als die anderen Notenzeilen. Dies ist natürlich
+auch in LilyPond möglich, benötigt aber Befehle, die bisher noch
+nicht vorgestellt wurden. Siehe @ref{Size of objects}
+und @ruser{Ossia staves}.
+
-@
@node On the un-nestedness of brackets and ties
@subsection On the un-nestedness of brackets and ties
-@untranslated
+@cindex Klammern, geschachtelt
+@cindex Schachtelung von Klammern
+
+Sie haben bisher zahlreiche verschiedene Arten von Klammern
+beim Schreiben von Musik mit LilyPond kennengelernt. Diese
+folgen verschiedenen Regeln, die zu Beginn vielleicht
+verwirrend wirken. Bevor die genauen Regeln vorgestellt werden,
+wollen wir die diversen Klammerarten kurz rekapitulieren:
+
+@c attempt to force this onto a new page
+@need 50
+@multitable @columnfractions .3 .7
+@headitem Klammerart
+ @tab Funktion
+@item @code{@{ .. @}}
+ @tab Umschließt ein sequenzielles Musiksegment
+@item @code{< .. >}
+ @tab Umschließt die Noten eines Akkords
+@item @code{<< .. >>}
+ @tab Umschließt parallele Musikausdrücke
+@item @code{( .. )}
+ @tab Markiert den Beginn und das Ende eines Haltebogens
+@item @code{\( .. \)}
+ @tab Markiert den Beginn und das Ende eines Phasierungsbogens
+@item @code{[ .. ]}
+ @tab Markiert den Beginn und das Ende eines manuell erzeugten Balkens
+@end multitable
+
+
+Zusätzlich sollten vielleicht noch einige weiter Konstruktionen
+erwähnt werden, die Noten auf irgendeine Art und Weise verbinden:
+Haltebögen (durch eine Tilde @code{~} markiert),
+Triolen (als @code{\times x/y @{..@}} geschrieben) und
+Vorschlagnoten (als @code{\grace@{..@}} notiert).
+
+Außerhalb von LilyPond fordert die übliche Benutzung von
+Klammern, dass die entsprechenden Arten korrekt verschachtelt
+werden, wie z.B. in @code{<< [ @{ ( .. ) @} ] >>}. Die
+schließenden Klammern kommen dabei in der umgekehrten Reihenfolge
+wie die öffnenden Klammern vor. Dies ist auch in LilyPond
+ein @strong{Muss} für die drei Klammerarten, die in obiger
+Tabelle mit dem Wort @q{Umschließt} beschrieben werden -- sie
+müssen korrekt geschachtelt werden.
+Die restlichen Klammerarten (durch @q{Markiert} beschrieben),
+die Haltebögen und die Triolen brauchen jedoch mit den
+anderen Klammerarten @strong{nicht} unbedingt korrekt
+geschachtelt werden. Tatsächlich sind sie auch keine Klammern
+in dem Sinn, dass sie etwas umschließen, sondern viel mehr
+Indikatoren, an welcher Stelle ein bestimmtes musikalisches
+Objekt beginnt oder endet.
+
+So kann also z.B. einen Phrasierungsbogen vor einem manuellen
+Balken beginn, jedoch schon vor dem Ende des Balkens enden.
+Dies mag zwar musikalisch wenig Sinn ergeben, ist aber in LilyPond
+auch möglich:
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+ { g8\( a b[ c b\) a] }
+@end lilypond
+
+Im Allgemeinen können die verschiedenen Klammerarten, Haltebögen,
+Triolen und Vorschlagnoten beliebig kombiniert werden.
+Das folgende Beispiel zeigt einen Balken, der in eine Triole reicht
+(Zeile 1), eine Bindebogen, der ebenfalls in eine Triole
+reicht (Zeile 2), einen Balken und einen Bindeboden in eine Triole,
+ein Haltebogen, der über zwei Triolen läuft, sowie einen
+Phrasierungsbogen, der in einer Triole beginnt (Zeilen 3 und 4).
+
+@lilypond[quote,verbatim,fragment,ragged-right]
+{
+ r16[ g16 \times 2/3 {r16 e'8] }
+ g16( a \times 2/3 {b d) e' }
+ g8[( a \times 2/3 {b d') e'~]}
+ \times 4/5 {e'32\( a b d' e'} a'4.\)
+}
+@end lilypond
+
@node Voices contain music
@section Voices contain music
@node Explicitly instantiating voices
@subsection Explicitly instantiating voices
+@c TODO: Move from simultaneous.itely
@untranslated
@node Voices and vocals
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 6bcad9cdc487270910758b1ee39cf3c8aee1015e
+ Translation of GIT committish: e831b9b97caae23725709d2fe11a6436240ed580
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
+@ifclear INSTALL
@node Install
@chapter Install
+@end ifclear
+Es gibt von Lilypond zwei verschiedene Typen von Versionen: stabile
+Versionen und instabile Entwicklerversionen. Stabile Versionen haben
+eine gerade Unter-Versionsnummer (z.B. 2.8, 2.10, 2.12, etc.).
+Entwicklerversionen haben hingegen ungerade Unter-Versionsnummern (z.B.
+2.7, 2.9, 2.11, etc.).
+
+LilyPond selbst zu kompilieren ist ein relativ komplizierter Vorgang, daher
+empfehlen wir @strong{stark}, die vorkompilierten Binär-Pakete zu benutzen.
@untranslated
@node Precompiled binaries
@section Precompiled binaries
-@untranslated
+@unnumberedsubsec Downloading
+
+
+Aktuelle Informationen zu vorkompilierten Binär-Paketen für Ihre Plattform
+finden Sie unter @uref{http://lilypond.org/web/install/}. Falls Ihr Betriebssystem
+auf dieser allgemeinen Seite nicht behandelt wird, sehen Sie bitte in
+der vollständigen Liste unter @uref{http://download.linuxaudio.org/lilypond/binaries/}
+nach.
+
+Momentan werden Binärpakete für folgende Plattformen erstellt:
+
+@example
+darwin-ppc - MacOS X powerpc
+darwin-x86 - MacOS X intel
+freebsd-64 - FreeBSD 6.x, x86_64
+freebsd-x86 - FreeBSD 4.x, x86
+linux-64 - Beliebige GNU/Linux Distribution, x86_64
+linux-arm - Beliebige GNU/Linux Distribution, arm
+linux-ppc - Beliebige GNU/Linux Distribution, powerpc
+linux-x86 - Beliebige GNU/Linux Distribution, x86
+mingw - Windows x86
+@end example
+
+@c TRANSLATORS:
+@c Please **do not** translate anything below this line. Users
+@c should not be compiling LilyPond themselves; if they really
+@c want to do so, they should be able to read the English docs,
+@c because they'll probably need to ask questions in English
+@c on the -devel list. -gp
-@subsection Downloading
@node Compiling from source
@section Compiling from source
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 8d678d320b2bef3d0ebfc737134d45bcec5e8a56
+ Translation of GIT committish: e831b9b97caae23725709d2fe11a6436240ed580
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
@c \version "2.11.51"
+@c Translators: Till Rettig, Reinhold Kainhofer
@node Introduction
@chapter Introduction
+Dieses Kapitel stellt dem Leser die Idee hinter LilyPond und die Dokumentation
+von LilyPond vor.
+
+@menu
+* Background::
+* About the documentation::
+@end menu
+
+
+@node Background
+@section Background
+
+Dieser Abschnitt behandelt die allgemeinen Ziele und die Architektur von LilyPond.
@menu
* Engraving::
* What symbols to engrave?::
* Music representation::
* Example applications::
-* About the documentation::
@end menu
@node Engraving
-@section Engraving
+@unnumberedsubsec Engraving
Die Kunst des Notensatzes wird auch als Notenstich bezeichnet. Dieser
Begriff stammt aus dem traditionellen Notendruck. Noch bis vor etwa 20
@node Automated engraving
-@section Automated engraving
+@unnumberedsubsec Automated engraving
Wie sollen wir also jetzt die Typographie anwenden?
Wie können wir erwarten, dass wir in der Lage wären,
@node What symbols to engrave?
-@section What symbols to engrave?
+@unnumberedsubsec What symbols to engrave?
@cindex Notensatz
@cindex Typographie
@end lilypond
@node Music representation
-@section Music representation
+@unnumberedsubsec Music representation
Idealerweise ist das Eingabeformat für ein höheres Satzsystem die
abstrakte Beschreibung des Inhaltes. In diesem Fall wäre das die
@end lilypond
@noindent
-Gleichzeitig erklingende Noten werden hinzugefügt, indem man alle in << und >> einschließt.
+Gleichzeitig erklingende Noten werden hinzugefügt, indem man alle in @code{<<} und @code{>>} einschließt.
@c < > is not a music expression,
@c so we use <<>> iso. <> to drive home the point of
Analysieren und Darstellen nimmt nur etwa 10% des Codes ein:
@node Example applications
-@section Example applications
+@unnumberedsubsec Example applications
Wir haben LilyPond als einen Versuch geschrieben, wie man die Kunst des
Musiksatzes in ein Computerprogramm gießen kann. Dieses
@node About the documentation
@section About the documentation
-Es gibt zwei Handbücher zu LilyPond: das @emph{Benutzerhandbuch} (dieses
-Dokument) und das @emph{Handbuch über die Programmbenutzung}.
+Die Dokumentation zu LilyPond ist unterteilt in mehrere Handbücher.
+
+@c leave these lines wrapping around. It's some texinfo 4.12 thing. -gp
+@c This is actually a limitation of texi2html. -jm
+@menu
+* About the Learning Manual:: Dieses Handbuch stellt LilyPond vor und vermittelt die Grundkenntnisse um damit arbeiten zu können.
+* About the Music Glossary:: Dieses Handbuch erklärt zahlreiche musikalische Fachausdrücke inklusive Übersetzungen in verschiedene Sprachen.
+* About the Notation Reference:: Dieses Handbuch stellt den Hauptteil der Dokumentation dar. Es liefert detaillierte Informationen zur Notation mit LilyPond. Als Voraussetzung werden die Kenntnisse des @q{Handbuchs zum Lernen} angenommen.
+* About the Application Usage:: Dieses Handbuch diskutiert den konkreten Aufruf des @q{lilypond} Programms, sowie Betriebssystem-spezifische Aspekte.
+* About the Snippet List:: Dies ist eine Sammlung von kurzen LilyPond Beispielen.
+* About the Internals Reference:: Dieses Dokument liefert Referenzwissen über LilyPonds interne Strukturen und ist vor allem bei der Erstellung von tiefergehenden Optimierungen und Anpassungen hilfreich.
+* Other documentation:: Es existieren noch etliche weitere Teile der Dokumentation, wie etwa die @q{Neueigkeiten} Seite oder das Archiv der Mailingliste.
+@end menu
+
+@node About the Learning Manual
+@unnumberedsubsec About the Learning Manual
-@subheading User manual
+Dieses Handbuch erklärt die Grundbegriffe von LilyPond und stellt
+die fundamentalen Konzepte hinter dem Programm vor. Diese Kapitel sollten
+in linearer Reihenfolge gelesen werden.
-Das Handbuch ist in drei Bücher geteilt.
+Am Ende jedes Abschnitts findet sich ein Absatz @strong{Siehe auch}, der
+Kreuzreferenzen zu anderen Abschnitten enthält. Beim ersten Durchlesen
+empfiehlt es sich nicht, diesen gleich zu folgen, da meist noch
+zahlreiche Grundbegriffe zum Verständnis fehlen. Wenn Sie sich durch
+das Handbuch zum Lernen geackert haben, wollen Sie vielleicht einzelne
+Abschnitte nochmal durchgehen und dann den Kreuzverweisen zur Vertiefung
+der Zusammenhänge folgen.
-@subsubheading Learning manual
+@itemize
-In diesem Buch wird erklärt, wie man das Programm LilyPond erlernt; mit
-einfachen Begriffen werden einige Schlüsselkonzepte erklärt. Die Kapitel
-sollten hintereinander gelesen werden.
+@item
+@ref{Introduction}: erklärt den Hintergrund und das Ziel von LilyPond.
-@c we need to completely rewrite this once GDP is finished. -gp
-@ignore
-@itemize @bullet
+@item
+@ref{Tutorial}: liefert eine einfache Einführung in das Setzen von Musik
+mit LilyPond. Neulinge sollten mit diesem Kapitel beginnen.
@item
-@ifhtml
-Die
-@end ifhtml
-@emph{@ref{Tutorial}},
-stellt eine einfache Einführung in den Musiksatz dar. Neulinge sollten hiermit
-beginnen.
+@ref{Fundamental concepts}: erklärt etliche allgemeine Konzepte
+hinter dem Dateiformat von LilyPond. Wenn Sie sich nicht sicher
+sind, an welcher Stelle Sie einen Befehl in die Datei einfügen sollen,
+ist dieses Kapitel genau das richtige!
+
+@item
+@ref{Tweaking output}: stellt dar, wie die Standardeinstellungen von
+LilyPond verändert werden können.
@item
-@emph{@ref{Fundamental concepts}},
-erklärt generelle Konzepte des LilyPond-Dateiformates. Wenn Sie sich nicht
-sicher sind, wohin ein Befehl gesetzt werden soll, lesen Sie hier nach.
+@ref{Working on LilyPond projects}: liefert Tipps im praktischen Umgang mit
+Lilypond und gibt Hinweise, wie gängige Fehler vermieden werden können.
+Bevor Sie mit einem großen Projekt beginnen, sollten Sie dieses Kapitel
+unbedingt gelesen haben!
+
+@end itemize
+
+Das Handbuch zum Lernen enthält auch zahlreiche Anhänge, die nicht
+zum linearen Durchlesen geeignet sind. Sie sind allerdings zur späteren
+Referenz sehr gut geeignet:
+
+@itemize
@item
-@emph{@ref{Working on LilyPond projects}},
-zeigt den wirklichen Einsatz von LilyPond und gibt Hinweise, wie einige
-Probleme vermieden werden können.
+@ref{Templates}: zeigt einige fertige Dokumentvorlagen für diverse
+Stücke mit unterschiedlichen Charakteristika. Kopieren Sie einfach
+die Vorlagen in Ihre eigene Datei, fügen Sie die Noten hinzu und Sie
+sind fertig!
@item
-@emph{@ref{Tweaking output}},
-stellt dar, wie die Standardeinstellungen von LilyPond verändert werden können.
-
+@ref{Scheme tutorial}: liefert eine kurze Einführung in Scheme, die
+Programmiersprache, die die Musikfunktionen in LilyPond intern benutzen.
+Dies stellt tiefgehendes Wissen dar, wenn Sie LilyPond bis ins kleinste Detail
+konfigurieren möchten. Die meisten Benutzer brauchen dies jedoch selten bis
+gar nicht.
+
@end itemize
-@subsubheading Notation reference
+@node About the Music Glossary
+@unnumberedsubsec About the Music Glossary
+
+@cindex Idiom
+@cindex Jargon
+@cindex Terminologie
+@cindex Übersetzungen
+@cindex Sprachen
+@cindex Glossar
+@cindex Thesaurus
+@cindex Fremdsprache
+
+@rglosnamed{Top,Das Musikglossar} erklärt musikalische Fachausdrücke und
+enthält auch deren Übersetzungen in diverse Sprachen. Wenn Sie mit
+Musiknotation oder der (englisch-sprachigen) Musikterminologie nicht vertraut
+sind (vor allem, wenn Englisch nicht Ihre Muttersprache ist), ist es
+sehr empfehlenswert, das Musikglossar immer wieder zu Rate zu ziehen.
+
+
+@node About the Notation Reference
+@unnumberedsubsec About the Notation Reference
In diesem Buch werden alle LilyPond-Befehle erklärt, die Notationszeichen
produzieren. Es geht von der Annahme aus, dass der Leser sich mit den
-Grundkonzeption des Programmes im Handbuch zum Lernen bekannt gemacht hat.
+Grundkonzepten des Programmes im Handbuch zum Lernen bekannt gemacht hat.
@itemize @bullet
@item
-@emph{@ruser{Musical notation}},
+@emph{@ruser{Musical notation}}:
erklärt alles über die grundlegenden Notationskonstruktionen. Dieses Kapitel
ist für fast jedes Notationsprojekt nützlich.
@item
-@emph{@ruser{Specialist notation}},
+@emph{@ruser{Specialist notation}}:
erklärt spezifische Schwierigkeiten, die sich bei bestimmten Notationstypen
ergeben. Dieses Kapitel ist nur in entsprechenden Fällen bestimmter Instrumente
oder bei Gesang zu konsultieren.
@item
-@emph{@ruser{Changing defaults}},
-erklärt, wie des Layout getrimmt werden kann.
+@emph{@ruser{General input and output}}:
+erläutert allgemeine Informationen über die Eingabedateien von Lilypond und
+wie die Ausgabe gesteuert werden kann.
@item
-@emph{@ruser{Non-musical notation}},
-zeigt alles, was nicht direkt mit den Noten zu tun hat wie Titel, mehrere Sätze oder
-wie man ein MIDI-Instrument auswählt.
-
-@item
-@emph{@ruser{Spacing issues}},
+@emph{@ruser{Spacing issues}}:
befasst sich mit globalen Fragen wie der Definition von Papierformaten
oder wie man Seitenumbrüche definiert.
@item
-@emph{@ruser{Interfaces for programmers}},
+@emph{@ruser{Changing defaults}}:
+erklärt, wie des Layout getrimmt werden kann um genau zum gewünschten Ergebnis
+zu kommen.
+
+@item
+@emph{@ruser{Interfaces for programmers}}:
demonstriert die Erstellung von musikalischen Funktionen.
@end itemize
+Ds Benutzerhandbuch enthält auch Anhänge mit nützlichen Referenztabellen.
-@subsubheading Appendices
-
-In diesem Buch werden nützliche Referenztabellen gezeigt.
+@itemize
-@itemize @bullet
@item
-@ifhtml
-Die
-@end ifhtml
-@emph{@ruser{Literature list}},
+Die @ruser{Literature list}
enthält einige wichtige Quellen für alle, die mehr über Notation und
den Notensatz erfahren wollen.
@item
-Die
-@emph{@ref{Scheme tutorial}},
-stellt eine kurze Einleitung in die Scheme-Sprache dar, mit dem
-die musikalischen Funktionen gebildet werden.
-
-@item
-@emph{@ruser{Notation manual tables}},
+@ruser{Notation manual tables}
sind Tabellen, in denen Akkordbezeichnungen, MIDI-Instrumente,
Farbbezeichnungen und die Zeichen der Feta-Schriftart gesammelt sind.
-@item
-@emph{@ref{Templates}},
-von LilyPond-Stücken. Kopieren Sie einfach hier, fügen Sie in ihre Datei
-ein und schreiben Sie noch die Noten dazu. Das ist alles!
-
@item
Die
-@emph{@ruser{Cheat sheet}},
+@emph{@ruser{Cheat sheet}}
zeigt die wichtigsten LilyPond-Befehle.
@item
Der
-@emph{@ruser{LilyPond command index}},
+@emph{@ruser{LilyPond command index}}
listet alle Befehle auf, die mit @code{\} anfangen.
@item
Der
-@emph{@ref{LilyPond index}},
+@emph{@ref{LilyPond index}}
ist ein vollständiger Index.
@end itemize
-@end ignore
-@subheading Program usage
+
+@node About the Application Usage
+@unnumberedsubsec About the Application Usage
In diesem Buch wird erklärt, wie das Programm ausgeführt wird und
wie die Notation von LilyPond in andere Programme integriert werden
@itemize @bullet
@item
-@emph{@rprogram{Install}},
+@emph{@rprogram{Install}}:
erklärt wie LilyPond installiert wird (inklusive Kompilation, wenn es
nötig sein sollte).
@item
-@emph{@rprogram{Setup}},
+@emph{@rprogram{Setup}}:
erklärt wie der Computer eingerichtet wird, damit LilyPond optimal genutzt
werden kann. Hierzu gehören etwa spezielle Umgebungen für bestimmte
Texteditoren.
@item
-@emph{@rprogram{Running LilyPond}},
+@emph{@rprogram{Running LilyPond}}:
zeigt, wie LilyPond und seine Hilfsprogramme gestartet werden. Zusätzlich
wird hier erklärt, wie Quelldateien von alten LilyPond-Versionen aktualisiert
werden können.
@item
-@emph{@rprogram{LilyPond-book}},
+@emph{@rprogram{LilyPond-book}}:
erklärt die Details, um einen Text mit eingefügten Notenbeispielen (wie
etwa dieses Handbuch) zu
erstellen.
@item
-@emph{@rprogram{Converting from other formats}},
+@emph{@rprogram{Converting from other formats}}:
erklärt, wie die Konvertierungsprogramme aufgerufen werden. Diese
Programme kommen mit LilyPond zusammen und konvertieren eine Vielzahl
von Notensatzformaten in das @code{.ly}-Format.
@end itemize
-@subsubheading Other information
-
-Es gibt einige andere Orte, die sehr wertvolle Information enthalten.
-@itemize @bullet
-@cindex Dialekt
-@cindex Jargon
-@cindex Terminologie
-@cindex Fremdsprache
-@cindex Sprache
-@cindex Englische Begriffe
+@node About the Snippet List
+@unnumberedsubsec About the Snippet List
-@item
-@ifnottex
-Das @ref{Top,Musik-Glossar,,music-glossary}, erklärt musikalische Ausdrücke
-und stellt Übersetzungen für einige Sprachen bereit. Es ist auch als PDF
-erhältlich.
-@end ifnottex
-@iftex
-Das Musik-Glossar erklärt musikalische Ausdrücke
-und stellt Übersetzungen für einige Sprachen bereit. Es ist auch als PDF
-erhältlich.
-@end iftex
-Wenn Sie sich mit der Notation von Musik nicht auskennen (und besonders,
-wenn Englisch nicht Ihre Muttersprache ist), wird dieses Glossar von
-großer Hilfe sein.
-
@cindex Schnipsel
@cindex LSR
-@item
-Die @rlsrnamed{Top,Schnipsel} sind eine ausführliche Sammlung kurzer Beispiele, anhand derer Tricks,
-Tipps und Spezialfunktionen von LilyPond demonstriert werden. Die meisten
-dieser Schnipsel können auch im
- @uref{http://lsr.dsi.unimi.it/,LilyPond Schnipsel
-Depot} betrachtet werden. Diese Internetseite verfügt auch über ein
+
+Die @rlsrnamed{Top,Schnipsel} sind eine ausführliche Sammlung kurzer
+Beispiele, anhand derer Tricks, Tipps und Spezialfunktionen von LilyPond
+demonstriert werden. Die meisten dieser Schnipsel können auch im
+ @uref{http://lsr.dsi.unimi.it/,LilyPond Schnipsel Depot} betrachtet
+werden. Diese Internetseite verfügt auch über ein
durchsuchbares LilyPond-Handbuch.
+Die Liste der Schnipsel zu einem Abschnitt des Benutzerhandbuchs ist auch
+dort jeweils im Abschnitt @strong{Siehe auch} verlinkt.
-@item
-Die
-@iftex
-Programmreferenz
-@end iftex
-@ifnottex
-@ref{Top,Programmreferenz,,lilypond-internals}
-@end ifnottex
-ist eine Sammlung intensiv verlinkter HTML-Seiten,
-die alle Details jeder einzelnen LilyPond-Klasse, jedes Objektes und
-jeder Funktion erklären. Sie wird direkt aus den Satzdefinitionen
-produziert.
+
+@node About the Internals Reference
+@unnumberedsubsec About the Internals Reference
+
+Die @rinternalsnamed{Top,Programmreferenz} ist eine Sammlung intensiv
+verlinkter HTML-Seiten, die alle Details jeder einzelnen
+LilyPond-Klasse, jedes Objektes und jeder Funktion erklären. Sie wird
+direkt aus den Satzdefinitionen im Quellcode produziert.
So gut wie alle Formatierungsmöglichkeiten, die intern verwendet werden,
sind auch direkt für den Benutzer zugänglich. Alle Variablen z. B., die
alle haben einen @qq{Siehe}-Abschnitt, der auf die Dokumentation verweist.
Im HTML-Handbuch haben diese Abschnitte klickbare Links.
-Die Programmreferenz ist nur auf englisch erhältlich.
+Die Programmreferenz ist nur auf englisch verfügbar.
-@end itemize
+@node Other documentation
+@unnumberedsubsec Other documentation
-Wenn Sie schon ein erfahrener Benutzer sind, können Sie dieses Handbuch
-als Referenz benutzen: Es enthält einen ausführlichen Index@footnote{Wenn
-Sie nach etwas suchen und es nicht im Handbuch finden, so gilt das als Fehler.
-Bitte schicken Sie in diesem Fall einen Fehlerbericht.}, aber das Dokument
-ist auch als
-@iftex
-große HTML-Seite erhältlich,
-@end iftex
+Es gibt noch eine Reihe weiterer wertvoller Informationsquellen zu LilyPond:
+
+
+@itemize
+
+@item
@ifhtml
-@uref{source/Documentation/user/lilypond-big-page.html, eine große Seite
-erhältlich},
+@ifset bigpage
+@uref{../topdocs/NEWS.html,Neuigkeiten}:
+@end ifset
+@ifclear bigpage
+@uref{../../topdocs/NEWS.html,Neuigkeiten}:
+@end ifclear
@end ifhtml
-die auf einfache Art mit der Suchfunktion Ihres Browsers durchsucht werden kann.
-
-Auf allen HTML-Seiten, die Noten eingebettet haben, deren Ausgabe mit LilyPond
-vorgenommen wurde, kann die originale Quelldatei durch einen Klick auf das
+@ifnothtml
+Neuigkeiten:
+@end ifnothtml
+eine Zusammenfassung der Änderungen in LilyPond seit der letzten Version.
+
+@item @uref{http://lists.gnu.org/archive/html/lilypond-user/,Das Archiv
+der lilypond-user Mailing-Liste}: enthält alle bisher an die Liste
+gesendeten Mails. Viele Fragen werden immer wieder gestellt und auch
+beantwortet. Die Chance, dass Ihre Frage auch schon mal aufgetaucht ist,
+ist also relativ groß. In diesem Fall finden Sie die Antwort in diesem
+Archiv.
+
+@item @uref{http://lists.gnu.org/archive/html/lilypond-devel/,Das Archiv
+der lilypond-devel Mailing-Liste}: enthält alle bisher an die
+Entwicklerliste gesendeten Mails. Diese Diskussionen sind dementsprechend
+technisch gehalten. Wenn Sie eine tiefergehende Frage zu den Interna von
+LilyPond haben, finden Sie die Antwort vielleicht in diesem Archiv.
+
+@item Eingebettete Musikbeispiele: Auf allen HTML-Seiten mit Notenbeispielen,
+die von LilyPond erzeugt wurden, kann die originale Quelldatei durch einen Klick auf das
Bild betrachtet werden.
+@item Initialisierungsdateien von LilyPond:
+
Der Speicherort der Dokumentationsdateien unterscheidet sich evtl. je
nach Betriebssystem. Manchmal wird hier auf Initialisierungs- oder
Beispieldateien verwiesen. Das Handbuch nimmt dabei an, dass diese
@file{lilypond@/2.x.y/@/input/@/lsr/@/Verzeichnis/@/bla@/.ly} verweisen. In den
Binärpaketen für Unix-Plattformen sind Dokumentation und Beispiele
üblicherweise in einem Verzeichnis wie @file{/usr/@/share/@/doc/@/lilypond/}
-gespeichert. Initialisierungsdateien, etwa @file{scm/@/lily@/.scm},
+gespeichert. Initialisierungsdateien, etwa @file{scm/@/lily@/.scm}
oder @file{ly/@/engraver@/-init@/.ly}, befinden sich normalerweise im
Verzeichnis @file{/usr/@/share/@/lilypond/}.
-@cindex Anpassen der Ausgabe
-@cindex Variablen
-@cindex Eigenschaften
-@cindex properties
-@cindex lilypond-internals
-@cindex interne Dokumentation
-@cindex Scheme
-@cindex Erweiterung von LilyPond
-@cindex Index
-
-Dieses Handbuch (so wie alle anderen) ist als PDF- oder HTML-Datei von
-LilyPonds Internetseite @uref{http://@/www@/.lilypond@/.org/} herunterladbar.
+Weiterführende Informationen finden Sie unter @ref{Other sources of information}.
+
+@end itemize
+
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 6bcad9cdc487270910758b1ee39cf3c8aee1015e
+ Translation of GIT committish: b54fc6953a8d70a3c51e8c3d0cbf9b3fe9652d78
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
+@c Translators: Reinhold Kainhofer
@node LilyPond-book
@chapter @command{lilypond-book}: Integrating text and music
-@untranslated
+
+Wenn Sie in ein Dokument Bilder von Musiknoten einfügen möchten, so können
+Sie genauso machen, wie Sie andere Bilder einfügen würden: Die Bilder
+werden getrennt vom Dokument im PostScript oder PNG Format erstellt
+und können dann in @LaTeX{} oder HTML inkludiert werden.
+
+@command{lilypond-book} automatisiert diesen Prozess: Dieses
+Programm extrahiert Musik-Schnipsel aus Ihrem Dokument,
+ruft @command{lilypond} auf und fügt die resultierenden Bilder
+in Ihr Dokument ein. Die Länge der Zeilen und die Schriftgroße
+werden dabei Ihrem Dokument angepasst.
+
+@command{lilypond-book} ist ein eigenständiges Programm und wird
+üblicherweise von der Kommandozeile aufgerufen. Nähere Informationen
+hierzu finden sich in @ref{Command-line usage}.
+
+Dieses Vorgehen kann bei @LaTeX{}, HTML, Texinfo oder DocBook Dokumenten
+angewendet werden.
+
+@cindex texinfo
+@cindex latex
+@cindex texinfo
+@cindex texi
+@cindex html
+@cindex docbook
+@cindex Dokument, Musik einfügen in
+@cindex HTML, Musik in
+@cindex Texinfo, Musik in
+@cindex DocBook, Musik in
+@cindex @LaTeX{}, Musik in
@menu
@node An example of a musicological document
@section An example of a musicological document
-@untranslated
+@cindex Musikwissenschaft
+
+Zahlreiche Texte enthalten Musikbeispiele: musikwissenschaftliche
+Abhandlungen, Liederbücher oder Handbücher wie dieses. Solche
+Texte können händisch erzeugt werden, indem einfach die Musikbeispiele
+als Grafik (PostScript, PNG, GIF, etc.) im Textverarbeitungsprogramm
+eingefügt werden. Für HTML, @LaTeX{}, Texinfo und DocBook Dokumente
+existiert jedoch ein Weg, dies automatisiert durchzuführen.
+
+Das Programm @code{lilypond-book} extrahiert die Musikfragmente aus
+dem Dokument, formatiert sie automatisiert in eine Grafik und fügt die
+resultierenden Notenbeispiele dann wieder in das Dokument ein. Dies soll
+hier an einem einfachen @LaTeX{}-Beispiel verdeutlicht werden. Das Beispiel
+selbst enthält schon Erklärungen, sodass wir es hier nicht weiter diskutieren
+müssen.
@subheading Input
+
+@quotation
+@verbatim
+\documentclass[a4paper]{article}
+
+\begin{document}
+
+Dokumente für \verb+lilypond-book+ können Musik und Text nach Belieben
+kombinieren. Zum Beispiel:
+
+\begin{lilypond}
+\relative c' {
+ c2 g'2 \times 2/3 { f8 e d } c'2 g4
+}
+\end{lilypond}
+
+Optionen für \verb+lilypond+ werden dabei in eckige Klammern gesetzt.
+
+\begin[fragment,quote,staffsize=26,verbatim]{lilypond}
+ c'4 f16
+\end{lilypond}
+
+Größere Beispiele können auch in einer eigenständigen Datei gespeichert
+und dann mit \verb+\lilypondfile+ eingebunden werden.
+
+\lilypondfile[quote,noindent]{screech-boink.ly}
+
+(Falls nötig kann screech-boink.ly durch eine beliebige andere .ly
+Datei im selben Verzeichnis wie diese Datei ersetzt werden.)
+
+\end{document}
+@end verbatim
+@end quotation
+
@subheading Processing
+
+Speichern Sie den obigen @LaTeX{} Quellcode in eine Datei @file{lilybook.lytex}
+und führen Sie dann in der Kommandozeile folgende Befehle aus:
+
+@c keep space after @version{} so TeX doesn't choke
+@example
+lilypond-book --output=out --pdf lilybook.lytex
+@emph{lilypond-book (GNU LilyPond) @version{} }
+@emph{Reading lilybook.lytex...}
+@emph{..(viele Ausgabezeilen entfernt)..}
+@emph{Compiling lilybook.tex...}
+cd out
+pdflatex lilybook
+@emph{..(viele Ausgabezeilen entfernt)..}
+xpdf lilybook
+@emph{(Ersetzen Sie @command{xpdf} durch Ihren PDF-Betrachter)}
+@end example
+
+Die Ausführung von @command{lilypond-book} und @command{latex} erzeugt
+zahlreiche temporäre Dateien, die das Arbeitsverzeichnis unnötig
+vollstopfen würden. Daher empfiehlt sich die Benutzung der @code{--output=@var{dir}}
+Option, wodurch die Dateien im Unterverzeichnis @file{dir} erzeugt werden.
+
+Das Endresultat des obigen @LaTeX{} Beispiels ist im nächsten Abschnitt
+zu sehen.@footnote{Da dieses Handbuch mit Texinfo erzeugt wurde,
+kann sich das Aussehen des Beispiels leicht von dem mit @LaTeX{}
+erzeugten unterscheiden.}
+
+@page
+
@subheading Output
+
+Dokumente für @command{lilypond-book} können Musik und Text nach Belieben
+kombinieren. Zum Beispiel:
+
+@lilypond
+\relative c' {
+ c2 g'2 \times 2/3 { f8 e d } c'2 g4
+}
+@end lilypond
+
+Optionen für @command{lilypond} werden dabei in eckige Klammern gesetzt.
+
+@lilypond[fragment,quote,staffsize=26,verbatim]
+c'4 f16
+@end lilypond
+
+Größere Beispiele können auch in einer eigenständigen Datei gespeichert
+und dann mit @code{\lilypondfile} eingebunden werden.
+
+@lilypondfile[quote,noindent]{screech-boink.ly}
+
+
+@page
+
+
+
@node Integrating music and text
@section Integrating music and text
-@untranslated
+In diesem Abschnitt soll die Integration von LilyPond mit den
+verschiedenen Dateiformaten detailliert erläutert werden.
@menu
@node LaTeX
@subsection @LaTeX{}
-@untranslated
+
+@LaTeX{} ist der de-facto Standard zur Publikation von wissenschaftlichen Texten
+in Naturwissenschaft und Technik. Es basiert auf dem Schriftsetzer @TeX{},
+der die bestmögliche Typographie erzeugt.
+
+Siehe die @uref{http://@/www@/.ctan@/.org/@/tex@/-archive/@/info/@/lshort/@/german/,
+@emph{@LaTeX{}2e-Kurzbeschreibung}} für eine Einführung in die
+Benutzung von @LaTeX{}.
+
+Musikbeispiele können eingegeben werden als
+
+@example
+\begin[Optionen,kommen,]@{lilypond@}
+ IHR LILYPOND QUELLCODE
+\end@{lilypond@}
+@end example
+
+@noindent
+oder
+
+@example
+\lilypondfile[Optionen,kommen,hier]@{@var{Dateiname}@}
+@end example
+
+@noindent
+oder
+
+@example
+\lilypond@{ IHR LILYPOND QUELLCODE @}
+@end example
+
+Der Aufruf von @command{lilypond-book} liefert eine Datei, die dann mit
+@LaTeX{} weiter verarbeitet werden kann.
+
+Dies soll hier an einigen Beispielen gezeigt werden. Die @code{lilypond} Umgebung
+
+@example
+\begin[quote,fragment,staffsize=26]@{lilypond@}
+ c' d' e' f' g'2 g'2
+\end@{lilypond@}
+@end example
+
+@noindent
+erzeugt
+
+@lilypond[quote,fragment,staffsize=26]
+c' d' e' f' g'2 g'2
+@end lilypond
+
+Die Kurzversion
+
+@example
+\lilypond[quote,fragment,staffsize=11]@{<c' e' g'>@}
+@end example
+
+@noindent
+erzeugt
+
+@lilypond[quote,fragment,staffsize=11]{<c' e' g'>}
+
+@noindent
+Innerhalb des @code{\lilypond@{@}} Befehls dürfen keine geschwungenen
+Klammern @code{@{} oder @code{@}} vorkommen, weshalb dieser Befehl
+nur mit der @code{fragment} Option Sinn macht.
+
+Die Standardzeilenlänge wird bestimmt, indem die Angaben in der Dokumentpräambel,
+also dem Teil der @LaTeX{} Datei vor dem @code{\begin@{document@}},
+analysiert werden. Der @command{lilypond-book} Befehl sendet diese
+Angaben an @LaTeX{}, um herauszufinden, wie breit der Text tatsächlich
+ist. Die Breite der Notenzeilen wird dann an diese Textbreite angepasst.
+Ein derartig heuristischer Algorithmus kann natürlich auch versagen,
+wobei man in diesem Fall die Breite auch explizit durch die
+@code{line-width} Option des @code{\lilypond@{@}} oder @code{\begin@{lilypond@}}
+Befehls angeben kann.
+
+@cindex titling and lilypond-book
+@cindex \header in @LaTeX{} documents
+
+Jedes Musikbeispiele ruft die folgenden Makros auf, wenn sie vom Benutzer
+definiert wurden:
+
+@itemize bullet
+@item @code{\preLilyPondExample} -- wird vor der Musik aufgerufen,
+
+@item @code{\postLilyPondExample} -- wird nach der Musik aufgerufen,
+
+@item @code{\betweenLilyPondSystem[1]} -- wird zwischen den einzelnen
+Systemen aufgerufen, wenn @code{lilypond-book} das Beispiel in verschiedene
+PostScript Dateien getrennt hat. Dieser @LaTeX{}-Befehl muss so definiert
+werden, dass er genau ein Argument erhält, nämlich die Zahl der bereits
+in @LaTeX{} eingefügten Dateien dieses Beispiels. Als Standard wird einfach
+ein @code{\linebreak} eingefügt.
+@end itemize
+
+@ignore
+Broken stuff. :(
+
+@cindex Latex, Feta Schriftart
+@cindex fetachar
+
+Um Zeichen wie Auflösungszeichen, Kreuze, Fermaten etc. aus der Feta-Schriftart
+von LilyPond in @LaTeX{} einzufügen, muss @code{\input@{titledefs@}} benutzt werden,
+wodurch dann der Befehl @code{\fetachar} zur Verfügung steht.
+
+@example
+\documentclass[a4paper]@{article@}
+
+\input@{titledefs@}
+
+\begin@{document@}
+
+\fetachar\fetasharp
+
+\end@{document@}
+@end example
+
+Die Namen der Symbole sind in der Datei @file{feta20.tex} definiert. Sie finden
+den Pfad zu dieser Datei mit dem Befehl
+
+@example
+kpsewhich feta20.tex
+@end example
+
+@end ignore
+
+@snippets
+
+Manchmal ist es nötig, Musikelemente wie Halte- oder Bindebögen so darzustellen,
+als ob sie am Ende des Musikausschnitten noch weitergehen würden. Eine solche
+Ausgabe kann erreicht werden, indem ein Zeilenumbruch in die Notenzeile
+eingefügt wird und die Ausgabe der folgenden Notenzeile unterdrückt wird.
+
+In @LaTeX{} wird dazu der Befehl @code{\betweenLilyPondSystem} einfach derartig
+programmiert, dass die Ausgabe der einzelnen Notensysteme abgebrochen wird,
+sobald die gewünschte Anzahl an Systemen erreicht ist. Da
+@code{\betweenLilyPondSystem} zum ersten Mal nach dem ersten System aufgerufen
+wird, ist die Ausgabe nur eines Systems trivial.
+
+@example
+\def\betweenLilyPondSystem#1@{\endinput@}
+
+\begin[fragment]@{lilypond@}
+ c'1\( e'( c'~ \break c' d) e f\)
+\end@{lilypond@}
+@end example
+
+Um eine größere Zahl an System nötig, dann muss dementsprechend eine
+@TeX{}-Bedingung vor dem @code{\endinput} benutzt werden:
+
+@example
+\def\betweenLilyPondSystem#1@{
+ \ifnum##1<2\else\endinput\fi
+@}
+@end example
+
+Dieses Beispiel bricht nach genau zwei ausgegebenen Notenzeilen ab.
+Für eine andere Anzahl braucht nur @q{2} durch die entsprechende
+Anzahl ersetzt werden.
+
+Die Definition von @code{\betweenLilyPondSystem} bleibt gültig,
+bis @TeX{} die aktuelle Umgebung in @LaTeX{} verlässt oder der
+Befehl durch eine neue Definition überschrieben wird.
+Dies kann etwa folgendermaßen in der @LaTeX{}-Datei geschehen:
+
+@example
+\let\betweenLilyPondSystem\undefined
+@end example
+
+Obige Definition von @code{\betweenLilyPondSystem} kann durch die
+Definition eines @TeX{}-Makros auch verallgemeinert werden,
+
+@example
+\def\onlyFirstNSystems#1@{
+ \def\betweenLilyPondSystem##1@{\ifnum##1<#1\else\endinput\fi@}
+@}
+@end example
+
+@noindent
+wobei diesem Makro @code{\onlyFirstNSystems} einfach die Anzahl der
+gewünschten Systeme übergeben wird:
+
+@example
+\onlyFirstNSystems@{3@}
+\begin@{lilypond@}...\end@{lilypond@}
+\onlyFirstNSystems@{1@}
+\begin@{lilypond@}...\end@{lilypond@}
+@end example
+
+@seealso
+@command{lilypond-book} stellt auch zahlreiche Kommandozeilen-Optionen zur
+Verfügung. Für eine Liste dieser Optionen und andere hilfreiche Details zur
+Verarbeitung von @LaTeX{}-Dokumenten, siehe @ref{Invoking lilypond-book}.
+
+
@node Texinfo
@subsection Texinfo
-@untranslated
+Texinfo ist das Standard-Dokumentationsformat des GNU Projekts. Ein Beispiel
+für ein Dokument im Texinfo Format ist dieses Handbuch, wobei die HTML-, PDF- und
+Info-Versionen alle aus demselben Texinfo Dokument erzeugt werden.
+
+In der Eingabedatei wir Musik eingegeben als
+
+@example
+@@lilypond[Optionen,kommen,hier]
+ IHR LILYPOND QUELLCODE
+@@end lilypond
+@end example
+
+@noindent
+oder
+
+@example
+@@lilypond[Optionen,kommen,hier]@{ IHR LILYPOND QUELLCODE @}
+@end example
+
+@noindent
+oder
+
+@example
+@@lilypondfile[Optionen,kommen,hier]@{@var{Dateiname}@}
+@end example
+
+Wenn @command{lilypond-book} eine derartige Datei verarbeitet,
+wird eine Texinfo-Datei mit der Erweiterung @file{.texi} erzeugt,
+die @code{@@image} Befehle für die Ausgabe nach HTML, Info und PDF
+enthält. @command{lilypond-book} erzeugt die entsprechenden Grafiken
+der Musikbeispiele im EPS- und PDF-Format für die Ausgabe nach PDF
+und im PNG-Format für die Ausgabe nach HTML und Info.
+
+Hier sollen zwei einfache Beispiele gezeigt werden. Eine @code{lilypond} Umgebung
+
+@example
+@@lilypond[fragment]
+c' d' e' f' g'2 g'
+@@end lilypond
+@end example
+
+@noindent
+erzeugt
+
+@lilypond[fragment]
+c' d' e' f' g'2 g'
+@end lilypond
+
+Die Kurzversion
+
+@example
+@@lilypond[fragment,staffsize=11]@{<c' e' g'>@}
+@end example
+
+@noindent
+erzeugt
+
+@lilypond[fragment,staffsize=11]{<c' e' g'>}
+
+Im Gegensatz zu @LaTeX{} erzeugt @code{@@lilypond@{...@}} allerdings keine Grafik
+im Fließtext, sondern setzt sie immer in einen eigenen Absatz.
@node HTML
@subsection HTML
-@untranslated
+Musik wird eingegeben als
+
+@example
+<lilypond fragment relative=2>
+\key c \minor c4 es g2
+</lilypond>
+@end example
+
+@noindent
+@command{lilypond-book} erzeugt dann daraus eine HTML-Datei mit den entsprechenden
+@code{<image>} Tags für die Musikbeispiele in jeweils einem eigenen Absatz.
+
+
+@lilypond[fragment,relative=2]
+\key c \minor c4 es g2
+@end lilypond
+
+Für Grafiken im Fließtext kann @code{<lilypond ... />} benutzt werden, wobei
+die Optionen durch einen Doppelpunkt von der Musik getrennt angegeben werden.
+
+@example
+Musik <lilypond relative=2: a b c/> in derselben Zeile.
+@end example
+
+Um Dateien mit Musik einzubinden, kann folgendermaßen vorgegangen werden:
+
+@example
+<lilypondfile @var{Option1} @var{Option2} ...>@var{Dateiname}</lilypondfile>
+@end example
+
@node DocBook
@subsection DocBook
-@untranslated
+Bei der Einbindung von Musik im LilyPond-Format in DocBook soll die
+Konformität unseres DocBook Dokuments erhalten bleiben und damit
+die Bearbeiten mit DocBook-Editoren sowie die Validierung weiter
+möglich bleiben. Aus diesem Grund werden in DocBook keine eigenen Tags
+wie in HTML benutzt, sondern die von den vorhandenen DocBook-Elementen
+vorgegebenen Konventionen entsprechend benützt.
@subheading Common conventions
+
+Für die Einbindung von LilyPond Code werden in allen Fällen die
+@code{mediaobject} und @code{inlinemediaobject} Elemente benutzt,
+die unsere Beispiele in einem eigenen Absatz oder im Fließtext
+einfügen. Die Optionen zur Formatierung mit LilyPond werden dabei
+in der @code{role} Eigenschaft des innersten Elements angegeben,
+wie im nächsten Abschnitt gezeigt wird. Die DocBook Datei, die
+dann von @command{lilypond-book} verarbeitet wird, sollte der Klarheit
+halber die Dateierweiterung @file{.lyxml} (jedenfalls nicht
+@file{.xml}) besitzen.
+
@subheading Including a LilyPond file
+
+Dies ist der einfachste Fall: Die LilyPond-Datei besitzt die Erweiterung
+@file{.ly} und wird einfach als @code{imageobject} eingebettet:
+
+@example
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="music1.ly" role="printfilename" />
+ </imageobject>
+</mediaobject>
+@end example
+
+Für das äußerste Element kann je nach Bedarf @code{mediaobject} oder
+@code{inlinemediaobject} benutzt werden.
+
@subheading Including LilyPond code
+
+Die Einbindung von LilyPond-Code direkt in der DocBook-Datei ist
+durch die Benutzung von @code{programlisting} möglich,
+wobei die Sprache auf @code{lilypond} gesetzt wird:
+
+@example
+<inlinemediaobject>
+ <textobject>
+ <programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
+\context Staff \with @{
+ \remove Time_signature_engraver
+ \remove Clef_engraver@}
+ @{ c4( fis) @}
+ </programlisting>
+ </textobject>
+</inlinemediaobject>
+@end example
+
+Das äußerste Element ist also @code{mediaobject} oder
+@code{inlinemediaobject}, welches ein @code{textobject} mit dem
+@code{programlisting} enthält.
+
@subheading Processing the DocBook document
+
+Der Aufruf von @command{lilypond-book} mit der @file{.lyxml}-Datei
+erzeugt ein gültiges DocBook-Dokument mit der Erweiterung @file{.xml},
+welches normal weiterverarbeitet werden kann. Bei Benutzung von
+@uref{http://@/dblatex@/.sourceforge@/.net@/,dblatex} wird daraus
+automatisch eine PDF-Datei erzeugt. Für die Erzeugung von HTML (HTML
+Help, JavaHelp, etc.) können die offiziellen DocBook XSL-Stylesheets
+benutzt werden. Eventuell müssen dafür allerdings kleinere Anpassungen
+vorgenommen werden.
+
+
@node Music fragment options
@section Music fragment options
@node Alternate methods of mixing text and music
@section Alternative methods of mixing text and music
-@untranslated
+Dieser Abschnitt stellt Methoden vor, wie Text und Musik auf andere
+Weise kombiniert werden können als dies durch @command{lilypond-book}
+automatisiert geschieht.
@menu
@node Many quotes from a large score
@subsection Many quotes from a large score
-@untranslated
+Wenn aus einer großen Partitur viele kleine Fragmente eingefügt
+werden sollen, kann dazu das @q{clip systems} Feature benutzt werden.
+Siehe @ruser{Extracting fragments of music}.
@node Inserting LilyPond output into OpenOffice.org
@subsection Inserting LilyPond output into OpenOffice.org
-@untranslated
+Musik im LilyPond-Format kann in OpenOffice.org eingefügt werden mittels
+@uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
@node Inserting LilyPond output into other programs
@subsection Inserting LilyPond output into other programs
-@untranslated
-
+Im die Ausgabe von LilyPond in anderen Programmen einzufügen,
+sollte @code{lilypond} benutzt werden. Jedes Beispiel muss
+getrennt manuell erzeugt und ins Dokument eingefügt werden;
+für letzteres schlagen Sie bitte im Handbuch Ihrer
+Textverarbeitungs-Software nach. Die meisten Programme
+unterstützen das Einfügen von Grafiken im @file{PNG}-, @file{EPS}-
+oder @file{PDF}-Format.
+
+Um den leeren Rand um die Notenzeilen zu verringern, können folgende
+Einstellungen benutzt werden:
+
+@example
+\paper@{
+ indent=0\mm
+ line-width=120\mm
+ oddFooterMarkup=##f
+ oddHeaderMarkup=##f
+ bookTitleMarkup = ##f
+ scoreTitleMarkup = ##f
+@}
+
+@{ c1 @}
+@end example
+
+Eine @file{EPS}-Datei kann mit folgendem Befehl erzeugt werden:
+
+@example
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts Dateiname.ly
+
+Eine @file{PNG}-Datei mittels:
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png Dateiname.ly
+@end example
@c -- SKELETON FILE --
\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: 90fd19c1e2a433d6657cf7270cf0d1932cb4934a
+ Translation of GIT committish: b54fc6953a8d70a3c51e8c3d0cbf9b3fe9652d78
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@c don't remove this comment.
@ignore
-@omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
-@omfdescription User manual of the LilyPond music engraving system
+@omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen und Graham Percival
+@omfdescription Handbuch zum Lernen des LilyPond Musiksatzsystems
@omftype program usage
@omfcategory Applications|Publishing
@omflanguage German
@ifnottex
@node Top
@top GNU LilyPond -- Handbuch zum Lernen
-@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
Das ist des Handbuch zum Erlernen von GNU LilyPond Version @version{}.
+Für einen Überblick über die gesamte Dokumentation von LilyPond und die Intention
+dieses Handbuchs siehe @ref{About the documentation}.
@cindex Internetseite
@cindex URL
\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: 90541cc59a99d0b53baccedc0327748b760fce68
+ Translation of GIT committish: b54fc6953a8d70a3c51e8c3d0cbf9b3fe9652d78
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@c don't remove this comment.
@ignore
-@omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
-@omfdescription User manual of the LilyPond music engraving system
+@omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen und Graham Percival
+@omfdescription Programmbenutzung des LilyPond-Musiksatzsystems
@omftype program usage
@omfcategory Applications|Publishing
@omflanguage German
@ifnottex
@node Top
@top GNU LilyPond -- Programmbenutzung
-@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
Das ist das Handbuch zur Programmbenutzung für GNU LilyPond Version @version{}.
+Für einen Überblick über die gesamte Dokumentation von LilyPond und die Intention
+dieses Handbuchs siehe @rlearning{About the documentation}.
@cindex Internetseite
@cindex URL
\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: ceabf54e194b8ea304a050f4d81c3833fdaaa226
+ Translation of GIT committish: b54fc6953a8d70a3c51e8c3d0cbf9b3fe9652d78
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
Das ist das Benutzerhandbuch für GNU LilyPond Version @version{}.
+Für einen Überblick über die gesamte Dokumentation von LilyPond und die Intention
+dieses Handbuchs siehe @rlearning{About the documentation}.
@cindex Internetseite
@cindex URL
@node LilyPond command index
@appendix LilyPond command index
+Dieser Index listet alle LilyPond Befehle und Schlüsselwörter auf,
+versehen mit Verweisen zu den Abschnitten im Handbuch, die den Befehl
+beschreiben oder seine Verwendung diskutieren. Der erste Teil zeigt auf
+die genaue Stelle im Handbuch, an der der Befehl oder das Schlüsselwort
+erscheint, der zweite Teil zeigt auf den entsprechenden Abschnitt.
+
@printindex ky
@node LilyPond index
@appendix LilyPond index
+Zusätzlich zu allen LilyPond Befehlen und Schlüsselwörtern listet
+dieser Index alle relevanten Begriffe auf und verlinkt sie mit den
+entsprechenden Abschnitten, wo sie erklärt werden. Der erste Teil
+zeigt auf die genaue Stelle im Handbuch, an der der der Begriff
+vorkommt, der zweite Teil zeigt auf den gesamten Abschnitt, in dem
+das Thema behandelt wird.
+
@printindex cp
@bye
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 90541cc59a99d0b53baccedc0327748b760fce68
+ Translation of GIT committish: b54fc6953a8d70a3c51e8c3d0cbf9b3fe9652d78
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
Das Quellenarchiv enthält eine ausführlichere Bib@TeX{}-Bibliographie mit
über 100 Titeln in
@ifhtml
+@ifset bigpage
+@uref{../bibliography/index.html, der Bibliographie}.
+@end ifset
+@ifclear bigpage
@uref{../../bibliography/index.html, der Bibliographie}.
+@end ifclear
@end ifhtml
@ifnothtml
@file{Documentation/@/bibliography/}.
@c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: 1440fffdf8579046cc2033b9c697a190b34b91e5
+ Translation of GIT committish: b54fc6953a8d70a3c51e8c3d0cbf9b3fe9652d78
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 8d678d320b2bef3d0ebfc737134d45bcec5e8a56
+ Translation of GIT committish: b54fc6953a8d70a3c51e8c3d0cbf9b3fe9652d78
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 6bcad9cdc487270910758b1ee39cf3c8aee1015e
+ Translation of GIT committish: 4ac76531a06d6b6836b67d3650b57a2f58d1108f
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@node Running LilyPond
@chapter Running LilyPond
-@untranslated
+Dieses Kapitel behandelt die technischen Details, wie Lilypond ausgeführt werden kann.
@menu
@node Normal usage
@section Normal usage
-@untranslated
+Die meisten Benutzer führen LilyPond von einer graphischen Benutzeroberfläche
+aus. Siehe @rlearning{First steps}, falls Sie dies nicht bereits getan haben.
@node Command-line usage
@section Command-line usage
-@untranslated
+Dieser Abschnitt enthält zusätzliche Informationen, wie Sie LilyPond
+von der Kommandozeile ausführen können. Dies kann erforderlich sein,
+um etwa zusätzliche Optionen an das Programm zu übergeben. Außerdem
+sind einige Zusatzprogramme (wie etwa @code{midi2ly}) nur von der
+Kommandozeile verfügbar.
+
+Unter @q{Kommandozeile} verstehen wir die Kommandozeile des jeweiligen
+Betriebssystems. Windows Benutzern ist sie vielleicht eher unter den
+englischen Begriffen @q{DOS shell} oder @q{command shell} bekannt.
+MacOS@tie{}X Benutzer kennen sie eher unter @q{Terminal} oder @q{Konsole}.
+Sie sollten auch den Abschnitt @ref{MacOS X on the command-line} konsultieren.
+
+Wie die Kommandozeile im jeweiligen Betriebssystem benutzt werden kann,
+soll in diesem Handbuch nicht näher beschrieben werden. Sehen Sie bitte
+im Handbuch Ihres Betriebssystems nach oder informieren Sie sich im
+Internet, wenn Sie mit der Kommandozeile nicht vertraut sind.
@menu
@node Invoking lilypond
@subsection Invoking lilypond
-@untranslated
+@cindex LilyPond aufrufen
+@cindex Kommandozeilen-Optionen
+@cindex Optionen an der Kommandozeile
+
+Das @command{lilypond} Programm kann folgendermaßen von der Kommandozeile
+aufgerufen werden.
+
+@example
+lilypond [@var{Option}]@dots{} @var{Dateiname}@dots{}
+@end example
+
+
+Wird ein @file{Dateiname} ohne Erweiterung angegeben, so wird @file{.ly} als
+Standarderweiterung für LilyPond-Dateien benutzt. Um Daten von
+@code{stdin} einzulesen, benutzen Sie einfach einen Bindestrich (@code{-})
+als @var{Dateiname}.
+
+Wenn Lilypond die Datei @file{Dateiname.ly} verarbeitet, werden daraus
+die Dateien @file{Dateiname.ps} und @file{Dateiname.pdf} erzeugt.
+Es können an @code{lilypond} auch mehrere @file{.ly} Dateien übergeben
+werden, die dann einzeln und voneinander unabhängig abgearbeitet
+werden.@footnote{Der Zustand von GUILE wird allerdings nicht nach
+jeder Datei zurückgesetzt, sodass Achtung geboten ist, wenn in einer
+Datei globale Änderungen von Scheme aus durchgeführt werden.}
+
+Falls @file{Dateiname.ly} mehr als einen @code{\score}-Block enthält,
+werden die weiteren Stücke in durchnummerierte Dateien der Form
+@file{Dateiname-1.pdf} ausgegeben. Zusätzlich wird der Wert der
+Variable @code{output-suffix} zwischen den ursprünglichen Dateienamen
+und der Zahl eingefügt. Eine Lilypond-Datei @var{Dateiname.ly} mit dem Inhalt
+
+@example
+#(define output-suffix "Geige")
+\book @{ @dots{} @}
+#(define output-suffix "Cello")
+\book @{ @dots{} @}
+@end example
+
+@noindent
+erzeigt daher die Dateien @var{Dateiname}@file{-Geige.pdf} und
+@var{Dateiname}@file{-Cello-1.pdf}.
+
@node Command line options
@node Environment variables
@subsection Environment variables
-@untranslated
+@cindex LANG
+@cindex LILYPOND_DATADIR
+
+@command{lilypond} erkennt und benützt die folgenden Umgebungsvariablen:
+@table @code
+@item LILYPOND_DATADIR
+Diese Variable gibt das Verzeichnis an, wo Lilypond seine eigenen Dateien,
+Meldungen und Übersetzungen finden kann. Dieses Verzeichnis sollte
+Unterverzeichnisse @file{ly/}, @file{ps/}, @file{tex/}, etc. beinhalten.
+
+@item LANG
+Gibt die Sprache an, in der Warnungen und Fehlermeldungen ausgegeben werden.
+
+@item LILYPOND_GC_YIELD
+Mit dieser Variable (mit Werten zwischen 0 und 100) kann die Feinabstimmung
+zwischen dem Bedarf an Hauptspeicher und Rechenleistung bei der Ausführung
+von LilyPond durchgeführt werden. Bei höheren Werten benutzt LilyPond
+mehr Hauptspeicher, benötigt aber weniger Prozessor-Leistung. Bei
+niedrigeren Werten wird mehr Prozessor-Zeit, dafür weniger Hauptspeicher
+benötigt. Voreinstellung ist ein Wert von @code{70}.
+
+@end table
@node Error messages
@section Error messages
-@untranslated
+@cindex error messages
+Während der Verarbeitung einer Dateien können diverse Meldungen an der
+Kommandozeile auftreten:
+
+@table @emph
+
+@item Warnung
+@cindex Warnung
+Irgendetwas ist verdächtig. Wenn Sie etwas Ungewöhnliches in Ihrer
+Datei durchführen, dann werden Sie die Meldung verstehen und können
+sie gegebenenfalls ignorieren. Im Normalfall jedoch bedeutet eine
+Warnung, dass mit Ihrer Datei etwas nicht stimmt, LilyPond jedoch
+trotzdem versucht, die Datei soweit wie möglich korrekt zu übersetzen.
+
+@item Fehler
+@cindex Fehler
+Irgendetwas stimmt definitiv nicht. Der aktuelle Bearbeitungsschritt
+(Einlesen, Interpretieren oder Formatieren der Datei) wird noch fertig
+ausgeführt, danach bricht die Bearbeitung aber ab.
+
+@item Fataler Fehler
+@cindex Fataler Fehler
+Irgendetwas stimmt definitiv nicht und LilyPond kann nicht weiter
+ausgeführt werden. Dies ist nur sehr selten der Fall, meist sind
+die Schriftarten nicht korrekt installiert.
+
+@item Scheme Fehler
+@cindex Fehlerprotokoll, Scheme
+@cindex Scheme Fehler
+Fehler, die während der Ausführung von Scheme-Code auftreten, werden
+vom Scheme-Interpreter aufgefangen und an der Kommandozeile ausgegeben.
+Wenn Sie LilyPond mit der @code{--verbose} Option (auch @code{-V})
+ausführen, wird der sogennante @q{Call trace} ausgegeben, der die
+aufgerufenen Funktionen zur Zeit des Fehlers angibt.
+
+@item Programmierfehler
+@cindex Programmierfehler
+Eine interne Inkonsistenz ist aufgetreten. Diese Fehlermeldungen
+sind sollen den Programmierern die Fehlersuche erleichtern und
+können meistens einfach ignoriert werden. In manchen Fällen werden
+so viele Meldungen ausgegeben, dass die Lesbarkeit der restliche
+Ausgabe davon beeinträchtigt wird.
+
+@item Abgebrochen (core dumped)
+Dies bezeichnet einen ernsten Programmierfehler, der das Programm
+zum Absturz gebracht hat. Solche Fehler werden als kritisch angesehen.
+Falls daher einer auftritt, senden Sie bitte einen Bug-Report!
+@end table
+
+@cindex Fehlermeldung, Format
+@cindex Form der Fehlermeldungen
+Wenn Warnungen oder Fehlermeldungen mit einer konkreten Stelle in der
+Eingabedatei verknüpft werden können, dann hat die Meldung die folgende
+Form:
+
+@example
+@var{Dateiname}:@var{Zeile}:@var{Spalte}: @var{Meldung}
+@var{Fehlerhafte Eingabezeile}
+@end example
+
+Ein Zeilenumbruch wird in der fehlerhaften Zeile an jener Stelle eingefügt,
+wo der Fehler aufgetreten ist. Zum Beispiel
+
+@example
+test.ly:2:19: Fehler: keine gültige Dauer: 5
+ @{ c'4 e'
+ 5 g' @}
+@end example
+
+Diese Stellen sind LilyPonds Vermutung, wo die Warnung oder der Fehler
+aufgetreten ist, allerdings treten Warnungen und Fehler ja gerade in
+unerwarteten Fällen auf. Manchmal kann Lilypond auch eine fehlerhafte
+Stelle zwar noch problemlos verarbeiten, ein paar Zeilen später wirkt
+sich der Fehler aber dann doch noch aus. In solchen Fällen, wo Sie in
+der angegebenen Zeile keinen Fehler erkenn, sollten Sie auch die Zeilen
+oberhalb der angegebenen Stelle genauer unter die Lupe nehmen.
@node Updating files with convert-ly
@node Reporting bugs
@section Reporting bugs
-@untranslated
+
+@cindex Fehler
+@cindex Fehler melden
+
+Wenn Sie eine Datei haben, die zu einem Absturz von LilyPond oder zu einer
+fehlerhaften Ausgabe führt, so ist dies ein @q{Bug}. Die List der aktuell
+bekannten derartigen Fehler findet sich in unserem @q{Google Bug Tracker}:
+
+@uref{http://code.google.com/p/lilypond/issues/list}
+
+Wenn Sie einen Fehler gefunden haben, der noch nicht aufgelistet ist, melden
+Sie dies bitte anhand der Anweisungen auf der Seite
+
+@uref{http://lilypond.org/web/devel/participating/bugs}
+
+Wenn Sie Beispieldateien für den Fehler erstellen, versuchen Sie bitte, die
+Datei möglichst minimal zu halten und nur jenen LilyPond Code aufzunehmen,
+der auch wirklich für den Fehler verantwortlich ist. Meldungen mit
+Beispieldateien, die nicht minimal sind, können wir meist aus Zeitgründen
+nicht effektiv bearbeiten.
@subsection Single voice
@menu
-* Chords::
+* Chorded notes::
* Clusters::
@end menu
-@node Chords
-@unnumberedsubsubsec Chords
+@node Chorded notes
+@unnumberedsubsubsec Chorded notes
@cindex Akkorde
@menu
* Basic polyphony::
* Explicitly instantiating voices::
-* Collision Resolution::
+* Collision resolution::
* Automatic part combining::
* Writing music in parallel::
@end menu
@end lilypond
-@node Collision Resolution
-@unnumberedsubsubsec Collision Resolution
+@node Collision resolution
+@unnumberedsubsubsec Collision resolution
Normalerweise werden Notenköpfe mit einer unterschiedlichen Anzahl
von Punktierungen nicht verschmolzen, aber wenn die Objekt-Eigenschaft
@c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: 1440fffdf8579046cc2033b9c697a190b34b91e5
+ Translation of GIT committish: b54fc6953a8d70a3c51e8c3d0cbf9b3fe9652d78
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@node Precompiled binaries
@section Precompiled binaries
-@subsection Downloading
+@unnumberedsubsec Downloading
Revise el enlace @uref{http://lilypond.org/web/install/} para ver
información actualizada sobre los paquetes binarios para su
@end menu
@node Metronome marks
-@subsubsection Metronome marks
+@unnumberedsubsubsec Metronome marks
@cindex Tempo
@cindex pulsos por minuto
@node Instrument names
-@subsubsection Instrument names
+@unnumberedsubsubsec Instrument names
En una partitura orquestal, los nombres de los instrumentos se imprimen en el lado izquierdo
de los pentagramas.
@node Quoting other voices
-@subsubsection Quoting other voices
+@unnumberedsubsubsec Quoting other voices
@cindex guías
@node Formatting cue notes
-@subsubsection Formatting cue notes
+@unnumberedsubsubsec Formatting cue notes
@cindex guía, formateo de las notas
@node Precompiled binaries
@section Precompiled binaries
-@subsection Downloading
+@unnumberedsubsec Downloading
Consultez @uref{http://lilypond.org/web/install/} pour connaître les
derniers paquets binaires dipsonibles pour votre plateforme. Si votre
@menu
* Basic polyphony::
-* Collision Resolution::
+* Collision resolution::
* Automatic part combining::
* Writing music in parallel::
@end menu
pas à @code{noteB} ou @code{noteA}.
-@node Collision Resolution
-@unnumberedsubsubsec Collision Resolution
+@node Collision resolution
+@unnumberedsubsubsec Collision resolution
D'ordinaire, les têtes de notes pointées et non-pointées ne sont pas
fusionnées, mais lorsque la propriété @code{merge-differently-dotted} de
"im englischen Benutzerhandbuch."
#: translations-status.py:56
-#, fuzzy
msgid "Section titles"
-msgstr "Titel erstellen"
+msgstr "Überschriften"
#: translations-status.py:57
#, python-format
msgstr "·<p><i>Zuletzt aktualisiert am·%s</i></p>\n"
#: translations-status.py:58
-#, fuzzy
msgid "Translators"
-msgstr "Transposition"
+msgstr "Übersetzer"
#: translations-status.py:58
msgid "Translation checkers"
msgstr "Übersetzungsüberprüfer"
#: translations-status.py:59
-#, fuzzy
msgid "Translated"
-msgstr "Transposition"
+msgstr "Übersetzt"
#: translations-status.py:59
msgid "Up to date"
msgstr "Aktuell"
#: translations-status.py:60
-#, fuzzy
msgid "Other info"
msgstr "Mehr Information"
#: translations-status.py:62
-#, fuzzy
msgid "no"
-msgstr "normal"
+msgstr "nein"
#: translations-status.py:63
-#, fuzzy
msgid "not translated"
-msgstr "Banjo-Tabulaturen"
+msgstr "nicht übersetzt"
#: translations-status.py:65
#, python-format
msgstr "ja"
#: translations-status.py:69
-#, fuzzy
msgid "translated"
-msgstr "transparent (durchsichtig)"
+msgstr "übersetzt"
#: translations-status.py:70 translations-status.py:71
msgid "up to date"
msgstr "aktuell"
#: translations-status.py:72
-#, fuzzy
msgid "partially"
-msgstr "Wiederholungen"
+msgstr "teilweise"
#: translations-status.py:73
msgid "partially up to date"
#. @section in Documentation/es/user/introduction.itely
#. @node in Documentation/de/user/introduction.itely
#. @section in Documentation/de/user/introduction.itely
-#, fuzzy
msgid "About the documentation"
-msgstr "Andere Dokumentation"
+msgstr "Über die Dokumentation"
#. @node in Documentation/user/introduction.itely
#. @unnumberedsubsec in Documentation/user/introduction.itely
#. @unnumberedsubsec in Documentation/fr/user/introduction.itely
#. @node in Documentation/es/user/introduction.itely
#. @unnumberedsubsec in Documentation/es/user/introduction.itely
-#, fuzzy
msgid "Other documentation"
msgstr "Andere Dokumentation"
msgstr ""
#. Documentation/user/fundamental.itely:639 (comment)
-#, fuzzy
msgid "Voice \\\"1\\\""
-msgstr "Stimme 1"
+msgstr ""
#. Documentation/user/fundamental.itely:644 (comment)
-#, fuzzy
msgid "Voice \\\"2\\\""
-msgstr "Stimme 1"
+msgstr ""
#. Documentation/user/fundamental.itely:662 (comment)
#. Documentation/user/fundamental.itely:686 (comment)
#. Documentation/user/fundamental.itely:1414 (variable)
#, fuzzy
msgid "versenotes"
-msgstr "Verzierungen"
+msgstr ""
#. Documentation/user/fundamental.itely:1306 (variable)
#. Documentation/user/fundamental.itely:1367 (variable)
#. Documentation/user/fundamental.itely:1419 (variable)
#, fuzzy
msgid "refrainnotesA"
-msgstr "Umgebungen erstellen"
+msgstr ""
#. Documentation/user/fundamental.itely:1362 (variable)
#. Documentation/user/fundamental.itely:1423 (variable)
#, fuzzy
msgid "refrainnotesB"
-msgstr "Umgebungen erstellen"
+msgstr ""
#. Documentation/user/fundamental.itely:1370 (variable)
#. Documentation/user/fundamental.itely:1431 (variable)
msgstr "Klaviersystem beenden"
#. Documentation/user/fundamental.itely:2830 (comment)
-#, fuzzy
msgid "end PedalOrgan Staff context"
-msgstr "Klaviersystem beenden"
+msgstr "Orgelsystem beenden"
#. Documentation/user/fundamental.itely:2832 (comment)
msgid "end Score context"
msgstr ""
#. Documentation/user/tweaks.itely:3165 (variable)
-#, fuzzy
msgid "normal"
msgstr "normal"
#. Documentation/user/tweaks.itely:3171 (variable)
-#, fuzzy
msgid "SopranoMusic"
msgstr "SopranNoten"
xml: $(outdir)/lilypond/lilypond.xml $(outdir)/lilypond-internals/lilypond-internals.xml
-# All web targets, except info image symlinks and info docs are
-# installed in non-recursing target from TOP-SRC-DIR
-local-install-WWW: local-install-info
-local-uninstall-WWW: local-uninstall-info
-
local-clean:
rm -f $(INFO_IMAGES_DIR)
@node The tweak command
@subsection The @code{\tweak} command
-FIXME expand to include all uses of \tweak
-TODO: can't use \tweak in a variable
-
@funindex \tweak
+@cindex tweaking
-In some cases, it is possible to take a short-cut for tuning graphical
-objects. For objects that result directly from a piece of the input,
-you can use the @code{\tweak} function, for example
+In some cases, it is possible to take a short-cut for tuning
+graphical objects. For objects that are created directly from
+an item in the input file, you can use the @code{\tweak} command.
+For example:
-@lilypond[relative=2,fragment,verbatim,ragged-right]
-<
- c
- \tweak #'color #red d
+@lilypond[relative=2,verbatim]
+< c
+ \tweak #'color #red
+ d
g
- \tweak #'duration-log #1 a
->4-\tweak #'padding #10 -.
+ \tweak #'duration-log #1
+ a
+> 4
+-\tweak #'padding #8
+-^
+@end lilypond
+
+@cindex chord, modifying one note in
+
+But the main use of the @code{\tweak} command is to modify just
+one of a number of notation elements which start at the same musical
+moment, like the notes of a chord, or tuplet brackets which start
+at the same time.
+
+For an introduction to the syntax and uses of the tweak command
+see @rlearning{Tweaking methods}.
+
+The @code{\tweak} command sets a property in the following object
+directly, without requiring the grob name or context to be
+specified. For this to work, it is necessary for the @code{\tweak}
+command to remain immediately adjacent to the object to which it is
+to apply after the input file has been converted to a music stream.
+This is often not the case, as many additional elements are inserted
+into the music stream implicitly. For example, when a note which is
+not part of a chord is processed, Lilypond implicitly inserts a
+@code{ChordEvent} event before the note, so separating the tweak
+from the note. However, if chord symbols are placed round the
+tweak and the note, the @code{\tweak} command comes after the
+@code{ChordEvent} in the music stream, so remaining adjacent to the
+note, and able to modify it.
+
+So, this works:
+
+@lilypond[relative=2,verbatim,quote]
+<\tweak #'color #red c>4
@end lilypond
-As you can see, properties are set in the objects directly,
-without mentioning the grob name or context where this should be
-applied.
+@noindent
+but this does not:
+
+@lilypond[relative=2,verbatim,quote]
+\tweak #'color #red c4
+@end lilypond
-This technique only works for objects that are directly connected to
-an @rinternals{Event} from the input, for example
+When several similar items are placed at the same musical moment,
+the @code{\override} command cannot be used to modify just one of
+them -- this is where the @code{\tweak} command must be used.
+Items which may appear more than once at the same musical moment
+include the following:
+@c TODO expand to include any further uses of \tweak
@itemize
-@item note heads, caused by chord-pitch (i.e., notes inside a chord)
-@item articulation signs, caused by articulation instructions
+@item note heads of notes inside a chord
+@item articulation signs on a single note
+@item ties between notes in a chord
+@item tuplet brackets starting at the same time
@end itemize
-It notably does not work for stems and accidentals (these are caused
-by note heads, not by music events) or clefs (these are not caused by
-music inputs, but rather by the change of a property value).
+@c TODO add examples of these
-There are very few objects which are @emph{directly} connected to
-output. A normal note (like @code{c4}) is not directly connected
-to output, so
+@noindent
+and @code{\tweak} may be used to modify any single occurrence of
+these items.
+
+Notably the @code{\tweak} command cannot be used to modify stems,
+beams or accidentals, since these are generated later by note heads,
+rather than by music elements in the input stream. Nor can a
+@code{\tweak} command be used to modify clefs or time signatures,
+since these become separated from any preceding @code{\tweak}
+command in the input stream by the automatic insertion of extra
+elements required to specify the context.
+
+But the @code{\tweak} command can be used as an alternative to
+the @code{\override} command to modify those notational elements
+that do not cause any additional implicit elements to be added
+before them in the music stream. For example, slurs may be
+modified in this way:
-@example
-\tweak #'color #red c4
-@end example
+@lilypond[verbatim,quote,relative=1]
+c-\tweak #'thickness #5 ( d e f)
+@end lilypond
-@noindent
-does not change color. See @ref{Displaying music expressions}, for
-details.
+Also several @code{\tweak} commands may be placed before a
+notational element -- all affect it:
+
+@lilypond[verbatim,quote,relative=1]
+c
+-\tweak #'style #'dashed-line
+-\tweak #'dash-fraction #0.2
+-\tweak #'thickness #3
+-\tweak #'color #red
+ \glissando
+f'
+@end lilypond
+
+The music stream which is generated from a section of an input file,
+including any automatically inserted elements, may be examined,
+see @ref{Displaying music expressions}. This may be helpful in
+determining what may be modified by a @code{\tweak} command.
+
+@seealso
+
+Learning Manual:
+@rlearning{Tweaking methods}.
+
+Notation Reference:
+@ref{Displaying music expressions}.
+
+@knownissues
+
+@cindex tweaks in a variable
+The @code{\tweak} command cannot be used inside a variable.
+
+@cindex tweaks in lyrics
+The @code{\tweak} commands cannot be used in @code{\lyricmode}.
+
+@cindex tweaking control points
+@cindex control points, tweaking
+The @code{\tweak} command cannot be used to modify the control
+points of just one of several ties in a chord, other than the first
+one encountered in the input file.
@node set versus override
@subsection @code{\set} vs. @code{\override}
\clef "treble_8"
< f, c f a c' f'>1 ^\markup
\fret-diagram #"c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
- < g, b, d g b' g'> ^\markup
+ < g, d g b d' g'> ^\markup
\fret-diagram #"c:6-1-3;6-3;5-5;4-5;3-4;2-3;1-3;"
}
>>
\clef "treble_8"
< f, c f a c' f'>1 ^\markup
\fret-diagram #"s:1.5;c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
- < g, b, d g b' g'> ^\markup
+ < g, b, d g b g'> ^\markup
\fret-diagram #"h:6;6-3;5-2;4-o;3-o;2-o;1-3;"
}
>>
\clef "treble_8"
< f, c f a c' f'>1 ^\markup
\fret-diagram-terse #"1-(;3;3;2;1;1-);"
- < g, b, d g b' g'> ^\markup
+ < g, d g b d' g'> ^\markup
\fret-diagram-terse #"3-(;5;5;4;3;3-);"
}
>>
(place-fret 1 1)
(barre 6 1 1)
)
- < g, b, d g b' g'> ^\markup
+ < g, b, d g b g'> ^\markup
\fret-diagram-verbose #'(
(place-fret 6 3 2)
(place-fret 5 2 1)
as follows:
@lilypond[verbatim,quote,ragged-right]
-\new Staff ="main" {
+\new Staff = "main" {
\relative g' {
r4 g8 g c4 c8 d |
e4 r8
@chapter Install
@end ifclear
-@c I don't know what this comment does. Remove? -gp
-@ignore
-@h tml
-<a name="download-source">
-@e nd html
-@end ignore
-
There are two sets of releases for LilyPond: stable releases, and
unstable development releases. Stable versions have an even-numbered
@q{minor} version number (i.e. 2.8, 2.10, 2.12, etc). Development
@node Precompiled binaries
@section Precompiled binaries
-@subsection Downloading
+@unnumberedsubsec Downloading
Check out @uref{http://lilypond.org/web/install/} for up to date
information on binary packages for your platform. If your operating
@item @uref{http://fontforge.sf.net/,FontForge} 20060125 or newer.
+@item MetaFont (mf-nowin, mf, mfw or mfont binaries) and MetaPost
+(mpost binary), usually packaged with a @LaTeX{} distribution like
+tetex or texlive.
+
@item @uref{http://www.lcdf.org/~eddietwo/type/#t1utils,t1utils}
(version 1.33 or newer recommended).
@end example
+
+@unnumberedsubsubsec Useful @command{make} variables
+
+If a less verbose build output if desired, the variable
+@code{QUIET_BUILD} may be set to @code{1} on @command{make} command
+line, or in @file{local.make} at top of the build tree.
+
+
@node Building documentation
@subsection Building documentation
for more information, see @file{Documentation/user/README.txt} and
@file{Documentation/TRANSLATION}.
+The makefile variable @code{QUIET_BUILD} may be set to @code{1} for a
+less verbose build output, just like for building the programs.
+
@knownissues
@code{-j} command-line option of @command{make} is unsupported for
running LilyPond to build images of music, the makefile variable
@code{CPU_COUNT} may be set in @file{local.make} or on the command line
to the number of @code{.ly} files that LilyPond should process
-simultaneously, e.g. on a bi-processor or Dual core machine
+simultaneously, e.g. on a bi-processor or dual core machine
@example
make CPU_COUNT=2 web
@item @code{\postLilyPondExample} called after the music,
@item @code{\betweenLilyPondSystem[1]} is called between systems if
-@code{lilypond-book} has split the snippet into several postscript
+@code{lilypond-book} has split the snippet into several PostScript
files. It must be defined as taking one parameter and will be
passed the number of files already included in this snippet.
The default is to simply insert a @code{\linebreak}.
</mediaobject>
@end example
-Note that you can use mediaobject or inlinemediaobject as the outermost
-element as you wish.
+Note that you can use @code{mediaobject} or @code{inlinemediaobject}
+as the outermost element as you wish.
@subheading Including LilyPond code
@end menu
@node Many quotes from a large score
-@subsection Many quotes from a large score
+@unnumberedsubsec Many quotes from a large score
If you need to quote many fragments from a large score, you can also use
the clip systems feature, see @ruser{Extracting fragments of music}.
@node Inserting LilyPond output into OpenOffice.org
-@subsection Inserting LilyPond output into OpenOffice.org
+@unnumberedsubsec Inserting LilyPond output into OpenOffice.org
@cindex OpenOffice.org
@node Inserting LilyPond output into other programs
-@subsection Inserting LilyPond output into other programs
+@unnumberedsubsec Inserting LilyPond output into other programs
To insert LilyPond output in other programs, use @code{lilypond}
instead of @code{lilypond-book}. Each example must be created
@{ c1 @}
@end example
-To produce a useful EPS file, use
+To produce a useful @file{EPS} file, use
@example
lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts myfile.ly
-PNG:
+@file{PNG}:
lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png myfile.ly
@end example
\new Staff { c4 \bar "|:" \grace s16 d2. } >>
@end lilypond
+Predefined commands, like @code{\voiceOne}, which are intended to
+change the behaviour of the notation after a grace note, may not
+be effective if placed immediately before the grace note -- they
+should be placed after it.
+
Grace sections should only be used within sequential music
expressions. Nesting or juxtaposing grace sections is not
supported, and might produce crashes or other errors.
This chapter details the technicalities of running LilyPond.
@menu
-* Normal usage::
+* Normal usage::
* Command-line usage::
* Error messages::
* Updating files with convert-ly::
extension is tried first. To read input from stdin, use a
dash (@code{-}) for @var{file}.
-When @file{filename.ly} is processed it will produce
-@file{filename.tex} as output (or @file{filename.ps} for PostScript
-output). If @file{filename.ly} contains more than one @code{\score}
-block, then the rest of the scores will be output in numbered files,
-starting with @file{filename-1.tex}. Several files can be specified;
+When @file{filename.ly} is processed it will produce @file{filename.ps}
+and @file{filename.pdf} as output. Several files can be specified;
they will each be processed independently. @footnote{The status of
GUILE is not reset after processing a @code{.ly} file, so be careful
not to change any system defaults from within Scheme.}
-In addition, the value of @code{output-suffix} will be inserted between
-the basename and the number. An input file containing
+If @file{filename.ly} contains more than one @code{\score}
+block, then the rest of the scores will be output in numbered files,
+starting with @file{filename-1.pdf}. In addition, the value of
+@code{output-suffix} will be inserted between the basename and the
+number. An input file containing
@example
#(define output-suffix "violin")
@end example
@noindent
-will output @var{base}@file{-violin.ps} and
-@var{base}@file{-cello-1.ps}.
+will output @var{base}@file{-violin.pdf} and
+@var{base}@file{-cello-1.pdf}.
@node Command line options
where the error was found. For example,
@example
-test.ly:2:19: error: not a duration: 5:
- @{ c'4 e'5
- g' @}
+test.ly:2:19: error: not a duration: 5
+ @{ c'4 e'
+ 5 g' @}
@end example
These locations are LilyPond's best guess about where the warning or
@cindex chords
@cindex brackets, angle
+@cindex relative pitch in chords
@funindex <
@funindex >
@funindex <...>
@unnumberedsubsubsec Clusters
@cindex cluster
+@cindex note cluster
@funindex \makeClusters
+@funindex makeClusters
A cluster indicates a continuous range of pitches to be played. They
can be denoted as the envelope of a set of notes. They are entered by
@node Single-staff polyphony
@unnumberedsubsubsec Single-staff polyphony
+@cindex single-staff polyphony
+@cindex polyphony, single-staff
+@cindex voice
+@cindex lyrics assigned to one voice
+@funindex \voiceOne
+@funindex voiceOne
+@funindex \voiceOne ... \voiceFour
+@funindex Voice
+@funindex \oneVoice
+@funindex oneVoice
+
The basic structure of code needed to achieve multiple, independent
voices in a single staff is illustrated in the following example:
>>
@end lilypond
-Here, the \voiceOne and \voiceTwo commands help to make clear what
+Here, the @code{\voiceOne} and @code{\voiceTwo} commands help to make clear what
settings does each voice receive.
The @code{<<@{...@} \\ @{...@}>>} construction, where the two (or
@predefined
-@funindex \voiceOne
@code{\voiceOne},
-@funindex \voiceTwo
@code{\voiceTwo},
-@funindex \voiceThree
@code{\voiceThree},
-@funindex \voiceFour
@code{\voiceFour},
-@funindex \oneVoice
@code{\oneVoice}.
@seealso
@cindex voice styles
@cindex styles, voice
@cindex coloring voices
+@funindex \voiceOneStyle
+@funindex \voiceTwoStyle
+@funindex \voiceThreeStyle
+@funindex \voiceFourStyle
+@funindex \voiceNeutralStyle
Voices may be given distinct colors and shapes, allowing them to be
easily identified:
@predefined
-@funindex \voiceOneStyle
+
@code{\voiceOneStyle},
-@funindex \voiceTwoStyle
+
@code{\voiceTwoStyle},
-@funindex \voiceThreeStyle
@code{\voiceThreeStyle},
-@funindex \voiceFourStyle
@code{\voiceFourStyle},
-@funindex \voiceNeutralStyle
@code{\voiceNeutralStyle}.
@seealso
@cindex merging notes
@cindex note collisions
@cindex collisions
+@cindex shift note
+@cindex multiple voices
+@cindex voices, multiple
+@cindex polyphonic music
+@cindex shifting voices
+@cindex voices, multiple
+@cindex shift rest, automatic
@funindex \shiftOn
+@funindex shiftOn
@funindex \shiftOnn
+@funindex shiftOnn
@funindex \shiftOnnn
+@funindex shiftOnnn
@funindex \shiftOff
-@cindex shift rest, automatic
+@funindex shiftOff
+@funindex \mergeDifferentlyDottedOn
+@funindex mergeDifferentlyDottedOn
+@funindex \mergeDifferentlyDottedOff
+@funindex mergeDifferentlyDottedOff
+@funindex \mergeDifferentlyHeadedOn
+@funindex mergeDifferentlyHeadedOn
+@funindex \mergeDifferentlyHeadedOff
+@funindex mergeDifferentlyHeadedOff
Note heads with equal durations are automatically merged, while
note heads with unequal durations are not merged. Rests opposite
>>
@end lilypond
-@cindex shift note
The collision on the second measure happens because
-@code{merge-differently-headed} cannot successfully complete the
+@code{\mergeDifferentlyHeadedOn} cannot successfully complete the
merge when three or more notes line up in the same column -- in
fact, you will obtain a warning for this reason. To allow the
merge to work properly, apply a @code{\shift} to the note that
should not be merged. Here, @code{\shiftOn} is applied to move
the top @code{g} out of the column, and
-@code{merge-differently-headed} works properly.
+@code{\mergeDifferentlyHeadedOn} works properly.
@lilypond[quote,relative=2,verbatim]
<<
Notes are only merged if they have opposing stem directions (i.e., in
@code{Voice} 1 and 2).
-@cindex multiple voices
-@cindex polyphonic music
-@cindex shifting voices
@predefined
-@funindex \mergeDifferentlyDottedOn
@code{\mergeDifferentlyDottedOn},
-@funindex \mergeDifferentlyDottedOff
@code{\mergeDifferentlyDottedOff},
-@funindex \mergeDifferentlyHeadedOn
@code{\mergeDifferentlyHeadedOn},
-@funindex \mergeDifferentlyHeadedOff
@code{\mergeDifferentlyHeadedOff}.
-@funindex \shiftOn
@code{\shiftOn},
-@funindex \shiftOnn
@code{\shiftOnn},
-@funindex \shiftOnnn
@code{\shiftOnnn},
-@funindex \shiftOff
@code{\shiftOff}.
@snippets
@knownissues
-When using @code{merge-differently-headed} with an upstem eighth
+When using @code{\mergeDifferentlyHeadedOn} with an upstem eighth
or a shorter note, and a downstem half note, the eighth note stem
gets a slightly wrong offset because of the different width of the
half note head symbol.
@cindex automatic part combining
@cindex part combiner
@cindex combining parts
+@cindex a due part
+@cindex solo part
@funindex \partcombine
+@funindex partcombine
Automatic part combining is used to merge two parts of music onto
a staff. It is aimed at typesetting orchestral scores. When the
>>
@end lilypond
-The notes in the third measure appear only once, although they
-were specified in both parts. Stem, slur, and tie directions are
-set automatically, depending whether there is a solo or unison.
-When needed in polyphony situations, the first part (with context
-called @code{one}) always gets up stems, while the second (called
-@code{two}) always gets down stems. In solo situations, the parts
-get marked with @q{Solo} and @q{Solo II}, respectively. The
-unisono (@notation{a due}) parts are marked by default with the
-text @qq{a2}.
+The notes in the third measure appear only once, although they were
+specified in both parts. Stem, slur, and tie directions are set
+automatically, depending whether there is a solo or unison. When
+needed in polyphony situations, the first part (with context called
+@code{one}) always gets up stems, while the second (called @code{two})
+always gets down stems. In solo situations, the first and second
+parts get marked with @q{Solo} and @q{Solo II}, respectively. The
+unisono (@notation{a due}) parts are marked by default with the text
+@qq{a2}.
Both arguments to @code{\partcombine} will be interpreted as
@code{Voice} contexts. If using relative octaves,
@node Writing music in parallel
@unnumberedsubsubsec Writing music in parallel
-@cindex Writing music in parallel
-@cindex Interleaved music
+@cindex writing music in parallel
+@cindex interleaved music
+@cindex parallel music
+@funindex \parallelMusic
@funindex parallelMusic
Music for multiple parts can be interleaved in input code. The
* Deeper nested staff groups::
@end menu
+
@node Instantiating new staves
@unnumberedsubsubsec Instantiating new staves
Notation Reference:
@ref{Creating contexts},
@ref{Percussion staves},
+@ref{Showing melody rhythms},
@ref{Default tablatures},
-@ref{Gregorian chant contexts},
-@ref{Mensural contexts},
-@ref{Staff symbol},
@ref{Pre-defined contexts},
-@ref{Showing melody rhythms}.
+@ref{Staff symbol},
+@ref{Gregorian chant contexts},
+@ref{Mensural contexts}.
Snippets:
@rlsr{Staff notation}.
>>
@end lilypond
-The @code{PianoStaff} is almost identical to a @code{GrandStaff},
-except that it supports printing the instrument name directly.
-For details, see @ref{Instrument names}.
+The @code{PianoStaff} is identical to a @code{GrandStaff}, except
+that it supports printing the instrument name directly. For
+details, see @ref{Instrument names}.
@lilypond[verbatim,quote,relative=2]
\new PianoStaff <<
Internals Reference:
@rinternals{Staff},
+@rinternals{StaffGroup},
@rinternals{ChoirStaff},
@rinternals{GrandStaff},
@rinternals{PianoStaff},
-@rinternals{StaffGroup},
@rinternals{SystemStartBar},
@rinternals{SystemStartBrace},
@rinternals{SystemStartBracket},
Two additional staff-group contexts are available that can be
nested within a @code{StaffGroup} or @code{ChoirStaff} context:
@code{InnerStaffGroup} and @code{InnerChoirStaff}. These contexts
-create an additional bracket next to the original bracket of their
-parent staff group.
+create a bracket next to the original bracket of their parent
+staff group.
An @code{InnerStaffGroup} is treated similarly to a
@code{StaffGroup}; bar lines are connected between each stave
@lilypond[verbatim,quote,relative=2]
\new StaffGroup <<
- \new Staff { c2 c }
+ \new Staff { c2 c | c2 c }
\new InnerStaffGroup <<
- \new Staff { g2 g }
- \new Staff { e2 e }
+ \new Staff { g2 g | g2 g }
+ \new Staff { e2 e | e2 e }
>>
>>
@end lilypond
@lilypond[verbatim,quote,relative=2]
\new ChoirStaff <<
- \new Staff { c2 c }
+ \new Staff { c2 c | c2 c }
\new InnerChoirStaff <<
- \new Staff { g2 g }
- \new Staff { e2 e }
+ \new Staff { g2 g | g2 g }
+ \new Staff { e2 e | e2 e }
>>
- \new Staff { c1 }
+ \new Staff { c1 | c1 }
>>
@end lilypond
@rinternals{ChoirStaff},
@rinternals{SystemStartBar},
@rinternals{SystemStartBrace},
-@rinternals{SystemStartBracket}.
+@rinternals{SystemStartBracket},
+@rinternals{SystemStartSquare}.
@node Modifying single staves
@cindex spacing of ledger lines
@cindex number of staff lines
-The grob @code{StaffSymbol} is responsible for drawing the lines
-of a staff. Its properties can be altered in order to change the
-appearance of a staff, but they must be changed before the staff
-is created. A staff may be started or stopped at any point in the
-score.
+The lines of a staff belong to the @code{StaffSymbol} grob.
+@code{StaffSymbol} properties can be modified to change the
+appearance of a staff, but they must be modified before the staff
+is created.
The number of staff lines may be changed. The clef position and
the position of middle C may need to be modified to fit the new
@ref{Clef}.
@lilypond[verbatim,quote,relative=2]
-\new Staff {
- \override Staff.StaffSymbol #'line-count = #3
- d4 d d d
+\new Staff \with {
+ \override StaffSymbol #'line-count = #3
}
+{ d4 d d d }
@end lilypond
The vertical position of staff lines and the number of staff lines
-can be defined at the same time. As the example shows, the
-positions of the notes are not influenced by the position of the
-staff lines. Details for modifying this property are found in
-@rinternals{staff-symbol-interface}.
+can be defined at the same time. As the following example shows,
+note positions are not influenced by the staff line positions.
@warning{The @code{'line-positions} property overrides the
@code{'line-count} property. The number of staff lines is
{ a4 e' f b | d1 }
@end lilypond
-The staff line thickness can be modified. The thickness of ledger
+Staff line thickness can be modified. The thickness of ledger
lines and stems are also affected, since they depend on staff line
thickness.
{ e4 d c b }
@end lilypond
-The thickness of ledger lines can be set independently of staff
-line thickness. A description of this property is also found in
-@rinternals{staff-symbol-interface}.
+Ledger line thickness can be set independently of staff line
+thickness.
@lilypond[verbatim,quote,relative=1]
\new Staff \with {
{ e4 d c b }
@end lilypond
-The distance between staff lines can be changed. The setting has
+The distance between staff lines can be changed. This setting has
influence on ledger lines as well.
@lilypond[verbatim,quote,relative=1]
{ a4 b c d }
@end lilypond
-The width of a staff can be adjusted. The unit is one staff
+The width of a staff can be modified. The unit is one staff
space. The spacing of objects inside the staff is not influenced
by this setting.
{ a4 e' f b | d1 }
@end lilypond
+Further details about the properties of @code{StaffSymbol} can be
+found here: @rinternals{staff-symbol-interface}.
+
+@funindex \startStaff
+@funindex \stopStaff
+
Modifications to staff properties in the middle of a score can be
placed between @code{\stopStaff} and @code{\startStaff}:
@predefined
-@funindex \startStaff
@code{\startStaff},
-@funindex \stopStaff
@code{\stopStaff}.
@knownissues
-When setting staff lines manually, bar lines are always drawn
-centered on the position 0, so the maximum distance of the bar
-lines in either direction must be equal.
+When setting vertical staff line positions manually, bar lines are
+always centered on position 0, so the maximum distance between the
+outermost bar lines in either direction must be equal.
@node Ossia staves
@node Hiding staves
@unnumberedsubsubsec Hiding staves
-@cindex Frenched scores
+@cindex Frenched score
+@cindex Frenched staff
@cindex staff, hiding
@cindex staff, empty
@cindex hiding of staves
@cindex empty staves
-@cindex Frenched staves
-In orchestral scores, staff lines that only have rests are usually
-removed in order to save some space. This style is called
-@q{French Score}. For the @code{Lyrics}, @code{ChordNames}, and
-@code{FiguredBass} contexts, this is switched on by default.
+Staff lines can be hidden by removing the
+@code{Staff_symbol_engraver} from the @code{Staff} context. As an
+alternative, @code{\stopStaff} may be used.
-For other staff contexts, this behavior is set with the
-@code{\RemoveEmptyStaffContext} command. It is set in the
-@code{\layout} block. As a result, empty staves or staves
-containing multi-measure rests are removed after a line break.
+@lilypond[verbatim,quote]
+\new Staff \with {
+ \remove "Staff_symbol_engraver"
+}
+\relative c''' { a8 f e16 d c b a2 }
+@end lilypond
+
+@funindex \RemoveEmptyStaffContext
+
+Empty staves can be hidden by setting the
+@code{\RemoveEmptyStaffContext} command in the @code{\layout}
+block. In orchestral scores, this style is known as @q{Frenched
+Score}. By default, this command hides all empty staves in a
+score except for those in the first system.
+
+@warning{An empty staff may only include multi-measure rests,
+skips, spacer rests, or a combination of these.}
@lilypond[verbatim,quote,ragged-right]
\layout {
\RemoveEmptyStaffContext
}
}
-\relative c'' {
- <<
- \new Staff { e4 f g a \break c1 }
- \new Staff { c4 d e f \break R1 }
- >>
-}
+\relative c' <<
+ \new Staff {
+ e4 f g a \break
+ b1 \break
+ a4 b c2
+ }
+ \new Staff {
+ c,4 d e f \break
+ R1 \break
+ f4 g c,2
+ }
+>>
@end lilypond
-To remove other types of contexts, use
-@code{\AncientRemoveEmptyStaffContext} or
-@code{\RemoveEmptyRhythmicStaffContext}.
-
@cindex ossia
-Another application of @code{\RemoveEmptyStaffContext} is to make
-ossia sections, i.e., alternative melodies on a separate piece of
-staff, with help of a Frenched staff. For details, see
-@ref{Ossia staves}.
-
-Staff lines can be made invisible by removing the
-@code{Staff_symbol_engraver} from the @code{Staff} context:
-
-@lilypond[verbatim,quote]
-\new Staff \with {
- \remove "Staff_symbol_engraver"
-}
-\relative c'' { c8 c c16 c c c c2 }
-@end lilypond
-
+@code{\RemoveEmptyStaffContext} can also be used to create ossia
+sections for a staff. For details, see @ref{Ossia staves}.
-@snippets
+@cindex hiding ancient staves
+@cindex hiding rhythmic staves
+@funindex \AncientRemoveEmptyStaffContext
+@funindex \RemoveEmptyRhythmicStaffContext
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{removing-the-first-empty-line.ly}
+The @code{\AncientRemoveEmptyStaffContext} command may be used to
+hide empty staves in ancient music contexts. Similarly,
+@code{\RemoveEmptyRhythmicStaffContext} may be used to hide empty
+@code{RhythmicStaff} contexts.
@predefined
-@funindex \RemoveEmptyStaffContext
@code{\RemoveEmptyStaffContext},
-@funindex \AncientRemoveEmptyStaffContext
@code{\AncientRemoveEmptyStaffContext},
-@funindex \RemoveEmptyRhythmicStaffContext
@code{\RemoveEmptyRhythmicStaffContext}.
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{removing-the-first-empty-line.ly}
+
+
@seealso
+Music Glossary:
+@rglos{Frenched staff}.
+
Notation Reference:
@ref{Staff symbol},
@ref{Ossia staves}.
@cindex metronome marking with text
@funindex \tempo
-Basic metronome markings can be entered as follows:
+A basic metronome mark is simple to write:
-@lilypond[verbatim,quote,relative=2]
-\tempo 2 = 120
-c1
+@lilypond[verbatim,quote,relative=1]
+\tempo 4 = 120
+c2 d
+e4. d8 c2
@end lilypond
-Textual tempo indications can be used instead:
+Tempo indications with text can be used instead:
@lilypond[verbatim,quote,relative=2]
\tempo "Allegretto"
-d2 c
+c4 e d c
+b4. a16 b c4 r4
@end lilypond
-The combination of a metronome marking and textual description
-will automatically place the metronome marking within parentheses:
+Combining a metronome mark and text will automatically place the
+metronome mark within parentheses:
@lilypond[verbatim,quote,relative=2]
\tempo "Allegro" 4 = 160
g4 c d e
+d4 b g2
@end lilypond
-To write a metronome marking in parentheses without the text,
-include an empty string in the input:
+In general, the text can be any markup object:
+
+@lilypond[verbatim,quote,relative=2]
+\tempo \markup { \italic Faster } 4 = 132
+a8-. r8 b-. r gis-. r a-. r
+@end lilypond
+
+A parenthesized metronome mark with no textual indication may be
+written by including an empty string in the input:
@lilypond[verbatim,quote,relative=2]
\tempo "" 8 = 96
@lilypond[verbatim,quote,ragged-right,relative=1]
\set Staff.instrumentName = "Violin "
\set Staff.shortInstrumentName = "Vln "
-c1
+c4.. g'16 c4.. g'16
\break
-c''1
+c1
@end lilypond
Markup mode can be used to create more complicated instrument
\set Staff.instrumentName = \markup {
\column { "Clarinetti"
\line { "in B" \smaller \flat } } }
-c1
+c4 c,16 d e f g2
@end lilypond
@cindex instrument names, centering
@lilypond[verbatim,quote,relative=2]
<<
+ \new Staff {
+ \set Staff.instrumentName = "Flute"
+ f2 g4 f
+ }
\new Staff {
\set Staff.instrumentName = \markup \center-column {
Clarinetti
\line { "in B" \smaller \flat }
}
- c1
- }
- \new Staff {
- \set Staff.instrumentName = "Vibraphone"
- c1
+ c4 b c2
}
>>
@end lilypond
@cindex indent
@cindex short-indent
-The @code{indent} and @code{short-indent} settings specify the
-level of indentation for the first system and all succeeding
-systems, respectively. They can be modified in the @code{\layout}
-block. For longer instrument names or short instrument names, it
-may be useful to increase the @code{indent} and
-@code{short-indent} settings:
-
-@lilypond[verbatim,quote]
-\relative c' <<
- \new Staff \with {
- instrumentName = "Oboe"
- }
- { c2 d }
- \new Staff \with {
- instrumentName = "Glockenspiel"
- }
- { c'2 d }
->>
+However, if the instrument names are longer, the instrument names
+in a staff group may not be centered unless the @code{indent} and
+@code{short-indent} settings are increased. The @code{indent} and
+@code{short-indent} settings are modified in the @code{\layout}
+block and specify the level of indentation for the first system
+and all succeeding systems, respectively.
+@lilypond[verbatim,quote,ragged-right]
\layout {
indent = 2.5\cm
+ short-indent = 1.5\cm
}
+
+\relative c'' <<
+ \new Staff {
+ \set Staff.instrumentName = "Flute"
+ \set Staff.shortInstrumentName = "Fl."
+ f2 g4 f \break
+ g4 f g2
+ }
+ \new Staff {
+ \set Staff.instrumentName = "Clarinet"
+ \set Staff.shortInstrumentName = "Clar."
+ c,4 b c2 \break
+ c2 b4 c
+ }
+>>
@end lilypond
To add instrument names to other contexts (such as
@end lilypond
-@snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{aligning-and-centering-instrument-names.ly}
-
-
@seealso
Notation Reference:
implicitly, and occurs simultaneously with @var{music}, which
creates a polyphonic situation. The @var{voice} argument
determines whether the cue notes should be notated as a first or
-second voice; @code{DOWN} corresponds to the first voice, and
-@code{UP} corresponds to the second.
+second voice; @code{UP} corresponds to the first voice, and
+@code{DOWN} corresponds to the second.
@lilypond[verbatim,quote]
oboe = \relative c'' {
explicitly declared, or else the entire music expression would
belong to the @code{CueVoice} context.
-@c TODO document \killCues
-@c TODO document instrumentCueName context property
+The name of the cued instrument can be printed by setting the
+@code{instrumentCueName} property.
+
+@lilypond[verbatim,quote]
+oboe = \relative c''' {
+ g4 r8 e16 f e4 d
+}
+\addQuote oboe { \oboe }
+
+\new Staff \relative c'' <<
+ \new CueVoice \with {
+ instrumentCueName = "ob."
+ }
+ \new Voice {
+ \cueDuring #"oboe" #UP { R1 }
+ g4. b8 d2
+ }
+>>
+@end lilypond
+
+The @code{\killCues} command is used to remove the cue notes from
+a music expression.
+
+@lilypond[verbatim,quote]
+flute = \relative c''' {
+ r2 cis2 r2 dis2
+}
+\addQuote flute { \flute }
+
+\new Voice \relative c'' {
+ \killCues {
+ \cueDuring #"flute" #UP { R1 }
+ g4. b8 d2
+ }
+}
+@end lilypond
When typesetting cue notes, some guidelines should be followed:
@end itemize
The @code{\transposedCueDuring} command is useful to add cues for
-instruments in a completely different register. Having piccolo
-cues within a contrabassoon part is a good example.
+instruments in a completely different register. The syntax is
+similar to @code{\cueDuring}, but it requires one more argument to
+specify the transposition of the cued instrument. For more
+information about transposition, see
+@ref{Instrument transpositions}.
@lilypond[verbatim,quote]
piccolo = \relative c''' {
@seealso
+Notation Reference:
+@ref{Instrument transpositions}.
+
Snippets:
@rlsr{Staff notation}.
Internals Reference:
+@rinternals{CueVoice},
@rinternals{Voice}.
doc:
$(MAKE) -C Documentation
+install-help2man:
+ $(MAKE) -C scripts man install-help2man
+ $(MAKE) -C lily man install-help2man
+
+# All web targets, except info image symlinks and info docs are
+# installed in non-recursing target from TOP-SRC-DIR
install-WWW:
-$(INSTALL) -m 755 -d $(DESTDIR)$(webdir)
rsync -rl $(outdir)/offline-root/ $(DESTDIR)$(webdir)
- $(MAKE) -C Documentation/user local-install-WWW
$(MAKE) -C Documentation/user install-info
$(MAKE) -C input/lsr install-info
-install-help2man:
- $(MAKE) -C scripts man install-help2man
- $(MAKE) -C lily man install-help2man
-
web-install:
$(MAKE) out=www install-WWW
uninstall-WWW:
- echo TODO
+ rm -rf $(DESTDIR)$(webdir)
+ -rmdir $(package_docdir)
+ $(MAKE) -C Documentation/user uninstall
+ $(MAKE) -C input/lsr uninstall
web-uninstall:
$(MAKE) out=www uninstall-WWW
--- /dev/null
+\version "2.11.57"
+\header {
+
+ texidoc = "Autobeaming will break beams according to beatGrouping
+if the total length of the beat groups is equal to measureLength.
+Otherwise, it will break beams according to beatLength."
+}
+
+{
+ \time 12/16
+
+ % default beatLength is 1/16; beatGrouping for this time is '()
+ b16 b b b b b b b b b b b % beatlength is used to breatk these beams
+ % use beatGrouping to get 1/8 groups
+ \set Timing.beatGrouping = #'(2 2 2 2 2 2) % 6*2 = 12 so beatGrouping applies
+ b16 b b b b b b b b b b b % beam groups are 1/8
+ % use beatLength to get 1/8 groups -- beatGrouping no longer applies
+ \set Score.beatLength = #(ly:make-moment 2 16 ) % 12*2/16 = 24/16
+ % bad beatGrouping; use
+ % beatLength (1/8 notes)
+ b16 b b b b b b b b b b b
+ % make custom beatGrouping
+ \set Timing.beatGrouping = #'(3 1 2) % 6*2/16 = 12/16
+ b16 b b b b b b b b b b b
+ % change beatLength
+ \set Score.beatLength = #(ly:make-moment 3 16 ) % 6*3/16 = 18/16; use beatLength
+ b16 b b b b b b b b b b b
+ \set Score.beatLength = #(ly:make-moment 4 16 ) % 6*4/16 = 24/16; use beatLength
+ b16 b b b b b b b b b b b
+}
--- /dev/null
+\version "2.11.57"
+
+\header {
+ texidoc = "String numbers should only be moved outside slurs when there
+is a collision."
+}
+
+\relative c'' {
+ \textLengthOn
+ <c\3>4-"inside"( d' <e,\2>-"inside" g
+ <c\1>1-"outside")
+}
Stencil *s = unsmob_stencil (stil);
LY_ASSERT_SMOB (Stencil, stil, 1);
LY_ASSERT_TYPE (scm_is_number, angle, 2);
- LY_ASSERT_TYPE (scm_is_number, x,3);
+ LY_ASSERT_TYPE (scm_is_number, x, 3);
LY_ASSERT_TYPE (scm_is_number, y, 4);
Real a = scm_to_double (angle);
Real x_off = scm_to_double (x);
-ddump-signatures \
-danti-alias-factor=$(ANTI_ALIAS_FACTOR)
+ifdef QUIET_BUILD
+LILYPOND_BOOK_VERBOSE =
+else
LILYPOND_BOOK_VERBOSE = --verbose
+endif
+
LILYPOND_BOOK_INFO_IMAGES_DIR = $(if $(INFO_IMAGES_DIR),--info-images-dir=$(INFO_IMAGES_DIR),)
LILYPOND_BOOK_FLAGS = $(LILYPOND_BOOK_VERBOSE) $(LILYPOND_BOOK_INFO_IMAGES_DIR)
;; 2. end * * *
;; 3. end <type> <num> <den>
;; 4. end * <num> <den>
-;; 5. if 1-4 not specified: begin anywhere, end at every beat
+;; 5. if 1-4 not specified, begin anywhere, end at time determined by
+;; beatGrouping and beatLength:
+;; if beatGrouping and beatLength are consistent with measureLength,
+;; use beatGrouping to determine end of beams.
+;; if beatGrouping and beatLength are inconsistent with measureLength,
+;; use beatLength to determine end of beams.
;;
;; Rationale:
;;
;; 4. exceptions for specific time signature
;; 5. easy catch-all rule for non-specified measure types
+
(define-public (default-auto-beam-check context dir test)
(define (get name default)
(let ((value (ly:context-property context name)))
(if (not (null? value)) value default)))
+ (define (ending-moments group-list start-beat beat-length)
+ (if (null? group-list)
+ '()
+ (let ((new-start (+ start-beat (car group-list))))
+ (cons (ly:moment-mul (ly:make-moment new-start 1) beat-length)
+ (ending-moments (cdr group-list) new-start beat-length)))))
+
+ (define (make-end-settings time ending-list moment-den)
+ (if (null? ending-list)
+ '()
+ (cons (cons (append '(end * *) time)
+ (ly:make-moment (car ending-list) moment-den))
+ (make-end-settings time (cdr ending-list) moment-den))))
+
;; Don't start auto beams on grace notes
(if (and (!= (ly:moment-grace-numerator (ly:context-now context)) 0)
(= dir START))
#f
- (let* ((beat-length (get 'beatLength (ly:make-moment 1 1)))
+ (let* ((beat-length (get 'beatLength (ly:make-moment 1 4)))
(measure-length (get 'measureLength (ly:make-moment 1 1)))
(measure-pos (get 'measurePosition ZERO-MOMENT))
+ (beat-grouping (get 'beatGrouping '()))
(settings (get 'autoBeamSettings '()))
(function (list (if (= dir START) 'begin 'end)))
+ ;; Calculate implied time signature based on measureLength
+ ;; and beatLength for default value in get
(num-mom (ly:moment-div measure-length beat-length))
(num (inexact->exact
(round (/ (ly:moment-main-numerator num-mom)
(ly:moment-main-denominator num-mom)))))
(den (ly:moment-main-denominator beat-length))
- (time (list num den))
+ (time-signature-fraction
+ (get 'timeSignatureFraction (cons num den)))
+ (time (list (car time-signature-fraction)
+ (cdr time-signature-fraction)))
(type (list (ly:moment-main-numerator test)
(ly:moment-main-denominator test)))
(pos (if (>= (ly:moment-main-numerator measure-pos) 0)
measure-pos
(ly:moment-add measure-length measure-pos)))
- (lst (list
+ (grouping-moments (ending-moments beat-grouping 0 beat-length))
+ ;; Calculate implied measure length from beatGrouping
+ ;; and beatLength
+ (grouping-length (if (null? grouping-moments)
+ ZERO-MOMENT
+ (list-ref grouping-moments
+ (1- (length grouping-moments)))))
+ (lst (list
;; Hmm, should junk user-override feature,
;; or split this in user-override and config section?
(append function type '(* *))
(append function '(* * * *))
(append function type time)
- (append function '(* *) time))))
-
- (if (or
+ (append function '(* *) time)))
+ (predefined-setting (first-assoc lst settings)))
+ (if (or
;; always begin or end beams at beginning/ending of measure
(= (ly:moment-main-numerator pos) 0)
(first-member (map (lambda (x) (cons x pos)) lst) settings))
(if (= dir START)
;; if no entry matches our function + time or type,
;; start anywhere
- (not (first-assoc lst settings))
- ;; if no entry matches our function + time or type,
- ;; end at any beat
- (and (not (first-assoc lst settings))
- (= (ly:moment-main-denominator
- (ly:moment-div pos beat-length)) 1)))))))
+ (not predefined-setting)
+ ;; if entry matches our function + time or type, check moment
+ (if predefined-setting
+ (equal? measure-pos (cdr predefined-setting))
+ ;; if measure-length matches grouping-length, use
+ ;; grouping moments, else use beat-length
+ (if (equal? measure-length grouping-length)
+ (member measure-pos grouping-moments)
+ (= (ly:moment-main-denominator
+ (ly:moment-div pos beat-length)) 1))))))))
(self-alignment-X . ,CENTER)
(self-alignment-Y . ,CENTER)
(script-priority . 100)
- (avoid-slur . outside)
+ (avoid-slur . around)
(font-encoding . fetaNumber)
(font-size . -5) ; don't overlap when next to heads.
(meta . ((class . Item)
AC_DEFUN(STEPMAKE_TEXMF, [
STEPMAKE_PROGS(METAFONT, mf-nowin mf mfw mfont, $1)
+ STEPMAKE_PROGS(METAPOST, mpost, $1)
# STEPMAKE_PROGS(INIMETAFONT, inimf inimfont "$METAFONT -ini", $1)
AC_MSG_CHECKING(for working metafont mode)
exe update all executables\n\
help this help\n\
install * install programs and data (prefix=$(prefix))\n\
+ uninstall* uninstall programs and data\n\
lib update all libraries\n\
web * update website in directory \`out-www'\n\
web-install * install website documentation in (webdir=$(webdir))\n\
$(MAKE) out=www WWW-1
web-clean:
- find -name out-www | xargs rm -rf
$(MAKE) out=www clean
rm $(basename $<).*gf
$(outdir)/%.tfm $(outdir)/%.log: %.mf
- MFINPUTS=$(src-dir) $(METAFONT) "\mode:=$(MFMODE); nonstopmode; input $<;"
+ MFINPUTS=$(src-dir) $(METAFONT) "\mode:=$(MFMODE); nonstopmode; input $<;" $(METAFONT_QUIET)
# Let's keep this log output, it saves another mf run.
mv $(basename $(@F)).log $(basename $(@F)).tfm $(outdir)
rm -f $(basename $(@F)).*gf $(basename $(@F)).*pk
TMP=`mktemp -d $(outdir)/pfbtemp.XXXXXXXXX` \
&& ( cd $$TMP \
&& ln -s ../mf2pt1.mem . \
- && MFINPUTS=$(top-src-dir)/mf:..:: $(PERL) $(top-src-dir)/buildscripts/mf2pt1.pl $(MF2PT1_OPTIONS) $< ) \
+ && MFINPUTS=$(top-src-dir)/mf:..:: $(PERL) $(top-src-dir)/buildscripts/mf2pt1.pl $(MF2PT1_OPTIONS) $< $(METAFONT_QUIET)) \
&& mv $$TMP/*pfb $(outdir); \
rm -rf $$TMP
--family=$(notdir $(<:%.mf=%)) \
--fullname=$(notdir $(<:%.mf=%)) \
--name=$(notdir $(<:%.mf=%))
+
+ifdef QUIET_BUILD
+METAFONT_QUIET = >/dev/null
+else
+METAFONT_QUIET =
+endif
# prerequisite, otherwise %.info are always outdated (because older
# than $(outdir), hence this .dep file
-$(outdir)/$(INFO_IMAGES_DIR).info-images-dir.dep: $(INFO_DOCS:%=$(outdir)/%.texi)
+$(outdir)/$(INFO_IMAGES_DIR).info-images-dir-dep: $(INFO_DOCS:%=$(outdir)/%.texi)
ifneq ($(INFO_IMAGES_DIR),)
rm -f $(INFO_IMAGES_DIR)
ln -s $(outdir) $(INFO_IMAGES_DIR)
endif
touch $@
-$(outdir)/%.info: $(outdir)/%.texi $(outdir)/$(INFO_IMAGES_DIR).info-images-dir.dep $(outdir)/version.itexi
+$(outdir)/%.info: $(outdir)/%.texi $(outdir)/$(INFO_IMAGES_DIR).info-images-dir-dep $(outdir)/version.itexi
$(MAKEINFO) -I$(outdir) --output=$@ $<
$(outdir)/%-big-page.html: $(outdir)/%.texi $(XREF_MAPS_DIR)/%.xref-map $(outdir)/version.itexi
echo $(TOPLEVEL_VERSION)>> $@
echo '@end macro'>> $@
-.SECONDARY: $(outdir)/version.itexi $(outdir)/version.texi
+.SECONDARY: $(outdir)/version.itexi $(outdir)/version.texi \
+ $(outdir)/$(INFO_IMAGES_DIR).info-images-dir-dep
# This builds all .info targets with images, in out-www.
# Viewable with a recent Emacs, doing: C-u C-h i out-www/lilypond.info
-local-install-info: info
- -$(INSTALL) -d $(DESTDIR)$(infodir)
ifneq ($(patsubst %/local,%,$(DESTDIR)$(prefix)),/usr)
## Can not have absolute symlinks because some binary packages build schemes
## install files in nonstandard root. Best we can do is to notify the
## builder or packager.
+local-install-info: info
+ -$(INSTALL) -d $(DESTDIR)$(infodir)
@echo
@echo "***************************************************************"
@echo "Please add or update the LilyPond direntries, do"
@echo " (cd $(infodir) && ln -sfT ../doc/lilypond/html/$(DEST_INFO_IMAGES_SUBDIR) $(INFO_IMAGES_DIR))"
@echo "or add something like that to the postinstall script."
@echo
+
+local-uninstall-info:
+ -rmdir $(DESTDIR)$(infodir)
+
else # installing directly into standard /usr/...
+local-install-info: info
-$(INSTALL) -d $(DESTDIR)$(infodir)
$(foreach f,$(INFO_FILES),install-info --remove --info-dir=$(infodir) $(f) ; )true
install-info --info-dir=$(infodir) $(outdir)/$(MAIN_INFO_DOC).info
cd $(infodir) && ln -sfT $(webdir)/$(DEST_INFO_IMAGES_SUBDIR) $(INFO_IMAGES_DIR)
-endif # installing directly into standard /usr/...
-local-uninstall-WWW:
+local-uninstall-info:
+ $(foreach f,$(INFO_FILES),install-info --remove --info-dir=$(infodir) $(f) ; )true
rm -f $(infodir)/$(INFO_IMAGES_DIR)
+endif # installing directly into standard /usr/...
+
else # out!=www
ifneq ($(patsubst %/local,%,$(DESTDIR)$(prefix)),/usr)
## install files in nonstandard root. Best we can do is to notify the
## builder or packager.
local-install-info: info
- -$(INSTALL) -d $(DESTDIR)$(package_infodir)
+ -$(INSTALL) -d $(DESTDIR)$(infodir)
@echo
@echo "***************************************************************"
@echo "Please add or update the LilyPond direntries, do"
@echo
local-uninstall-info:
- -rmdir $(DESTDIR)$(package_infodir)
+ -rmdir $(DESTDIR)$(infodir)
else # installing directly into standard /usr/...
local-install-info: info
- -$(INSTALL) -d $(DESTDIR)$(package_infodir)
-$(INSTALL) -d $(DESTDIR)$(infodir)
$(foreach f,$(INFO_FILES),install-info --remove --info-dir=$(infodir) $(f) ; )true
install-info --info-dir=$(infodir) $(outdir)/$(MAIN_INFO_DOC).info
local-uninstall-info:
$(foreach f,$(INFO_FILES),install-info --remove --info-dir=$(infodir) $(f) ; )true
- -rmdir $(DESTDIR)$(infodir)
- -rmdir $(DESTDIR)$(package_infodir)
endif # installing into standard /usr/* root
TEXI2HTML_INIT = --init-file=$(top-src-dir)/lilypond-texi2html.init
TEXI2HTML = $(TEXI2HTML_PROGRAM) $(TEXI2HTML_FLAGS) $(TEXI2HTML_LANG)
+ifdef QUIET_BUILD
TEXI2PDF_FLAGS += -q
+endif
# info stuff
INFO_INSTALL_FILES = $(wildcard $(addsuffix *, $(INFO_FILES)))
local-help:
@echo -e "\
+ web-uninstall remove installed documentation with images\n\
config rerun configure\n\
dist roll tarball: $(depth)/$(outdir)/$(distname).tar.gz\n\
distclean also remove configure output\n\
projects / lilypond.git / commitdiff