Merge branch 'master' of carldsorensen@git.sv.gnu.org:/srv/git/lilypond into ralph

[lilypond.git] / Documentation / de / user / text.itely

diff --git a/Documentation/de/user/text.itely b/Documentation/de/user/text.itely
index e74d9683236d048211faa2802f7622d655c1581d..3ab6da3bfd94683a8ab606d08f52b3d06ed8dbd4 100644 (file)
--- a/Documentation/de/user/text.itely
+++ b/Documentation/de/user/text.itely
@@ -1,13 +1,13 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 3a8542af9f54c99b53374328af0d5d87005ca49e
+    Translation of GIT committish: 4770e4e71ebff6104cad46bd2d889c3ff6ba3875
 
     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.65"
+@c \version "2.12.0"
 
 @node Text
 @section Text
@@ -27,6 +27,13 @@ in anderen Abschnitten: @ref{Vocal music}, @ref{Titles and headers}.
 * Fonts::
 @end menu
 
+
+@node Writing text
+@subsection Writing text
+
+Dieser Abschnitt zeigt verschiedene Arten, wie Text in die Partitur
+eingefügt werden kann.
+
 @cindex Text, andere Sprachen
 
 @warning{Wenn man Zeichen mit Akzenten und Umlaute oder besondere
@@ -35,13 +42,6 @@ kann man die Zeichen einfach direkt in die Datei einfügen.  Die
 Datei muss als UTF-8 gespeichert werden.  Für mehr Information
 siehe @ref{Text encoding}.}
 
-
-@node Writing text
-@subsection Writing text
-
-Dieser Abschnitt zeigt verschiedene Arten, wie Text in die Partitur
-eingefügt werden kann.
-
 @menu
 * Text scripts::
 * Text spanners::
@@ -49,6 +49,7 @@ eingefügt werden kann.
 * Separate text::
 @end menu
 
+
 @node Text scripts
 @unnumberedsubsubsec Text scripts
 
@@ -62,8 +63,8 @@ zeigt.  Derartiger Text kann manuell über oder unter dem
 Notensystem platziert werden, die Syntax hierzu ist beschrieben
 in @ref{Direction and placement}.
 
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-d8^"pizz." e f g a4-"scherz." f
+@lilypond[quote,verbatim,relative=2]
+d8^"pizz." g f e a4-"scherz." f
 @end lilypond
 
 Diese Syntax ist eine Kurzform, komplexere Formatierungen
@@ -72,8 +73,8 @@ explizit den @code{\markup}-Befehl mit darauf folgenden
 geschweiften Klammern einsetzt, wie beschrieben in
 @ref{Formatting text}.
 
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-d8^\markup { \italic pizz. } e f g
+@lilypond[quote,verbatim,relative=2]
+a8^\markup { \italic pizz. } g f e
 a4_\markup { \tiny scherz. \bold molto } f
 @end lilypond
 
@@ -85,8 +86,8 @@ zweite die Note nach rechts verschiebt.  Das Verhalten wird mit
 dem Befehl @code{\textLengthOn} (Textlänge an) erreicht, rückgängig
 kann es mit dem Befehl @code{\textLengthOff} gemacht werden.
 
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-d8^"pizz." e f g
+@lilypond[quote,verbatim,relative=2]
+a8^"pizz." g f e
 \textLengthOn
 a4_"scherzando" f
 @end lilypond
@@ -138,7 +139,7 @@ auswirkt.  Solche Objekte, @qq{Strecker} (engl. spanners) genannt,
 können von einer Note bis zu einer anderen mit folgender
 Anweisung erstellt werden:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \override TextSpanner #'(bound-details left text) = "rit."
 b1\startTextSpan
 e,\stopTextSpan
@@ -150,7 +151,7 @@ Standardeinstellungen wird er kursiv ausgegeben, aber eine andere
 Formatierung kann erreicht werden, indem man @code{\markup}-Blöcke
 einsetzt, wie beschrieben in @ref{Formatting text}.
 
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+@lilypond[quote,relative=2,verbatim]
 \override TextSpanner #'(bound-details left text) =
   \markup { \upright "rit." }
 b1\startTextSpan c
