1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 2c00bdbfaf62dd90863331c4713e6b29e32c9322
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
15 @lilypondfile[quote]{text-headword.ly}
17 Dieser Abschnitt erklärt, wie man Text (mit vielfältiger
18 Formatierung) in Partituren einfügt.
21 Einige Textelemente, die hier nicht behandelt werden, finden sich
22 in anderen Abschnitten: @ref{Vocal music}, @ref{Titles and headers}.
32 @subsection Writing text
34 Dieser Abschnitt zeigt verschiedene Arten, wie Text in die Partitur
35 eingefügt werden kann.
37 @cindex Text, andere Sprachen
39 @warning{Wenn man Zeichen mit Akzenten und Umlaute oder besondere
40 Zeichen (wie etwa Text mit anderen Alphabeten) eingeben möchte,
41 kann man die Zeichen einfach direkt in die Datei einfügen. Die
42 Datei muss als UTF-8 gespeichert werden. Für mehr Information
43 siehe @ref{Text encoding}.}
54 @unnumberedsubsubsec Text scripts
57 @cindex Textelemente, nicht leer
58 @cindex zitierter Text
60 Am einfachsten kann Text mit geraden Anführungsstrichen
61 in eine Partitur eingefügt werden, wie das folgende Beispiel
62 zeigt. Derartiger Text kann manuell über oder unter dem
63 Notensystem platziert werden, die Syntax hierzu ist beschrieben
64 in @ref{Direction and placement}.
66 @lilypond[quote,verbatim,relative=2]
67 d8^"pizz." g f e a4-"scherz." f
70 Diese Syntax ist eine Kurzform, komplexere Formatierungen
71 können einem Text hinzugefügt werden, wenn man
72 explizit den @code{\markup}-Befehl mit darauf folgenden
73 geschweiften Klammern einsetzt, wie beschrieben in
74 @ref{Formatting text}.
76 @lilypond[quote,verbatim,relative=2]
77 a8^\markup { \italic pizz. } g f e
78 a4_\markup { \tiny scherz. \bold molto } f
81 Standardmäßig haben Textbeschriftungen keinen Einfluss auf die
82 Positionierung der Noten. Man kann aber auch bestimmen, dass
83 die Breite des Textes mit berücksichtigt wird. Im nächsten
84 Beispiel fordert der erste Text keinen Platz, während der
85 zweite die Note nach rechts verschiebt. Das Verhalten wird mit
86 dem Befehl @code{\textLengthOn} (Textlänge an) erreicht, rückgängig
87 kann es mit dem Befehl @code{\textLengthOff} gemacht werden.
89 @lilypond[quote,verbatim,relative=2]
97 @funindex \textLengthOn
99 @funindex \textLengthOff
100 @code{\textLengthOff}.
106 @ref{Formatting text},
107 @ref{Direction and placement}.
112 Referenz der Interna:
113 @rinternals{TextScript}.
117 Eine Überprüfung, ob sich auch alle Textbeschriftungen und Gesangstext
118 innerhalb der Ränder der Noten befinden, braucht verhältnismäßig
119 viel Rechenaufwand. Diese Überprüfung ist standardmäßig ausgestellt,
120 damit LilyPond die Dateien schneller bearbeiten kann. Man kann
121 die Überprüfung aber mit folgendem Code einschalten:
124 \override Score.PaperColumn #'keep-inside-line = ##t
130 @unnumberedsubsubsec Text spanners
133 @cindex Strecker, Text
135 Einige Aufführungsanweisungen, etwa @notation{rallentando} oder
136 @notation{accelerando}, werden als Text geschrieben, gefolgt von
137 einer gestrichelten Linie, die anzeigt, wie weit sich die Anweisung
138 auswirkt. Solche Objekte, @qq{Strecker} (engl. spanners) genannt,
139 können von einer Note bis zu einer anderen mit folgender
140 Anweisung erstellt werden:
142 @lilypond[verbatim,quote,relative=2]
143 \override TextSpanner #'(bound-details left text) = "rit."
149 Der Text wird durch Objekteigenschaften beeinflusst. In den
150 Standardeinstellungen wird er kursiv ausgegeben, aber eine andere
151 Formatierung kann erreicht werden, indem man @code{\markup}-Blöcke
152 einsetzt, wie beschrieben in @ref{Formatting text}.
154 @lilypond[quote,relative=2,verbatim]
155 \override TextSpanner #'(bound-details left text) =
156 \markup { \upright "rit." }
161 Auch der Stil der Linie kann ähnlich wie der Text mit den Objekteigenschaften
162 geändert werden. Diese Syntax ist beschrieben in @ref{Line styles}.
166 @funindex textSpannerUp
167 @code{\textSpannerUp},
168 @funindex textSpannerDown
169 @code{\textSpannerDown},
170 @funindex textSpannerNeutral
171 @code{\textSpannerNeutral}.
183 Referenz der Interna:
184 @rinternals{TextSpanner}.
189 @unnumberedsubsubsec Text marks
191 @cindex Coda an Taktlinie
192 @cindex Segno an Taktlinie
193 @cindex Fermate an Taktlinie
194 @cindex Taktlinie, Symbole anfügen
195 @cindex Symbole auf der Taktlinie
198 Verschiedene Textelemente können der Partitur hinzugefügt werden,
199 indem man die Syntax für Zeichen einsetzen, wie beschrieben in
200 @ref{Rehearsal marks}:
202 @c \mark needs to be placed on a separate line (it's not
203 @c attached to an object like \markup is). -vv
205 @lilypond[verbatim,quote,relative=2]
211 Diese Syntax ermöglicht es, beliebigen Text über eine Taktlinie
212 zu platzieren, weitere Formatierungsmöglichkeiten sind mit dem
213 @code{\markup}-Befehl gegeben, wie beschrieben in
214 @ref{Formatting text}:
216 @lilypond[fragment,quote,relative=1]
218 \mark \markup { \italic { colla parte } }
224 Diese Syntax ermöglicht es auch, besondere Zeichen einzufügen, wie
225 etwa Coda-, Segno- oder Fermatenzeichen, indem das entsprechende
226 Symbol mit dem Befehl @code{\musicglyph} angegeben wird, wie
228 @ref{Music notation inside markup}:
230 @lilypond[fragment,quote,relative=2]
232 \mark \markup { \musicglyph #"scripts.ufermata" }
237 Derartige Objekte werden über dem höchsten System einer Partitur
238 gesetzt -- abhängig davon, ob sie mitten im Takt oder an seinem
239 Ende notiert werden, werden sie zwischen Noten oder über der
240 Taktlinie gesetzt. Wenn sie an einem Zeilenumbruch angegeben
241 werden, wird das Zeichen zu Beginn der nächsten Zeile ausgegeben.
243 @lilypond[fragment,quote,relative=2]
253 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
254 {printing-marks-at-the-end-of-a-line-or-a-score.ly}
256 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
257 {aligning-marks-with-various-notation-objects.ly}
259 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
260 {printing-marks-on-every-staff.ly}
264 @ref{Rehearsal marks},
265 @ref{Formatting text},
266 @ref{Music notation inside markup},
272 Referenz der Interna:
273 @rinternals{RehearsalMark}.
276 @c To be removed when Issue 69 in the tracker gets fixed. -vv
278 Wenn ein Zeichen am Ende des letzten Taktes eines Stückes notiert
279 wird (wo also keine nächste Zeile mehr existiert), wird das Zeichen
280 überhaupt nicht gesetzt.
285 @unnumberedsubsubsec Separate text
287 @cindex separater Text
293 Eine @code{\markup}-Umgebung kann auch für sich alleine existieren,
294 außerhalb einer @code{\score}-Umgebung, als ein Ausdruck auf der
298 @lilypond[verbatim,quote]
300 Morgen, morgen, und morgen...
305 Damit kann Text unabhängig von den Noten gesetzt werden. Das
306 bietet sich vor allem in Situationen an, in denen mehrere Stücke
307 in einer Datei vorkommen, wie beschrieben in
308 @ref{Multiple scores in a book}.
311 @lilypond[quote,verbatim]
316 Morgen, übermorgen, und überübermorgen...
323 Unabhängige Textabschnitte können über mehrere Seiten reichen, so
324 dass man Textdokumente oder Bücher ausschließlich mit LilyPond
325 setzen kann. Einzelheiten zu den vielfältigen Möglichkeiten finden
326 sich in @ref{Multi-page markup}.
331 @funindex \markuplines
339 @c TODO Replace following example with this snippet when available
340 @c Submitted to LSR 30 Nov 08
341 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
342 {stand--alone-two--column-markup.ly}
345 Text alleine kann auch in mehreren Spalten angeordnet werden.
347 @lilypond[verbatim,quote]
352 \line {"O sacrum convivium" }
353 \line {"in quo Christus sumitur," }
354 \line {"recolitur memoria passionis ejus," }
355 \line {"mens impletur gratia," }
356 \line {"futurae gloriae nobis pignus datur." }
361 \line { \italic {"O sacred feast"} }
362 \line { \italic {"in which Christ is received,"} }
363 \line { \italic {"the memory of His Passion is renewed,"} }
364 \line { \italic {"the mind is filled with grace," } }
365 \line { \italic {"and a pledge of future glory is given to us." }}
366 \line { \italic {"Amen."}}
375 @ref{Formatting text},
376 @ref{File structure},
377 @ref{Multiple scores in a book},
378 @ref{Multi-page markup}.
383 Referenz der Interna:
384 @rinternals{TextScript}.
388 @node Formatting text
389 @subsection Formatting text
391 Dieser Abschnitt zeigt grundlegende und fortgeschrittene
392 Formatierung von Text, wobei der Textbeschriftungsmodus
393 (@code{\markup} benutzt wird.
396 * Text markup introduction::
397 * Selecting font and font size::
399 * Graphic notation inside markup::
400 * Music notation inside markup::
401 * Multi-page markup::
404 @node Text markup introduction
405 @unnumberedsubsubsec Text markup introduction
408 @cindex Textbeschriftung
409 @cindex Beschriftung, Text
410 @cindex Setzen von Text
413 Eine @code{\markup}-Umgebung wird benutzt, um Text mit einer
414 großen Anzahl von Formatierungsmöglichkeiten (im @qq{markup-Modus})
417 @cindex Textbeschriftungs-Ausdrücke
419 @cindex markup, Syntax
421 Die Syntax für Textbeschriftungen ähnelt der normalen Syntax von
422 LilyPond: ein @code{\markup}-Ausdruck wird in geschweifte Klammern
423 eingeschlossen (@code{@{@dots{} @}}). Ein einzelnes Wort wird als
424 ein Minimalausdruck erachtet und muss deshalb nicht notwendigerweise
425 eingeklammert werden.
427 Anders als Text in Anführungsstrichen können sich in einer
428 Textbeschriftungsumgebung (@code{\markup}) geschachtelte Ausdrücke
429 oder weitere Textbefehle befinden, eingeführt mit einem Backslash
430 (@code{\}). Derartige Befehle beziehen sich nur auf den ersten
431 der folgenden Ausdrücke.
433 @lilypond[quote,verbatim,relative=2]
435 a2^\markup { poco \italic più forte }
437 d2_\markup { \italic "string. assai" }
439 b1^\markup { \bold { molto \italic agitato } }
443 @cindex Sonderzeichen in Textbeschriftungen
444 @cindex Textbeschriftung, Sonderzeichen
445 @cindex besondere Zeichen, Text
446 @cindex Text mit Sonderzeichen
447 @cindex Anführungsstriche im Text
449 Eine @code{\markup}-Umgebung kann auch Text in
450 Anführungszeichen beinhalten. Derartige Zeichenketten werden als
451 ein Textausdruck angesehen, und darum werden innerhalb von ihnen
452 Befehle oder Sonderzeichen (wie @code{\} oder @code{#}) so
453 ausgegeben, wie sie eingeben werden. Doppelte Anführungsstriche
454 können gesetzt werden, indem man ihnen einen Backslash voranstellt.
457 @lilypond[quote,verbatim,relative=2]
459 a_\markup { \italic "... setzt \"kursive\" Buchstaben!" }
463 Damit eine Anzahl von Wörtern als ein einziger Ausdruck behandelt
464 wird, müssen alle Wörter zwischen geraden Anführungszeichen (Shift+2)
465 stehen oder ihnen muss ein Befehl vorangestellt werden. Die Art,
466 wie die Ausdrücke definiert sind, wirkt sich darauf aus, wie
467 sie übereinander gestapelt, mittig und aneinander ausgerichtet
468 werden. Im folgenden Beispiel verhält sich der zweite
469 @code{\markup}-Ausdruck genauso wie der erste:
471 @lilypond[quote,verbatim,relative=2]
472 c1^\markup { \center-column { a bbb c } }
473 c1^\markup { \center-column { a { bbb c } } }
474 c1^\markup { \center-column { a \line { bbb c } } }
475 c1^\markup { \center-column { a "bbb c" } }
478 Textbeschriftung kann auch durch Variablen definiert werden. Diese
479 Variablen können dann direkt an Noten angefügt werden:
481 @lilypond[quote,verbatim]
482 allegro = \markup { \bold \large Allegro }
492 Eine ausführliche Liste der @code{\markup}-Befehle findet sich in
493 @ref{Text markup commands}.
498 @ref{Text markup commands}.
503 Installierte Dateien:
504 @file{scm/@/markup@/.scm}.
509 Syntaxfehler im Textbeschriftungsmodus können sehr verwirrend sein.
512 @node Selecting font and font size
513 @unnumberedsubsubsec Selecting font and font size
515 @cindex Schriftschnitt verändern
520 Einfache Änderungen des Schriftartschnitts können im Textbeschriftungsmodus
523 @lilypond[quote,verbatim,relative=2]
526 \italic { non troppo \underline Vivo }
529 d,_\markup { \italic quasi \smallCaps Tromba }
535 @cindex Größe der Schriftart
541 Die Größe von Buchstaben kann auf verschiedene Arten verändert werden:
544 die Schriftgröße kann auf bestimmte deinierte Standardgrößen gesetzt werden,
547 die Schriftgröße kann mit einem absoluten Wert gesetzt werden,
550 die Schriftgröße kann relativ zur vorhergehenden Größe geändert werden.
554 Das Beispiel unten zeigt alle drei Möglichkeiten:
556 @lilypond[quote,verbatim,relative=1]
563 \fontsize #5 Sinfonia
570 \magnify #0.6 { e sentimento } )
576 @cindex tiefergestellt
580 Text kann auch hoch- bzw. tiefgestellt gesetzt werden. Die so markierten
581 Buchstaben werden automatisch in einer kleineren Schriftgröße gesetzt,
582 aber die normale Schriftgröße kann auch eingesetzt werden:
584 @lilypond[quote,verbatim]
587 \line { 1 \super st movement }
588 \line { 1 \normal-size-super st movement
589 \sub { (part two) } }
594 @cindex Schriftfamilien
595 @cindex Schriftschnitte
597 Der Textbeschriftungsmodus stellt eine einfache Möglichkeit zur Verfügung
598 unterschiedliche Schriftschnitte anzuwählen. Ohne besondere Einstellungen
599 wird automatisch eine Schriftart mit Serifen ausgewählt. Das Beispiel
600 unten zeigt die Verwendung der eigenen Zahlenschriftart von LilyPond,
601 den Einsatz von serifenloser Schriftart und von Schreibmaschinenschriftart.
602 Die letzte Zeile zeigt, dass sich die Standardeinstellung mit dem
603 Befehl @code{\roman} wieder herstellen lässt.
605 @lilypond[quote,verbatim]
608 \line { Act \number 1 }
609 \line { \sans { Scene I. } }
610 \line { \typewriter { Verona. An open place. } }
611 \line { Enter \roman Valentine and Proteus. }
617 Einige dieser Schriftarten, etwa die Zahlenschriftart oder die Schriftart
618 für Dynamikzeichen, stellen nicht alle Zeichen zur Verfügung, wie beschrieben
619 in @ref{New dynamic marks} und @ref{Manual repeat marks}.
621 @c \concat is actually documented in Align (it is not
622 @c a font-switching command). But we need it here. -vv
624 Einige Schriftartbefehle können ungewollte Leerzeichen innerhalb von Wörtern
625 hervorrufen. Das kann vermieden werden, indem die einzelnen Elemente mit
626 dem Befehl @code{\concat} zu einem Element verschmolzen werden:
628 @lilypond[quote,verbatim]
632 \concat { 1 \super st }
636 \concat { \dynamic p , }
637 \italic { con dolce espressione }
643 Eine ausführliche Liste der unterschiedlichen Befehl zur Beeinflussung
644 der Schriftarten findet sich in @ref{Font}.
646 Es ist auch möglich, eigene Schriftfamlien zu definieren, wie erklärt in
657 @funindex \normalsize
673 @ref{New dynamic marks},
674 @ref{Manual repeat marks},
680 Referenz der Interna:
681 @rinternals{TextScript}.
683 Installierte Dateien:
684 @file{scm/@/define@/-markup@/-commands@/.scm}.
688 @unnumberedsubsubsec Text alignment
690 @cindex Text, Ausrichtung
691 @cindex Ausrichtung von Text
693 Dieser Abschnitt zeigt, wie man Text im Textbeschriftungsmodus
694 eingibt. Textobjekte können auch als eine Einheit verschoben
695 werden, wie beschrieben in @rlearning{Moving objects}.
697 @c Padding commands should be mentioned on this page, but
698 @c most of these require \box to be more clearly illustrated. -vv
700 @cindex Text, horizontale Ausrichtung
701 @cindex horizontale Ausrichtung von Text
702 @funindex \left-align
703 @funindex \center-align
704 @funindex \right-align
706 Textbeschriftungsobjekte können auf verschiedene Weise ausgerichtet
707 werden. Standardmäßig wird ein Textobjekt an seiner linken Ecke
708 ausgerichtet, darum wird das erste und zweite Objekt gleichermaßen
709 an der linken Ecke ausgerichtet.
711 @lilypond[quote,verbatim,relative=2]
714 d-\markup { \left-align poco }
716 d-\markup { \center-align { poco } }
718 d-\markup { \right-align poco }
723 Die horizontale Ausrichtung kann mit einer Zahl auf einen exakten
724 Wert festgelegt werden:
726 @lilypond[quote,verbatim,relative=2]
727 a1-\markup { \halign #-1 poco }
729 a,-\markup { \halign #0 poco }
731 a,-\markup { \halign #0.5 poco }
733 a,-\markup { \halign #2 poco }
737 Manche Objekte haben eigene Ausrichtungsvorgänge und werden deshalb
738 nicht von diesen Befehlen beeinflusst. Es ist möglich, solche
739 Objekte als eine Einheit anzusprechen und zu bewegen, wie
740 gezeigt in @ref{Text marks}.
742 @cindex Text, vertikale Ausrichtung
743 @cindex vertickale Ausrichtung von Text
747 Die vertikale Ausrichtung ist etwas schwieriger. Textelemente
748 können komplett verschoben werden, es ist aber auch möglich, nur
749 einen Teil innerhalb der Textbeschriftung zu bewegen. In diesem
750 Fall muss dem zu verschiebenden Objekt ein Ankerpunkt zugewiesen
751 werden, welcher entweder ein anderes Textelement oder ein
752 unsichtbares Objekt sein kann (im Beispiel mit @code{\null} erstellt).
753 Der letzte Text im Beispiel hat keinen Anker und wird deshalb auch nicht verschoben.
755 @lilypond[quote,verbatim,relative=1]
758 \raise #2 { Scène 1 }
763 \lower #4 \bold { Très modéré }
767 \raise #4 \italic { Une forêt. }
772 @funindex \general-align
774 @funindex \translate-scaled
776 Einige Befehle können sowohl die horizontale als auch die vertikale
777 Ausrichtung von Textobjekten beeinflussen. Jedes Objekt, das auf
778 diese Weise verschoben wird, benötigt einen Anker:
780 @lilypond[quote,verbatim,relative=1]
783 \translate #'(-1 . 2) "Scène 1"
788 \general-align #Y #3.2 \bold "Très modéré"
793 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
799 @funindex \center-column
801 @cindex mehrzeiliger Text
802 @cindex Text, mehrere Zeilen
806 Ein Textbeschriftungsobjekt kann mehrere Zeilen beinhalten. Im folgenden
807 Beispiel wird jeder Ausdruck innerhalb von @code{\markup} auf einer
808 eigenen Zeile gesetzt, entweder linksbündig oder zentriert:
810 @lilypond[quote,verbatim]
828 @cindex Text auf der Seite zentrieren
829 @cindex Zentrieren von Text auf der Seite
831 Eine Anzahl an Ausdrücken innerhalb von @code{\markup} kann auch
832 gestreckt werden, so dass die gesamte Seitenbreite benutzt wird. Wenn
833 nur ein Objekt vorhanden ist, wird es zentriert gesetzt. Die Ausdrücke
834 selber können wiederum mehrzeilig sein und andere Textbeschriftungsbefehle
837 @lilypond[quote,verbatim]
840 \line { William S. Gilbert }
842 \huge \smallCaps "The Mikado"
844 \smallCaps "The Town of Titipu"
846 \line { Sir Arthur Sullivan }
857 @cindex Umbruch von Text
858 @cindex Blocksatz, Text
859 @cindex Text, Blocksatz
861 Längere Texte können auch automatisch umgebrochen werden, wobei es
862 möglich ist, die Zeilenbreite zu bestimmen. Der Text ist entweder
863 linksbündig oder im Blocksatz, wie das nächste Beispiel illustriert:
865 @lilypond[quote,verbatim]
868 \line \smallCaps { La vida breve }
869 \line \bold { Acto I }
871 (La escena representa el corral de una casa de
872 gitanos en el Albaicín de Granada. Al fondo una
873 puerta por la que se ve el negro interior de
874 una Fragua, iluminado por los rojos resplandores
879 \line \bold { Acto II }
880 \override #'(line-width . 50)
882 (Calle de Granada. Fachada de la casa de Carmela
883 y su hermano Manuel con grandes ventanas abiertas
884 a través de las que se ve el patio
885 donde se celebra una alegre fiesta)
891 Eine vollständige Liste der Textausrichtungsbefehle findet sich in
896 @rlearning{Moving objects}.
905 Installierte Dateien:
906 @file{scm/@/define@/-markup@/-commands@/.scm}.
908 Referenz der Interna:
909 @rinternals{TextScript}.
913 @node Graphic notation inside markup
914 @unnumberedsubsubsec Graphic notation inside markup
916 @cindex Graphik, eingebunden
917 @cindex Illustrationen im Text
918 @cindex Zeichnen im Text
919 @cindex Abbildungen im Text
921 Verschiedene graphische Objekte können im Textbeschriftungsmodus
926 @funindex \rounded-box
930 @cindex Kasten, Graphik
931 @cindex gerundeter Kasten, Graphik
932 @cindex Klammern, Graphik
933 @cindex Text verzieren
934 @cindex Text einrahmen
937 Mit bestimmten Textbeschriftungsbefehlen kann man Textelementen
938 Graphik hinzufügen, wie das nächste Beispiel zeigt:
940 @lilypond[quote,verbatim]
949 \bracket "1866 - 1925"
952 \rounded-box \bold Prelude
957 @funindex \pad-markup
959 @funindex \pad-to-box
960 @funindex \pad-around
962 @cindex Platz um Text
964 @cindex Füllung um Text
965 @cindex Text, Rand außen
967 Es kann nötig sein, einem Text mehr Platz einzuräumen. Das geschieht mit
968 verschiedenen Befehlen, wie das folgende Beispiel zeigt. Eine ausführliche
969 Übersicht findet sich in @ref{Align}.
971 @lilypond[quote,verbatim]
974 \box "Charles Ives (1874 - 1954)"
976 \box \pad-markup #2 "THE UNANSWERED QUESTION"
977 \box \pad-x #8 "A Cosmic Landscape"
984 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
985 \bold "Largo to Presto"
988 "String quartet keeps very even time,
989 Flute quartet keeps very uneven time."
994 @funindex \draw-circle
995 @funindex \filled-box
998 @funindex \arrow-head
1000 @cindex Graphische Notation
1001 @cindex Symbole, nicht Musik-
1003 Andere graphische Elemente oder Symbole können gesetzt werden, ohne dass
1004 man Text benötigt. Wie mit allen Textbeschriftungen können Objekte
1005 innerhalb von @code{\markup} kombiniert werden.
1007 @lilypond[quote,verbatim]
1010 \draw-circle #4 #0.4 ##f
1011 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1017 \draw-line #'(0 . 4)
1018 \arrow-head #Y #DOWN ##f
1024 @funindex \postscript
1026 @cindex Einbinden von Graphik
1027 @cindex Bilder einbinden
1028 @cindex Graphik einbinden
1029 @cindex Postscript, Graphik
1031 Fortgeschrittene graphische Möglichkeiten bietet unter Anderem eine
1032 Funktion, mit der man externe Graphiken im
1033 Encapsulated PostScript (@emph{eps}) -Format einbinden kann oder
1034 aber Graphiken direkt in den Quelltext unter Verwendung von
1035 PostScript-Code notiert. In diesem Fall kann es nötig sein, die
1036 Größe der Zeichnung explizit anzugeben, wie im Beispiel unten gezeigt:
1038 @lilypond[quote,verbatim,relative=1]
1041 \epsfile #X #10 #"./context-example.eps"
1042 \with-dimensions #'(0 . 6) #'(0 . 10)
1058 Eine ausführliche Liste der Graphik-Befehle findet sich in
1064 @ref{Editorial annotations}.
1069 Referenz der Interna:
1070 @rinternals{TextScript}.
1072 Installierte Dateien:
1073 @file{scm/@/define@/-markup@/-commands@/.scm},
1074 @file{scm/@/stencil@/.scm}.
1078 @node Music notation inside markup
1079 @unnumberedsubsubsec Music notation inside markup
1081 @cindex Notationsobjekte, Einfügen
1082 @cindex Einfügen von Notationsobjekten
1083 @cindex Musikobjekte, Einfügen
1085 Auch Musikobjekte können innerhalb der Textbeschriftungsumgebung gesetzt
1088 Noten und Versetzungszeichen lassen sich mit @code{\markup} einfügen:
1090 @lilypond[quote,verbatim,relative=2]
1094 \note-by-number #1 #1 #1.5
1097 \natural \semiflat \flat
1098 \sesquiflat \doubleflat
1102 \natural \semisharp \sharp
1103 \sesquisharp \doublesharp
1108 Andere Notationsobjekte können auch eingefügt werden:
1110 @lilypond[quote,verbatim,relative=1]
1117 fis_\markup { \dynamic rf }
1128 Allgemeiner gesagt kann jedes verfügbare Notationssymbol unabhängig
1129 von der Notation als ein Textbeschriftungsobjekt eingefügt werden, wie
1130 unten gezeigt. Eine vollständige Liste der verfügbaren Symbole findet
1132 @ref{The Feta font}.
1134 @lilypond[quote,verbatim,relative=2]
1136 c'^\markup { \musicglyph #"eight" }
1138 c,8._\markup { \musicglyph #"clefs.G_change" }
1140 c2^\markup { \musicglyph #"timesig.neomensural94" }
1143 @c TODO: add \lookup here? -vv
1144 @c Probably better not to document \lookup, which is useful only for
1145 @c printing braces, and instead document \left-brace and \right-brace
1146 @c when these become available -td
1149 Eine andere Möglichkeit, andere als Textsymbole zu schreiben, findet sich
1151 @ref{Fonts explained}.
1153 Der Textbeschriftungsmodus unterstützt auch Diagramme für bestimmte
1156 @lilypond[quote,verbatim,relative=2]
1158 \fret-diagram-terse #"x;x;o;2;3;2;"
1161 \harp-pedal #"^-v|--ov^"
1166 \musicglyph #"accordion.accDiscant"
1168 \raise #0.5 \musicglyph #"accordion.accDot"
1169 \raise #1.5 \musicglyph #"accordion.accDot"
1173 @c The accordion diagram is actually taken from a snippet.
1176 Derartige Digramme sind dokumentiert in @ref{Instrument Specific Markup}.
1178 Sogar eine ganze Partitur kann in ein Textbeschriftungsobjekt eingefügt
1179 werden. In diesem Fall muss die eingefügte @code{\score}-Umgebung
1180 eine @code{\layout}-Umgebung haben, wie in diesem Beispiel:
1182 @lilypond[quote,verbatim,relative=1]
1185 \relative { c4 d e f }
1193 Eine vollständige Liste der Musiksymbol-Befehle findet sich in
1199 @ref{The Feta font},
1200 @ref{Fonts explained}.
1205 Referenz der Interna:
1206 @rinternals{TextScript}.
1208 Installierte Dateien:
1209 @file{scm/@/define@/-markup@/-commands@/.scm},
1210 @file{scm/@/fret@/-diagrams@/.scm},
1211 @file{scm/@/harp@/-pedals@/.scm}.
1215 @node Multi-page markup
1216 @unnumberedsubsubsec Multi-page markup
1218 Normale Textbeschriftungsobjekte können nicht getrennt werden, aber mit
1219 einer spezifischen Umgebung ist es möglich, Text auch über mehrere Seiten
1222 @lilypond[quote,verbatim]
1225 A very long text of justified lines.
1229 Another very long paragraph.
1236 Die Syntax braucht eine Liste von Textbeschriftungen folgender Art:
1240 das Resultat eines Beschriftungslistenbefehls,
1242 eine Textbeschriftungsliste,
1244 eine Liste von Beschriftungslisten.
1247 Eine vollständige Liste der Beschriftungslistenbefehle findet sich in
1248 @ref{Text markup list commands}.
1252 @ref{Text markup list commands},
1253 @ref{New markup list command definition}.
1258 Referenz der Interna: @rinternals{TextScript}.
1260 Installierte Dateien:
1261 @file{scm/@/define@/-markup@/-commands@/.scm}.
1265 @funindex \markuplines
1266 @code{\markuplines}.
1273 Dieser Abschnitt zeigt, wie Schriftarten eingesetzt werden können und
1274 wie man sie in Partituren ändern kann.
1278 * Single entry fonts::
1279 * Entire document fonts::
1282 @node Fonts explained
1283 @unnumberedsubsubsec Fonts explained
1286 @cindex Schriftarten, Hintergrundinformation
1287 @funindex font-interface
1289 Schriftarten werden von mehreren Bibliotheken verwaltet. FontConfig wird
1290 benützt, um die vorhandenen Schriftarten des Systems zu erkennen, die
1291 gewählte Schriftart wird dann mit Pango verarbeitet.
1293 Notationsschriftarten können als eine Ansammlung von besonderen Zeichen
1294 erklärt werden, wobei die Sonderzeichen in verschiedene Familien
1295 klassifiziert werden. Die Syntax des folgenden Beispiels ermöglicht es,
1296 direkt auf verschiedene nicht textuelle Sonderzeichen der
1297 @code{feta}-Schriftart zuzugreifen. Das ist die Standardschriftart
1298 für Notationselemente in LilyPond.
1300 @lilypond[quote,verbatim,relative=2]
1303 \override #'(font-encoding . fetaBraces)
1305 \override #'(font-encoding . fetaNumber)
1307 \override #'(font-encoding . fetaDynamic)
1309 \override #'(font-encoding . fetaMusic)
1310 \lookup #"noteheads.s0petrucci"
1316 Eine einfachere, aber weniger vielfältige Syntax wird beschrieben in
1317 @ref{Music notation inside markup}.
1319 Drei Textschriftarten sind verfügbar (auf Englisch @code{family} genannt):
1320 mit @code{roman} eine Schriftart
1321 mit Serifen (Standard ist New Century Schoolbook), mit @code{sans}
1322 eine serifenlose (gerade) Schriftart und mit @code{typewriter} eine
1323 Schreibmaschinenschrift, in welcher die Buchstaben alle die gleiche
1324 Weite haben. Die aktuelle Schriftart von @code{sans} und
1325 @code{tpyewriter} wird durch Pango entspechend den Systemvorgaben
1328 Jede Familie kann verschiedene Schriftschnitte besitzen. Im Englischen
1329 wird unterschieden zwischen @code{shape} für kursive Schnitte und
1330 @code{series} für fette Schnitte. Im folgenden Beispiel wird
1331 demonstriert, wie man die verschiedenen Eigenschaften auswählen kann.
1332 Der Wert, der @code{font-size} übergeben wird, entspricht der geforderten
1333 Änderung in Bezug auf die Standardschriftgröße.
1335 @lilypond[quote,verbatim,relative=2]
1336 \override Score.RehearsalMark #'font-family = #'typewriter
1337 \mark \markup "Ouverture"
1338 \override Voice.TextScript #'font-shape = #'italic
1339 \override Voice.TextScript #'font-series = #'bold
1340 d'2.^\markup "Allegro"
1341 \override Voice.TextScript #'font-size = #-3
1346 Eine ähnliche Syntax kann im Textbeschriftungsmodus eingesetzt werden,
1347 hier bietet es sich aber an, die einfacheren Befehle zu verwenden, die
1349 @ref{Selecting font and font size}:
1351 @lilypond[quote,verbatim]
1355 \override #'(font-shape . italic)
1356 \override #'(font-size . 4)
1360 \override #'(font-family . typewriter)
1362 \override #'(font-series . bold)
1366 \override #'(font-family . sans)
1373 Auch wenn es einfach ist, zwischen den vorefinierten Schriftarten
1374 umzuschalten, kann man auch eigene Schriftarten verwenden, wie erklärt
1375 in folgenden Abschnitten: @ref{Single entry fonts} und
1376 @ref{Entire document fonts}.
1380 @ref{The Feta font},
1381 @ref{Music notation inside markup},
1382 @ref{Selecting font and font size},
1386 @node Single entry fonts
1387 @unnumberedsubsubsec Single entry fonts
1389 Jede Schriftart, die über das Betriebssystem installiert ist und von
1390 FontConfig erkannt wird, kann in einer Partitur eingefügt werden. Dazu
1391 verwendet man folgende Syntax:
1393 @lilypond[quote,verbatim,relative=2]
1394 \override Staff.TimeSignature #'font-name = #"Charter"
1395 \override Staff.TimeSignature #'font-size = #2
1399 \override #'(font-name . "Vera Bold")
1404 @funindex show-available-fonts
1406 Mit folgendem Befehl erhält man eine Liste aller verfügbaren Schriftarten
1407 des Betriebssystems:
1410 lilypond -dshow-available-fonts x
1414 Das letzte Argument kann ein beliebiges Zeichen sein, aber es darf nicht
1419 @ref{Fonts explained},
1420 @ref{Entire document fonts}.
1425 Installierte Dateien:
1426 @file{lily/@/font@/-config@/-scheme@/.cc}.
1430 @node Entire document fonts
1431 @unnumberedsubsubsec Entire document fonts
1433 Es ist auch möglich, die Schriftarten für die gesamte Partitur zu ändern.
1434 In diesem Fall müssen die Familien @code{roman},
1435 @code{sans} und @code{typewriter} in genaus dieser Reihenfolge
1436 entsprechend der Syntax unten definiert werden. Einzelheiten zu
1437 Schriftarten in @ref{Fonts explained}.
1439 @cindex Schriftartenfamilien, Definieren
1440 @funindex make-pango-font-tree
1442 @lilypond[verbatim,quote]
1446 (make-pango-font-tree "Times New Roman"
1449 (/ myStaffSize 20)))
1456 \typewriter typewriter. }
1460 @c we don't do Helvetica / Courier, since GS incorrectly loads
1465 @ref{Fonts explained},
1466 @ref{Single entry fonts},
1467 @ref{Selecting font and font size},