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
256 Verschiedene Textelemente können der Partitur hinzugefügt werden,
257 indem man die Syntax für Zeichen einsetzen, wie beschrieben in
260 @c \mark needs to be placed on a separate line (it's not
261 @c attached to an object like \markup is). -vv
263 @lilypond[verbatim,quote]
271 Diese Syntax ermöglicht es, beliebigen Text über eine Taktlinie
272 zu platzieren, weitere Formatierungsmöglichkeiten sind mit dem
273 @code{\markup}-Befehl gegeben, wie beschrieben in
274 @ref{Text formatieren}:
276 @lilypond[quote,verbatim]
279 \mark \markup { \italic { colla parte } }
286 Diese Syntax ermöglicht es auch, besondere Zeichen einzufügen, wie
287 etwa Coda-, Segno- oder Fermatenzeichen, indem das entsprechende
288 Symbol mit dem Befehl @code{\musicglyph} angegeben wird, wie
290 @ref{Musikalische Notation innerhalb einer Textbeschriftung}:
292 @lilypond[quote,verbatim]
295 \mark \markup { \musicglyph #"scripts.ufermata" }
301 Derartige Objekte werden über dem höchsten System einer Partitur
302 gesetzt -- abhängig davon, ob sie mitten im Takt oder an seinem
303 Ende notiert werden, werden sie zwischen Noten oder über der
304 Taktlinie gesetzt. Wenn sie an einem Zeilenumbruch angegeben
305 werden, wird das Zeichen zu Beginn der nächsten Zeile ausgegeben.
307 @lilypond[quote,verbatim,relative=2]
317 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
318 {printing-marks-at-the-end-of-a-line.ly}
320 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
321 {printing-marks-on-every-staff.ly}
326 @ref{Text formatieren},
327 @ref{Musikalische Notation innerhalb einer Textbeschriftung},
328 @ref{Die Feta-Schriftart}.
333 Referenz der Interna:
334 @rinternals{MarkEvent},
335 @rinternals{Mark_engraver},
336 @rinternals{RehearsalMark}.
339 Wenn ein Zeichen am Ende des letzten Taktes einer Partitur gesetzt wird
340 (wenn also keine nächste Zeile mehr kommt), wird das Zeichen nicht
346 @unnumberedsubsubsec Separater Text
347 @translationof Separate text
349 @cindex separater Text
352 @cindex Text, oberste Ebene
353 @cindex oberste Ebene, Text
358 Eine @code{\markup}-Umgebung kann auch für sich alleine existieren,
359 außerhalb einer @code{\score}-Umgebung, als ein Ausdruck auf der
360 höchsten Ebene. Diese Syntax ist beschrieben in @ref{Die Dateistruktur}.
363 @lilypond[verbatim,quote]
365 Morgen, morgen, und morgen...
370 Damit kann Text unabhängig von den Noten gesetzt werden. Das
371 bietet sich vor allem in Situationen an, in denen mehrere Stücke
372 in einer Datei vorkommen, wie beschrieben in
373 @ref{Mehrere Partituren in einem Buch}.
376 @lilypond[quote,verbatim]
381 Morgen, übermorgen, und überübermorgen...
388 Unabhängige Textabschnitte können über mehrere Seiten reichen, so
389 dass man Textdokumente oder Bücher ausschließlich mit LilyPond
390 setzen kann. Einzelheiten zu den vielfältigen Möglichkeiten finden
391 sich in @ref{Textbeschriftung über mehrere Seiten}.
393 @funindex \markuplist
406 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
407 {stand-alone-two-column-markup.ly}
411 @ref{Text formatieren},
412 @ref{Die Dateistruktur},
413 @ref{Mehrere Partituren in einem Buch},
414 @ref{Textbeschriftung über mehrere Seiten}.
419 Referenz der Interna:
420 @rinternals{TextScript}.
424 @node Text formatieren
425 @subsection Text formatieren
426 @translationof Formatting text
428 Dieser Abschnitt zeigt grundlegende und fortgeschrittene
429 Formatierung von Text, wobei der Textbeschriftungsmodus
430 (@code{\markup} benutzt wird.
433 * Textbeschriftung (Einleitung)::
434 * Überblick über die wichtigsten Textbeschriftungsbefehle::
436 * Graphische Notation innerhalb einer Textbeschriftung::
437 * Musikalische Notation innerhalb einer Textbeschriftung::
438 * Textbeschriftung über mehrere Seiten::
441 @node Textbeschriftung (Einleitung)
442 @unnumberedsubsubsec Textbeschriftung (Einleitung)
443 @translationof Text markup introduction
446 @cindex Textbeschriftung
447 @cindex Beschriftung, Text
448 @cindex Setzen von Text
453 Eine @code{\markup}-Umgebung wird benutzt, um Text mit einer
454 großen Anzahl von Formatierungsmöglichkeiten (im @qq{markup-Modus})
457 @cindex Textbeschriftungs-Ausdrücke
459 @cindex markup, Syntax
460 @cindex Ausdrück, Text
462 Die Syntax für Textbeschriftungen ähnelt der normalen Syntax von
463 LilyPond: ein @code{\markup}-Ausdruck wird in geschweifte Klammern
464 eingeschlossen (@code{@{@dots{} @}}). Ein einzelnes Wort wird als
465 ein Minimalausdruck erachtet und muss deshalb nicht notwendigerweise
466 eingeklammert werden.
468 Anders als Text in Anführungsstrichen können sich in einer
469 Textbeschriftungsumgebung (@code{\markup}) geschachtelte Ausdrücke
470 oder weitere Textbefehle befinden, eingeführt mit einem
471 Backslash@tie{}(@code{\}). Derartige Befehle beziehen sich nur auf
472 den ersten der folgenden Ausdrücke.
474 @lilypond[quote,verbatim]
477 a2^\markup { poco \italic più forte }
479 d2_\markup { \italic "string. assai" }
481 b1^\markup { \bold { molto \italic agitato } }
486 @cindex Sonderzeichen in Textbeschriftungen
487 @cindex Textbeschriftung, Sonderzeichen
488 @cindex besondere Zeichen, Text
489 @cindex Text mit Sonderzeichen
490 @cindex Anführungsstriche im Text
491 @cindex Drucken von Sonderzeichen
492 @cindex Setzen von Sonderzeichen
493 @cindex Beschriftung, Sonderzeichen
495 Eine @code{\markup}-Umgebung kann auch Text in
496 Anführungszeichen beinhalten. Derartige Zeichenketten werden als
497 ein Textausdruck angesehen, und darum werden innerhalb von ihnen
498 Befehle oder Sonderzeichen (wie @code{\} oder@tie{}@code{#}) so
499 ausgegeben, wie sie eingeben werden. Doppelte Anführungsstriche
500 können gesetzt werden, indem man ihnen einen Backslash voranstellt.
503 @lilypond[quote,verbatim]
505 a'1^"\italic Text..."
506 a_\markup { \italic "... setzt \"kursive\" Buchstaben!" }
511 Damit eine Anzahl von Wörtern als ein einziger Ausdruck behandelt
512 wird, müssen alle Wörter zwischen geraden Anführungszeichen (Shift+2)
513 stehen oder ihnen muss ein Befehl vorangestellt werden. Die Art,
514 wie die Ausdrücke definiert sind, wirkt sich darauf aus, wie
515 sie übereinander gestapelt, mittig und aneinander ausgerichtet
516 werden. Im folgenden Beispiel verhält sich der zweite
517 @code{\markup}-Ausdruck genauso wie der erste:
519 @lilypond[quote,verbatim]
521 c1^\markup { \center-column { a bbb c } }
522 c1^\markup { \center-column { a { bbb c } } }
523 c1^\markup { \center-column { a \line { bbb c } } }
524 c1^\markup { \center-column { a "bbb c" } }
528 Textbeschriftung kann auch durch Variablen definiert werden. Diese
529 Variablen können dann direkt an Noten angefügt werden:
531 @lilypond[quote,verbatim]
532 allegro = \markup { \bold \large Allegro }
541 Eine ausführliche Liste der @code{\markup}-Befehle findet sich in
542 @ref{Textbeschriftungsbefehle}.
546 @ref{Textbeschriftungsbefehle}.
551 Installierte Dateien:
552 @file{scm/markup.scm}.
555 Syntaxfehler im Textbeschriftungsmodus können sehr verwirrend sein.
558 @node Überblick über die wichtigsten Textbeschriftungsbefehle
559 @unnumberedsubsubsec Überblick über die wichtigsten Textbeschriftungsbefehle
560 @translationof Selecting font and font size
562 @cindex Schriftschnitt verändern
563 @cindex Schriftart verändern
564 @cindex Verändern der Schriftart
573 Einfache Änderungen des Schriftartschnitts können im Textbeschriftungsmodus
576 @lilypond[quote,verbatim]
580 \italic { non troppo \underline Vivo }
583 d,_\markup { \italic quasi \smallCaps Tromba }
590 @cindex Größe der Schriftart
592 @funindex \abs-fontsize
602 Die Schriftgröße kann auf verschiedene Arten verändert werden, relativ
603 zur globalen Notensystemgröße:
605 Sie kann auf eine vordefinierte Größe gesetzt werden:
607 @lilypond[quote,verbatim]
609 b1_\markup { \huge Sinfonia }
610 b1^\markup { \teeny da }
611 b1-\markup { \normalsize camera }
615 Sie kann relativ zum vorherigen Wert gesetzt werden:
617 @lilypond[quote,verbatim]
619 b1_\markup { \larger Sinfonia }
620 b1^\markup { \smaller da }
621 b1-\markup { \magnify #0.6 camera }
625 Sie kann vergrößert oder verkleinert werden relativ zum Wert, der
626 von der globalen Notensystemgröße vorgegeben wird:
628 @lilypond[quote,verbatim]
630 b1_\markup { \fontsize #-2 Sinfonia }
631 b1^\markup { \fontsize #1 da }
632 b1-\markup { \fontsize #3 camera }
636 Sie kann auch auf eine bestimmte Punktegröße festgelegt werden, unabhängig von
637 der globalen Notensystemgröße:
639 @lilypond[quote,verbatim]
641 b1_\markup { \abs-fontsize #20 Sinfonia }
642 b1^\markup { \abs-fontsize #8 da }
643 b1-\markup { \abs-fontsize #14 camera }
648 @cindex tiefergestellt
654 @funindex \normal-size-super
655 @funindex normal-size-super
657 Text kann auch hoch- bzw. tiefgestellt gesetzt werden. Die so markierten
658 Buchstaben werden automatisch in einer kleineren Schriftgröße gesetzt,
659 aber die normale Schriftgröße kann auch eingesetzt werden:
661 @lilypond[quote,verbatim]
664 \line { 1 \super st movement }
665 \line { 1 \normal-size-super st movement
666 \sub { (part two) } }
671 @cindex Schriftfamilien
672 @cindex Schriftschnitte
674 Der Textbeschriftungsmodus stellt eine einfache Möglichkeit zur Verfügung
675 unterschiedliche Schriftschnitte anzuwählen. Ohne besondere Einstellungen
676 wird automatisch eine Schriftart mit Serifen ausgewählt. Das Beispiel
677 unten zeigt die Verwendung der eigenen Zahlenschriftart von LilyPond,
678 den Einsatz von serifenloser Schriftart und von Schreibmaschinenschriftart.
679 Die letzte Zeile zeigt, dass sich die Standardeinstellung mit dem
680 Befehl @code{\roman} wieder herstellen lässt.
682 @lilypond[quote,verbatim]
685 \line { Act \number 1 }
686 \line { \sans { Scene I. } }
687 \line { \typewriter { Verona. An open place. } }
688 \line { Enter \roman Valentine and Proteus. }
694 Einige dieser Schriftarten, etwa die Zahlenschriftart oder die Schriftart
695 für Dynamikzeichen, stellen nicht alle Zeichen zur Verfügung, wie beschrieben
696 in @ref{Neue Lautstärkezeichen} und @ref{Manuelle Wiederholungszeichen}.
698 @c \concat is actually documented in Align (it is not
699 @c a font-switching command). But we need it here. -vv
701 Einige Schriftartbefehle können ungewollte Leerzeichen innerhalb von Wörtern
702 hervorrufen. Das kann vermieden werden, indem die einzelnen Elemente mit
703 dem Befehl @code{\concat} zu einem Element verschmolzen werden:
705 @lilypond[quote,verbatim]
709 \concat { 1 \super st }
713 \concat { \dynamic p , }
714 \italic { con dolce espressione }
720 Eine ausführliche Liste der unterschiedlichen Befehl zur Beeinflussung
721 der Schriftarten findet sich in @ref{Font}.
723 Es ist auch möglich, eigene Schriftfamilien zu definieren, wie erklärt in
729 @funindex \normalsize
758 @ref{Neue Lautstärkezeichen},
759 @ref{Manuelle Wiederholungszeichen},
762 Installierte Dateien:
763 @file{scm/define-markup-commands.scm}.
768 Referenz der Interna:
769 @rinternals{TextScript}.
772 Wenn die Befehle @code{\teeny}, @code{\tiny},
773 @code{\small}, @code{\normalsize}, @code{\large} und
774 @code{\huge} eingesetzt werden, erhält man schlechte Zeilenabstände
775 verglichen mit @code{\fontsize}.
778 @node Textausrichtung
779 @unnumberedsubsubsec Textausrichtung
780 @translationof Text alignment
782 @cindex Text, Ausrichtung
783 @cindex Ausrichtung von Text
784 @cindex Textbeschriftung ausrichten
785 @cindex Beschriftung ausrichten
787 Dieser Abschnitt zeigt, wie man Text im Textbeschriftungsmodus
788 eingibt. Textobjekte können auch als eine Einheit verschoben
789 werden, wie beschrieben in @rlearning{Verschieben von Objekten}.
791 @c Padding commands should be mentioned on this page, but
792 @c most of these require \box to be more clearly illustrated. -vv
794 @cindex Text, horizontale Ausrichtung
795 @cindex horizontale Ausrichtung von Text
797 @funindex \left-align
798 @funindex \center-align
799 @funindex \right-align
801 @funindex center-align
802 @funindex right-align
804 Textbeschriftungsobjekte können auf verschiedene Weise ausgerichtet
805 werden. Standardmäßig wird ein Textobjekt an seiner linken Ecke
806 ausgerichtet, darum wird das erste und zweite Objekt gleichermaßen
807 an der linken Ecke ausgerichtet.
809 @lilypond[quote,verbatim]
811 d''1-\markup { poco }
813 d-\markup { \left-align poco }
815 d-\markup { \center-align { poco } }
817 d-\markup { \right-align poco }
824 Die horizontale Ausrichtung kann mit einer Zahl auf einen exakten
825 Wert festgelegt werden:
827 @lilypond[quote,verbatim]
829 a'1-\markup { \halign #-1 poco }
831 a,-\markup { \halign #0 poco }
833 a,-\markup { \halign #0.5 poco }
835 a,-\markup { \halign #2 poco }
840 Manche Objekte haben eigene Ausrichtungsvorgänge und werden deshalb
841 nicht von diesen Befehlen beeinflusst. Es ist möglich, solche
842 Objekte als eine Einheit anzusprechen und zu bewegen, wie
843 gezeigt in @ref{Textartige Zeichen}.
845 @cindex Text, vertikale Ausrichtung
846 @cindex vertikale Ausrichtung von Text
855 Die vertikale Ausrichtung ist etwas schwieriger. Textelemente
856 können komplett verschoben werden, es ist aber auch möglich, nur
857 einen Teil innerhalb der Textbeschriftung zu bewegen. In diesem
858 Fall muss dem zu verschiebenden Objekt ein Ankerpunkt zugewiesen
859 werden, welcher entweder ein anderes Textelement oder ein
860 unsichtbares Objekt sein kann (im Beispiel mit @code{\null} erstellt).
861 Der letzte Text im Beispiel hat keinen Anker und wird deshalb auch nicht verschoben.
863 @lilypond[quote,verbatim]
867 \raise #2 { Scène 1 }
872 \lower #4 \bold { Très modéré }
876 \raise #4 \italic { Une forêt. }
882 @funindex \general-align
884 @funindex \translate-scaled
885 @funindex general-align
887 @funindex translate-scaled
889 Einige Befehle können sowohl die horizontale als auch die vertikale
890 Ausrichtung von Textobjekten beeinflussen. Jedes Objekt, das auf
891 diese Weise verschoben wird, benötigt einen Anker:
893 @lilypond[quote,verbatim]
897 \translate #'(-1 . 2) "Scène 1"
902 \general-align #Y #3.2 \bold "Très modéré"
907 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
913 @cindex mehrzeiliger Text
914 @cindex Text, mehrere Zeilen
917 @cindex Beschriftung, mehrzeilig
918 @cindex Textbeschriftung, mehrzeilig
921 @funindex \center-column
923 @funindex center-column
925 Ein Textbeschriftungsobjekt kann mehrere Zeilen beinhalten. Im folgenden
926 Beispiel wird jeder Ausdruck innerhalb von @code{\markup} auf einer
927 eigenen Zeile gesetzt, entweder linksbündig oder zentriert:
929 @lilypond[quote,verbatim]
947 @cindex Text auf der Seite zentrieren
948 @cindex Zentrieren von Text auf der Seite
949 @cindex Beschriftung, Zentrieren auf der Seite
954 Eine Anzahl an Ausdrücken innerhalb von @code{\markup} kann auch
955 gestreckt werden, so dass die gesamte Seitenbreite benutzt wird. Wenn
956 nur ein Objekt vorhanden ist, wird es zentriert gesetzt. Die Ausdrücke
957 selber können wiederum mehrzeilig sein und andere Textbeschriftungsbefehle
960 @lilypond[quote,verbatim]
963 \line { William S. Gilbert }
965 \huge \smallCaps "The Mikado"
967 \smallCaps "The Town of Titipu"
969 \line { Sir Arthur Sullivan }
977 @cindex Umbruch von Text
978 @cindex Blocksatz, Text
979 @cindex Text, Blocksatz
980 @cindex Beschriftung, Blocksatz
981 @cindex Textbeschriftung, Blocksatz
988 Längere Texte können auch automatisch umgebrochen werden, wobei es
989 möglich ist, die Zeilenbreite zu bestimmen. Der Text ist entweder
990 linksbündig oder im Blocksatz, wie das nächste Beispiel illustriert:
992 @lilypond[quote,verbatim]
995 \line \smallCaps { La vida breve }
996 \line \bold { Acto I }
998 (La escena representa el corral de una casa de
999 gitanos en el Albaicín de Granada. Al fondo una
1000 puerta por la que se ve el negro interior de
1001 una Fragua, iluminado por los rojos resplandores
1006 \line \bold { Acto II }
1007 \override #'(line-width . 50)
1009 (Calle de Granada. Fachada de la casa de Carmela
1010 y su hermano Manuel con grandes ventanas abiertas
1011 a través de las que se ve el patio
1012 donde se celebra una alegre fiesta)
1018 @cindex Textausrichtungsbefehle
1019 @cindex Textausrichtung, Befehle
1020 @cindex Befehle zur Textausrichtung
1021 @cindex Ausrichtung von Text, Befehle
1023 Eine vollständige Liste der Textausrichtungsbefehle findet sich in
1027 Handbuch zum Lernen:
1028 @rlearning{Verschieben von Objekten}.
1032 @ref{Textartige Zeichen}.
1034 Installierte Dateien:
1035 @file{scm/define-markup-commands.scm}.
1040 Referenz der Interna:
1041 @rinternals{TextScript}.
1044 @node Graphische Notation innerhalb einer Textbeschriftung
1045 @unnumberedsubsubsec Graphische Notation innerhalb einer Textbeschriftung
1046 @translationof Graphic notation inside markup
1048 @cindex Graphik, eingebunden
1049 @cindex Illustrationen im Text
1050 @cindex Zeichnen im Text
1051 @cindex Abbildungen im Text
1052 @cindex Objekte, Graphik im Text
1053 @cindex eingebundene Graphik im Text
1055 Verschiedene graphische Objekte können im Textbeschriftungsmodus
1058 @cindex Kasten, Graphik
1059 @cindex gerundeter Kasten, Graphik
1060 @cindex Klammern, Graphik
1061 @cindex Text verzieren
1062 @cindex Text einrahmen
1063 @cindex Rahmen, Text
1067 @funindex \rounded-box
1072 @funindex rounded-box
1076 Mit bestimmten Textbeschriftungsbefehlen kann man Textelementen
1077 Graphik hinzufügen, wie das nächste Beispiel zeigt:
1079 @lilypond[quote,verbatim]
1080 \markup \fill-line {
1088 \bracket "1866 - 1925"
1091 \rounded-box \bold Prelude
1096 @cindex Platz um Text
1097 @cindex Rand um Text
1098 @cindex Füllung um Text
1099 @cindex Text, Rand außen
1101 @funindex \pad-markup
1103 @funindex \pad-to-box
1104 @funindex \pad-around
1105 @funindex pad-markup
1107 @funindex pad-to-box
1108 @funindex pad-around
1110 Es kann nötig sein, einem Text mehr Platz einzuräumen. Das geschieht mit
1111 verschiedenen Befehlen, wie das folgende Beispiel zeigt. Eine ausführliche
1112 Übersicht findet sich in @ref{Align}.
1114 @lilypond[quote,verbatim]
1115 \markup \fill-line {
1117 \box "Charles Ives (1874 - 1954)"
1119 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1120 \box \pad-x #8 "A Cosmic Landscape"
1127 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1128 \bold "Largo to Presto"
1131 "String quartet keeps very even time,
1132 Flute quartet keeps very uneven time."
1136 @cindex Graphische Notation
1137 @cindex Symbole, nicht musikalische
1138 @cindex Notation, graphische
1139 @cindex nichtmusikalische Symbole
1142 @funindex \draw-circle
1143 @funindex \filled-box
1145 @funindex \draw-line
1146 @funindex \arrow-head
1148 @funindex draw-circle
1149 @funindex filled-box
1152 @funindex arrow-head
1154 Andere graphische Elemente oder Symbole können gesetzt werden, ohne dass
1155 man Text benötigt. Wie mit allen Textbeschriftungen können Objekte
1156 innerhalb von @code{\markup} kombiniert werden.
1158 @lilypond[quote,verbatim]
1161 \draw-circle #4 #0.4 ##f
1162 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1168 \draw-line #'(0 . 4)
1169 \arrow-head #Y #DOWN ##f
1174 @cindex Einbinden von Graphik
1175 @cindex Bilder einbinden
1176 @cindex Graphik einbinden
1177 @cindex Postscript, Graphik
1180 @funindex \postscript
1182 @funindex postscript
1184 Fortgeschrittene graphische Möglichkeiten bietet unter Anderem eine
1185 Funktion, mit der man externe Graphiken im
1186 Encapsulated PostScript (@emph{eps}) -Format einbinden kann oder
1187 aber Graphiken direkt in den Quelltext unter Verwendung von
1188 PostScript-Code notiert. In diesem Fall kann es nötig sein, die
1189 Größe der Zeichnung explizit anzugeben, wie im Beispiel unten gezeigt:
1191 @lilypond[quote,verbatim,fragment]
1194 \epsfile #X #10 #"./context-example.eps"
1195 \with-dimensions #'(0 . 6) #'(0 . 10)
1211 Eine ausführliche Liste der Graphik-Befehle findet sich in
1220 Installierte Dateien:
1221 @file{scm/define-markup-commands.scm},
1222 @file{scm/stencil.scm}.
1227 Referenz der Interna:
1228 @rinternals{TextScript}.
1231 @node Musikalische Notation innerhalb einer Textbeschriftung
1232 @unnumberedsubsubsec Musikalische Notation innerhalb einer Textbeschriftung
1233 @translationof Music notation inside markup
1235 @cindex Notationsobjekte, Einfügen
1236 @cindex Einfügen von Notationsobjekten
1237 @cindex Musikobjekte, Einfügen
1238 @cindex Beschriftung, Notationsobjekte einfügen
1239 @cindex Textbeschriftung, Notationsobjekte einfügen
1241 Auch Musikobjekte können innerhalb der Textbeschriftungsumgebung gesetzt
1244 Noten und Versetzungszeichen lassen sich mit @code{\markup} einfügen:
1246 @lilypond[quote,verbatim,fragment]
1250 \note-by-number #1 #1 #1.5
1253 \natural \semiflat \flat
1254 \sesquiflat \doubleflat
1258 \natural \semisharp \sharp
1259 \sesquisharp \doublesharp
1264 Andere Notationsobjekte können auch eingefügt werden:
1266 @lilypond[quote,verbatim,relative=1]
1273 fis_\markup { \dynamic rf }
1284 Allgemeiner gesagt kann jedes verfügbare Notationssymbol unabhängig
1285 von der Notation als ein Textbeschriftungsobjekt eingefügt werden, wie
1286 unten gezeigt. Eine vollständige Liste der verfügbaren Symbole findet
1287 sich in @ref{Die Feta-Schriftart}.
1289 @lilypond[quote,verbatim]
1292 c'^\markup { \musicglyph #"eight" }
1294 c,8._\markup { \musicglyph #"clefs.G_change" }
1296 c2^\markup { \musicglyph #"timesig.neomensural94" }
1301 Eine andere Möglichkeit, andere als Textsymbole zu schreiben, findet sich
1302 in @ref{Was sind Schriftarten}. Diese Methode bietet sich an, um Klammern
1303 unterschiedlicher Größe zu setzen.
1305 Der Textbeschriftungsmodus unterstützt auch Diagramme für bestimmte
1308 @lilypond[quote,verbatim]
1311 \fret-diagram-terse #"x;x;o;2;3;2;"
1314 \harp-pedal #"^-v|--ov^"
1319 \musicglyph #"accordion.discant"
1321 \raise #0.5 \musicglyph #"accordion.dot"
1322 \raise #1.5 \musicglyph #"accordion.dot"
1327 @c The accordion diagram is actually taken from a snippet.
1330 Derartige Digramme sind dokumentiert in @ref{Instrument Specific Markup}.
1332 @cindex Notation innerhalb von Beschriftung
1333 @cindex Notation innerhalb von Text
1334 @cindex Text, Notation innerhalb
1335 @cindex Beschriftung, Notation einfügen
1336 @cindex Notensysteme in Text einfügen
1338 Sogar eine ganze Partitur kann in ein Textbeschriftungsobjekt eingefügt
1339 werden. In diesem Fall muss die eingefügte @code{\score}-Umgebung
1340 eine @code{\layout}-Umgebung haben, wie in diesem Beispiel:
1342 @lilypond[quote,verbatim]
1346 \relative { c'4 d e f }
1355 Eine vollständige Liste der Musiksymbol-Befehle findet sich in @ref{Music}.
1360 @ref{Die Feta-Schriftart},
1361 @ref{Was sind Schriftarten}.
1363 Installierte Dateien:
1364 @file{scm/define-markup-commands.scm},
1365 @file{scm/fret-diagrams.scm},
1366 @file{scm/harp-pedals.scm}.
1371 Referenz der Interna:
1372 @rinternals{TextScript}.
1376 @node Textbeschriftung über mehrere Seiten
1377 @unnumberedsubsubsec Textbeschriftung über mehrere Seiten
1378 @translationof Multi-page markup
1380 @cindex Textbeschriftung über mehrere Seiten
1381 @cindex Beschriftung über mehrere Seiten
1382 @cindex Text über mehrere Seiten
1383 @cindex mehrseitiger Text
1385 @funindex \markuplist
1386 @funindex markuplist
1387 @funindex \justified-lines
1388 @funindex justified-lines
1389 @funindex \wordwrap-lines
1390 @funindex wordwrap-lines
1392 Normale Textbeschriftungsobjekte können nicht getrennt werden, aber mit
1393 einer spezifischen Umgebung ist es möglich, Text auch über mehrere Seiten
1396 @lilypond[quote,verbatim]
1399 A very long text of justified lines.
1403 Another very long paragraph.
1410 Die Syntax braucht eine Liste von Textbeschriftungen folgender Art:
1414 das Resultat eines Beschriftungslistenbefehls,
1416 eine Textbeschriftungsliste,
1418 eine Liste von Beschriftungslisten.
1421 Eine vollständige Liste der Beschriftungslistenbefehle findet sich in
1422 @ref{Textbeschriftungslistenbefehle}.
1426 @ref{Textbeschriftungslistenbefehle}.
1429 @rextend{Neue Definitionen von Beschriftungslistenbefehlen}.
1431 Installierte Dateien:
1432 @file{scm/define-markup-commands.scm}.
1437 Referenz der Interna:
1438 @rinternals{TextScript}.
1440 @funindex \markuplist
1441 @funindex markuplist
1449 @subsection Schriftarten
1450 @translationof Fonts
1452 Dieser Abschnitt zeigt, wie Schriftarten eingesetzt werden können und
1453 wie man sie in Partituren ändern kann.
1456 * Was sind Schriftarten::
1457 * Schriftarten für einen Eintrag::
1458 * Schriftart des gesamten Dokuments::
1461 @node Was sind Schriftarten
1462 @unnumberedsubsubsec Was sind Schriftarten
1463 @translationof Fonts explained
1466 @cindex Schriftarten, Hintergrundinformation
1467 @cindex Klammern, unterschiedliche Größen
1468 @cindex Schriftarten, Nicht-Text in Beschriftung
1469 @cindex Nicht-Textschriftarten in Beschriftung
1471 @funindex font-interface
1473 Schriftarten werden von mehreren Bibliotheken verwaltet. FontConfig wird
1474 benützt, um die vorhandenen Schriftarten des Systems zu erkennen, die
1475 gewählte Schriftart wird dann mit Pango verarbeitet.
1477 Notationsschriftarten können als eine Ansammlung von besonderen Zeichen
1478 erklärt werden, wobei die Sonderzeichen in verschiedene Familien
1479 klassifiziert werden. Die Syntax des folgenden Beispiels ermöglicht es,
1480 direkt auf verschiedene nicht textuelle Sonderzeichen der
1481 @code{feta}-Schriftart zuzugreifen. Das ist die Standardschriftart
1482 für Notationselemente in LilyPond.
1484 @lilypond[quote,verbatim,fragment]
1487 \override #'(font-encoding . fetaBraces)
1489 \override #'(font-encoding . fetaText)
1491 \override #'(font-encoding . fetaMusic)
1492 \lookup #"noteheads.s0petrucci"
1498 Außer den verschiedenen Klammern, die in @code{fetaBraces}
1499 in verschiedenen Größen enthalten sind, lassen sich alle
1500 dieses Symbole auch mit einer einfacheren Syntax notieren.
1501 Sie ist beschrieben in
1502 @ref{Musikalische Notation innerhalb einer Textbeschriftung}.
1504 Wenn man die Klammern von @code{fetaBraces} benutzt, wird die
1505 Größe der Klammer durch einen numeralen Part in der
1506 Bezeichnung des Glyphs bestimmt. Als Wert kann eine
1507 Ganzzahl von @code{0} bis @code{575} benutzt werden, wobei
1508 @code{0} die kleinste Klammern ergibt. Der optimale Wert
1509 muss durch Ausprobieren herausgefunden werden. Diese Glyphen
1510 sind alle linke Klammern, rechte Klammern lassen sich durch
1511 eine Drehung herstellen, siehe
1512 @ref{Drehen von Objekten}.
1514 Drei Textschriftarten sind verfügbar (auf Englisch @code{family} genannt):
1515 mit @code{roman} eine Schriftart
1516 mit Serifen (Standard ist New Century Schoolbook), mit @code{sans}
1517 eine serifenlose (gerade) Schriftart und mit @code{typewriter} eine
1518 Schreibmaschinenschrift, in welcher die Buchstaben alle die gleiche
1519 Weite haben. Die aktuelle Schriftart von @code{sans} und
1520 @code{typewriter} wird durch Pango entsprechend den Systemvorgaben
1523 Jede Familie kann verschiedene Schriftschnitte besitzen. Im Englischen
1524 wird unterschieden zwischen @code{shape} für kursive Schnitte und
1525 @code{series} für fette Schnitte. Im folgenden Beispiel wird
1526 demonstriert, wie man die verschiedenen Eigenschaften auswählen kann.
1527 Der Wert, der @code{font-size} übergeben wird, entspricht der geforderten
1528 Änderung in Bezug auf die Standardschriftgröße.
1530 @lilypond[quote,verbatim,fragment]
1531 \override Score.RehearsalMark.font-family = #'typewriter
1532 \mark \markup "Ouverture"
1533 \override Voice.TextScript.font-shape = #'italic
1534 \override Voice.TextScript.font-series = #'bold
1535 d''2.^\markup "Allegro"
1536 \override Voice.TextScript.font-size = #-3
1541 Eine ähnliche Syntax kann im Textbeschriftungsmodus eingesetzt werden,
1542 hier bietet es sich aber an, die einfacheren Befehle zu verwenden, die
1544 @ref{Überblick über die wichtigsten Textbeschriftungsbefehle}:
1546 @lilypond[quote,verbatim]
1550 \override #'(font-shape . italic)
1551 \override #'(font-size . 4)
1555 \override #'(font-family . typewriter)
1557 \override #'(font-series . bold)
1561 \override #'(font-family . sans)
1568 Auch wenn es einfach ist, zwischen den vordefinierten Schriftarten
1569 umzuschalten, kann man auch eigene Schriftarten verwenden, wie erklärt
1570 in folgenden Abschnitten: @ref{Schriftarten für einen Eintrag} und
1571 @ref{Schriftart des gesamten Dokuments}.
1575 @ref{Die Feta-Schriftart},
1576 @ref{Drehen von Objekten},
1577 @ref{Musikalische Notation innerhalb einer Textbeschriftung},
1578 @ref{Überblick über die wichtigsten Textbeschriftungsbefehle},
1582 @node Schriftarten für einen Eintrag
1583 @unnumberedsubsubsec Schriftarten für einen Eintrag
1584 @translationof Single entry fonts
1586 Jede Schriftart, die über das Betriebssystem installiert ist und von
1587 FontConfig erkannt wird, kann in einer Partitur eingefügt werden. Dazu
1588 verwendet man folgende Syntax:
1590 @lilypond[quote,verbatim,fragment]
1591 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1592 \override Staff.TimeSignature.font-size = #2
1596 \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
1597 { Vera Oblique Bold }
1601 @cindex Schriftarten, Liste zum Auswählen
1602 @cindex Schriftarten, vorhandene auflisten
1603 @cindex vorhandene Schriftarten auflisten
1604 @cindex Liste der vorhandenen Schriftarten
1605 @cindex verwendbare Schriftarten auflisten
1607 @funindex show-available-fonts
1609 Mit folgendem Befehl erhält man eine Liste aller verfügbaren Schriftarten
1610 des Betriebssystems:
1613 lilypond -dshow-available-fonts x
1618 @ref{Was sind Schriftarten},
1619 @ref{Schriftart des gesamten Dokuments}.
1625 @node Schriftart des gesamten Dokuments
1626 @unnumberedsubsubsec Schriftart des gesamten Dokuments
1627 @translationof Entire document fonts
1629 Es ist auch möglich, die Schriftarten für die gesamte Partitur zu ändern.
1630 In diesem Fall müssen die Familien @code{roman},
1631 @code{sans} und @code{typewriter} in genaus dieser Reihenfolge
1632 entsprechend der Syntax unten definiert werden. Einzelheiten zu
1633 Schriftarten in @ref{Was sind Schriftarten}.
1635 @cindex Schriftartenfamilien, definieren
1636 @cindex Schriftarten, für das gesamte Dokument ändern
1637 @cindex Ändern von Schriftarten für das gesamte Dokument
1639 @funindex make-pango-font-tree
1641 @lilypond[verbatim,quote]
1645 (make-pango-font-tree "Times New Roman"
1648 (/ myStaffSize 20)))
1655 \typewriter typewriter. }
1659 @c we don't do Helvetica / Courier, since GS incorrectly loads
1664 @ref{Was sind Schriftarten},
1665 @ref{Schriftarten für einen Eintrag},
1666 @ref{Überblick über die wichtigsten Textbeschriftungsbefehle},