]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/de/notation/spacing.itely
Doc-de: update commitsh strings to reflect status as up-to-date
[lilypond.git] / Documentation / de / notation / spacing.itely
index 47d7f7af06517f1abf105da3ec0ae828808a2c57..a87feb53cb7e829e61688255bc67fb9c7d8957a7 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 
 @ignore
-    Translation of GIT committish: c1df40da9f8b2794e173583c363f9e736e5531bd
+    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.15.20"
+@c \version "2.16.0"
 
 @c Translators: Till Paala
 
@@ -168,62 +168,75 @@ Installierte Dateien:
 
 @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.
 
@@ -231,15 +244,17 @@ Wenn das Symbol @code{'landscape} als Argument an die Funktion
 #(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
@@ -327,7 +342,7 @@ ein bis zwei Notensystemgruppen pro Seite haben, etwa Orchesterpartituren.
 
 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
@@ -349,6 +364,9 @@ behandelt, sodass @code{ragged-bottom} und @code{ragged-last-bottom} auch
 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
@@ -448,6 +466,10 @@ zu vermeiden.
 
 @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
@@ -665,6 +687,10 @@ Notationsreferenz:
 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
@@ -885,7 +911,8 @@ Notationsreferenz:
 @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}.
@@ -1079,7 +1106,106 @@ Hier ist ein Beispiel für eine @code{\layout}-Umgebung:
 @}
 @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:
@@ -1223,6 +1349,7 @@ Notenlinien.
 * 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
@@ -1585,12 +1712,30 @@ ist die Funktion geeignet.  Sie wird folgendermaßen aktiviert:
 @}
 @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
@@ -2053,7 +2198,6 @@ Notensystem behandelt. Wird @code{staff-affinity} auf @code{UP},
 @code{CENTER} oder @code{DOWN} gesetzt, wird das Notensystem als
 Nicht-Notensystemzeile plaziert.
 
-
 @item nonstaff-relatedstaff-spacing
 Nicht-Notensystem-verwandtesSystem-Platzierung
 
@@ -2125,15 +2269,15 @@ Notationsreferenz:
 @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
@@ -2359,12 +2503,6 @@ Referenz der Interna:
 
 
 
-
-
-
-
-
-
 @node Explizite Positionierung von Systemen
 @subsection Explizite Positionierung von Systemen
 @translationof Explicit staff and system positioning
@@ -2668,7 +2806,7 @@ dem vorhergehenden Objekt eingefügt werden kann (auch als
 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
@@ -2817,6 +2955,9 @@ besser sieht:
 Proportionale Notation ist unterstützt, siehe @ref{Proportionale Notation}.
 
 @seealso
+Aufsatz über den automatischen Notensatz:
+@ressay{Optischer Ausgleich}.
+
 Schnipsel:
 @rlsr{Spacing}.
 
@@ -2826,9 +2967,6 @@ Referenz der Interna:
 @rinternals{StaffSpacing},
 @rinternals{NonMusicalPaperColumn}.
 
-Aufsatz über den automatischen Notensatz:
-@ressay{Optischer Ausgleich}.
-
 @knownissues
 
 Es gibt keine sinnvolle Möglichkeit, die horizontale Verteilung der
@@ -2837,7 +2975,7 @@ dehnbare Abstände (padding) eingesetzt werden, kann benutzt
 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.
@@ -3563,6 +3701,16 @@ nur 10 Systemen erzwingen.
 @}
 @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