@@ -201,7 +202,7 @@ indem man die Syntax für Zeichen einsetzen, wie beschrieben in
 @c \mark needs to be placed on a separate line (it's not
 @c attached to an object like \markup is). -vv
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c4
 \mark "Allegro"
 c c c
@@ -212,7 +213,7 @@ zu platzieren, weitere Formatierungsmöglichkeiten sind mit dem
 @code{\markup}-Befehl gegeben, wie beschrieben in 
 @ref{Formatting text}:
 
-@lilypond[fragment,quote,ragged-right,verbatim,relative=1]
+@lilypond[fragment,quote,relative=1]
 <c e>1
 \mark \markup { \italic { colla parte } }
 <d f>2 <e g>
@@ -226,8 +227,8 @@ Symbol mit dem Befehl @code{\musicglyph} angegeben wird, wie
 beschrieben in
 @ref{Music notation inside markup}:
 
-@lilypond[fragment,quote,ragged-right,verbatim,relative=1]
-<f bes>2 <d aes'>
+@lilypond[fragment,quote,relative=2]
+<bes f>2 <aes d>
 \mark \markup { \musicglyph #"scripts.ufermata" }
 <e g>1
 @end lilypond
@@ -239,7 +240,7 @@ Ende notiert werden, werden sie zwischen Noten oder über der
 Taktlinie gesetzt.  Wenn sie an einem Zeilenumbruch angegeben
 werden, wird das Zeichen zu Beginn der nächsten Zeile ausgegeben.
 
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+@lilypond[fragment,quote,relative=2]
 \mark "Allegro"
 c1 c
 \mark "assai" \break
@@ -307,7 +308,7 @@ in einer Datei vorkommen, wie beschrieben in
 @ref{Multiple scores in a book}.
 
 @c KEEP LY
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[quote,verbatim]
 \score {
   c'1
 }
@@ -332,11 +333,10 @@ sich in @ref{Multi-page markup}.
 @endpredefined
 
 
-@ignore
 @snippets
 
-TODO: add convenient snippets in input/new -vv
-@end ignore
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{stand-alone-two-column-markup.ly}
 
 @seealso
 Notationsreferenz:
@@ -398,8 +398,8 @@ oder weitere Textbefehle befinden, eingeführt mit einem Backslash
 (@code{\}).  Derartige Befehle beziehen sich nur auf den ersten
 der folgenden Ausdrücke.
 
-@lilypond[quote,verbatim,fragment,relative=1]
-e1-\markup intenso
+@lilypond[quote,verbatim,relative=2]
+a1-\markup intenso
 a2^\markup { poco \italic più forte  }
 c e1
 d2_\markup { \italic "string. assai" }
@@ -422,10 +422,10 @@ ausgegeben, wie sie eingeben werden.  Doppelte Anführungsstriche
 können gesetzt werden, indem man ihnen einen Backslash voranstellt.
 
 @c KEEP LY
-@lilypond[quote,verbatim,fragment,relative=1]
-d1^"\italic Text..."
-d_\markup { \italic "... setzt \"kursive\" Buchstaben!" }
-d d
+@lilypond[quote,verbatim,relative=2]
+a1^"\italic Text..."
+a_\markup { \italic "... setzt \"kursive\" Buchstaben!" }
+a a
 @end lilypond
 
 Damit eine Anzahl von Wörtern als ein einziger Ausdruck behandelt
@@ -436,7 +436,7 @@ sie übereinander gestapelt, mittig und aneinander ausgerichtet
 werden.  Im folgenden Beispiel verhält sich der zweite
 @code{\markup}-Ausdruck genauso wie der erste:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=2]
 c1^\markup { \center-column { a bbb c } }
 c1^\markup { \center-column { a { bbb c } } }
 c1^\markup { \center-column { a \line { bbb c } } }
@@ -676,7 +676,7 @@ werden.  Standardmäßig wird ein Textobjekt an seiner linken Ecke
 ausgerichtet, darum wird das erste und zweite Objekt gleichermaßen
 an der linken Ecke ausgerichtet.
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=2]
 d1-\markup { poco }
 f
 d-\markup { \left-align poco }
