Doc-fr: Learning Manual full update

[lilypond.git] / Documentation / de / user / lilypond-book.itely

diff --git a/Documentation/de/user/lilypond-book.itely b/Documentation/de/user/lilypond-book.itely
index a0137df8c4b54fd6bddff93168e9a406e630b51c..ae38383538f561f2923dd1b8aaf2c0b231bd6275 100644 (file)
--- a/Documentation/de/user/lilypond-book.itely
+++ b/Documentation/de/user/lilypond-book.itely
@@ -1,18 +1,21 @@
 @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: d96023d8792c8af202c7cb8508010c0d3648899d
 
     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
@@ -26,7 +29,9 @@ 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}.
+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.
@@ -214,10 +219,11 @@ oder
 \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@}
@@ -264,7 +270,7 @@ Befehls angeben kann.
 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,
@@ -408,6 +414,8 @@ oder
 @@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 
@@ -460,7 +468,6 @@ Musik wird eingegeben als
 @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
@@ -478,6 +485,8 @@ Um Dateien mit Musik einzubinden, kann folgendermaßen vorgegangen werden:
 <lilypondfile @var{Option1} @var{Option2} ...>@var{Dateiname}</lilypondfile>
 @end example
 
+Zusätzlich gibt @code{<lilypondversion/>} die aktuelle Versionsnummer
+von LilyPond aus.
 
 
 @node DocBook
@@ -531,7 +540,7 @@ wobei die Sprache auf @code{lilypond} gesetzt wird:
     <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>
@@ -586,11 +595,6 @@ explizit angegeben ist.
 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
@@ -701,6 +705,13 @@ erzeugt ein Zitat der Form
   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
@@ -737,8 +748,8 @@ so liefert der folgende Aufruf von @code{lilypond-book} das gewünschte
 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)
@@ -767,6 +778,10 @@ 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}.
 
+@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 
@@ -1082,8 +1097,12 @@ Eine @file{EPS}-Datei kann mit folgendem Befehl erzeugt werden:
 
 @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