1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
4 Translation of GIT committish: e5a609e373eae846857f9a6d70a402a3d42b7d94
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes.
13 @c Translators: Till Paala
19 @lilypondfile[quote]{text-headword.ly}
21 Dieser Abschnitt erklärt, wie man Text (mit vielfältiger
22 Formatierung) in Partituren einfügt.
25 Einige Textelemente, die hier nicht behandelt werden, finden sich
26 in anderen Abschnitten: @ref{Notation von Gesang}, @ref{Titel}.
36 @subsection Text eingeben
37 @translationof Writing text
39 Dieser Abschnitt zeigt verschiedene Arten, wie Text in die Partitur
40 eingefügt werden kann.
42 @cindex Text, andere Sprachen
44 @warning{Wenn man Zeichen mit Akzenten und Umlaute oder besondere
45 Zeichen (wie etwa Text mit anderen Alphabeten) eingeben möchte,
46 kann man die Zeichen einfach direkt in die Datei einfügen. Die
47 Datei muss als UTF-8 gespeichert werden. Für mehr Information
48 siehe @ref{Zeichenkodierung}.}
52 * Text mit Verbindungslinien::
53 * Textartige Zeichen::
59 @unnumberedsubsubsec Textarten
60 @translationof Text scripts
63 @cindex Textelemente, nicht leer
64 @cindex zitierter Text
66 Am einfachsten kann Text mit geraden Anführungsstrichen
67 in eine Partitur eingefügt werden, wie das folgende Beispiel
68 zeigt. Derartiger Text kann manuell über oder unter dem
69 Notensystem platziert werden, die Syntax hierzu ist beschrieben
70 in @ref{Richtung und Platzierung}.
72 @lilypond[quote,verbatim]
73 \relative { a'8^"pizz." g f e a4-"scherz." f }
76 Diese Syntax ist eine Kurzform, komplexere Formatierungen
77 können einem Text hinzugefügt werden, wenn man
78 explizit den @code{\markup}-Befehl mit darauf folgenden
79 geschweiften Klammern einsetzt, wie beschrieben in
80 @ref{Text formatieren}.
82 @lilypond[quote,verbatim]
84 a'8^\markup { \italic pizz. } g f e
85 a4_\markup { \tiny scherz. \bold molto } f }
88 Standardmäßig haben Textbeschriftungen keinen Einfluss auf die
89 Positionierung der Noten. Man kann aber auch bestimmen, dass
90 die Breite des Textes mit berücksichtigt wird. Im nächsten
91 Beispiel fordert der erste Text keinen Platz, während der
92 zweite die Note nach rechts verschiebt. Das Verhalten wird mit
93 dem Befehl @code{\textLengthOn} (Textlänge an) erreicht, rückgängig
94 kann es mit dem Befehl @code{\textLengthOff} gemacht werden.
96 @lilypond[quote,verbatim]
104 Neben Textbeschriftungen können auch Artikulationen an Noten angehängt
105 werden. Siehe auch @ref{Artikulationszeichen und Verzierungen}.
107 Zu weiterer Information zu der relativen Anordnung von Textbeschriftungen
108 und Artikulationen, siehe @rlearning{Positionierung von Objekten}.
110 @funindex \textLengthOn
111 @funindex \textLengthOff
112 @funindex textLengthOn
113 @funindex textLengthOff
116 @code{\textLengthOn},
117 @code{\textLengthOff}.
123 @rlearning{Positionierung von Objekten}.
126 @ref{Text formatieren},
127 @ref{Richtung und Platzierung},
128 @ref{Artikulationszeichen und Verzierungen}.
133 Referenz der Interna:
134 @rinternals{TextScript}.
136 @cindex Text außerhalb des Randes
137 @cindex Rand, überhängender Text
138 @cindex Seitenrand, überhängender Text
139 @cindex Gesangstext, innerhalb des Randes behalten
140 @cindex Text, innerhalb des Randes behalten
143 Eine Überprüfung, ob sich auch alle Textbeschriftungen und Gesangstext
144 innerhalb der Ränder der Noten befinden, braucht verhältnismäßig
145 viel Rechenaufwand. Sollten Sie aber etwas bessere Leistung bevorzugen,
146 schreiben Sie in Ihre Datei:
149 \override Score.PaperColumn.keep-inside-line = ##f
154 @node Text mit Verbindungslinien
155 @unnumberedsubsubsec Text mit Verbindungslinien
156 @translationof Text spanners
159 @cindex Strecker, Text
161 Einige Aufführungsanweisungen, etwa @notation{rallentando} oder
162 @notation{accelerando}, werden als Text geschrieben, gefolgt von
163 einer gestrichelten Linie, die anzeigt, wie weit sich die Anweisung
164 auswirkt. Solche Objekte, @qq{Strecker} (engl. spanners) genannt,
165 können von einer Note bis zu einer anderen mit folgender
166 Anweisung erstellt werden:
168 @lilypond[verbatim,quote]
170 \override TextSpanner.bound-details.left.text = "rit."
176 @cindex Textstrecker, Formatierung
177 @cindex Formatierung von Textstreckern
178 @cindex Strecker, Text-, Formatierung
181 Der Text wird durch Objekteigenschaften beeinflusst. In den
182 Standardeinstellungen wird er kursiv ausgegeben, aber eine andere
183 Formatierung kann erreicht werden, indem man @code{\markup}-Blöcke
184 einsetzt, wie beschrieben in @ref{Text formatieren}.
186 @lilypond[quote,verbatim]
188 \override TextSpanner.bound-details.left.text =
189 \markup { \upright "rit." }
195 Auch der Stil der Linie kann ähnlich wie der Text mit den Objekteigenschaften
196 geändert werden. Diese Syntax ist beschrieben in @ref{Linienstile}.
197 Textstrecker sind Teil des @code{Dynamic}-Kontextes, siehe
198 @rinternals{Dynamics}.
200 @funindex textSpannerUp
201 @funindex textSpannerDown
202 @funindex textSpannerNeutral
203 @funindex \textSpannerUp
204 @funindex \textSpannerDown
205 @funindex \textSpannerNeutral
208 @code{\textSpannerUp},
209 @code{\textSpannerDown},
210 @code{\textSpannerNeutral}.
216 @lilypondfile[verbatim,quote,texidoc,doctitle]
217 {dynamics-text-spanner-postfix.ly}
219 @lilypondfile[verbatim,quote,texidoc,doctitle]
220 {dynamics-custom-text-spanner-postfix.ly}
227 @ref{Text formatieren}.
231 @rlsr{Expressive marks}.
233 Referenz der Interna:
234 @rinternals{TextSpanner}
237 @node Textartige Zeichen
238 @unnumberedsubsubsec Textartige Zeichen
239 @translationof Text marks
242 @cindex textartige Zeichen
243 @cindex Zeichen, textartige
244 @cindex Text am Taktstrich
245 @cindex Coda am Taktstrich
246 @cindex Segno an Taktstrich
247 @cindex Fermate an Taktstrich
248 @cindex Taktstrich, Symbole anfügen
249 @cindex Symbole auf der Taktstrich
254 Verschiedene Textelemente können der Partitur hinzugefügt werden,
255 indem man die Syntax für Zeichen einsetzen, wie beschrieben in
258 @c \mark needs to be placed on a separate line (it's not
259 @c attached to an object like \markup is). -vv
261 @lilypond[verbatim,quote]
269 Diese Syntax ermöglicht es, beliebigen Text über eine Taktlinie
270 zu platzieren, weitere Formatierungsmöglichkeiten sind mit dem
271 @code{\markup}-Befehl gegeben, wie beschrieben in
272 @ref{Text formatieren}:
274 @lilypond[quote,verbatim]
277 \mark \markup { \italic { colla parte } }
284 Diese Syntax ermöglicht es auch, besondere Zeichen einzufügen, wie
285 etwa Coda-, Segno- oder Fermatenzeichen, indem das entsprechende
286 Symbol mit dem Befehl @code{\musicglyph} angegeben wird, wie
288 @ref{Musikalische Notation innerhalb einer Textbeschriftung}:
290 @lilypond[quote,verbatim]
293 \mark \markup { \musicglyph #"scripts.ufermata" }
299 Derartige Objekte werden über dem höchsten System einer Partitur
300 gesetzt -- abhängig davon, ob sie mitten im Takt oder an seinem
301 Ende notiert werden, werden sie zwischen Noten oder über der
302 Taktlinie gesetzt. Wenn sie an einem Zeilenumbruch angegeben
303 werden, wird das Zeichen zu Beginn der nächsten Zeile ausgegeben.
305 @lilypond[quote,verbatim,relative=2]
315 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
316 {printing-marks-at-the-end-of-a-line.ly}
318 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
319 {printing-marks-on-every-staff.ly}
324 @ref{Text formatieren},
325 @ref{Musikalische Notation innerhalb einer Textbeschriftung},
326 @ref{Die Feta-Schriftart}.
331 Referenz der Interna:
332 @rinternals{MarkEvent},
333 @rinternals{Mark_engraver},
334 @rinternals{RehearsalMark}.
337 Wenn ein Zeichen am Ende des letzten Taktes einer Partitur gesetzt wird
338 (wenn also keine nächste Zeile mehr kommt), wird das Zeichen nicht
344 @unnumberedsubsubsec Separater Text
345 @translationof Separate text
347 @cindex separater Text
350 @cindex Text, oberste Ebene
351 @cindex oberste Ebene, Text
355 Eine @code{\markup}-Umgebung kann auch für sich alleine existieren,
356 außerhalb einer @code{\score}-Umgebung, als ein Ausdruck auf der
357 höchsten Ebene. Diese Syntax ist beschrieben in @ref{Die Dateistruktur}.
360 @lilypond[verbatim,quote]
362 Morgen, morgen, und morgen...
367 Damit kann Text unabhängig von den Noten gesetzt werden. Das
368 bietet sich vor allem in Situationen an, in denen mehrere Stücke
369 in einer Datei vorkommen, wie beschrieben in
370 @ref{Mehrere Partituren in einem Buch}.
373 @lilypond[quote,verbatim]
378 Morgen, übermorgen, und überübermorgen...
385 Unabhängige Textabschnitte können über mehrere Seiten reichen, so
386 dass man Textdokumente oder Bücher ausschließlich mit LilyPond
387 setzen kann. Einzelheiten zu den vielfältigen Möglichkeiten finden
388 sich in @ref{Textbeschriftung über mehrere Seiten}.
390 @funindex \markuplist
403 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
404 {stand-alone-two-column-markup.ly}
408 @ref{Text formatieren},
409 @ref{Die Dateistruktur},
410 @ref{Mehrere Partituren in einem Buch},
411 @ref{Textbeschriftung über mehrere Seiten}.
416 Referenz der Interna:
417 @rinternals{TextScript}.
421 @node Text formatieren
422 @subsection Text formatieren
423 @translationof Formatting text
425 Dieser Abschnitt zeigt grundlegende und fortgeschrittene
426 Formatierung von Text, wobei der Textbeschriftungsmodus
427 (@code{\markup} benutzt wird.
430 * Textbeschriftung (Einleitung)::
431 * Überblick über die wichtigsten Textbeschriftungsbefehle::
433 * Graphische Notation innerhalb einer Textbeschriftung::
434 * Musikalische Notation innerhalb einer Textbeschriftung::
435 * Textbeschriftung über mehrere Seiten::
438 @node Textbeschriftung (Einleitung)
439 @unnumberedsubsubsec Textbeschriftung (Einleitung)
440 @translationof Text markup introduction
443 @cindex Textbeschriftung
444 @cindex Beschriftung, Text
445 @cindex Setzen von Text
449 Eine @code{\markup}-Umgebung wird benutzt, um Text mit einer
450 großen Anzahl von Formatierungsmöglichkeiten (im @qq{markup-Modus})
453 @cindex Textbeschriftungs-Ausdrücke
455 @cindex markup, Syntax
456 @cindex Ausdrück, Text
458 Die Syntax für Textbeschriftungen ähnelt der normalen Syntax von
459 LilyPond: ein @code{\markup}-Ausdruck wird in geschweifte Klammern
460 eingeschlossen (@code{@{@dots{} @}}). Ein einzelnes Wort wird als
461 ein Minimalausdruck erachtet und muss deshalb nicht notwendigerweise
462 eingeklammert werden.
464 Anders als Text in Anführungsstrichen können sich in einer
465 Textbeschriftungsumgebung (@code{\markup}) geschachtelte Ausdrücke
466 oder weitere Textbefehle befinden, eingeführt mit einem
467 Backslash@tie{}(@code{\}). Derartige Befehle beziehen sich nur auf
468 den ersten der folgenden Ausdrücke.
470 @lilypond[quote,verbatim]
473 a2^\markup { poco \italic più forte }
475 d2_\markup { \italic "string. assai" }
477 b1^\markup { \bold { molto \italic agitato } }
482 @cindex Sonderzeichen in Textbeschriftungen
483 @cindex Textbeschriftung, Sonderzeichen
484 @cindex besondere Zeichen, Text
485 @cindex Text mit Sonderzeichen
486 @cindex Anführungsstriche im Text
487 @cindex Drucken von Sonderzeichen
488 @cindex Setzen von Sonderzeichen
489 @cindex Beschriftung, Sonderzeichen
491 Eine @code{\markup}-Umgebung kann auch Text in
492 Anführungszeichen beinhalten. Derartige Zeichenketten werden als
493 ein Textausdruck angesehen, und darum werden innerhalb von ihnen
494 Befehle oder Sonderzeichen (wie @code{\} oder@tie{}@code{#}) so
495 ausgegeben, wie sie eingeben werden. Doppelte Anführungsstriche
496 können gesetzt werden, indem man ihnen einen Backslash voranstellt.
499 @lilypond[quote,verbatim]
501 a'1^"\italic Text..."
502 a_\markup { \italic "... setzt \"kursive\" Buchstaben!" }
507 Damit eine Anzahl von Wörtern als ein einziger Ausdruck behandelt
508 wird, müssen alle Wörter zwischen geraden Anführungszeichen (Shift+2)
509 stehen oder ihnen muss ein Befehl vorangestellt werden. Die Art,
510 wie die Ausdrücke definiert sind, wirkt sich darauf aus, wie
511 sie übereinander gestapelt, mittig und aneinander ausgerichtet
512 werden. Im folgenden Beispiel verhält sich der zweite
513 @code{\markup}-Ausdruck genauso wie der erste:
515 @lilypond[quote,verbatim]
517 c1^\markup { \center-column { a bbb c } }
518 c1^\markup { \center-column { a { bbb c } } }
519 c1^\markup { \center-column { a \line { bbb c } } }
520 c1^\markup { \center-column { a "bbb c" } }
524 Textbeschriftung kann auch durch Variablen definiert werden. Diese
525 Variablen können dann direkt an Noten angefügt werden:
527 @lilypond[quote,verbatim]
528 allegro = \markup { \bold \large Allegro }
537 Eine ausführliche Liste der @code{\markup}-Befehle findet sich in
538 @ref{Textbeschriftungsbefehle}.
542 @ref{Textbeschriftungsbefehle}.
547 Installierte Dateien:
548 @file{scm/markup.scm}.
551 Syntaxfehler im Textbeschriftungsmodus können sehr verwirrend sein.
554 @node Überblick über die wichtigsten Textbeschriftungsbefehle
555 @unnumberedsubsubsec Überblick über die wichtigsten Textbeschriftungsbefehle
556 @translationof Selecting font and font size
558 @cindex Schriftschnitt verändern
559 @cindex Schriftart verändern
560 @cindex Verändern der Schriftart
569 Einfache Änderungen des Schriftartschnitts können im Textbeschriftungsmodus
572 @lilypond[quote,verbatim]
576 \italic { non troppo \underline Vivo }
579 d,_\markup { \italic quasi \smallCaps Tromba }
586 @cindex Größe der Schriftart
588 @funindex \abs-fontsize
598 Die Schriftgröße kann auf verschiedene Arten verändert werden, relativ
599 zur globalen Notensystemgröße:
601 Sie kann auf eine vordefinierte Größe gesetzt werden:
603 @lilypond[quote,verbatim]
605 b1_\markup { \huge Sinfonia }
606 b1^\markup { \teeny da }
607 b1-\markup { \normalsize camera }
611 Sie kann relativ zum vorherigen Wert gesetzt werden:
613 @lilypond[quote,verbatim]
615 b1_\markup { \larger Sinfonia }
616 b1^\markup { \smaller da }
617 b1-\markup { \magnify #0.6 camera }
621 Sie kann vergrößert oder verkleinert werden relativ zum Wert, der
622 von der globalen Notensystemgröße vorgegeben wird:
624 @lilypond[quote,verbatim]
626 b1_\markup { \fontsize #-2 Sinfonia }
627 b1^\markup { \fontsize #1 da }
628 b1-\markup { \fontsize #3 camera }
632 Sie kann auch auf eine bestimmte Punktegröße festgelegt werden, unabhängig von
633 der globalen Notensystemgröße:
635 @lilypond[quote,verbatim]
637 b1_\markup { \abs-fontsize #20 Sinfonia }
638 b1^\markup { \abs-fontsize #8 da }
639 b1-\markup { \abs-fontsize #14 camera }
644 @cindex tiefergestellt
648 @funindex \normal-size-super
650 Text kann auch hoch- bzw. tiefgestellt gesetzt werden. Die so markierten
651 Buchstaben werden automatisch in einer kleineren Schriftgröße gesetzt,
652 aber die normale Schriftgröße kann auch eingesetzt werden:
654 @lilypond[quote,verbatim]
657 \line { 1 \super st movement }
658 \line { 1 \normal-size-super st movement
659 \sub { (part two) } }
664 @cindex Schriftfamilien
665 @cindex Schriftschnitte
667 Der Textbeschriftungsmodus stellt eine einfache Möglichkeit zur Verfügung
668 unterschiedliche Schriftschnitte anzuwählen. Ohne besondere Einstellungen
669 wird automatisch eine Schriftart mit Serifen ausgewählt. Das Beispiel
670 unten zeigt die Verwendung der eigenen Zahlenschriftart von LilyPond,
671 den Einsatz von serifenloser Schriftart und von Schreibmaschinenschriftart.
672 Die letzte Zeile zeigt, dass sich die Standardeinstellung mit dem
673 Befehl @code{\roman} wieder herstellen lässt.
675 @lilypond[quote,verbatim]
678 \line { Act \number 1 }
679 \line { \sans { Scene I. } }
680 \line { \typewriter { Verona. An open place. } }
681 \line { Enter \roman Valentine and Proteus. }
687 Einige dieser Schriftarten, etwa die Zahlenschriftart oder die Schriftart
688 für Dynamikzeichen, stellen nicht alle Zeichen zur Verfügung, wie beschrieben
689 in @ref{Neue Lautstärkezeichen} und @ref{Manuelle Wiederholungszeichen}.
691 @c \concat is actually documented in Align (it is not
692 @c a font-switching command). But we need it here. -vv
694 Einige Schriftartbefehle können ungewollte Leerzeichen innerhalb von Wörtern
695 hervorrufen. Das kann vermieden werden, indem die einzelnen Elemente mit
696 dem Befehl @code{\concat} zu einem Element verschmolzen werden:
698 @lilypond[quote,verbatim]
702 \concat { 1 \super st }
706 \concat { \dynamic p , }
707 \italic { con dolce espressione }
713 Eine ausführliche Liste der unterschiedlichen Befehl zur Beeinflussung
714 der Schriftarten findet sich in @ref{Font}.
716 Es ist auch möglich, eigene Schriftfamilien zu definieren, wie erklärt in
722 @funindex \normalsize
751 @ref{Neue Lautstärkezeichen},
752 @ref{Manuelle Wiederholungszeichen},
755 Installierte Dateien:
756 @file{scm/define-markup-commands.scm}.
761 Referenz der Interna:
762 @rinternals{TextScript}.
765 Wenn die Befehle @code{\teeny}, @code{\tiny},
766 @code{\small}, @code{\normalsize}, @code{\large} und
767 @code{\huge} eingesetzt werden, erhält man schlechte Zeilenabstände
768 verglichen mit @code{\fontsize}.
771 @node Textausrichtung
772 @unnumberedsubsubsec Textausrichtung
773 @translationof Text alignment
775 @cindex Text, Ausrichtung
776 @cindex Ausrichtung von Text
777 @cindex Textbeschriftung ausrichten
778 @cindex Beschriftung ausrichten
780 Dieser Abschnitt zeigt, wie man Text im Textbeschriftungsmodus
781 eingibt. Textobjekte können auch als eine Einheit verschoben
782 werden, wie beschrieben in @rlearning{Verschieben von Objekten}.
784 @c Padding commands should be mentioned on this page, but
785 @c most of these require \box to be more clearly illustrated. -vv
787 @cindex Text, horizontale Ausrichtung
788 @cindex horizontale Ausrichtung von Text
790 @funindex \left-align
791 @funindex \center-align
792 @funindex \right-align
794 @funindex center-align
795 @funindex right-align
797 Textbeschriftungsobjekte können auf verschiedene Weise ausgerichtet
798 werden. Standardmäßig wird ein Textobjekt an seiner linken Ecke
799 ausgerichtet, darum wird das erste und zweite Objekt gleichermaßen
800 an der linken Ecke ausgerichtet.
802 @lilypond[quote,verbatim]
804 d''1-\markup { poco }
806 d-\markup { \left-align poco }
808 d-\markup { \center-align { poco } }
810 d-\markup { \right-align poco }
816 Die horizontale Ausrichtung kann mit einer Zahl auf einen exakten
817 Wert festgelegt werden:
819 @lilypond[quote,verbatim]
821 a'1-\markup { \halign #-1 poco }
823 a,-\markup { \halign #0 poco }
825 a,-\markup { \halign #0.5 poco }
827 a,-\markup { \halign #2 poco }
832 Manche Objekte haben eigene Ausrichtungsvorgänge und werden deshalb
833 nicht von diesen Befehlen beeinflusst. Es ist möglich, solche
834 Objekte als eine Einheit anzusprechen und zu bewegen, wie
835 gezeigt in @ref{Textartige Zeichen}.
837 @cindex Text, vertikale Ausrichtung
838 @cindex vertikale Ausrichtung von Text
847 Die vertikale Ausrichtung ist etwas schwieriger. Textelemente
848 können komplett verschoben werden, es ist aber auch möglich, nur
849 einen Teil innerhalb der Textbeschriftung zu bewegen. In diesem
850 Fall muss dem zu verschiebenden Objekt ein Ankerpunkt zugewiesen
851 werden, welcher entweder ein anderes Textelement oder ein
852 unsichtbares Objekt sein kann (im Beispiel mit @code{\null} erstellt).
853 Der letzte Text im Beispiel hat keinen Anker und wird deshalb auch nicht verschoben.
855 @lilypond[quote,verbatim]
859 \raise #2 { Scène 1 }
864 \lower #4 \bold { Très modéré }
868 \raise #4 \italic { Une forêt. }
874 @funindex \general-align
876 @funindex \translate-scaled
877 @funindex general-align
879 @funindex translate-scaled
881 Einige Befehle können sowohl die horizontale als auch die vertikale
882 Ausrichtung von Textobjekten beeinflussen. Jedes Objekt, das auf
883 diese Weise verschoben wird, benötigt einen Anker:
885 @lilypond[quote,verbatim]
889 \translate #'(-1 . 2) "Scène 1"
894 \general-align #Y #3.2 \bold "Très modéré"
899 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
905 @cindex mehrzeiliger Text
906 @cindex Text, mehrere Zeilen
909 @cindex Beschriftung, mehrzeilig
910 @cindex Textbeschriftung, mehrzeilig
913 @funindex \center-column
915 @funindex center-column
917 Ein Textbeschriftungsobjekt kann mehrere Zeilen beinhalten. Im folgenden
918 Beispiel wird jeder Ausdruck innerhalb von @code{\markup} auf einer
919 eigenen Zeile gesetzt, entweder linksbündig oder zentriert:
921 @lilypond[quote,verbatim]
939 @cindex Text auf der Seite zentrieren
940 @cindex Zentrieren von Text auf der Seite
941 @cindex Beschriftung, Zentrieren auf der Seite
945 Eine Anzahl an Ausdrücken innerhalb von @code{\markup} kann auch
946 gestreckt werden, so dass die gesamte Seitenbreite benutzt wird. Wenn
947 nur ein Objekt vorhanden ist, wird es zentriert gesetzt. Die Ausdrücke
948 selber können wiederum mehrzeilig sein und andere Textbeschriftungsbefehle
951 @lilypond[quote,verbatim]
954 \line { William S. Gilbert }
956 \huge \smallCaps "The Mikado"
958 \smallCaps "The Town of Titipu"
960 \line { Sir Arthur Sullivan }
968 @cindex Umbruch von Text
969 @cindex Blocksatz, Text
970 @cindex Text, Blocksatz
971 @cindex Beschriftung, Blocksatz
972 @cindex Textbeschriftung, Blocksatz
979 Längere Texte können auch automatisch umgebrochen werden, wobei es
980 möglich ist, die Zeilenbreite zu bestimmen. Der Text ist entweder
981 linksbündig oder im Blocksatz, wie das nächste Beispiel illustriert:
983 @lilypond[quote,verbatim]
986 \line \smallCaps { La vida breve }
987 \line \bold { Acto I }
989 (La escena representa el corral de una casa de
990 gitanos en el Albaicín de Granada. Al fondo una
991 puerta por la que se ve el negro interior de
992 una Fragua, iluminado por los rojos resplandores
997 \line \bold { Acto II }
998 \override #'(line-width . 50)
1000 (Calle de Granada. Fachada de la casa de Carmela
1001 y su hermano Manuel con grandes ventanas abiertas
1002 a través de las que se ve el patio
1003 donde se celebra una alegre fiesta)
1009 @cindex Textausrichtungsbefehle
1010 @cindex Textausrichtung, Befehle
1011 @cindex Befehle zur Textausrichtung
1012 @cindex Ausrichtung von Text, Befehle
1014 Eine vollständige Liste der Textausrichtungsbefehle findet sich in
1018 Handbuch zum Lernen:
1019 @rlearning{Verschieben von Objekten}.
1023 @ref{Textartige Zeichen}.
1025 Installierte Dateien:
1026 @file{scm/define-markup-commands.scm}.
1031 Referenz der Interna:
1032 @rinternals{TextScript}.
1035 @node Graphische Notation innerhalb einer Textbeschriftung
1036 @unnumberedsubsubsec Graphische Notation innerhalb einer Textbeschriftung
1037 @translationof Graphic notation inside markup
1039 @cindex Graphik, eingebunden
1040 @cindex Illustrationen im Text
1041 @cindex Zeichnen im Text
1042 @cindex Abbildungen im Text
1043 @cindex Objekte, Graphik im Text
1044 @cindex eingebundene Graphik im Text
1046 Verschiedene graphische Objekte können im Textbeschriftungsmodus
1049 @cindex Kasten, Graphik
1050 @cindex gerundeter Kasten, Graphik
1051 @cindex Klammern, Graphik
1052 @cindex Text verzieren
1053 @cindex Text einrahmen
1054 @cindex Rahmen, Text
1058 @funindex \rounded-box
1063 @funindex rounded-box
1067 Mit bestimmten Textbeschriftungsbefehlen kann man Textelementen
1068 Graphik hinzufügen, wie das nächste Beispiel zeigt:
1070 @lilypond[quote,verbatim]
1071 \markup \fill-line {
1079 \bracket "1866 - 1925"
1082 \rounded-box \bold Prelude
1087 @cindex Platz um Text
1088 @cindex Rand um Text
1089 @cindex Füllung um Text
1090 @cindex Text, Rand außen
1092 @funindex \pad-markup
1094 @funindex \pad-to-box
1095 @funindex \pad-around
1096 @funindex pad-markup
1098 @funindex pad-to-box
1099 @funindex pad-around
1101 Es kann nötig sein, einem Text mehr Platz einzuräumen. Das geschieht mit
1102 verschiedenen Befehlen, wie das folgende Beispiel zeigt. Eine ausführliche
1103 Übersicht findet sich in @ref{Align}.
1105 @lilypond[quote,verbatim]
1106 \markup \fill-line {
1108 \box "Charles Ives (1874 - 1954)"
1110 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1111 \box \pad-x #8 "A Cosmic Landscape"
1118 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1119 \bold "Largo to Presto"
1122 "String quartet keeps very even time,
1123 Flute quartet keeps very uneven time."
1127 @cindex Graphische Notation
1128 @cindex Symbole, nicht musikalische
1129 @cindex Notation, graphische
1130 @cindex nichtmusikalische Symbole
1133 @funindex \draw-circle
1134 @funindex \filled-box
1136 @funindex \draw-line
1137 @funindex \arrow-head
1139 @funindex draw-circle
1140 @funindex filled-box
1143 @funindex arrow-head
1145 Andere graphische Elemente oder Symbole können gesetzt werden, ohne dass
1146 man Text benötigt. Wie mit allen Textbeschriftungen können Objekte
1147 innerhalb von @code{\markup} kombiniert werden.
1149 @lilypond[quote,verbatim]
1152 \draw-circle #4 #0.4 ##f
1153 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1159 \draw-line #'(0 . 4)
1160 \arrow-head #Y #DOWN ##f
1165 @cindex Einbinden von Graphik
1166 @cindex Bilder einbinden
1167 @cindex Graphik einbinden
1168 @cindex Postscript, Graphik
1171 @funindex \postscript
1173 @funindex postscript
1175 Fortgeschrittene graphische Möglichkeiten bietet unter Anderem eine
1176 Funktion, mit der man externe Graphiken im
1177 Encapsulated PostScript (@emph{eps}) -Format einbinden kann oder
1178 aber Graphiken direkt in den Quelltext unter Verwendung von
1179 PostScript-Code notiert. In diesem Fall kann es nötig sein, die
1180 Größe der Zeichnung explizit anzugeben, wie im Beispiel unten gezeigt:
1182 @lilypond[quote,verbatim,fragment]
1185 \epsfile #X #10 #"./context-example.eps"
1186 \with-dimensions #'(0 . 6) #'(0 . 10)
1202 Eine ausführliche Liste der Graphik-Befehle findet sich in
1211 Installierte Dateien:
1212 @file{scm/define-markup-commands.scm},
1213 @file{scm/stencil.scm}.
1218 Referenz der Interna:
1219 @rinternals{TextScript}.
1222 @node Musikalische Notation innerhalb einer Textbeschriftung
1223 @unnumberedsubsubsec Musikalische Notation innerhalb einer Textbeschriftung
1224 @translationof Music notation inside markup
1226 @cindex Notationsobjekte, Einfügen
1227 @cindex Einfügen von Notationsobjekten
1228 @cindex Musikobjekte, Einfügen
1229 @cindex Beschriftung, Notationsobjekte einfügen
1230 @cindex Textbeschriftung, Notationsobjekte einfügen
1232 Auch Musikobjekte können innerhalb der Textbeschriftungsumgebung gesetzt
1235 Noten und Versetzungszeichen lassen sich mit @code{\markup} einfügen:
1237 @lilypond[quote,verbatim,fragment]
1241 \note-by-number #1 #1 #1.5
1244 \natural \semiflat \flat
1245 \sesquiflat \doubleflat
1249 \natural \semisharp \sharp
1250 \sesquisharp \doublesharp
1255 Andere Notationsobjekte können auch eingefügt werden:
1257 @lilypond[quote,verbatim,relative=1]
1264 fis_\markup { \dynamic rf }
1275 Allgemeiner gesagt kann jedes verfügbare Notationssymbol unabhängig
1276 von der Notation als ein Textbeschriftungsobjekt eingefügt werden, wie
1277 unten gezeigt. Eine vollständige Liste der verfügbaren Symbole findet
1278 sich in @ref{Die Feta-Schriftart}.
1280 @lilypond[quote,verbatim]
1283 c'^\markup { \musicglyph #"eight" }
1285 c,8._\markup { \musicglyph #"clefs.G_change" }
1287 c2^\markup { \musicglyph #"timesig.neomensural94" }
1292 Eine andere Möglichkeit, andere als Textsymbole zu schreiben, findet sich
1293 in @ref{Was sind Schriftarten}. Diese Methode bietet sich an, um Klammern
1294 unterschiedlicher Größe zu setzen.
1296 Der Textbeschriftungsmodus unterstützt auch Diagramme für bestimmte
1299 @lilypond[quote,verbatim]
1302 \fret-diagram-terse #"x;x;o;2;3;2;"
1305 \harp-pedal #"^-v|--ov^"
1310 \musicglyph #"accordion.discant"
1312 \raise #0.5 \musicglyph #"accordion.dot"
1313 \raise #1.5 \musicglyph #"accordion.dot"
1318 @c The accordion diagram is actually taken from a snippet.
1321 Derartige Digramme sind dokumentiert in @ref{Instrument Specific Markup}.
1323 @cindex Notation innerhalb von Beschriftung
1324 @cindex Notation innerhalb von Text
1325 @cindex Text, Notation innerhalb
1326 @cindex Beschriftung, Notation einfügen
1327 @cindex Notensysteme in Text einfügen
1329 Sogar eine ganze Partitur kann in ein Textbeschriftungsobjekt eingefügt
1330 werden. In diesem Fall muss die eingefügte @code{\score}-Umgebung
1331 eine @code{\layout}-Umgebung haben, wie in diesem Beispiel:
1333 @lilypond[quote,verbatim]
1337 \relative { c'4 d e f }
1346 Eine vollständige Liste der Musiksymbol-Befehle findet sich in @ref{Music}.
1351 @ref{Die Feta-Schriftart},
1352 @ref{Was sind Schriftarten}.
1354 Installierte Dateien:
1355 @file{scm/define-markup-commands.scm},
1356 @file{scm/fret-diagrams.scm},
1357 @file{scm/harp-pedals.scm}.
1362 Referenz der Interna:
1363 @rinternals{TextScript}.
1367 @node Textbeschriftung über mehrere Seiten
1368 @unnumberedsubsubsec Textbeschriftung über mehrere Seiten
1369 @translationof Multi-page markup
1371 @cindex Textbeschriftung über mehrere Seiten
1372 @cindex Beschriftung über mehrere Seiten
1373 @cindex Text über mehrere Seiten
1374 @cindex mehrseitiger Text
1376 @funindex \markuplist
1377 @funindex \justified-lines
1378 @funindex \wordwrap-lines
1380 Normale Textbeschriftungsobjekte können nicht getrennt werden, aber mit
1381 einer spezifischen Umgebung ist es möglich, Text auch über mehrere Seiten
1384 @lilypond[quote,verbatim]
1387 A very long text of justified lines.
1391 Another very long paragraph.
1398 Die Syntax braucht eine Liste von Textbeschriftungen folgender Art:
1402 das Resultat eines Beschriftungslistenbefehls,
1404 eine Textbeschriftungsliste,
1406 eine Liste von Beschriftungslisten.
1409 Eine vollständige Liste der Beschriftungslistenbefehle findet sich in
1410 @ref{Textbeschriftungslistenbefehle}.
1414 @ref{Textbeschriftungslistenbefehle}.
1417 @rextend{Neue Definitionen von Beschriftungslistenbefehlen}.
1419 Installierte Dateien:
1420 @file{scm/define-markup-commands.scm}.
1425 Referenz der Interna:
1426 @rinternals{TextScript}.
1428 @funindex \markuplist
1436 @subsection Schriftarten
1437 @translationof Fonts
1439 Dieser Abschnitt zeigt, wie Schriftarten eingesetzt werden können und
1440 wie man sie in Partituren ändern kann.
1443 * Was sind Schriftarten::
1444 * Schriftarten für einen Eintrag::
1445 * Schriftart des gesamten Dokuments::
1448 @node Was sind Schriftarten
1449 @unnumberedsubsubsec Was sind Schriftarten
1450 @translationof Fonts explained
1453 @cindex Schriftarten, Hintergrundinformation
1454 @cindex Klammern, unterschiedliche Größen
1455 @cindex Schriftarten, Nicht-Text in Beschriftung
1456 @cindex Nicht-Textschriftarten in Beschriftung
1458 @funindex font-interface
1460 Schriftarten werden von mehreren Bibliotheken verwaltet. FontConfig wird
1461 benützt, um die vorhandenen Schriftarten des Systems zu erkennen, die
1462 gewählte Schriftart wird dann mit Pango verarbeitet.
1464 Notationsschriftarten können als eine Ansammlung von besonderen Zeichen
1465 erklärt werden, wobei die Sonderzeichen in verschiedene Familien
1466 klassifiziert werden. Die Syntax des folgenden Beispiels ermöglicht es,
1467 direkt auf verschiedene nicht textuelle Sonderzeichen der
1468 @code{feta}-Schriftart zuzugreifen. Das ist die Standardschriftart
1469 für Notationselemente in LilyPond.
1471 @lilypond[quote,verbatim,fragment]
1474 \override #'(font-encoding . fetaBraces)
1476 \override #'(font-encoding . fetaText)
1478 \override #'(font-encoding . fetaMusic)
1479 \lookup #"noteheads.s0petrucci"
1485 Außer den verschiedenen Klammern, die in @code{fetaBraces}
1486 in verschiedenen Größen enthalten sind, lassen sich alle
1487 dieses Symbole auch mit einer einfacheren Syntax notieren.
1488 Sie ist beschrieben in
1489 @ref{Musikalische Notation innerhalb einer Textbeschriftung}.
1491 Wenn man die Klammern von @code{fetaBraces} benutzt, wird die
1492 Größe der Klammer durch einen numeralen Part in der
1493 Bezeichnung des Glyphs bestimmt. Als Wert kann eine
1494 Ganzzahl von @code{0} bis @code{575} benutzt werden, wobei
1495 @code{0} die kleinste Klammern ergibt. Der optimale Wert
1496 muss durch Ausprobieren herausgefunden werden. Diese Glyphen
1497 sind alle linke Klammern, rechte Klammern lassen sich durch
1498 eine Drehung herstellen, siehe
1499 @ref{Drehen von Objekten}.
1501 Drei Textschriftarten sind verfügbar (auf Englisch @code{family} genannt):
1502 mit @code{roman} eine Schriftart
1503 mit Serifen (Standard ist New Century Schoolbook), mit @code{sans}
1504 eine serifenlose (gerade) Schriftart und mit @code{typewriter} eine
1505 Schreibmaschinenschrift, in welcher die Buchstaben alle die gleiche
1506 Weite haben. Die aktuelle Schriftart von @code{sans} und
1507 @code{typewriter} wird durch Pango entsprechend den Systemvorgaben
1510 Jede Familie kann verschiedene Schriftschnitte besitzen. Im Englischen
1511 wird unterschieden zwischen @code{shape} für kursive Schnitte und
1512 @code{series} für fette Schnitte. Im folgenden Beispiel wird
1513 demonstriert, wie man die verschiedenen Eigenschaften auswählen kann.
1514 Der Wert, der @code{font-size} übergeben wird, entspricht der geforderten
1515 Änderung in Bezug auf die Standardschriftgröße.
1517 @lilypond[quote,verbatim,fragment]
1518 \override Score.RehearsalMark.font-family = #'typewriter
1519 \mark \markup "Ouverture"
1520 \override Voice.TextScript.font-shape = #'italic
1521 \override Voice.TextScript.font-series = #'bold
1522 d''2.^\markup "Allegro"
1523 \override Voice.TextScript.font-size = #-3
1528 Eine ähnliche Syntax kann im Textbeschriftungsmodus eingesetzt werden,
1529 hier bietet es sich aber an, die einfacheren Befehle zu verwenden, die
1531 @ref{Überblick über die wichtigsten Textbeschriftungsbefehle}:
1533 @lilypond[quote,verbatim]
1537 \override #'(font-shape . italic)
1538 \override #'(font-size . 4)
1542 \override #'(font-family . typewriter)
1544 \override #'(font-series . bold)
1548 \override #'(font-family . sans)
1555 Auch wenn es einfach ist, zwischen den vordefinierten Schriftarten
1556 umzuschalten, kann man auch eigene Schriftarten verwenden, wie erklärt
1557 in folgenden Abschnitten: @ref{Schriftarten für einen Eintrag} und
1558 @ref{Schriftart des gesamten Dokuments}.
1562 @ref{Die Feta-Schriftart},
1563 @ref{Drehen von Objekten},
1564 @ref{Musikalische Notation innerhalb einer Textbeschriftung},
1565 @ref{Überblick über die wichtigsten Textbeschriftungsbefehle},
1569 @node Schriftarten für einen Eintrag
1570 @unnumberedsubsubsec Schriftarten für einen Eintrag
1571 @translationof Single entry fonts
1573 Jede Schriftart, die über das Betriebssystem installiert ist und von
1574 FontConfig erkannt wird, kann in einer Partitur eingefügt werden. Dazu
1575 verwendet man folgende Syntax:
1577 @lilypond[quote,verbatim,fragment]
1578 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1579 \override Staff.TimeSignature.font-size = #2
1583 \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
1584 { Vera Oblique Bold }
1588 @cindex Schriftarten, Liste zum Auswählen
1589 @cindex Schriftarten, vorhandene auflisten
1590 @cindex vorhandene Schriftarten auflisten
1591 @cindex Liste der vorhandenen Schriftarten
1592 @cindex verwendbare Schriftarten auflisten
1594 @funindex show-available-fonts
1596 Mit folgendem Befehl erhält man eine Liste aller verfügbaren Schriftarten
1597 des Betriebssystems:
1600 lilypond -dshow-available-fonts x
1605 @ref{Was sind Schriftarten},
1606 @ref{Schriftart des gesamten Dokuments}.
1612 @node Schriftart des gesamten Dokuments
1613 @unnumberedsubsubsec Schriftart des gesamten Dokuments
1614 @translationof Entire document fonts
1616 Es ist auch möglich, die Schriftarten für die gesamte Partitur zu ändern.
1617 In diesem Fall müssen die Familien @code{roman},
1618 @code{sans} und @code{typewriter} in genaus dieser Reihenfolge
1619 entsprechend der Syntax unten definiert werden. Einzelheiten zu
1620 Schriftarten in @ref{Was sind Schriftarten}.
1622 @cindex Schriftartenfamilien, definieren
1623 @cindex Schriftarten, für das gesamte Dokument ändern
1624 @cindex Ändern von Schriftarten für das gesamte Dokument
1626 @funindex make-pango-font-tree
1628 @lilypond[verbatim,quote]
1632 (make-pango-font-tree "Times New Roman"
1633 "Nimbus Sans,Nimbus Sans L"
1635 (/ myStaffSize 20)))
1642 \typewriter typewriter. }
1646 @c we don't do Helvetica / Courier, since GS incorrectly loads
1651 @ref{Was sind Schriftarten},
1652 @ref{Schriftarten für einen Eintrag},
1653 @ref{Überblick über die wichtigsten Textbeschriftungsbefehle},