@@ -691,7 +691,7 @@ d-\markup { \right-align poco }
 Die horizontale Ausrichtung kann mit einer Zahl auf einen exakten
 Wert festgelegt werden:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=2]
 a1-\markup { \halign #-1 poco }
 e'
 a,-\markup { \halign #0 poco }
@@ -720,7 +720,7 @@ werden, welcher entweder ein anderes Textelement oder ein
 unsichtbares Objekt sein kann (im Beispiel mit @code{\null} erstellt).
 Der letzte Text im Beispiel hat keinen Anker und wird deshalb auch nicht verschoben.
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=1]
 d2^\markup {
   Acte I
   \raise #2 { Scène 1 }
@@ -745,7 +745,7 @@ Einige Befehle können sowohl die horizontale als auch die vertikale
 Ausrichtung von Textobjekten beeinflussen.  Jedes Objekt, das auf
 diese Weise verschoben wird, benötigt einen Anker:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=1]
 d2^\markup {
   Acte I
   \translate #'(-1 . 2) "Scène 1"
@@ -1003,7 +1003,7 @@ aber Graphiken direkt in den Quelltext unter Verwendung von
 PostScript-Code notiert.  In diesem Fall kann es nötig sein, die
 Größe der Zeichnung explizit anzugeben, wie im Beispiel unten gezeigt:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=1]
 c1^\markup {
   \combine
     \epsfile #X #10 #"./context-example.eps"
@@ -1055,7 +1055,7 @@ werden.
 
 Noten und Versetzungszeichen lassen sich mit @code{\markup} einfügen:
 
-@lilypond[quote,verbatim,fragment,relative=2]
+@lilypond[quote,verbatim,relative=2]
 a2 a^\markup {
   \note #"4" #1
   =
@@ -1075,7 +1075,7 @@ a1_\markup {
 
 Andere Notationsobjekte können auch eingefügt werden:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=1]
 g1 bes
 ees-\markup {
   \finger 4
@@ -1099,7 +1099,7 @@ unten gezeigt.  Eine vollständige Liste der verfügbaren Symbole findet
 sich in
 @ref{The Feta font}.
 
-@lilypond[quote,verbatim,fragment,relative=2]
+@lilypond[quote,verbatim,relative=2]
 c2
 c'^\markup { \musicglyph #"eight" }
 c,4
@@ -1107,7 +1107,11 @@ c,8._\markup { \musicglyph #"clefs.G_change" }
 c16
 c2^\markup { \musicglyph #"timesig.neomensural94" }
 @end lilypond
+
 @c TODO: add \lookup here? -vv
+@c Probably better not to document \lookup, which is useful only for
+@c printing braces, and instead document \left-brace and \right-brace
+@c when these become available  -td
 
 @noindent
 Eine andere Möglichkeit, andere als Textsymbole zu schreiben, findet sich
@@ -1117,7 +1121,7 @@ in
 Der Textbeschriftungsmodus unterstützt auch Diagramme für bestimmte
 Instrumente:
 
-@lilypond[quote,verbatim,fragment,relative=2]
+@lilypond[quote,verbatim,relative=2]
 c1^\markup {
   \fret-diagram-terse #"x;x;o;2;3;2;"
 }
@@ -1143,7 +1147,7 @@ Sogar eine ganze Partitur kann in ein Textbeschriftungsobjekt eingefügt
 werden.  In diesem Fall muss die eingefügte @code{\score}-Umgebung
 eine @code{\layout}-Umgebung haben, wie in diesem Beispiel:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=1]
 c4 d^\markup {
   \score {
     \relative { c4 d e f }
@@ -1190,7 +1194,7 @@ fließen zu lassen:
     ...
   }
   \wordwrap-lines {
-    An other very long paragraph.
+    Another very long paragraph.
     ...
   }
   ...
@@ -1227,7 +1231,7 @@ Installierte Dateien:
 
 @predefined
 @funindex \markuplines
-@code{\markuplines}
+@code{\markuplines}.
 @endpredefined
 
 
@@ -1257,11 +1261,11 @@ gewählte Schriftart wird dann mit Pango verarbeitet.
 Notationsschriftarten können als eine Ansammlung von besonderen Zeichen
 erklärt werden, wobei die Sonderzeichen in verschiedene Familien
 klassifiziert werden.  Die Syntax des folgenden Beispiels ermöglicht es,
-direkt auf verschiedene Sonderzeichen der @code{feta}-Schriftart
-zuzugreifen.  Das ist die Standardschriftart für Notationselemente in
-LilyPond.
+direkt auf verschiedene nicht textuelle Sonderzeichen der
+@code{feta}-Schriftart zuzugreifen.  Das ist die Standardschriftart
+für Notationselemente in LilyPond.
 
-@lilypond[quote,verbatim,fragment,relative=2]
+@lilypond[quote,verbatim,relative=2]
 a1^\markup {
   \vcenter {
     \override #'(font-encoding . fetaBraces)
@@ -1293,15 +1297,17 @@ Jede Familie kann verschiedene Schriftschnitte besitzen. Im Englischen
 wird unterschieden zwischen @code{shape} für kursive Schnitte und 
 @code{series} für fette Schnitte.  Im folgenden Beispiel wird
 demonstriert, wie man die verschiedenen Eigenschaften auswählen kann.
+Der Wert, der @code{font-size} übergeben wird, entspricht der geforderten
+Änderung in Bezug auf die Standardschriftgröße.
 
-@lilypond[quote,verbatim,fragment,relative=2]
+@lilypond[quote,verbatim,relative=2]
   \override Score.RehearsalMark #'font-family = #'typewriter
   \mark \markup "Ouverture"
-  \key d \major
   \override  Voice.TextScript #'font-shape = #'italic
   \override  Voice.TextScript #'font-series = #'bold
   d'2.^\markup "Allegro"
-  r4
+  \override Voice.TextScript #'font-size = #-3
+  c4^smaller
 @end lilypond
 
 @noindent
@@ -1332,14 +1338,6 @@ erklärt wurden in
 }
 @end lilypond
 
-@ignore
-@c FIXME: This needs an example -vv
-
-The size of the font may be set with the @code{font-size}
-property.  The resulting size is taken relative to the
-@code{text-font-size} as defined in the @code{\paper} block.
-@end ignore
-
 Auch wenn es einfach ist, zwischen den vorefinierten Schriftarten
 umzuschalten, kann man auch eigene Schriftarten verwenden, wie erklärt
 in folgenden Abschnitten: @ref{Single entry fonts} und
@@ -1360,12 +1358,12 @@ Jede Schriftart, die über das Betriebssystem installiert ist und von
 FontConfig erkannt wird, kann in einer Partitur eingefügt werden.  Dazu
 verwendet man folgende Syntax:
 
-@lilypond[quote,verbatim,fragment,relative=1]
+@lilypond[quote,verbatim,relative=2]
 \override Staff.TimeSignature #'font-name = #"Charter"
 \override Staff.TimeSignature #'font-size = #2
 \time 3/4
 
-c1_\markup {
+a1_\markup {
   \override #'(font-name . "Vera Bold")
     { Vera Bold }
 }
@@ -1400,11 +1398,11 @@ Installierte Dateien:
 @node Entire document fonts
 @unnumberedsubsubsec Entire document fonts
 
-Es ist auch möglich, die Schriftart für die gesamte Partitur zu ändern.
-In diesem Fall muss die folgende Syntax benutzt werden, mit der drei
-Schriftarten für die drei unterschiedlichen Familien @code{roman},
-@code{sans} und @code{typewriter} definiert werden.  Einzelheiten zu den
-Familien in @ref{Fonts explained}.
+Es ist auch möglich, die Schriftarten für die gesamte Partitur zu ändern.
+In diesem Fall müssen die Familien @code{roman},
+@code{sans} und @code{typewriter} in genaus dieser Reihenfolge
+entsprechend der Syntax unten definiert werden.  Einzelheiten zu
+Schriftarten in @ref{Fonts explained}.
 
 @cindex Schriftartenfamilien, Definieren
 @funindex make-pango-font-tree