@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@ignore
- Translation of GIT committish: ac3dd3ad38528113d97f6a8a7b81751c328f1c36
+ Translation of GIT committish: e5a609e373eae846857f9a6d70a402a3d42b7d94
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes.
@end ignore
-@c \version "2.14.0"
+@c \version "2.17.0"
@c Translators: Till Paala
@node Das Papierformat einstellen
@unnumberedsubsubsec Das Papierformat einstellen
-@translationof Setting paper size
+@translationof Setting the paper size
-Zwei Funktionen ermöglichen es, die Papiergröße zu ändern:
-@code{set-default-paper-size} und @code{set-paper-size}.
-@code{set-default-paper-size} muss auf der obersten Ebene in
-der Quelldatei gesetzt werden, @code{set-paper-size} hingegen
-muss sich in einer @code{\paper}-Umgebung befinden:
+@q{A4} ist der Standardwert, wenn keine ausdrückliches Papierformat
+eingestellt ist. Es gibt jedoch zwei Funktionen, mit denen man
+das Papierformat ändern kann: @code{set-default-paper-size}
@example
-#(set-default-paper-size "a4")
+#(set-default-paper-size "quarto")
@end example
+@noindent
+welcher immer auf oberster Ebene der Datei geschrieben werden muss, und
+@code{set-paper-size}
+
@example
\paper @{
- #(set-paper-size "a4")
+ #(set-paper-size "tabliod")
@}
@end example
@noindent
-Auf oberster Ebene kann @code{set-default-paper-size} überall vor der ersten
-@code{\paper}-Umgebung aufgerufen werden. Innerhalb einer @code{\paper}-Umgebung
-ist der beste Platz für @code{set-paper-size} gleich am Anfang, über der Liste
-der Variablen-Definitionen. Der Grund dafür wird behandelt in
-@ref{Automatische Skalierung auf ein Papierformat}
-
-@code{set-default-paper-size} bestimmt die Größe aller Seiten, während
-@code{set-paper-size} nur die Seitengröße für die Seiten definiert,
-auf die sich die aktuelle @code{\paper}-Umgebung bezieht. Wenn die
-@code{\paper}-Umgebung gleich am Anfang der Datei steht, bezieht sich die
-Papiergröße auf alle Seiten, wenn sie aber innerhalb einer
-@code{\book}-Umgebung definiert wird, nur auf die Seiten innerhalb
-dieses Buches.
-
-Die normalen Papierformate sind definiert, u.A. @code{a4},
-@code{letter}, @code{legal} und @code{11x17} (auch als
-Tabloit bekannt). Sehr viel mehr Formate sind unterstützt.
-Einzelheiten finden sich in der Datei
-@file{scm/paper.scm} in der Definition von
-@code{paper-alist}.
-
-@warning{Das Standardformat ist @code{a4}.}
-
-Weitere Papierformate können hinzugefügt werden, indem die
-Definition von @code{paper-alist} in der Datei
-@file{scm/paper.scm} verändert wird. Derartige
-Änderungen werden jedoch bei einer Aktualisierung des
-Programmes überschrieben.
+welcher in eine @code{\paper}-Umgebung geschrieben werden muss.
+
+
+Wenn die @code{set-default-paper-size}-Funktion auf oberster Ebene der
+Datei eingesetzt wird, muss sie vor allen @code{\paper}-Umgebungen kommen.
+@code{set-default-paper-size} definiert das Papierformat für alle Seiten,
+während @code{set-paper-size} nur das Format der Seiten bestimmt, auf die
+sich die @code{\paper}-Umgebung bezieht. Wenn beispielsweise die
+@code{\paper}-Umgebung oben in der Datei steht, dann bezieht sie sich
+auf alle Seiten in der Datei. Wenn die @code{\paper}-Umgebung innherhalb
+einer @code{\book}-Umgebung steht, dann bezieht sie sich nur auf das eine
+Buch.
+
+Wenn die @code{set-paper-size}-Funktion eingesetzt wird, muss sie @emph{vor}
+allen anderen Funktionen stehen, die in derselben @code{\paper}-Umgebung
+benützt werden. Siehe @ref{Automatische Skalierung auf ein Papierformat}.
+
+Die Papierformate finden sich in der Datei @file{scm/paper.scm} definiert.
+Hierhin kann man eigene Formate definieren, sie werden jedoch bei einer
+Aktualisierung von LilyPond überschrieben. Die vorhandenen Papierformate
+finden sich in @ref{Vordefinierte Papierformate}.
+
+@c An appendix entry exists for paper sizes but is not auto-generated
+
+Der folgende Befehl kann benützt werden, um ein eigenes Papierformat
+hinzuzufügen, welches dann mit @code{set-default-paper-size} oder
+@code{set-paper-size} benützt werden kann:
+
+@example
+#(set! paper-alist (cons '("mein Format" . (cons (* 15 in) (* 3 in))) paper-alist))
+
+\paper @{
+ #(set-paper-size "mein Format")
+@}
+@end example
+
+Die Einheiten @code{in} (Fuß), @code{cm} (Centimeter) and @code{mm} (Millimeter)
+können benützt werden.
@cindex Ausrichtung, Papier
@cindex Papier, Ausrichtung
@cindex hochkant, Papier
@cindex quer, Papier
+@cindex Papier, quer
@funindex landscape
-Wenn das Symbol @code{'landscape} als Argument an die Funktion
+Wenn das Symbol @code{'landscape} an die Funktion
@code{set-default-paper-size} gehängt wird, werden die Seiten um
90° gedreht und die Notensysteme entsprechend breiter gesetzt.
#(set-default-paper-size "a6" 'landscape)
@end example
+Die Notenausgabe wird @emph{nicht} gedreht, nur das Papierformat.
+
@seealso
Notationsreferenz:
-@ref{Automatische Skalierung auf ein Papierformat}.
+@ref{Automatische Skalierung auf ein Papierformat},
+@ref{Vordefinierte Papierformate}.
Installierte Dateien:
@file{scm/paper.scm}.
-
@node Automatische Skalierung auf ein Papierformat
@unnumberedsubsubsec Automatische Skalierung auf ein Papierformat
@translationof Automatic scaling to paper size
Wenn auf falsch gesetzt, werden die Systeme vertikal auf der letzten Seite
verteilt. Bei Stücken, die grob zwei oder mehr Seiten füllen, sollten es auf
-wahr gesetzt werden. Hiermit wird auch die letzte Seite von Teilen eines
+falsch (@code{false}) gesetzt werden. Hiermit wird auch die letzte Seite von Teilen eines
@code{\book}, die mit @code{\bookpart} erstellt sind, beeinflusst.
@end table
zusätzlichen Abstand zwischen den Titel und dem ersten System einer
Paritur einfügt.
+Explizit definierte Papierformate überschreiben alle vom Benutzer erstellte
+Randeinstellung für die Ränder oben und unten.
+
@node Vertikale \paper-Variablen mit flexiblen Abständen
@unnumberedsubsubsec Vertikale @code{\paper}-Variablen mit flexiblen Abständen
@menu
* Struktur der Alisten für flexible vertikale Abstände::
-* Liste der flexiblen vertikalen Abstandsvariblen in \paper::
+* Liste der flexiblen vertikalen Abstandsvariablen in \paper::
@end menu
@end itemize
+Bei Partituren über mehrere Seiten mit nicht ausgeglichenem unteren Rand
+greift die letzte Seite auf die gleiche Positionierung zurück wie die
+vorhergehende Seite, vorausgesetzt, dafür ist genügend Platz vorhanden.
+
Spezifische Methoden, um Alisten zu verändern, werden behandelt in
@ref{Alisten verändern}. Das folgende Beispiel demonstriert beide Arten,
wie diese Alisten verändert werden können. Der erste Aufruf verändert
Installierte Dateien:
@file{ly/paper-defaults-init.ly}.
+@knownissues
+Explizit definierte Papierformate überschreiben alle vom Benutzer erstellte
+Randeinstellung für die Ränder oben und unten.
+
@node \paper-Variablen für zweiseitigen Satz
@unnumberedsubsubsec @code{\paper}-Variablen für zweiseitigen Satz
@table @code
-@item blank-after-score-page-force
-@funindex blank-after-score-page-force
+@item blank-after-score-page-penalty
+@funindex blank-after-score-page-penalty
Die Strafpunke, die erteilt werden, wenn eine leere Seite nach einer
Partitur und vor der nächsten vorkommt. Der Standardwert hiervon ist
-kleiner als @code{blank-page-force}, sodass leere Seiten nach einer Partitur
+kleiner als @code{blank-page-penalty}, sodass leere Seiten nach einer Partitur
leeren Seiten innerhalb einer Partitur vorgezogen werden.
-@item blank-last-page-force
-@funindex blank-last-page-force
+@item blank-last-page-penalty
+@funindex blank-last-page-penalty
Die Strafpunkte, wenn eine Partitur auf einer ungeraden Seite
beendet wird. Standard: @code{0}.
-@item blank-page-force
-@funindex blank-page-force
+@item blank-page-penalty
+@funindex blank-page-penalty
Die Strafpunkte, wenn eine leere Seite mitten in einer Partitur
auftritt. Das wird nicht benutzt von @code{ly:optimal-breaking},
@ref{Seitenumbrüche},
@ref{Optimale Seitenumbrüche},
@ref{Optimale Umbrüche zum Blättern},
-@ref{Minimale Seitenumbrüche}.
+@ref{Minimale Seitenumbrüche},
+@ref{Eine-Seite-Seitenumbrüche}.
Installierte Dateien:
@file{ly/paper-defaults-init.ly}.
Die relative Gewichtung von (vertikalem) Abstand auf der Seite und
(horizontalem) Abstand innerhalb der Zeilen. Hohe Werte gewichten
-die vertikalen Abstände mehr. Standard: @code{#10}.
+die vertikalen Abstände mehr. Standard: @code{10}.
@item print-all-headers
@funindex print-all-headers
Wenn wahr, werden alle Einträge des Titelfeldes (@code{\header}-Umgebung)
für jede Partitur (@code{\score}) ausgegeben. Normalerweise wird nur die
Satzbezeichnung und die Opuszahl (@code{piece} und @code{opus})
-ausgegeben. Standard: @code{##f}.
+ausgegeben. Standard: @code{#f}.
@item system-separator-markup
@funindex system-separator-markup
@node Die \layout-Umgebung
-@subsection Die @code{ayout}-Umgebung
+@subsection Die @code{\layout}-Umgebung
@translationof The \layout block
@cindex Partitur, Layout
@}
@end example
+Mehrfache @code{\layout}-Umbgebungen können als Ausdrücke auf höchster
+Ebene eingegeben werden. Das kann beispielsweise nützlich sein, wenn
+unterschiedliche Einstellungen in extra Dateien gespeichert werden und
+optional eingefügt werden. Intern wird eine Kopie der aktuellen
+@code{\layout}-Konfiguration gemacht, wenn eine @code{\layout}-Umgebung
+ausgewertet wird, dann erst werden Änderungen aus der Umgebung angewendet
+und das Ergebnis als die neue aktuelle Konfiguration gespeichert.
+Aus der Sicht des Benutzers werden die @code{\layout}-Umgebungen
+kombiniert, aber in Konfliktsituationen (wenn die gleiche Eigenschaft
+in unterschiedlichen Umgebungen geändert wird), erhält die spätere
+Definition den Vorrang.
+
+Wenn also diese Umgebung:
+
+@example
+\layout @{
+ \context @{
+ \Voice
+ \override TextScript #'color = #magenta
+ \override Glissando #'thickness = #1.5
+ @}
+@}
+@end example
+
+nach der Umgebung aus dem vorherigen Beispiel geschrieben wird, werden
+die @code{'padding}- und @code{'color}-Einstellungen für @code{TextScript}
+kombiniert, aber die spätere @code{'thickness}-Einstellung für
+@code{Glissando} ersetzt (oder versteckt) die vorherige.
+
+@code{\layout}-Umgebungen können einer Variable zur späteren Benutzung
+zugewiesen werden, aber die Funktionsweise dieser Zuweisung ist geringfügig
+aber deutlich unterschiedlich von der Variante, sie auszuschreiben.
+
+Wenn eine Variable etwa so definiert wird:
+
+@example
+layoutVariable = \layout @{
+ \context @{
+ \Voice
+ \override NoteHead #'font-size = #4
+ @}
+@}
+@end example
+
+@noindent
+dann enthält sie die aktuelle @code{\layout}-Konfiguration mit zusätzlicher
+Veränderung von @code{NoteHead #'font-size} (der Schriftgröße der Notenköpfe),
+aber diese Kombination wird @emph{nicht} als nächste aktuelle
+Konfiguration gespeichert. Man muss sich im klaren sein, dass die
+@qq{aktuelle Konfiguration} gelesen wird, wenn die Variable erstellt
+wird, nicht wenn sie benutzt wird. Darum ist der Inhalt der Variable
+abhängig von ihrer Position in der Partitur.
+
+Die Variable kann dann auch innerhalb einer anderen @code{\layout}-Umgebung
+eingesetzt werden, etwa:
+
+@example
+\layout @{
+ \layoutVariable
+ \context @{
+ \Voice
+ \override NoteHead #'color = #red
+ @}
+@}
+@end example
+Eine @code{\layout}-Umgebung, die eine Variable enthält wie im Beispiel oben,
+kopiert die aktuelle Konfiguration @emph{nicht}, sondern benützt den
+Inhalt von @code{\layoutVariable} als Basiskonfiguration für die weiteren
+Veränderungen. Das heißt, dass Änderungen, die zwischen der Definition
+der Variable und ihrer Benutzung definiert wurden, verloren gehen.
+
+Wenn @code{layoutVariable} kurz vor ihrer Benutzung definiert wird (oder
+mit @code{\include} eingefügt wird), entspricht ihr Inhalt der
+aktuellen Konfiguration plus die Änderungen, die die Variable definiert.
+Das obige Beispiel, das den Einsatz von @code{\layoutVariable} zeigt,
+würde in seiner finalen Version folgende @code{\layout}-Umgebung haben:
+
+@example
+ TextScript #'padding = #1
+ TextScript #'color = #magenta
+ Glissando #'thickness = #1.5
+ NoteHead #' font-size = #4
+ NoteHead #' color = #red
+@end example
+
+plus die Veränderungen an Einrückung (@code{indent}) und @code{StaffGrouper}.
+
+Aber wenn die Variable vor der ersten @code{\layout}-Umgebung definiert
+wird, würde die aktuelle Konfiguration nur enthalten:
+
+@example
+ NoteHead #' font-size= #4 % (written in the variable definition)
+ NoteHead #' color = #red % (added after the use of the variable)
+@end example
+
+Wenn man sorgfältig plant, können @code{\layout}-Variablen ein wertvolles
+Instrument sein, um das Layout-Design von Quellen zu strukturieren und
+auch dazu dienen, die Layout-Einstellungen an einer bestimmten Stelle
+wieder zurückzusetzen.
@seealso
Notationsreferenz:
* Optimale Seitenumbrüche::
* Optimale Umbrüche zum Blättern::
* Minimale Seitenumbrüche::
+* Eine-Seite-Seitenumbrüche::
* Ausdrückliche Umbrüche::
* Eine zusätzliche Stimme für Umbrüche benutzen::
@end menu
@lilypond[quote,ragged-right,verbatim]
\new Voice \with {
- \remove Forbid_line_break_engraver
+ \remove "Forbid_line_break_engraver"
} \relative c'' {
<<
{ c2. \times 2/3 { c4 c c } c2. | }
Es gibt auch vertikale Gegenstücke zu den Variablen
@code{ragged-right} und @code{ragged-last}:
@code{ragged-bottom} und @code{ragged-last-bottom}. Wenn diese
-Variablen auf @code{##t} (wahr) gesetzt werden, werden im ersten
+Variablen auf @code{#t} (wahr) gesetzt werden, werden im ersten
Fall die Notensysteme auf allen Seiten eng nach oben orientiert
gesetzt werden. Im zweiten Fall bezieht sich dies nur auf die
letzte Seite.
Der @code{Page_turn_engraver} liest die Kontexteigenschaft
@code{minimumPageTurnLength} um zu erkennen, wie lang eine Stelle
frei von Noten sein muss, damit ein Seitenumbruch in Frage kommt. Der
-Standardwert hierfür ist @code{#(ly:make-moment 1 1)}. Wenn Sie
+Standardwert hierfür ist @code{(ly:make-moment 1 1)}. Wenn Sie
Seitenumbrüche zum Umblättern ausschalten wollen, können Sie
einen sehr großen Wert angeben.
@}
@end example
-
@seealso
Schnipsel:
@rlsr{Spacing}.
+@node Eine-Seite-Seitenumbrüche
+@subsection Eine-Seite-Seitenumbrüche
+@translationof One-line page breaking
+
+@funindex ly:one-line-breaking
+
+Die Funktion @code{ly:one-line-breaking} ist ein besonderer
+Seitenumbruchalgorithmus, der jede Partitur (@code{score}) auf
+eine eigene Seite ausgibt, und in einer einzlenen Zeile. Diese
+Seitenumbruchfunktion gibt keine Titel oder Ränder aus, nur die
+Partitur wird dargestellt.
+
+Die Seitenbreite wird angepasst, sodass die längeste Partitur auf
+eine Zeile passt. Die Variablen @code{paper-width}, @code{line-width}
+und @code{indent} in der @code{\paper}-Umgebung werden ignoriert,
+wenn auch @code{left-margin} und @code{right-margin} noch beachtet
+werden. Die Höhe der Seite wird nicht verändert.
+
+
@node Ausdrückliche Umbrüche
@subsection Ausdrückliche Umbrüche
@translationof Explicit breaks
@menu
* Flexible vertikale Abstände in Systemgruppen::
-* Explizite Positionierung von Systemen und Systemgruppen::
+* Explizite Positionierung von Systemen::
* Vermeidung von vertikalen Zusammenstößen::
@end menu
@code{@var{Element1}} befindet; beispielsweise
@code{nonstaff-relatedstaff-spacing} (Nicht-Notensystem-verwandtesNotensystem)
misst von dem Nicht-Notensystem nach oben, wenn @code{staff-affinity}
-(Richtung, an der sich ein System ausrichtet) auf @code{#UP} (nach oben)
+(Richtung, an der sich ein System ausrichtet) auf @code{UP} (nach oben)
eingestellt ist.
Jeder Abstand wird zwischen den @emph{Referenzpunkten} der zwei Objekten
#(define-music-function
(parser location context)
(string?)
- #{ s1*0^\markup { \typewriter $context } #})
+ #{ s1*0^\markup { \typewriter #context } #})
\layout {
\context { \Dynamics \alignToZero }
@code{CENTER} oder @code{DOWN} gesetzt, wird das Notensystem als
Nicht-Notensystemzeile plaziert.
-
@item nonstaff-relatedstaff-spacing
Nicht-Notensystem-verwandtesSystem-Platzierung
@ref{Vertikale \paper-Variablen mit flexiblen Abständen},
@ref{Alisten verändern}.
+Installierte Dateien:
+@file{ly/engraver-init.ly},
+@file{scm/define-grobs.scm}.
+
Referenz der Interna:
@rinternals{Contexts},
@rinternals{VerticalAxisGroup},
@rinternals{StaffGrouper}.
-Installierte Dateien:
-@file{ly/engraver-init.ly},
-@file{scm/define-grobs.scm}.
-
@node Abstände von nicht gruppierten Notensystemen
@unnumberedsubsubsec Abstände von nicht gruppierten Notensystemen
-
-
-
-
-
-
@node Explizite Positionierung von Systemen
@subsection Explizite Positionierung von Systemen
@translationof Explicit staff and system positioning
padding bezeichnet), kann durch @code{outside-staff-padding}
kontrolliert werden.
-@lilypond[quote,ragged-right,relative=2,verbatim]
+@lilypond[quote,ragged-right,relative=2,verbatim,staffsize=18]
\once \override TextScript #'outside-staff-padding = #0
a'^"This text is placed very close to the note"
\once \override TextScript #'outside-staff-padding = #3
häufigste kürzeste Note wird dann als Grundlage für die Platzverteilung
der Noten herangezogen, mit der Bedingung, dass diese kürzeste
Note immer ein Achtel oder kürzer sein soll. Die kürzeste Dauer
-wird ausgegeben, wenn @code{lilypond} mit der Option @code{--verbose}
+wird ausgegeben, wenn @code{lilypond} mit der Option @option{--verbose}
aufgerufen wird.
Diese Dauern können aber auch angepasst werden. Wenn Sie die Eigenschaft
Proportionale Notation ist unterstützt, siehe @ref{Proportionale Notation}.
@seealso
+Aufsatz über den automatischen Notensatz:
+@ressay{Optischer Ausgleich}.
+
Schnipsel:
@rlsr{Spacing}.
@rinternals{StaffSpacing},
@rinternals{NonMusicalPaperColumn}.
-Aufsatz über den automatischen Notensatz:
-@ressay{Optischer Ausgleich}.
-
@knownissues
Es gibt keine sinnvolle Möglichkeit, die horizontale Verteilung der
werden, um zusätzlichen Platz in eine Partitur einzufügen.
@example
- \once \override Score.SeparationItem #'padding = #10
+ \override Score.NonMusicalPaperColumn #'padding = #10
@end example
Es gibt derzeit keine Möglichkeit, den Platz zu verringern.
@item @code{proportionalNotationDuration} (proportionale Notendauer)
@item @code{uniform-stretching} (gleichmäßige Dehnung)
@item @code{strict-note-spacing} (strenge Notenverteilung)
-@item @code{\remove Separating_line_group_engraver} (entferne Liniengruppentrennungsengraver)
+@item @code{\remove "Separating_line_group_engraver"} (entferne Liniengruppentrennungsengraver)
@item @code{\override PaperColumn #'used = ##t} (PapierSpalte benutzt = wahr)
@end itemize
welches die Referenzdauer ist, anhand welcher alle Noten platziert werden.
Hier wird die LilyPond Scheme-Funktion @code{make-moment} eingesetzt. Sie
braucht zwei Argumente: einen Zähler und einen Nenner, die einen Bruch einer
-Ganzen darstellen. Die Funktion @code{#(ly:make-moment 1 20)} ergibt also
+Ganzen darstellen. Die Funktion @code{(ly:make-moment 1 20)} ergibt also
eine Referenzdauer von einer Zwanzigstel. Genauso gut können etwa die Dauern
-@code{#(ly:make-moment 1 16)}, @code{#(ly:make-moment 1 8)} oder
-@code{#(ly:make-moment 3 97)} eingesetzt werden.
+@code{(ly:make-moment 1 16)}, @code{(ly:make-moment 1 8)} oder
+@code{(ly:make-moment 3 97)} eingesetzt werden.
Die richtige Referenzdauer, mit der eine vernünftige Verteilung der Noten
proportional möglich ist, muss durch Ausprobieren herausgefunden werden.
}
\new Staff \with {
- \remove Separating_line_group_engraver
+ \remove "Separating_line_group_engraver"
} {
c'1
\break
@item @code{\override Beam #'breakable = ##t}
@item @code{\override Glissando #'breakable = ##t}
@item @code{\override TextSpanner #'breakable = ##t}
-@item @code{\remove Forbid_line_break_engraver in the Voice context}
+@item @code{\remove "Forbid_line_break_engraver" in the Voice context}
@end itemize
Diese Einstellungen bewirken, dass auch Verzierungsnoten proportional
Die Ausgabe von @code{annotate-spacing} bietet sehr viele
Details zu den vertikalen Dimensionen einer Partitur. Zu Information,
wie Seitenränder und andere Layout-Variablen geändert werden
-können, siehe @ref{Seitenformatierung}.
+können, siehe @ref{Seitenlayout}.
Neben Rändern gibt es einige weitere Optionen, Platz zu sparen:
@}
@end example
+@item
+Die Anzahl der Seiten kann erzwungen werden. Beispielsweise erzwingt
+folgender Code ein Layout mit zwei Seiten:
+
+@example
+\paper @{
+ page-count = #2
+@}
+@end example
+
@item
Vermeidung (oder Verminderung) von Objekten, die den vertikalen Abstand von Systemen
vergrößern, hilft oft. Die Verwendung von Klammern bei Wiederholungen
@seealso
Notationsreferenz:
-@ref{Seitenformatierung},
+@ref{Seitenlayout},
@ref{Horizontale Abstände verändern}.
Schnipsel:
projects / lilypond.git / blobdiff