},
+aber fügt anstelle der LilyPond-Datei eine MusicXML-Datei ein.
+
+Eine Liste der Optionen, die man mit @code{lilypond} oder @code{lilypondfile}
+benutzen kann, siehe @ref{Die Musikfragment-Optionen}
+
Zusätzlich gibt @code{} die aktuelle Versionsnummer
von LilyPond aus.
@@ -503,8 +597,8 @@ von LilyPond aus.
@translationof DocBook
-Bei der Einbindung von Musik im LilyPond-Format in DocBook soll die
-Konformität unseres DocBook Dokuments erhalten bleiben und damit
+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
@@ -512,19 +606,19 @@ vorgegebenen Konventionen entsprechend benützt.
@subheading Definitionen
-Für die Einbindung von LilyPond Code werden in allen Fällen die
+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
+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
+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 Eine LilyPond-Datei einfügen
-Dies ist der einfachste Fall: Die LilyPond-Datei besitzt die Erweiterung
+Dies ist der einfachste Fall: Die LilyPond-Datei besitzt die Erweiterung
@file{.ly} und wird einfach als @code{imageobject} eingebettet:
@example
@@ -535,12 +629,12 @@ Dies ist der einfachste Fall: Die LilyPond-Datei besitzt die Erweiterung
@end example
-Für das äuÃerste Element kann je nach Bedarf @code{mediaobject} oder
+Für das äuÃerste Element kann je nach Bedarf @code{mediaobject} oder
@code{inlinemediaobject} benutzt werden.
@subheading LilyPond-Code einfügen
-Die Einbindung von LilyPond-Code direkt in der DocBook-Datei ist
+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:
@@ -558,7 +652,7 @@ wobei die Sprache auf @code{lilypond} gesetzt wird:
@end example
Das äuÃerste Element ist also @code{mediaobject} oder
-@code{inlinemediaobject}, welches ein @code{textobject} mit dem
+@code{inlinemediaobject}, welches ein @code{textobject} mit dem
@code{programlisting} enthält.
@subheading Ein DocBook-Dokument übersetzen
@@ -567,7 +661,7 @@ 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
+automatisch eine PDF-Datei erzeugt. Für die Erzeugung von HTML (HTML
Hilfe, JavaHelp, etc.) können die offiziellen DocBook XSL-Stylesheets
benutzt werden. Eventuell müssen dafür allerdings kleinere Anpassungen
vorgenommen werden.
@@ -577,17 +671,17 @@ vorgenommen werden.
@section Die Musikfragment-Optionen
@translationof Music fragment options
-Im Folgenden meint @q{LilyPond-Kommando} ein beliebiges in den vorgehenden
-Abschnitten beschriebenes Kommando, welches ein LilyPond-Fragment in eine Datei
+Im Folgenden meint @q{LilyPond-Befehl} einen beliebigen in den vorgehenden
+Abschnitten beschriebenen Befehl, der ein LilyPond-Fragment in eine Datei
einfügt und von @command{lilypond-book} verarbeitet wird. Der Einfachheit
-halber werden hier alle LilyPond-Kommandos in der Syntax von @LaTeX{}
+halber werden hier alle LilyPond-Befehle in der Syntax von @LaTeX{}
dargestellt.
-Zu beachten ist, dass die Optionen eines LilyPond-Kommandos von links
+Zu beachten ist, dass die Optionen eines LilyPond-Befehls von links
nach rechts verarbeitet werden. Wenn eine Option also mehrfach angegeben
wird, wird nur die letzte benutzt.
-Die folgenden Optionen können für LilyPond-Kommandos benutzt werden:
+Die folgenden Optionen können für LilyPond-Befehle benutzt werden:
@table @code
@item staffsize=@var{ht}
@@ -595,12 +689,10 @@ Setzt die Höhe einer Notenzeile auf @var{ht}, angegeben in Punkten.
@item ragged-right
Erzeugt Notenzeilen im Flattersatz mit natürlichem Abstand der Noten. In
-anderen Worten: @code{ragged-right = ##t} wird in das Musikfragment
-eingefügt. Dies ist die Standardeinstellung für das @code{\lilypond@{@}}
-Kommando, wenn die Option @code{line-width} nicht angegeben wird.
-Ebenso ist dies die Standardeinstellung für die @code{lilypond}-Umgebung,
-wenn die Option @code{fragment}, aber keine Zeilenlänge
-explizit angegeben ist.
+anderen Worten: @code{ragged-right = ##t} wird in das Musikfragment
+eingefügt. Einzeilige Fragmentschnipsel werden standardmäÃig immer
+im Flattersatz gesetzt, auÃer @code{noragged-right} wird explizit
+angegeben.
@item noragged-right
Streckt Musikfragmente mit nur einer Notenzeile auf die volle Breite,
@@ -610,19 +702,27 @@ es wird also @code{ragged-right = ##f} in das Musikfragment eingefügt.
@itemx line-width=@var{Breite}\@var{Einheit}
Setzt die Breite der Notenzeilen auf @var{Breite}, gemessen in Vielfachen
der @var{Einheit}. Als Einheit können die folgenden Zeichenfolgen angegeben
-werden: @code{cm}, @code{mm}, @code{in} oder @code{pt}. Diese Option hat
+werden: @code{cm}, @code{mm}, @code{in} oder @code{pt}. Diese Option hat
nur Einfluss auf die Breite von Notenzeilen und Text im Musikfragment, nicht
jedoch auf den restlichen Text des Dokuments.
Wird diese Option ohne einen Wert angegeben, wird die Zeilenbreite auf
-einen Standardwert gesetzt, der durch einen heuristischen Algorithmus
+einen Standardwert gesetzt, der durch einen heuristischen Algorithmus
bestimmt wird.
-Wenn die @code{line-width} Option nicht angegeben wird, versucht
-@command{lilypond-book} einen geeigneten Standardwert für alle
-@code{lilypond}-Umgebungen zu finden, die die @code{ragged-right} Option
+Wenn die @code{line-width}-Option nicht angegeben wird, versucht
+@command{lilypond-book} einen geeigneten Standardwert für alle
+@code{lilypond}-Umgebungen zu finden, die die @code{ragged-right}-Option
nicht benutzen.
+@item papersize=@var{Zeichenkette}
+Wobei @var{Zeichenkette} eine PapiergröÃe wie definiert in @file{scm/paper.scm}
+ist, beispielsweise @code{a5}, @code{quarto}, @code{11x17} usw.
+
+Werte, die nicht in @file{scm/paper.scm} definiert sind, werden ignoriert,
+eine Warnung wird ausgegeben und das Schnipsel wird mit dem Standardwert
+@code{a4} ausgegeben.
+
@item notime
Verhindert die Ausgabe der Taktangabe am Anfang des Fragments und schaltet
Taktstriche und alle Taktangaben im Fragment ab.
@@ -645,14 +745,14 @@ die Standardeinstellung, insofern ist diese Option im Normalfall unnötig.
Setzt den Einzug des ersten Notensystems auf @var{Einzug}, gemessen in
Vielfachen der @var{Einheit}. Als Einheit können die folgenden Zeichenfolgen
angegeben werden: @code{cm}, @code{mm}, @code{in} oder @code{pt}. Diese
-Option hat nur Einfluss auf den Einzug von Notenzeilen und Text im
+Option hat nur Einfluss auf den Einzug von Notenzeilen und Text im
Musikfragment, nicht jedoch auf den restlichen Text des Dokuments.
@item noindent
Setzt den Einzug des ersten Notensystems auf 0. Diese
-Option hat nur Einfluss auf den Einzug von Notenzeilen und Text im
-Musikfragment, nicht jedoch auf den restlichen Text des Dokuments. Dies
-ist die Standardeinstellung, insofern ist diese Option im Normalfall
+Option hat nur Einfluss auf den Einzug von Notenzeilen und Text im
+Musikfragment, nicht jedoch auf den restlichen Text des Dokuments. Dies
+ist die Standardeinstellung, insofern ist diese Option im Normalfall
unnötig.
@item quote
@@ -667,14 +767,15 @@ Option eingerückt wird.
@item relative
@itemx relative=@var{n}
Benutzt relative Oktavenbezeichnungen. StandardmäÃig werden Noten relativ
-zum mittleren C angegeben. Das optionale ganzzahlige Argument
-gibt die Oktave der ersten Note an, wobei die Standardeinstellung von
+zum mittleren C angegeben. Das optionale ganzzahlige Argument
+gibt die Oktave der ersten Note an, wobei die Standardeinstellung von
@code{1} das mittlere C bedeutet. Die @code{relative} Option macht nur
Sinn in Verbindung mit der @code{fragment} Option, weshalb @code{fragment}
-automatisch durch die Angabe der @code{relative} Option impliziert wird.
+automatisch durch die Angabe der @code{relative} Option impliziert wird.
Eine explizite Angabe der @code{(no)fragment} Option hat keinen Effekt.
@end table
+
LilyPond benutzt zur Erzeugung seiner eigenen Dokumentation ebenfalls
@command{lilypond-book}. Zu diesem Zweck stehen noch zahlreiche
spezialisierte Optionen zur Verfügung:
@@ -683,22 +784,22 @@ spezialisierte Optionen zur Verfügung:
@item verbatim
Der LilyPond-Code im LilyPond-Kommando wird zum einen benutzt, um das
Musikfragment in eine Grafik mit schönem Notensatz zu konvertieren,
-andererseits aber auch wörtlich in das Dokument eingefügt. Dies
-geschieht in einem @q{verbatim}-Block, gefolgt vom Text einer
+andererseits aber auch wörtlich in das Dokument eingefügt. Dies
+geschieht in einem @q{verbatim}-Block, gefolgt vom Text einer
möglicherweise angegebenen @code{intertext} Option@footnote{Die
-@code{intertext} Option ist noch nicht implementiert.} und der
+@code{intertext} Option ist noch nicht implementiert.} und der
Grafik des tatsächlichen Notensatzes. Diese Option funktioniert nur
fehlerhaft, wenn @code{\lilypond@{@}} im FlieÃtext benutzt wird.
Wird @code{verbatim} in Verbindung mit einem @code{lilypondfile}-Kommando
-benutzt, so ist es auch möglich, nur ein Teil der Datei wörtlich einfügen
+benutzt, so ist es auch möglich, nur ein Teil der Datei wörtlich einfügen
zu lassen: Wenn die eingebundene LilyPond-Datei ein Kommentar mit dem Inhalt
-@samp{begin verbatim} (ohne Anführungszeichen) enthält, wird nur der
+@samp{begin verbatim} (ohne Anführungszeichen) enthält, wird nur der
Dateiinhalt ab dieser Position eingefügt. Enthält die Datei mehrere
solche Kommentare, wirkt nur das letzte. Analog wird nur der Dateiinhalt
-bis zu einem etwaigen Kommentar mit dem Inhalt @samp{end verbatim}
-eingefügt. Im folgenden Beispiel wird das gesamte Musik für die
-Erzeugung der Grafik im relativen Oktavenmodus interpretiert, der
+bis zu einem etwaigen Kommentar mit dem Inhalt @samp{end verbatim}
+eingefügt. Im folgenden Beispiel wird das gesamte Musik für die
+Erzeugung der Grafik im relativen Oktavenmodus interpretiert, der
wörtlich in das Dokument kopierte LilyPond-Code zeigt den @code{relative}-Befehl jedoch nicht.
@example
@@ -729,16 +830,17 @@ einen Baum an @file{.mo}-Nachrichtenkatalogen beinhalten mit
@code{verbatim}.
@item texidoc
-(Nur innerhalb von Texinfo-Dateien.) Wird @command{lilypond} mit der
+(Nur innerhalb von Texinfo-Dateien.) Wird @command{lilypond} mit der
Kommandozeilenoption @option{--header=@/texidoc} für eine Datei
-@file{foo@/.ly} und enthält die Datei ein @code{texidoc}-Feld im
-@code{\header}-Block, so wird dessen Inhalt in die Datei
-@file{foo@/.texidoc} ausgegeben. Die @code{texidoc} Option veranlasst
-@code{lilypond-book}, den Inhalt dieser @file{.texidoc} Dateien innerhalb
-eines Dokumentationsblocks direkt vor dem Musikfragment in das aktuelle
-Dokument einzufügen.
+@file{foo.ly} und enthält die Datei ein @code{texidoc}-Feld im
+@code{\header}-Block, so wird dessen Inhalt in die Datei
+@file{foo.texidoc} ausgegeben. Die @code{texidoc} Option veranlasst
+@code{lilypond-book}, den Inhalt dieser @file{.texidoc} Dateien innerhalb
+eines Dokumentationsblocks direkt vor dem Musikfragment in das aktuelle
+Dokument einzufügen (aber auÃerhalb der @code{example}-Umgebung, die durch
+die Option @code{quote} hervorgerufen wird).
-Enthält also die Datei @file{foo@/.ly} etwa den LilyPond-Code
+Enthält also die Datei @file{foo.ly} etwa den LilyPond-Code
@example
\header @{
@@ -766,26 +868,23 @@ lilypond-book --pdf --process="lilypond \
Die meisten Test-Dateien (im @file{input/} Verzeichnis von LilyPond)
sind kleine @file{.ly} Dateien von genau dieser Form.
-Auch die Ãbersetzung dieser zusätzlichen Kommentare ist möglich:
+Auch die Ãbersetzung dieser zusätzlichen Kommentare ist möglich:
Dazu muss das Texinfo-Dokument den Befehl @code{@@documentlanguage @var{LANG}}
-und der @code{\header} Block in der Datei @file{foo@/.ly}
-die Ãbersetzung im Feld @code{texidoc@var{LANG}} enthalten. Wird nun
+und der @code{\header} Block in der Datei @file{foo.ly}
+die Ãbersetzung im Feld @code{texidoc@var{LANG}} enthalten. Wird nun
@command{lilypond} mit der Option @option{--header=@/texidoc@var{LANG}}
-aufgerufen, so wird der Inhalt der Datei @file{foo@/.texidoc@var{LANG}} anstelle von @file{foo@/.texidoc} eingefügt.
-
-@item lilyquote
-(Nur innerhalb von Texinfo-Dateien.) Diese Option wirkt wie die @code{quote} Option, auÃer dass nur das Musikfragment (und natürlich optional der
-gesamte LilyPond-Code bei Benutzung von @code{verbatim}) in den Zitatblock eingefügt wird. Dies ist nützlich, wenn Sie ein Musikfragment zitieren möchten, nicht aber dessen @code{texidoc} Dokumentationsblock.
+aufgerufen, so wird der Inhalt der Datei @file{foo.texidoc@var{LANG}}
+anstelle von @file{foo.texidoc} eingefügt.
@item doctitle
(Nur innerhalb von Texinfo-Dateien.) Diese Option wirkt ähnlich wie die
-@code{texidoc} Option: Wenn @command{lilypond} mit der Option
-@option{--header=@/doctitle} aufgerufen wird und die Eingabedatei
-@file{foo@/.ly} ein Feld @code{doctitle} im @code{\header}-Block enthält,
-wird dessen Wert in die Datei @file{foo@/.doctitle} geschrieben. Wird die
-@code{doctitle} Option für ein Musikfragment benutzt, so wird der Inhalt
-dieser Datei, der eine einzelne Textzeile sein sollte, im Texinfo-Dokument
-als @code{@@lydoctitle @var{Text}} eingefügt. @code{@@lydoctitle} muss
+@code{texidoc} Option: Wenn @command{lilypond} mit der Option
+@option{--header=@/doctitle} aufgerufen wird und die Eingabedatei
+@file{foo.ly} ein Feld @code{doctitle} im @code{\header}-Block enthält,
+wird dessen Wert in die Datei @file{foo.doctitle} geschrieben. Wird die
+@code{doctitle} Option für ein Musikfragment benutzt, so wird der Inhalt
+dieser Datei, der eine einzelne Textzeile sein sollte, im Texinfo-Dokument
+als @code{@@lydoctitle @var{Text}} eingefügt. @code{@@lydoctitle} muss
allerdings in Ihrem Texinfo-Dokument als Makro selbst definiert werden.
Die Ãbersetzung funktioniert völlig analog zu @code{texidoc}.
@@ -795,7 +894,7 @@ zitierten Quelltext des Schnipsel werden nicht übersetzt.
@item printfilename
Wenn eine LilyPond-Datei mittels @code{\lilypondfile} und dieser Option
-eingebunden wird, wird der Dateiname (ohne die Pfadangabe) unmittelbar vor
+eingebunden wird, wird der Dateiname (ohne die Pfadangabe) unmittelbar vor
dem Musikfragment ausgegeben. In HTML-Dateien ist er auÃerdem ein Link
auf die LilyPond-Datei. Nur der eigentliche Name der Datei wird
ausgegeben, der Pfad wird also nicht mit angezeigt.
@@ -807,10 +906,10 @@ ausgegeben, der Pfad wird also nicht mit angezeigt.
@section @command{lilypond-book} aufrufen
@translationof Invoking lilypond-book
-@command{lilypond-book} erzeugt abhängig vom Ausgabeformat eine Datei mit
-einer der folgenden Dateierweiterungen: @file{.tex}, @file{.texi},
+@command{lilypond-book} erzeugt abhängig vom Ausgabeformat eine Datei mit
+einer der folgenden Dateierweiterungen: @file{.tex}, @file{.texi},
@file{.html} oder @file{.xml}. Alle @file{.tex}, @file{.texi} und
-@file{.xml} Dateien müssen noch mit den entsprechenden Programmen (@LaTeX{},
+@file{.xml} Dateien müssen noch mit den entsprechenden Programmen (@LaTeX{},
DocBook, etc.) weiter verarbeitet werden, um druckfähige Dateien zu erhalten.
@@ -820,17 +919,17 @@ DocBook, etc.) weiter verarbeitet werden, um druckfähige Dateien zu erhalten.
Es existieren zwei Methoden, Ihr @LaTeX{}-Dokument weiter zu verarbeiten,
um zu einer druck- oder publikationsfähigen Datei zu gelangen:
-Zum einen die direkte Erzeugung einer PDF-Datei mit PDF@LaTeX{}, zum
-anderen die Erzeugung einer DVI daraus einer PostScript-Datei mittels
+Zum einen die direkte Erzeugung einer PDF-Datei mit PDF@LaTeX{}, zum
+anderen die Erzeugung einer DVI daraus einer PostScript-Datei mittels
@LaTeX{} und einem DVI-nach-PostScript Konverters wie @command{dvips}.
Die erste Methode ist einfacher und daher empfehlenswert.@footnote{Manchmal
kann eine Datei entweder von PDF@LaTeX{} oder von @LaTeX{} nicht korrekt
verarbeitet werden, weshalb hier beide Methoden beschrieben werden.} Welche
Methode auch immer benutzt wird, die Konvertierung zwischen PostScript und
-PDF kann leicht mit Hilfsprogrammen wie @command{ps2pdf} und @command{pdf2ps}
-(aus dem Ghostscript Paket) erfolgen.
+PDF kann leicht mit Hilfsprogrammen wie @command{ps2pdf} und @command{pdf2ps}
+(aus dem Ghostscript-Paket) erfolgen.
-Um eine PDF-Datei mittels PDF@LaTeX{} zu erzeugen, kann folgendermaÃen
+Um eine PDF-Datei mittels PDF@LaTeX{} zu erzeugen, kann folgendermaÃen
vorgegangen werden:
@example
@@ -842,6 +941,7 @@ pdflatex Ihre_Datei.tex
@cindex Type1 Schriften
@cindex dvips
@cindex Aufruf von dvips
+
Um eine PDF-Datei mittels @LaTeX{}/@command{dvips}/@command{ps2pdf} zu
erhalten, sind folgende Befehle nötig:
@@ -858,20 +958,32 @@ scheint keine Notenköpfe zu enthalten, was in Ordnung ist. Wenn Sie die
Datei wie beschrieben weiter verarbeiten, erscheinen die Notenköpfe korrekt
in den @file{.ps} und @file{.pdf} Dateien.
-Der Aufruf von @command{dvips} kann einige Warnungen über fehlende
+Der Aufruf von @command{dvips} kann einige Warnungen über fehlende
Schriftarten ausgeben. Auch dies ist in Ordnung und kann ignoriert werden.
Wenn Sie in der @LaTeX{}-Datei das Papierformat auf Querformat eingestellt
-haben, vergessen Sie nicht auf die @code{-t landscape} Option beim
+haben, vergessen Sie nicht die @option{-t landscape}-Option beim
Aufruf von @command{dvips}.
+@knownissues
+Der Befehl @code{\pageBreak} funktioniert nicht innerhalb einer
+@code{\begin@{lilypond@} @dots{} \end@{lilypond@}}-Umgebung.
+
+Auch viele Variablen der @code{\paper}-Umgebung funktionieren nicht
+innerhalb einer @code{\begin@{lilypond@} @dots{} \end@{lilypond@}}-Umgebung.
+Benutzen Sie @code{\newcommand} mit @code{\betweenLilyPondSystem}:
+
+@example
+\newcommand@{\betweenLilyPondSystem@}[1]@{\vspace@{36mm@}\linebreak@}
+@end example
+
@subsubheading Texinfo
-Um ein von @command{lilypond-book} erzeugtes Texinfo-Dokument zu
-verarbeiten, gehen Sie wie für alle anderen Texinfo-Dokumente vor:
+Um ein von @command{lilypond-book} erzeugtes Texinfo-Dokument zu
+verarbeiten, gehen Sie wie für alle anderen Texinfo-Dokumente vor:
Rufen Sie -- abhängig vom gewünschten Ausgabeformat -- eines der Programme
-@command{texi2pdf}, @command{texi2dvi}, @command{makeinfo} oder
+@command{texi2pdf}, @command{texi2dvi}, @command{makeinfo} oder
@command{texi2html} auf.
@ifinfo
@@ -890,9 +1002,9 @@ Die Dokumentation von Texinfo liefert dazu nähere Informationen.
@item -f @var{Format}
@itemx --format=@var{Format}
Gibt das Format des Eingabedokuments an: @code{html}, @code{latex},
-@code{texi} (Standardeinstellung), @code{texi-html} oder @code{docbook}.
-Ist diese Option nicht angegeben, versucht @command{lilypond-book} das
-Format anhand des Dateinamens zu bestimmen. Im Moment bedeutet @code{texi}
+@code{texi} (Standardeinstellung), @code{texi-html} oder @code{docbook}.
+Ist diese Option nicht angegeben, versucht @command{lilypond-book} das
+Format anhand des Dateinamens zu bestimmen. Im Moment bedeutet @code{texi}
praktisch dasselbe wie @code{texi-html}.
@c This complicated detail is not implemented, comment it out -jm
@@ -905,8 +1017,8 @@ version, the format @code{texi-html} must be used instead.
@item -F @var{Filter}
@itemx --filter=@var{Filter}
Leitet die Musikfragmente durch das Programm @var{filter} anstatt sie
-mit Lilypond zu einer Grafik zu verarbeiten. @option{--filter} und
-@option{--process} kann nicht gleichzeigt benutzt werden. Beispielaufruf:
+mit Lilypond zu einer Grafik zu verarbeiten. @option{--filter} und
+@option{--process} kann nicht gleichzeitig benutzt werden. Beispielaufruf:
@example
lilypond-book --filter='convert-ly --from=2.0.0 -' Mein-Buch.tely
@@ -918,20 +1030,28 @@ Gibt eine kurze Hilfemeldung aus.
@item -I @var{Pfad}
@itemx --include=@var{Pfad}
-Fügt @var{Pfad} zu den Include-Pfaden hinzu. @command{lilypond-book} sucht
+Fügt @var{Pfad} zu den Include-Pfaden hinzu. @command{lilypond-book} sucht
auch in allen Include-Pfaden nach bereits erstellten Grafiken für die
Musikfragmente. Wird das aktuelle Fragment gefunden und hat sich seit der
letzten Erstellung nicht geändert, wird es nicht erneut erzeugt. Bei manchen
-der Programme zur Weiterverarbeitung wie etwa @command{makeinfo} oder
-@command{latex} muss dieselbe @code{-I @var{Pfad}} Option angegeben werden,
+der Programme zur Weiterverarbeitung wie etwa @command{makeinfo} oder
+@command{latex} muss dieselbe @option{-I @var{Pfad}} Option angegeben werden,
damit das entsprechende Programm die Grafiken ebenso findet.
+@item -l @var{Logstufe}
+@itemx --loglevel=@var{Logstufe}
+Passt die Ausführlichkeit der Ausgabe entsprechend @var{Logstufe} an.
+Mögliche Werte sind @code{NONE}, @code{ERROR}, @code{WARNING},
+@code{PROGRESS} (Standard) und @code{DEBUG}. Wenn diese Option nicht
+genutzt wird und die Umgebungsvariable @code{LILYPOND_BOOK_LOGLEVEL}
+definiert ist, wird ihr Wert als Logstufe eingesetzt.
+
@item -o @var{Verzeichnis}
@itemx --output=@var{Verzeichnis}
-Erzeugt die Ausgabedateien in @var{Verzeichnis}. Der Aufruf von
-@command{lilypond-book} erzeugt zahlreiche kleine Dateien, die von
-LilyPond, @command{latex}, @command{makeinfo} etc. dann weiter benützt
-werden. Um zu vermeiden, dass das Quellenverzeichnis durch diese
+Erzeugt die Ausgabedateien in @var{Verzeichnis}. Der Aufruf von
+@command{lilypond-book} erzeugt zahlreiche kleine Dateien, die von
+LilyPond, @command{latex}, @command{makeinfo} etc. dann weiter benützt
+werden. Um zu vermeiden, dass das Quellenverzeichnis durch diese
Dateien unübersichtlich wird, kann die @option{--output} Option benutzt
werden. Vor dem Aufruf von @command{latex} oder @command{makeinfo}
sollten Sie in dieses Verzeichnis wechseln.
@@ -948,16 +1068,23 @@ gefunden wird. Dies wird benutzt für Dokumentation ohne Grafiken.
@itemx --skip-png-check
Nicht mit einer Fehlermeldung abbrechen, wenn für die EPS-Dateien keine
-PNG-Grafiken gefunden werden. Dies wird benutzt für Dokumentation ohne
+PNG-Grafiken gefunden werden. Dies wird benutzt für Dokumentation ohne
Grafiken.
@itemx --lily-output-dir=@var{Verzeichnis}
Schreibt @file{lily-XXX} Dateien nach @var{Verzeichnis} und erzeugt
-im mit @code{--output} angegebenen Verzeichnis Verknüpfungen darauf.
-Diese Option ist nützlich, um Zeit zu sparen, wenn Dokumente in
+im mit @option{--output} angegebenen Verzeichnis Verknüpfungen darauf.
+Diese Option ist nützlich, um Zeit zu sparen, wenn Dokumente in
verschiedenen Verzeichnissen viele identische Musikfragmente
enthalten.
+@itemx --lily-loglevel=@var{Logstufe}
+Passt die Ausführlichkeit der Ausgabe entsprechend @var{Logstufe} an.
+Mögliche Werte sind @code{NONE}, @code{ERROR}, @code{WARNING},
+@code{PROGRESS} (Standard) und @code{DEBUG}. Wenn diese Option nicht
+genutzt wird und die Umgebungsvariable @code{LILYPOND_LOGLEVEL}
+definiert ist, wird ihr Wert als Logstufe eingesetzt.
+
@itemx --info-images-dir=@var{Verzeichnis}
Formatiert die Texinfo-Ausgabe dergestalt, dass Info in @var{Verzeichnis}
nach den Grafiken zu den Musikfragmenten sucht.
@@ -970,28 +1097,38 @@ wie etwa @command{xelatex} verarbeitet werden soll.
@itemx --left-padding=@var{Einrückung}
Fügt @var{Einrückung} als zusätzlichen Einzug in die EPS-Box ein.
@var{Einrückung} wird in Millimetern angegeben, die Standardeinstellung
-is 3.0 Millimeter. Diese Option kann benutzt werden, wenn die Notenzeilen
+ist 3.0 Millimeter. Diese Option kann benutzt werden, wenn die Notenzeilen
über den Rand des Dokuments hinausstehen.
-Die Breite eines eng ausgeschnittenen Notensystems kann variieren
+Die Breite eines eng ausgeschnittenen Notensystems kann variieren
aufgrund von Notationselementen, die über den linken Rand hinausstehen,
-wie etwa Taktzahlen und Bezeichnungen der Instrumente. Diese Option
+wie etwa Taktzahlen und Bezeichnungen der Instrumente. Diese Option
verkürzt die Notenzeile und verschiebt sie um denselben Betrag nach
rechts.
-
-@item -P @var{Kommando}
-@itemx --process=@var{Kommando}
-Verarbeitet LilyPond-Fragmente mit @var{Kommando} anstelle des
-Standardbefehls @code{lilypond}. @code{--filter} und @code{--process}
-können nicht gleichzeitig angegeben werden.
+@item -P @var{Befehl}
+@itemx --process=@var{Befehl}
+Verarbeitet LilyPond-Fragmente mit @var{Befehl} anstelle des
+Standardbefehls @code{lilypond}. @option{--filter} und @option{--process}
+können mit @code{lilypond-book} nicht gleichzeitig benutzt werden.
@item --pdf
Erzeugt PDF-Dateien mit PDF@LaTeX{}.
+@item --redirect-lilypond-output
+StandardmäÃig wird die Ausgabe auf der Kommandozeile ausgegeben.
+Diese Option leitet die Ausgabe in eine Log-Datei im selben Verzeichnis
+wie die Quelldatei um.
+
+@itemx --use-source-file-names
+Schreibe Schnipsel-Ausgabedateien mit den gleichen Basisnamen wie die
+Quelldateien. Diese Option funktioniert mit Schnipseln, die mit
+@code{lilypondfile} eingfügt wurden und auch nur, wenn die Verzeichnisse
+@option{--output-dir} und @option{--lily-output-dir} unterschiedlich sind.
+
@item -V
@itemx --verbose
-Gibt ausführliche informative Meldungen aus.
+Gibt ausführliche informative Meldungen aus. Ãquivalent zu @option{--loglevel=DEBUG}.
@item -v
@itemx --version
@@ -1011,12 +1148,12 @@ Nur der erste @code{\score}-Block eines LilyPond-Fragments wird verarbeitet.
@section Dateiendungen
@translationof Filename extensions
-Für die Eingabedatei kann zwar jede beliebige Dateinamenserweiterung benutzt
+Für die Eingabedatei kann zwar jede beliebige Dateinamenserweiterung benutzt
werden, allerdings muss bei Verwendung einer nicht bekannten Erweiterung
-das Ausgabeformat explizit an @command{lilypond-book} angegeben werden.
-Details dazu finden sich im Abschnitt @ref{lilypond-book aufrufen}.
-Wird eine bekannte Erweiterung benutzt, wählt @command{lilypond-book}
-automatisch das richtige Ausgabeformat basierend auf der Erweiterung der
+das Ausgabeformat explizit an @command{lilypond-book} angegeben werden.
+Details dazu finden sich im Abschnitt @ref{lilypond-book aufrufen}.
+Wird eine bekannte Erweiterung benutzt, wählt @command{lilypond-book}
+automatisch das richtige Ausgabeformat basierend auf der Erweiterung der
Eingabedatei:
@quotation
@@ -1037,85 +1174,267 @@ Eingabedatei:
@end quotation
Wird dieselbe Erweiterung für die Eingabedatei wie für die Ausgabedatei
-benutzt und befindet sich die Eingabedatei im aktuellen Arbeitsverzeichnis
-von @command{lilypond-book}, muss die @code{--output} Option für
-@command{lilypond-book} benutzt werden. Anderenfalls würde
-@command{lilypond-book} ja die Eingabedatei überschreiben, weshalb das
-Programm in diesem Fall mit einer Fehlermeldung wie @qq{Fehler: Ausgabe
+benutzt und befindet sich die Eingabedatei im aktuellen Arbeitsverzeichnis
+von @command{lilypond-book}, muss die @option{--output} Option für
+@command{lilypond-book} benutzt werden. Anderenfalls würde
+@command{lilypond-book} ja die Eingabedatei überschreiben, weshalb das
+Programm in diesem Fall mit einer Fehlermeldung wie @qq{Fehler: Ausgabe
würde Eingabedatei überschreiben; verwenden Sie --output.} abbricht.
-@node Alternative Methoden, Text und Musik zu kombinieren
-@section Alternative Methoden, Text mit Musik zu kombinieren
-@translationof Alternate methods of mixing text and music
-
-Dieser Abschnitt stellt Methoden vor, wie Text und Musik auf andere
-Weise kombiniert werden können als dies durch @command{lilypond-book}
-automatisiert geschieht.
+@node lilypond-book-Vorlagen
+@section @command{lilypond-book}-Vorlagen
+@translationof lilypond-book templates
+Diese Vorlagen sollen mit @code{lilypond-book} benutzt werden. Wenn Sie sich
+mit dem Programm nicht auskennen, lesen Sie bitte
+@ref{lilypond-book}.
-@menu
-* Viele Zitate aus einer langen Partitur::
-* LilyPond-Noten in OpenOffice.org integrieren::
-* LilyPond-Noten in andere Programme integrieren::
-@end menu
+@subsection LaTeX
-@node Viele Zitate aus einer langen Partitur
-@subsection Viele Zitate aus einer langen Partitur
-@translationof Many quotes from a large score
+Sie können LilyPond-Fragmente in ein LaTeX-Dokument einfügen:
-Wenn aus einer groÃen Partitur viele kleine Fragmente eingefügt
-werden sollen, kann dazu das @q{clip systems} Feature benutzt werden.
-Siehe @ruser{Notationsfragmente extrahieren}.
+@example
+\documentclass[]@{article@}
+\begin@{document@}
-@node LilyPond-Noten in OpenOffice.org integrieren
-@subsection LilyPond-Noten in OpenOffice.org integrieren
-@translationof Inserting LilyPond output into OpenOffice.org
+Normaler LaTeX-Text.
-Musik im LilyPond-Format kann in OpenOffice.org eingefügt werden mittels
-@uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
+\begin@{lilypond@}
+\relative c'' @{
+ a4 b c d
+@}
+\end@{lilypond@}
+Weiterer LaTeX-Text und Optionen in eckigen Klammern.
-@node LilyPond-Noten in andere Programme integrieren
-@subsection LilyPond-Noten in andere Programme integrieren
-@translationof Inserting LilyPond output into other programs
+\begin@{lilypond@}[fragment,relative=2,quote,staffsize=26,verbatim]
+d4 c b a
+\end@{lilypond@}
+\end@{document@}
+@end example
-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.
+@subsection Texinfo
-Um den leeren Rand um die Notenzeilen zu verringern, können folgende
-Einstellungen benutzt werden:
+LilyPond-Fragmente können in Texinfo-Dokumente eingefügt werden: dieses gesamte
+Handbuch wurde in Texinfo geschrieben.
@example
-\paper@{
- indent=0\mm
- line-width=120\mm
- oddFooterMarkup=##f
- oddHeaderMarkup=##f
- bookTitleMarkup = ##f
- scoreTitleMarkup = ##f
+\input texinfo @c -*-texinfo-*-
+@@node Top
+@@top
+
+Texinfo-Text
+
+@@lilypond
+\relative c' @{
+ a4 b c d
@}
+@@end lilypond
+
+Weiterer Texinfo-Text und Optionen in Klammern.
-@{ c1 @}
+@@lilypond[verbatim,fragment,ragged-right]
+d4 c b a
+@@end lilypond
+
+@@bye
@end example
-Eine @file{EPS}-Datei kann mit folgendem Befehl erzeugt werden:
+
+@subsection html
@example
-lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts Dateiname.ly
+
+
+
+
+
+
+Dokumente für lilypond-book können Noten und Text frei kombinieren. Zum
+Beispiel
+
+\relative c'' @{
+ a4 b c d
+@}
+
+
+
+
+Noch etwas LilyPond, mit Optionen:
+
+
+a4 b c d
+
+
+
+
+
+
+
@end example
-@noindent
-eine @file{PNG}-Datei mittels:
+@subsection xelatex
+
+@verbatim
+\documentclass{article}
+\usepackage{ifxetex}
+\ifxetex
+%xetex specific stuff
+\usepackage{xunicode,fontspec,xltxtra}
+\setmainfont[Numbers=OldStyle]{Times New Roman}
+\setsansfont{Arial}
+\else
+%This can be empty if you are not going to use pdftex
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage{mathptmx}%Times
+\usepackage{helvet}%Helvetica
+\fi
+%Here you can insert all packages that pdftex also understands
+\usepackage[ngerman,finnish,english]{babel}
+\usepackage{graphicx}
+
+\begin{document}
+\title{A short document with LilyPond and xelatex}
+\maketitle
+
+Normal \textbf{font} commands inside the \emph{text} work,
+because they \textsf{are supported by \LaTeX{} and XeteX.}
+If you want to use specific commands like \verb+\XeTeX+, you
+should include them again in a \verb+\ifxetex+ environment.
+You can use this to print the \ifxetex \XeTeX{} command \else
+XeTeX command \fi which is not known to normal \LaTeX .
+
+In normal text you can easily use LilyPond commands, like this:
+
+\begin{lilypond}
+{a2 b c'8 c' c' c'}
+\end{lilypond}
+
+\noindent
+and so on.
+
+The fonts of snippets set with LilyPond will have to be set from
+inside
+of the snippet. For this you should read the AU on how to use
+lilypond-book.
+\end{document}
+@end verbatim
+
+
+@node Das Inhaltsverzeichnis flexibel einsetzen
+@section Das Inhaltsverzeichnis flexibel einsetzen
+@translationof Sharing the table of contents
+
+Diese Funktionen existieren schon im OrchestraLily-Paket:
@example
-lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png Dateiname.ly
+@url{http://repo.or.cz/w/orchestrallily.git}
@end example
+Um den Text flexibler behandeln zu können, bevorzugen manche Benutzer es,
+das Inhaltsverzeichnis aus LilyPond zu exportieren und dann mit
+@LaTeX{} einzulesen.
+
+@subsubheading Das Inhaltsverzeichnis (ToC) aus LilyPond exportieren
+
+Hier wird angenommen, dass in Ihrer Partitur mehrere Sätze vorkommen, die
+sich alle in der selben LilyPond-Datei befinden.
+
+@smallexample
+#(define (oly:create-toc-file layout pages)
+ (let* ((label-table (ly:output-def-lookup layout 'label-page-table)))
+ (if (not (null? label-table))
+ (let* ((format-line (lambda (toc-item)
+ (let* ((label (car toc-item))
+ (text (caddr toc-item))
+ (label-page (and (list? label-table)
+ (assoc label label-table)))
+ (page (and label-page (cdr label-page))))
+ (format #f "~a, section, 1, @{~a@}, ~a" page text label))))
+ (formatted-toc-items (map format-line (toc-items)))
+ (whole-string (string-join formatted-toc-items ",\n"))
+ (output-name (ly:parser-output-name parser))
+ (outfilename (format "~a.toc" output-name))
+ (outfile (open-output-file outfilename)))
+ (if (output-port? outfile)
+ (display whole-string outfile)
+ (ly:warning (_ "Unable to open output file ~a for the TOC information") outfilename))
+ (close-output-port outfile)))))
+
+\paper @{
+ #(define (page-post-process layout pages) (oly:create-toc-file layout pages))
+@}
+@end smallexample
+
+@subsubheading Das Inhaltsverzeichnis in LaTeX importieren
+
+In der LaTeX-Datei sollte folgendes enthalten:
+
+@c no, this doesn't require the smallexample, but since the other
+@c two blocks on this page use it, I figured I might as well
+@c user it here as well, for consistency. -gp
+@smallexample
+\usepackage@{pdfpages@}
+\includescore@{nameofthescore@}
+@end smallexample
+
+@noindent
+wobei @code{\includescore} wiefolgt definiert ist:
+
+@smallexample
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% \includescore@{PossibleExtension@}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+% Read in the TOC entries for a PDF file from the corresponding .toc file.
+% This requires some heave latex tweaking, since reading in things from a file
+% and inserting it into the arguments of a macro is not (easily) possible
+
+% Solution by Patrick Fimml on #latex on April 18, 2009:
+% \readfile@{filename@}@{\variable@}
+% reads in the contents of the file into \variable (undefined if file
+% doesn't exist)
+\newread\readfile@@f
+\def\readfile@@line#1@{%
+@{\catcode`\^^M=10\global\read\readfile@@f to \readfile@@tmp@}%
+\edef\do@{\noexpand\g@@addto@@macro@{\noexpand#1@}@{\readfile@@tmp@}@}\do%
+\ifeof\readfile@@f\else%
+\readfile@@line@{#1@}%
+\fi%
+@}
+\def\readfile#1#2@{%
+\openin\readfile@@f=#1 %
+\ifeof\readfile@@f%
+\typeout@{No TOC file #1 available!@}%
+\else%
+\gdef#2@{@}%
+\readfile@@line@{#2@}%
+\fi
+\closein\readfile@@f%
+@}%
+
+
+\newcommand@{\includescore@}[1]@{
+\def\oly@@fname@{\oly@@basename\@@ifmtarg@{#1@}@{@}@{_#1@}@}
+\let\oly@@addtotoc\undefined
+\readfile@{\oly@@xxxxxxxxx@}@{\oly@@addtotoc@}
+\ifx\oly@@addtotoc\undefined
+\includepdf[pages=-]@{\oly@@fname@}
+\else
+\edef\includeit@{\noexpand\includepdf[pages=-,addtotoc=@{\oly@@addtotoc@}]
+@{\oly@@fname@}@}\includeit
+\fi
+@}
+@end smallexample
+
+
+@node Alternative Methoden Text und Musik zu kombinieren
+@section Alternative Methoden Text und Musik zu kombinieren
+@translationof Alternate methods of mixing text and music
+Andere Methoden, Text und Noten miteinander zu kombinieren (ohne
+@command{lilypond-book} zu benutzen) werden beschrieben in
+@ref{LilyPond-Ausgabe in anderen Programmen}.