@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 023d49bb18cbc21a03e7711186d961b8b4fc5e80
+ Translation of GIT committish: 499a511d4166feaada31114e097f86b5e0c56421
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.12.0"
+
@c Translators: Reinhold Kainhofer
+@c Translation checkers: Till Rettig
+
@node LilyPond-book
@chapter @command{lilypond-book}: Integrating text and music
-
Wenn Sie in ein Dokument Grafiken Ihres Musiksatzes einfügen möchten, so
können Sie genauso machen, wie Sie andere Grafiken einfügen würden: Die
Bilder werden getrennt vom Dokument im PostScript- oder PNG-Format erstellt
@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}.
+hierzu finden sich in @ref{Command-line usage}. Wenn Sie MacOS 10.3
+oder 10.4 benutzen und Probleme mit @code{lilypond-book} haben, lesen
+Sie @ref{Setup for MacOS X}.
Dieses Vorgehen kann bei @LaTeX{}, HTML, Texinfo oder DocBook Dokumenten
angewendet werden.
\lilypond@{ IHR LILYPOND QUELLCODE @}
@end example
-Der Aufruf von @command{lilypond-book} liefert eine Datei, die dann mit
-@LaTeX{} weiter verarbeitet werden kann.
+Zusätzlich kann mit @code{\lilypondversion} die benutzte Versionsnummer
+von LilyPond angezeigt werden. 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
+Dies soll hier an einigen Beispielen gezeigt werden. Die @code{lilypond}-Umgebung
@example
\begin[quote,fragment,staffsize=26]@{lilypond@}
Jedes Musikbeispiele ruft die folgenden Makros auf, wenn sie vom Benutzer
definiert wurden:
-@itemize bullet
+@itemize @bullet
@item @code{\preLilyPondExample} -- wird vor der Musik aufgerufen,
@item @code{\postLilyPondExample} -- wird nach der Musik aufgerufen,
@@lilypondfile[Optionen,kommen,hier]@{@var{Dateiname}@}
@end example
+Zusätzlich kann mit @code{@@lilypondversion} die aktuelle Versionsnummer
+von LilyPond angezeigt werden.
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
@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
<lilypondfile @var{Option1} @var{Option2} ...>@var{Dateiname}</lilypondfile>
@end example
+Zusätzlich gibt @code{<lilypondversion/>} die aktuelle Versionsnummer
+von LilyPond aus.
@node DocBook
<programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
\context Staff \with @{
\remove Time_signature_engraver
- \remove Clef_engraver@}
+ \remove Clef_engraver@}
@{ c4( fis) @}
</programlisting>
</textobject>
Streckt Musikfragmente mit nur einer Notenzeile auf die volle Breite,
es wird also @code{ragged-right = ##f} in das Musikfragment eingefügt.
-@c does this option still exist in lilypond? -jm
-@item packed
-Erzeugt Notenzeilen mit möglichst engem Notenabstand, es wird also
-@code{packed = ##t} in das Musikfragment eingefügt.
-
@item line-width
@itemx line-width=@var{Breite}\@var{Einheit}
Setzt die Breite der Notenzeilen auf @var{Breite}, gemessen in Vielfachen
f2 e
@end example
+@noindent
+Wenn Kommentare und Variablen im Zitat, aber nicht im Quelltext
+übersetzt werden sollen, kann die Umgebungsvariable @code{LYDOC_LOCALEDIR}
+auf einen Verzeichnispfad gesetzt werden. Das Verzeichnis sollte
+einen Baum an @file{.mo}-Nachrichtenkatalogen beinhalten mit
+@code{lilypond-doc} als Domain.
+
@item addversion
(Nur innerhalb von Texinfo-Dateien.) Stellt @code{\version
@@w@{"@@version@{@}"@}} an den Beginn des Fragments der Ausgabe mit
Ergebnis:
@example
-lilypond-book --process="lilypond --format=tex --tex \
- --header=texidoc test.texinfo
+lilypond-book --pdf --process="lilypond \
+ -dbackend=eps --header=texidoc" test.texinfo
@end example
Die meisten Test-Dateien (im @file{input/} Verzeichnis von LilyPond)
allerdings in Ihrem Texinfo-Dokument als Makro selbst definiert werden.
Die Übersetzung funktioniert völlig analog zu @code{texidoc}.
+@item nogettext
+Nur für Texinfo-Ausgabe: Kommentare und Variablenbezeichnungen im
+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
@example
lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts Dateiname.ly
+@end example
-Eine @file{PNG}-Datei mittels:
+@noindent
+eine @file{PNG}-Datei mittels:
+
+@example
lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png Dateiname.ly
@end example