]> 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 0b973cc3524f4adbcfd9a4e9f5f96a5ee9abb496..a87feb53cb7e829e61688255bc67fb9c7d8957a7 100644 (file)
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 
 @ignore
-    Translation of GIT committish: 32b9cd030a1917570346e9b9ea267fe409156b2f
+    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
@@ -896,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}.
@@ -1090,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:
@@ -1234,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
@@ -1596,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
@@ -2064,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
 
@@ -2136,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
@@ -2370,12 +2503,6 @@ Referenz der Interna:
 
 
 
-
-
-
-
-
-
 @node Explizite Positionierung von Systemen
 @subsection Explizite Positionierung von Systemen
 @translationof Explicit staff and system positioning
@@ -2679,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
@@ -2828,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}.
 
@@ -2837,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
@@ -3574,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