X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fde%2Fuser%2Ftext.itely;h=8ae9409fee5f59e736aa93a9323e0cfce8712138;hb=b97565a9af1c13369ac7e7e9ea80c2638dbc0e51;hp=b0d05265f7cd7f99b14e9133093bf4033d2c8cde;hpb=c6554467b0a9beddf0d7ef12746ae31a25fe36e7;p=lilypond.git diff --git a/Documentation/de/user/text.itely b/Documentation/de/user/text.itely index b0d05265f7..8ae9409fee 100644 --- 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: 4a527608c5ff2ce31e596495d00dce181dc1b9ea + 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.11.61" +@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,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,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,22 +86,22 @@ 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,verbatim,relative=1] -d8^"pizz." e f g +@lilypond[quote,verbatim,relative=2] +a8^"pizz." g f e \textLengthOn a4_"scherzando" f @end lilypond -@predefined +@predefined @funindex \textLengthOn @code{\textLengthOn}, @funindex \textLengthOff -@code{\textLengthOff} +@code{\textLengthOff}. +@endpredefined @seealso - Notationsreferenz: @ref{Formatting text}, @ref{Direction and placement}. @@ -139,8 +140,8 @@ können von einer Note bis zu einer anderen mit folgender Anweisung erstellt werden: @lilypond[verbatim,quote,relative=2] -\override TextSpanner #'bound-details #'left #'text = "rit." -b1\startTextSpan +\override TextSpanner #'(bound-details left text) = "rit." +b1\startTextSpan e,\stopTextSpan @end lilypond @@ -151,8 +152,8 @@ Formatierung kann erreicht werden, indem man @code{\markup}-Blöcke einsetzt, wie beschrieben in @ref{Formatting text}. @lilypond[quote,relative=2,verbatim] -\override TextSpanner #'bound-details #'left #'text = - \markup { \upright "rit." } +\override TextSpanner #'(bound-details left text) = + \markup { \upright "rit." } b1\startTextSpan c e,\stopTextSpan @end lilypond @@ -160,17 +161,18 @@ e,\stopTextSpan Auch der Stil der Linie kann ähnlich wie der Text mit den Objekteigenschaften geändert werden. Diese Syntax ist beschrieben in @ref{Line styles}. -@predefined +@predefined @funindex textSpannerUp @code{\textSpannerUp}, @funindex textSpannerDown @code{\textSpannerDown}, @funindex textSpannerNeutral -@code{\textSpannerNeutral} +@code{\textSpannerNeutral}. +@endpredefined -@seealso +@seealso Notationsreferenz: @ref{Line styles}, @ref{Dynamics}. @@ -225,8 +227,8 @@ Symbol mit dem Befehl @code{\musicglyph} angegeben wird, wie beschrieben in @ref{Music notation inside markup}: -@lilypond[quote,verbatim,relative=1] -2 +@lilypond[fragment,quote,relative=2] +2 \mark \markup { \musicglyph #"scripts.ufermata" } 1 @end lilypond @@ -238,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[quote,ragged-right,verbatim,relative=2] +@lilypond[fragment,quote,relative=2] \mark "Allegro" c1 c \mark "assai" \break @@ -258,7 +260,6 @@ c c {printing-marks-on-every-staff.ly} @seealso - Notationsreferenz: @ref{Rehearsal marks}, @ref{Formatting text}, @@ -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 } @@ -324,20 +325,20 @@ dass man Textdokumente oder Bücher ausschließlich mit LilyPond setzen kann. Einzelheiten zu den vielfältigen Möglichkeiten finden sich in @ref{Multi-page markup}. -@predefined +@predefined @code{\markup}, @funindex \markuplines -@code{\markuplines} +@code{\markuplines}. +@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: @ref{Formatting text}, @ref{File structure}, @@ -383,7 +384,7 @@ zu setzen. @cindex Textbeschriftungs-Ausdrücke @cindex Text, Syntax -@cindex markup, syntax +@cindex markup, Syntax Die Syntax für Textbeschriftungen ähnelt der normalen Syntax von LilyPond: ein @code{\markup}-Ausdruck wird in geschweifte Klammern @@ -397,12 +398,12 @@ 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" } -e +e b1^\markup { \bold { molto \italic agitato } } c @end lilypond @@ -421,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 @@ -435,14 +436,14 @@ 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 } } } c1^\markup { \center-column { a "bbb c" } } @end lilypond -Textbeschriftung kann auch durch Variblen definiert werden. Diese +Textbeschriftung kann auch durch Variablen definiert werden. Diese Variablen können dann direkt an Noten angefügt werden: @lilypond[quote,verbatim] @@ -461,7 +462,6 @@ Eine ausführliche Liste der @code{\markup}-Befehle findet sich in @seealso - Notationsreferenz: @ref{Text markup commands}. @@ -489,9 +489,9 @@ Einfache Änderungen des Schriftartschnitts können im Textbeschriftungsmodus vorgenommen werden: @lilypond[quote,verbatim,relative=2] -d1^\markup { - \bold { Più mosso } - \italic { non troppo \underline Vivo } +d1^\markup { + \bold { Più mosso } + \italic { non troppo \underline Vivo } } r2 r4 r8 d,_\markup { \italic quasi \smallCaps Tromba } @@ -532,7 +532,7 @@ a^\markup { \fontsize #2 da \fontsize #3 camera } -bes^\markup { (con +bes^\markup { (con \larger grande \smaller emozione \magnify #0.6 { e sentimento } ) @@ -553,7 +553,7 @@ aber die normale Schriftgröße kann auch eingesetzt werden: \markup { \column { \line { 1 \super st movement } - \line { 1 \normal-size-super st movement + \line { 1 \normal-size-super st movement \sub { (part two) } } } } @@ -614,27 +614,28 @@ der Schriftarten findet sich in @ref{Font}. Es ist auch möglich, eigene Schriftfamlien zu definieren, wie erklärt in @ref{Fonts}. -@predefined +@predefined @funindex \teeny -@funindex \tiny -@funindex \small -@funindex \normalsize -@funindex \large -@funindex \huge -@funindex \smaller -@funindex \larger @code{\teeny}, +@funindex \tiny @code{\tiny}, +@funindex \small @code{\small}, +@funindex \normalsize @code{\normalsize}, +@funindex \large @code{\large}, +@funindex \huge @code{\huge}, +@funindex \smaller @code{\smaller}, +@funindex \larger @code{\larger}. +@endpredefined -@seealso +@seealso Notationsreferenz: @ref{Font}, @ref{New dynamic marks}, @@ -675,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 } @@ -690,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 } @@ -719,8 +720,8 @@ 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] -d2^\markup { +@lilypond[quote,verbatim,relative=1] +d2^\markup { Acte I \raise #2 { Scène 1 } } @@ -744,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" @@ -814,7 +815,7 @@ beinhalten. } } \markup { - \fill-line { 1885 } + \fill-line { 1885 } } @end lilypond @@ -839,7 +840,7 @@ linksbündig oder im Blocksatz, wie das nächste Beispiel illustriert: gitanos en el Albaicín de Granada. Al fondo una puerta por la que se ve el negro interior de una Fragua, iluminado por los rojos resplandores - del fuego.) + del fuego.) } \hspace #0 @@ -1002,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" @@ -1054,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 = @@ -1074,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 @@ -1098,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 @@ -1106,17 +1107,16 @@ c,8._\markup { \musicglyph #"clefs.G_change" } c16 c2^\markup { \musicglyph #"timesig.neomensural94" } @end lilypond -@c TODO: add \lookup here? -vv @noindent Eine andere Möglichkeit, andere als Textsymbole zu schreiben, findet sich -in -@ref{Fonts explained}. +in @ref{Fonts explained}. Diese Methode bietet sich an, um Klammern +unterschiedlicher Größe zu setzen. 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;" } @@ -1142,7 +1142,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 } @@ -1189,7 +1189,7 @@ fließen zu lassen: ... } \wordwrap-lines { - An other very long paragraph. + Another very long paragraph. ... } ... @@ -1223,9 +1223,11 @@ Referenz der Interna: @rinternals{TextScript}. Installierte Dateien: @file{scm/@/define@/-markup@/-commands@/.scm}. + @predefined @funindex \markuplines -@code{\markuplines} +@code{\markuplines}. +@endpredefined @node Fonts @@ -1245,6 +1247,7 @@ wie man sie in Partituren ändern kann. @cindex Pango @cindex Schriftarten, Hintergrundinformation +@cindex Klammern, unterschiedliche Größen @funindex font-interface Schriftarten werden von mehreren Bibliotheken verwaltet. FontConfig wird @@ -1254,11 +1257,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) @@ -1274,9 +1277,22 @@ a1^\markup { @end lilypond @noindent -Eine einfachere, aber weniger vielfältige Syntax wird beschrieben in +Außer den verschiedenen Klammern, die in @code{fetaBraces} +in verschiedenen Größen enthalten sind, lassen sich alle +dieses Symbole auch mit einer einfacheren Syntax notieren. +Sie ist beschrieben in @ref{Music notation inside markup}. +Wenn man die Klammern von @code{fetaBraces} benutzt, wird die +Größe der Klammer durch einen numeralen Part in der +Bezeichnung des Glyphs bestimmt. Als Wert kann eine +Ganzzahl von @code{0} bis @code{575} benutzt werden, wobei +@code{0} die kleinste Klammern ergibt. Der optimale Wert +muss durch Ausprobieren herausgefunden werden. Diese Glyphen +sind alle linke Klammern, rechte Klammern lassen sich durch +eine Drehung herstellen, siehe +@ref{Rotating objects}. + Drei Textschriftarten sind verfügbar (auf Englisch @code{family} genannt): mit @code{roman} eine Schriftart mit Serifen (Standard ist New Century Schoolbook), mit @code{sans} @@ -1290,15 +1306,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 @@ -1329,21 +1347,12 @@ 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 @ref{Entire document fonts}. @seealso - Notationsreferenz: @ref{The Feta font}, @ref{Music notation inside markup}, @@ -1358,12 +1367,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 } } @@ -1383,7 +1392,6 @@ Das letzte Argument kann ein beliebiges Zeichen sein, aber es darf nicht fehlen. @seealso - Notationsreferenz: @ref{Fonts explained}, @ref{Entire document fonts}. @@ -1399,11 +1407,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 @@ -1430,7 +1438,6 @@ Familien in @ref{Fonts explained}. @c Apple TTF fonts @seealso - Notationsreferenz: @ref{Fonts explained}, @ref{Single entry fonts},