Documentation/de/notation/spacing.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
   2
   3 @ignore
   4     Translation of GIT committish: ab9e3136d78bfaf15cc6d77ed1975d252c3fe506
   5
   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.
   9 @end ignore
  10
  11 @c \version "2.13.39"
  12
  13 @c Translators: Till Paala
  14
  15
  16 @node Abstände
  17 @chapter Abstände
  18 @translationof Spacing issues
  19
  20 Das finale Layout der Seite wird von drei Faktoren bestimmt: dem Layout
  21 der Seite, den Zeilenumbrüchen und der Platzverteilung.  Jeder Faktor
  22 beeinflusst auch die anderen mit.  Die Wahl der Platzverteilung
  23 entscheidet, wie eng die Notensysteme gesetzt werden.  Das wiederum
  24 hat Einfluss auf die gewählten Zeilenumbrüche und letztendlich also
  25 auch darauf, wieviele Seiten ein Stück beansprucht.
  26
  27 Die Verteilung der Musik auf der Seite geschieht grob gesagt in
  28 vier Schritten.  Zuerst werden flexible Entfernungen (@qq{springs})
  29 gewählt, die auf den Notendauern basieren.  Alle möglichen
  30 Zeilenumbrüche werden getestet und ein @qq{Schlechtigkeitsscore}
  31 für die Umbrüche erstellt.  Danach wird die mögliche Höhe eines Systems
  32 ermittelt und schließlich wird eine bestimmte Kombination aus
  33 Seiten- und Zeilenumbruch ausgewählt, sodass weder die horizontale
  34 noch die vertikale Platzverteilung zu eng oder zu weit gesetzt wird.
  35
  36 Einstellungen, die das Layout beeinflussen, können in zwei Umgebungen
  37 gesetzt werden: Die @code{\paper @{...@}}-Umgebung wird außerhalb einer
  38 @code{\score @{...@}}-Umgebung geschrieben und enthält Einstellungen,
  39 die für das gesamte Dokument gelten.  Die @code{\layout @{...@}}-Umgebung
  40 wird innerhalb von einer @code{\score @{...@}}-Umgebung notiert und
  41 enthält die Einstellungen für eine bestimmte Partitur.  Wenn Sie
  42 nur eine @code{\score @{...@}}-Umgebung in der Datei haben, haben
  43 beide Umgebungen den gleichen Effekt.  Die Befehle, die in diesem Abschnitt
  44 erklärt werden, können in beiden Umgebungen nach Bedarf gesetzt werden.
  45
  46 @menu
  47 * Papier und Seiten::
  48 * Notenlayout::
  49 * Umbrüche::
  50 * Vertikale Abstände::
  51 * Horizontale Abstände::
  52 * Die Musik auf weniger Seiten zwingen::
  53 @end menu
  54
  55
  56 @node Papier und Seiten
  57 @section Papier und Seiten
  58 @translationof Paper and pages
  59
  60 Dieser Abschnitt behandelt die Grenzen, die Notationsgebiete
  61 definieren.
  62
  63 @menu
  64 * Papierformat::
  65 * Seitenformatierung::
  66 @end menu
  67
  68
  69 @node Papierformat
  70 @subsection Papierformat
  71 @translationof Paper size
  72
  73 @cindex Papiergröße
  74 @cindex Größe, Papier
  75 @cindex Seitegröße
  76 @cindex Größe, Seite
  77
  78 Zwei Funktionen ermöglichen es, die Papiergröße zu ändern:
  79 @code{set-default-paper-size} und @code{set-paper-size}.
  80 @code{set-default-paper-size} muss auf der obersten Ebene in
  81 der Quelldatei gesetzt werden, @code{set-paper-size} hingegen
  82 muss sich in einer @code{\paper}-Umgebung befinden:
  83
  84 @example
  85 #(set-default-paper-size "a4")
  86 @end example
  87
  88 @example
  89 \paper @{
  90   #(set-paper-size "a4")
  91 @}
  92 @end example
  93
  94 @noindent
  95 @code{set-default-paper-size} bestimmt die Größe aller Seiten, während
  96 @code{set-paper-size} nur die Seitengröße für die Seiten definiert,
  97 auf die sich die aktuelle @code{\paper}-Umgebung bezieht.  Wenn die
  98 @code{\paper}-Umgebung auf der höchsten Ebene steht, bezieht sich die
  99 Papiergröße auf alle Seiten, wenn sie aber innerhalb einer
 100 @code{\book}-Umgebung definiert wird, nur auf die Seiten innerhalb
 101 dieses Buches.
 102
 103 Die normalen Papierformate sind definiert, u.A. @code{a4},
 104 @code{letter}, @code{legal} und @code{11x17} (auch als
 105 Tabloit bekannt).  Sehr viel mehr Formate sind unterstützt.
 106 Einzelheiten finden sich in der Datei
 107 @file{scm/@/paper@/.scm} in der Definition von
 108 @code{paper-alist}.
 109
 110 @warning{Das Standardformat ist @code{a4}.}
 111
 112 Weitere Papierformate können hinzugefügt werden, indem die
 113 Definition von @code{paper-alist} in der Datei
 114 @file{scm/@/paper@/.scm} verändert wird.  Derartige
 115 Änderungen werden jedoch bei einer Aktualisierung des
 116 Programmes überschrieben.
 117
 118 @cindex Ausrichtung, Papier
 119 @cindex Papier, Ausrichtung
 120 @cindex hochkant, Papier
 121 @cindex quer, Papier
 122
 123 @funindex landscape
 124
 125 Wenn das Symbol @code{'landscape} als Argument an die Funktion
 126 @code{set-default-paper-size} gehängt wird, werden die Seiten um
 127 90° gedreht und die Notensysteme entsprechend breiter gesetzt.
 128
 129 @example
 130 #(set-default-paper-size "a6" 'landscape)
 131 @end example
 132
 133 Wenn man die Seitengröße setzt, werden einige Variablen der
 134 @code{\paper}-Umgebung verändert, wie etwa Seitenränder.  Um
 135 eine bestimmte Papiergröße mit veränderten @code{\paper}-Variablen
 136 zu benutzen, muss die Papiergröße definiert werden, bevor diese
 137 Variablen neu gesetzt werden.
 138
 139
 140 @seealso
 141 Installierte Dateien:
 142 @file{scm/@/paper@/.scm}.
 143
 144 Schnipsel:
 145 @rlsr{Spacing}.
 146
 147
 148 @node Seitenformatierung
 149 @subsection Seitenformatierung
 150 @translationof Page formatting
 151
 152 Ränder, Kopf- und Fußzeilen und andere Layoutvariablen werden
 153 entsprechend dem Papierformat automatisch gesetzt.
 154
 155 Standardwerte für Ränder finden sich in der Datei
 156 @file{ly/@/paper@/-defaults@/-init@/.ly}.  Sie gelten
 157 für die normale Papiergröße (A4, wenn nicht anders angegeben)
 158 und sind entsprechend skaliert für andere Papiergrößen.
 159
 160 Dieser Abschnitt zeigt einige der Papiervariablen, die geändert
 161 werden können.
 162
 163 @menu
 164 * Vertikale Dimensionen::
 165 * Horizontale Dimensionen::
 166 * Weitere Layout-Variablen::
 167 @end menu
 168
 169
 170 @node Vertikale Dimensionen
 171 @unnumberedsubsubsec Vertikale Dimensionen
 172 @translationof Vertical dimensions
 173
 174 Diese Variablen werden benutzt um andere vertikale Verhältnisse
 175 auf einer Seite zu produzieren:
 176
 177 @funindex \paper
 178 @funindex after-title-space
 179 @funindex before-title-space
 180 @funindex between-system-padding
 181 @funindex between-system-space
 182 @funindex between-title-space
 183 @funindex bottom-margin
 184 @funindex foot-separation
 185 @funindex head-separation
 186 @funindex page-top-space
 187 @funindex paper-height
 188 @funindex top-margin
 189
 190 @table @code
 191
 192 @item markup-system-spacing
 193
 194 @funindex markup-system-spacing
 195
 196 Gibt an, wie der Abstand zwischen Titel (oder der obersten Beschriftung) und
 197 dem darauffolgenden Notensystem berechnet wird.  Das ist eine assoziative
 198 Liste mit fünf Einrägen:
 199
 200 @itemize @bullet
 201 @item
 202 @var{Platz} -- Die Größe an dehnbarem Platz zwischen der Grundlinie eines
 203 Titels und dem Mittelpunkt des folgenden Notensystems.
 204
 205 @item
 206 @var{Verschiebung (padding)} -- Der minimale weiße Platz, der zwischen einem
 207 System und der Überschrift erhalten bleiben muss.
 208
 209 @item
 210 @var{Dehnbarkeit} -- Wie leicht der Platz zwischen Titel und erstem System
 211 geweitet wird, wenn eine Seite gedehnt wird.
 212 Wenn der Wert von @var{Dehnbarkeit} Null ist, dann wird der Abstand zum
 213 nächsten System überhaupt nicht gedehnt.  Das hat den Unterschied zu
 214 @var{Verschiebung}, dass die Höhe eines Systems keinen Einfluss auf die
 215 Anwendung von @var{minimum-distance} (minimaler Abstand) hat (während die Höhe
 216 eines Systems ausdrücklich für @var{Verschiebung} verlangt wird.
 217
 218 @end itemize
 219
 220 Der Standard beispielsweise ist:
 221
 222 @example
 223 markup-system-spacing = #'((Platz . 2) Verschiebung . 0.5))
 224 @end example
 225
 226 Wenn eine Seite einen keinen ausgeglichenen unteren Rand hat, wird @var{Platz}
 227 nicht gestreckt.  Insbesondere der Abstand auf einer derartigen Seite der
 228 größte Wert von
 229
 230 @itemize @bullet
 231 @item @var{Platz},
 232 @item @var{minimum-distance} und
 233 @item @var{Verschiebung} plus dem Mindestabstand, damit keine Überlappung
 234 auftreten.
 235 @end itemize
 236
 237 @item score-markup-spacing
 238
 239 @funindex score-markup-spacing
 240
 241 Definiert den Platz zwiscehn einem System und dem Titel (oder der obersten
 242 Beschriftung), der darauf folgt.  Der Abstand wird von der Mitte des letzten
 243 Notensystems der Systemgruppe zur Grundlinie des darauf folgenden Titels
 244 berechnet.  Siehe auch @var{markup-system-spacing}.
 245
 246 @item score-system-spacing
 247
 248 @funindex score-system-spacing
 249
 250 Definiert den Abstand zwischen zwei Systemen, wenn sie sich in unterschiedlichen
 251 Partituren (Score) befinden, aber zwischen ihnen keine Überschrift kommt.  Siehe
 252 auch @var{markup-system-spacing}.
 253
 254 @item system-system-spacing
 255
 256 @funindex system-system-spacing
 257
 258 Definiert den Abstand zwischen der Mitte des untersten Notensystems einer
 259 Systemgruppe und der Mitte des obersten Notensystems der folgenden Systemgruppe.
 260 Siehe @var{markup-system-spacing}.
 261
 262 @item markup-markup-spacing
 263
 264 @funindex markup-markup-spacing
 265
 266 Definiert den Abstand zwischen zwei Überschriften (oder Beschriftungen auf oberster
 267 Ebene).  Die Abstände werden von der Grundlinie der ersten Überschrift zur
 268 Grundlinie der zweiten Überschrift errechnet.  Siehe @var{markup-system-spacing}.
 269
 270 @item bottom-margin
 271
 272 Der Rand zwischen der Fußzeile und dem unteren Rand der Seite.
 273 Standard: @code{6\mm}.
 274
 275 @item last-bottom-spacing
 276
 277 @funindex last-bottom-spacing
 278
 279 Definiert den Abstand von der Mitte des letzten Systems (oder der Grundlinie der
 280 letzten Beschriftung) zum Ende des bedruckbaren Bereichs (normalerweise die
 281 Oberkante des Seitenrandes).  Siehe @var{markup-system-spacing}.
 282
 283 @item top-markup-spacing
 284
 285 @funindex top-markup-spacing
 286
 287 Definiert den Abstand vom Oberrand des bedruckbaren Bereichs (also dem Unterrand
 288 des oberen Seitenrandes) zur Grundlinie der Ügerschrift.  Siehe @var{markup-system-spacing}.
 289
 290 @item top-system-spacing
 291
 292 @funindex top-system-spacing
 293
 294 Definiert den Abstand vom Oberrand des bedruckbaren Bereiches (also dem Unterrand
 295 des oberen Seitenrandes) zur Mitte des ersten Notensystems.  Der Wert wird nur
 296 eingesetzt, wenn oben auf der Seite kein Titel gesetzt ist (in welchem Fall
 297 @var{top-markup-spacing} benutzt wird).  Siehe @var{markup-system-spacing}.
 298
 299 @item paper-height
 300
 301 Die Höhe der Seite.  Standard:  Die Höhe des aktuellen Papierformats.
 302 Zu Einzelheiten siehe @ref{Papierformat}.
 303
 304 @item top-margin
 305
 306 Der Rand zwischen der Kopfzeile und dem oberen Rand der Seite. Standard:
 307 @code{5\mm}.
 308
 309 @end table
 310
 311
 312 @snippets
 313
 314 Kopf- und Fußzeile werden von den Funktionen @code{make-footer} und
 315 @code{make-header} erstellt, welche in der @code{\paper}-Umgebung definiert
 316 werden.  Die Standardeinstellungen sind in den Dateien
 317 @file{ly/paper-defaults.ly} und @code{ly/titling-init.ly} dargestellt.
 318
 319 Das Seitenlayout wird durch zwei Funktionen der @code{\paper}-Umgebung
 320 bestimmt: @code{page-music-height} und @code{page-make-stencil}.  Die erste
 321 teilt dem Zeilenumbruchsalgorithmus mit, wieviel Platz auf einer Seite
 322 belegt werden kann, die zweite hingegen erstellt die konkrete Seite,
 323 nachdem sie die Systeme entgegengenommen hat, die auf der Seite platziert
 324 werden sollen.
 325
 326 Beispiel:
 327
 328 @example
 329 \paper @{
 330   paper-width = 2\cm
 331   top-margin = 3\cm
 332   bottom-margin = 3\cm
 333   ragged-last-bottom = ##t
 334 @}
 335 @end example
 336
 337 Das nächste Beispiel zentriert Seitenzahlen unten auf jeder Seite:
 338
 339 @example
 340 \paper @{
 341   print-page-number = ##t
 342   print-first-page-number = ##t
 343   oddHeaderMarkup = \markup \fill-line @{ " " @}
 344   evenHeaderMarkup = \markup \fill-line @{ " " @}
 345   oddFooterMarkup = \markup @{ \fill-line @{
 346      \bold \fontsize #3 \on-the-fly #print-page-number-check-first
 347      \fromproperty #'page:page-number-string @} @}
 348   evenFooterMarkup = \markup @{ \fill-line @{
 349      \bold \fontsize #3 \on-the-fly #print-page-number-check-first
 350      \fromproperty #'page:page-number-string @} @}
 351 @}
 352 @end example
 353
 354 Werte der @code{\paper}-Umgebung können in Scheme definiert werden.  In diesem
 355 Fall sind @code{mm}, @code{in}, @code{pt} und @code{cm} Variablen,
 356 die in der Datei @file{paper@/-defaults@/-init@/.ly} mit Millimeter-Werten definiert
 357 sind.  Darum muss der Wert 2 cm in dem Beispiel unten multipliziert werden
 358 muss:
 359
 360 @example
 361 \paper @{
 362  #(define bottom-margin (* 2 cm))
 363 @}
 364 @end example
 365
 366 Kopf- und Fußzeile werden durch die Funktionen @code{make-footer} und
 367 @code{make-header} erstellt, welche in @code{\paper} definiert sind.
 368 Die Standardwerte finden sich in @file{paper@/-defaults@/-init@/.ly} und
 369 @file{ly/@/titling@/-init@/.ly}.
 370
 371 Das Seitenlayout selber wird von zwei Funktionen in @code{\paper} vorgenommen:
 372 @code{page-music-height} und @code{page-make-stencil}.  Die erste sagt
 373 dem Zeilenumbruchsalgorithmus, wieviel Platz auf einer Seite verteilt werden
 374 kann, die zweite erstellt die eigentliche Seite, wenn sie das System hat,
 375 das auf der Seite erscheinen soll.
 376
 377 @seealso
 378 Notationsreferenz:
 379 @ref{Vertikale Abstände zwischen Systemen}.
 380
 381 Schnipsel:
 382 @rlsr{Spacing}.
 383
 384
 385 @node Horizontale Dimensionen
 386 @unnumberedsubsubsec Horizontale Dimensionen
 387 @translationof Horizontal dimensions
 388
 389 Es gibt einige Variablen, die die horizontalen Dimensionen der Seite
 390 beeinflussen:
 391
 392 @table @code
 393
 394 @item binding-offset
 395
 396 @funindex binding-offset
 397
 398 Der Wert, um welchen @code{inner-margin} erhöht wird, um sicherzugehen, dass
 399 nichts in der Bindung verschwindet.  Funktioniert nur, wenn @code{two-sided}
 400 wahr ist.  Standard: @code{0}.
 401
 402 @item horizontal-shift
 403
 404 @funindex horizontal-shift
 405
 406 Der Wert, um den alle Systeme (und auch Überschriften und Systemtrenner)
 407 nach rechts verschoben werden.  Standard: @code{0.0}.
 408
 409 @item indent
 410
 411 @funindex indent
 412
 413 Der Einzug für das erste System einer Partitur.  Standard: @code{15\mm}.
 414
 415 @item inner-margin
 416
 417 @funindex inner-margin
 418
 419 Der Rand, den alle Seiten auf der Innenseite haben, wenn sie Teil eines
 420 Buches (@code{\book}) sind.  Funktioniert nur, wenn @code{two-sided}
 421 wahr ist.  Standard: @code{10\mm}.
 422
 423 @item left-margin
 424
 425 @funindex left-margin
 426
 427 Der Rand zwischen dem linken Rand der Seite und dem Anfang der Notensysteme.
 428 Standard: @code{10\mm}.
 429
 430 @item line-width
 431
 432 @funindex line-width
 433
 434 Die Breite der Notensystems. Standard: @code{paper-width} minus
 435 @code{left-margin} und @code{right-margin}.
 436
 437 @item outer-margin
 438
 439 @funindex outer-margin
 440
 441 Der Rand, den alle Seiten auf der Außenseite haben, wenn sie Teil eines Buches
 442 sind.  Funktioniert nur, wenn @code{two-sided} wahr ist.  Standard: @code{20\mm}.
 443
 444 @item paper-width
 445
 446 @funindex paper-width
 447
 448 Die Breite der Seite.  Standard: Die Breite des aktuellen
 449 Papierformats.  Zu Einzelheiten siehe @ref{Papierformat}.
 450
 451 @item right-margin
 452
 453 @funindex right-margin
 454
 455 Der Rand zwischen dem Papierrand und dem Ende jedes Systems.  Standard:
 456 @code{10\mm}.
 457
 458 @item short-indent
 459
 460 @funindex short-indent
 461
 462 Der Einzug für alle Systeme einer Partitur ausschließlich das
 463 erste System.  Standard: @code{0}.
 464
 465 @end table
 466
 467 Wenn einige der Werte nicht definiert sind, werden die Standardwerte eingesetzt.
 468 Ihre exakten Werte werden entsprechend der angegebenen Papiergröße angepasst.
 469 Im Moment werden folgende Werte von dieser Skalierung berücksichtigt:
 470
 471 @itemize
 472 @item @var{left-margin}
 473 @item @var{right-margin}
 474 @item @var{top-margin}
 475 @item @var{bottom-margin}
 476 @item @var{head-separation}
 477 @item @var{foot-separation}
 478 @item @var{indent}
 479 @item @var{short-indent}
 480 @end itemize
 481
 482 Die Einstellungen für @code{line-width}, @code{left-margin},
 483 @code{right-margin} und @code{paper-width} hängen voneinander ab,
 484 aber sie müssen nicht vollständig definiert werden.
 485
 486 @example
 487 \paper @{
 488   left-margin = 30\mm
 489 @}
 490 @end example
 491
 492 In diesem Beispiel wird nur @code{left-margin} definiert.  Der Wert
 493 für @code{right-margin} bleibt bei dem Standardwert, @code{line-width}
 494 wird automatisch errechnet.
 495
 496 @example
 497 \paper @{
 498   line-width = 150\mm
 499 @}
 500 @end example
 501
 502 Hier erhalten @code{left-margin} und @code{right-margin} den gleichen Wert.
 503 Deshalb wird @code{line-width} von @code{paper-width} abgezogen und durch
 504 zwei geteilt.  Das bedeutet, dass Systeme auf der Seite zentriert werden, wenn
 505 nur @code{line-width} definiert wird.
 506
 507 Einige Überprüfungen werden angestellt, um die Richtigkeit der Wert zu gewährleisten.
 508 Wenn die Werte nicht passen oder Systeme aus der Seite hinausragen würden, wird
 509 eine Warnung ausgegeben und die Standardwerte eingesetzt.
 510
 511 @example
 512 \paper @{
 513   paper-width = 210\mm
 514   left-margin = 20\mm
 515   right-margin = 30\mm
 516   line-width = 100\mm
 517 @}
 518 @end example
 519
 520 Diese Überprüfungen können vermieden werden, indem man @code{check-consistency}
 521 als unwahr definiert.
 522
 523 @example
 524 \paper @{
 525   paper-width = 210\mm
 526   left-margin = 20\mm
 527   line-width = 200\mm
 528   check-consistency = ##f
 529 @}
 530 @end example
 531
 532 @warning{Wenn @code{paper-width} manuell definiert wird, müssen eventuell auch
 533 @code{line-width}, @code{left-margin}, @code{indent} und @code{short-indent}
 534 angepasst werden.}
 535
 536 @seealso
 537 Schnipsel:
 538 @rlsr{Spacing}.
 539
 540
 541 @node Weitere Layout-Variablen
 542 @unnumberedsubsubsec Weitere Layout-Variablen
 543 @translationof Other layout variables
 544
 545 Diese Variablen können verwendet werden, um das allgemeine Layout der Seite
 546 anzupassen.
 547
 548 @funindex auto-first-page-number
 549 @funindex blank-last-page-force
 550 @funindex blank-page-force
 551 @funindex first-page-number
 552 @funindex page-breaking-between-system-padding
 553 @funindex page-count
 554 @funindex page-limit-inter-system-space
 555 @funindex page-limit-inter-system-space-factor
 556 @funindex page-spacing-weight
 557 @funindex print-all-headers
 558 @funindex print-first-page-number
 559 @funindex print-page-number
 560 @funindex ragged-bottom
 561 @funindex ragged-last
 562 @funindex ragged-last-bottom
 563 @funindex ragged-right
 564 @funindex system-separator-markup
 565 @funindex system-count
 566
 567 @table @code
 568
 569 @item auto-first-page-number
 570
 571 Der Seitenumbruchsalgorithmus wird davon beeinflusst, ob die erste
 572 Seitenzahl gerade oder ungerade ist.  Wenn die Variable auf wahr
 573 gesetzt wird, entscheidet der Seitenumbruchsalgorithmus selber,
 574 ob die Noten auf einer geraden oder ungeraden Seite beginnen sollen.
 575 Das hat dann zur Folge, dass die erste Seite entweder bleibt wie
 576 sie ist oder um eins erhöht wird.  Standard: @code{##f}.
 577
 578 @ignore
 579
 580 TODO: this variable is used, but I don't know what it does. -pm
 581 @item blank-after-score-page-force
 582 @funindex blank-after-score-page-force
 583
 584 Default: @code{2}.
 585
 586 @end ignore
 587
 588 @item blank-last-page-force
 589
 590 Die Strafpunkte, wenn eine Partitur auf einer ungeraden Seite
 591 beendet wird. Standard: @code{0}.
 592
 593 @item blank-page-force
 594
 595 Die Strafpunkte, wenn eine leere Seite mitten in einer Partitur
 596 auftritt.  Das wird nicht benutzt von @code{ly:optimal-breaking},
 597 weil hiermit niemals leere Seiten mitten in einer Partitur zugelassen
 598 werden.  Standard: @code{5}.
 599
 600 @item check-consistency
 601
 602 @funindex check-consistency
 603
 604 Wenn wahr, wird überprüft, ob @code{left-margin}, @code{right-margin} und
 605 @code{line-width} zueinander passen.  Ihr Gesamtwert darf auch nicht die
 606 Seitenbreite (@code{paper-width} übertreffen.  Standard: @code{##t}.
 607
 608 @item first-page-number
 609
 610 Der Wert der Seitenzahl auf der ersten Seite.  Standard: @code{#1}.
 611
 612 @item max-systems-per-page
 613
 614 Die maximale Anzahl an Notensystemen, die auf einer Seite gesetzt werden.  Das
 615 wird zur Zeit nur von dem @code{ly:optimal-breaking}-Algorithmus
 616 unterstützt.  Standard: nicht gesetzt.
 617
 618 @item min-systems-per-page
 619
 620 Die minimale Anzahl an Notensystemen, die auf einer Seite gesetzt werden. Das
 621 kann dazu führen, dass Seiten zu dicht gefüllt werden, wenn der Wert
 622 zu groß gewählt wird.  Die Option ist zur Zeit nur von dem
 623 @code{ly:optimal-breaking}-Algorithmus unterstützt.  Standard: nicht gesetzt.
 624
 625 @item page-breaking-system-system-spacing
 626
 627 @funindex page-breaking-system-system-spacing
 628
 629 Überlistet die Seitenumbruchfunktion, indem ihr ein anderer Wert
 630 für @code{system-system-spacing} mitgeteilt wird, als in Wirklichkeit
 631 eingestellt ist.  Wenn beispielsweise
 632 @code{page-breaking-system-system-spacing #'padding} auf einen
 633 deutlich größeren Wert als @code{system-system-spacing #'padding} gesetzt
 634 wird, setzt die Seitenumbruchsfunktion weniger Systeme auf eine
 635 Seite.  Standard: nicht gesetzt.
 636
 637 @item page-count
 638
 639 Die Zahl der Seiten, die für eine Partitur benutzt werden sollen.
 640 Standard: nicht gesetzt.
 641
 642 @item page-limit-inter-system-space
 643
 644 Wenn wahr, wird Platz zwischen Systemen eingeschränkt, wenn viel
 645 Platz auf der Seite ist.  Standard: @code{##f}.  Einzelheiten siehe
 646 @ref{Vertikale Abstände zwischen Systemen}.
 647
 648 @item page-limit-inter-system-space-factor
 649
 650 Der Faktor, der von @code{page-limit-inter-system-space} verwendet
 651 wird.  Standard: @code{1.4}.  Einzelheiten siehe
 652 @ref{Vertikale Abstände zwischen Systemen}.
 653
 654 @item page-spacing-weight
 655
 656 Die relative Gewichtung von (vertikalem) Abstand auf der Seite und
 657 (horizontalem) Abstand innerhalb der Zeilen.  Hohe Werte gewichten
 658 die vertikalen Abstände mehr.  Standard: @code{#10}.
 659
 660 @item print-all-headers
 661
 662 Wenn wahr, werden alle Einträge des Titelfeldes (@code{\header}-Umgebung)
 663 für jede Partitur ausgegeben.  Normalerweise wird nur die
 664 Satzbezeichnung und die Opuszahl (@code{piece} und @code{opus})
 665 ausgegeben.  Standard: @code{##f}.
 666
 667 @item print-first-page-number
 668
 669 Wenn wahr, wird auch auf der ersten Seite die Seitenzahl ausgegeben.
 670 Standard: @code{##f}.
 671
 672 @item print-page-number
 673
 674 Wenn falsch, werden Seitenzahlen nicht ausgegeben.  Standard:
 675 @code{##t}.
 676
 677 @item ragged-bottom
 678
 679 Wenn wahr, werden die Systeme nicht gleichmäßig über die Seite
 680 verteilt sondern am oberen Seitenrand beginnend eng angeordnet.
 681 Das wirkt sich nicht auf die letzte Seite aus.  Standard: @code{##f}.
 682
 683 Die Variable sollte auf wahr gesetzt werden für Stücke, die nur
 684 zwei oder drei Systeme pro Seite haben, wie etwa Orchesterpartituren.
 685
 686 @item ragged-last
 687
 688 Wenn wahr, wird die letzte Notenzeile einer Partitur nicht bis
 689 zum Zeilenende durchgezogen, sondern entsprechend mit Noten
 690 gefüllt und dann abgebrochen.  Standard: @code{##f}.
 691
 692 @item ragged-last-bottom
 693
 694 Wenn falsch, werden Systeme gleichmäßig über die letzte Seite
 695 verteilt.  Standard: @code{##t}.
 696
 697 Stücke, die zwei oder mehr Seiten gut füllen, sollten die Option auf wahr
 698 gesetzt haben.
 699
 700 Sie wirkt sich auch auf die letzte Seite von Buchteilen aus, d.h.
 701 Teilen eines Buches, die mit der @code{\bookpart}-Umgebung erstellt werden.
 702
 703 @item ragged-right
 704
 705 Wenn wahr, werden Systeme nicht im Blocksatz gesetzt, sondern erhalten
 706 nur ihre normale Breite.  Standard: @code{##f}.
 707
 708 Wenn eine Partitur nur ein System hat, ist der Standardwert @code{##t}.
 709
 710 @item system-separator-markup
 711
 712 Ein Beschriftungsobjekt, das zwischen zwei Systeme gesetzt wird.  Das
 713 wird oft in Orchesterpartituren eingesetzt.  Standard: nicht gesetzt.
 714
 715 Der Beschriftungsbefehl @code{\slashSeparator} kann für einen Trenner
 716 benutzt werden, etwa so:
 717
 718 @lilypond[quote,ragged-right]
 719 #(set-default-paper-size "a6" 'landscape)
 720 \book {
 721   \score {
 722     \relative c' { c1 \break c1 }
 723   }
 724   \paper {
 725     system-separator-markup = \slashSeparator
 726   }
 727 }
 728 @end lilypond
 729
 730 @item system-count
 731
 732 Die Anzahl der Systeme, auf denen eine Partitur gesetzt werden soll.
 733 Standard: nicht gesetzt.
 734
 735 @item systems-per-page
 736 @funindex systems-per-page
 737
 738 Die Anzahl an Systemen, die auf jede Seite gesetzt werden sollen.
 739 Diese Option wird zur Zeit nur von dem @code{ly:optimal-breaking}-Algorithmus
 740 unterstützt.  Standard: nicht gesetzt.
 741
 742 @item two-sided
 743
 744 @funindex two-sided
 745
 746 @cindex Bundsteg
 747 @cindex Binderand
 748
 749 Wenn auf wahr (@code{##t}) gesetzt, werden  @code{inner-margin}, @code{outer-margin}
 750 und @code{binding-offset} zusammen benutzt, um die Ränder der Seite in Abhängigkeit
 751 von einer geraden oder ungeraden Seitennummer zu errechnen.  Damit werden die
 752 Werte von @code{left-margin} und @code{right-margin} überschrieben.  Standard:
 753 @code{##f}.
 754
 755 @end table
 756
 757
 758 @seealso
 759 Schnipsel:
 760 @rlsr{Spacing}.
 761
 762
 763 @knownissues
 764
 765 Die Standard-Kopfzeilendefinition setzt die Seitenzahl und das
 766 @code{instrument}-Feld aus der @code{\header}-Umgebung in eine
 767 Zeile.
 768
 769 Die Überschriften (aus der @code{\header}-Umgebung) werden als
 770 ein System interpretiert, sodass @code{ragged-bottom} und
 771 @code{ragged-last-bottom} Platz zwischen die Überschrift und
 772 das erste System der Partitur setzen.
 773
 774
 775 @node Notenlayout
 776 @section Notenlayout
 777 @translationof Music layout
 778
 779 @menu
 780 * Die Notensystemgröße einstellen::
 781 * Partiturlayout::
 782 @end menu
 783
 784
 785 @node Die Notensystemgröße einstellen
 786 @subsection Die Notensystemgröße einstellen
 787 @translationof Setting the staff size
 788
 789 @cindex Schriftgröße, Einstellung
 790 @cindex Systemgröße, Einstellung
 791 @cindex Verändern der Schriftgröße
 792 @cindex Verändern der Systemgröße
 793 @funindex layout file
 794
 795 Die Standardgröße der Notensysteme beträgt 20 Punkte (pt).
 796 Das kann auf zwei Arten geändert werden:
 797
 798 Um die Systemgröße global für alle Partituren einer
 799 Datei (bzw. einer @code{\book}-Umgebung) zu verändern,
 800 geht man wie folgt vor:
 801
 802 @example
 803 #(set-global-staff-size 14)
 804 @end example
 805
 806 @noindent
 807 Hiermit wird die Standardhöhe der Notensysteme auf 14 pt
 808 gesetzt.  Die Schriftarten werden entsprechend verkleinert.
 809
 810 Um die Systemhöhe für jede Partitur einzeln zu verändern,
 811 muss
 812
 813 @example
 814 \score@{
 815   ...
 816   \layout@{
 817   #(layout-set-staff-size 15)
 818   @}
 819 @}
 820 @end example
 821
 822 @noindent
 823 eingesetzt werden.
 824
 825 Die Feta-Schriftart stellt die Noten- und Musiksymbole
 826 für acht verschiedene Größen zur Verfügung.  Jede
 827 Schriftgröße ist einer bestimmten Systemgröße angepasst:
 828 für kleinere Schriftgrößen werden die Zeichen etwas
 829 schwerer, um mit den ebenfalls dickeren Notenlinien
 830 zu harmonieren.  Die empfohlenen Notensystemgrößen
 831 sind in der Tabelle aufgeführt:
 832
 833 @quotation
 834 @multitable @columnfractions .15 .2 .22 .2
 835
 836 @item @b{Schriftbezeichnung}
 837 @tab @b{Höhe des Systems (pt)}
 838 @tab @b{Höhe des Systems (mm)}
 839 @tab @b{Benutzung}
 840
 841 @item feta11
 842 @tab 11.22
 843 @tab 3.9
 844 @tab Taschenparituren
 845
 846 @item feta13
 847 @tab 12.60
 848 @tab 4.4
 849 @tab
 850
 851 @item feta14
 852 @tab 14.14
 853 @tab 5.0
 854 @tab
 855
 856 @item feta16
 857 @tab 15.87
 858 @tab 5.6
 859 @tab
 860
 861 @item feta18
 862 @tab 17.82
 863 @tab 6.3
 864 @tab Liederbücher
 865
 866 @item feta20
 867 @tab 20
 868 @tab 7.0
 869 @tab Orchesterstimmen
 870
 871 @item feta23
 872 @tab 22.45
 873 @tab 7.9
 874 @tab
 875
 876 @item feta26
 877 @tab 25.2
 878 @tab 8.9
 879 @tab
 880 @c modern rental material?
 881
 882 @end multitable
 883 @end quotation
 884
 885 Diese Schriftarten sind in allen Größen erhältlich.  Die Kontext-Eigenschaft
 886 @code{fontSize} und die Layout-Eigenschaft @code{staff-space} (in
 887 @code{StaffSymbol}) können benutzt werden, um die Schriftgröße für
 888 einzelne Systeme zu verändern.  Die Größe von einzelnen Systemen
 889 ist relativ zur globalen Systemgröße.
 890
 891
 892 @seealso
 893 Notationsreferenz:
 894 @ref{Auswahl der Notations-Schriftgröße}.
 895
 896 Schnipsel:
 897 @rlsr{Spacing}.
 898
 899
 900 @knownissues
 901
 902 @code{layout-set-staff-size} verändert nicht den Abstand zwischen den
 903 Notenlinien.
 904
 905
 906 @node Partiturlayout
 907 @subsection Partiturlayout
 908 @translationof Score layout
 909
 910 @cindex Partitur, Layout
 911 @cindex Layout, Partitur
 912
 913 @funindex \layout
 914
 915 Während die @code{\paper}-Umgebung Einstellungen für die Formatierung
 916 der Seiten eines gesamten Dokuments enthalten, enthält die
 917 @code{\layout}-Umgebung Einstellungen für einzelne Partituren.
 918
 919 @example
 920 \layout @{
 921   indent = 2.0\cm
 922   \context @{ \Staff
 923     \override VerticalAxisGroup #'minimum-Y-extent = #'(-6 . 6)
 924   @}
 925   \context @{ \Voice
 926     \override TextScript #'padding = #1.0
 927     \override Glissando #'thickness = #3
 928   @}
 929 @}
 930 @end example
 931
 932 @seealso
 933 Notationsreferenz:
 934 @ref{Die Standardeinstellungen von Kontexten ändern}.
 935
 936 Schnipsel:
 937 @rlsr{Spacing}.
 938
 939
 940 @node Umbrüche
 941 @section Umbrüche
 942 @translationof Breaks
 943
 944 @menu
 945 * Zeilenumbrüche::
 946 * Seitenumbrüche::
 947 * Optimale Seitenumbrüche::
 948 * Optimale Umbrüche zum Blättern::
 949 * Minimale Seitenumbrüche::
 950 * Ausdrückliche Umbrüche::
 951 * Eine zusätzliche Stimme für Umbrüche benutzen::
 952 @end menu
 953
 954
 955 @node Zeilenumbrüche
 956 @subsection Zeilenumbrüche
 957 @translationof Line breaking
 958
 959 @cindex Zeilenumbrüche
 960 @cindex Umbrüche von Zeilen
 961
 962 Zeilenumbrüche werden normalerweise automatisch erstellt.  Sie
 963 werden so ausgewählt, dass die Zeilen weder gedrängt noch zu
 964 weit gespreizt wirken und aufeinander folgende Seiten einen
 965 ähnlichen Grauwert haben.  In seltenen Fällen kann es jedoch
 966 nötig sein, manuell Zeilenumbrüche einzufügen.  Das geschieht
 967 mit dem Befehl @code{\break}.  Hiermit wird direkt nach dem Befehl
 968 ein Zeilenumbruch erzwungen.  Zeilenumbrüche können jedoch nur
 969 am Ende von @qq{vollständigen} Takten stattfinden.  Damit sind
 970 Takte gemeint, in welchen alle Noten mit der letzten Taktzeit
 971 komplett abgeschlossen sind und nicht über das Taktende hinausragen.
 972 Wenn Sie einen Zeilenumbruch an einer Stelle benötigen, an der
 973 keine Taktlinie vorliegt, können Sie mit @code{\bar ""} eine
 974 unsichtbare Taktlinie hinzufügen, die dann den Zeilenumbruch
 975 erlaubt.  Wiederum gilt, dass keine Noten überstehen dürfen,
 976 sonst wird diese unsichtbare Taktlinie ignoriert.
 977
 978 Mit dem Befehl @code{\noBreak} wird ein Zeilenumbruch an dem
 979 entsprechenden Taktstrich verboten.
 980
 981 Die grundlegenden Einstellungen, die Einfluss auf die Zeilenlänge
 982 haben, sind @code{indent} (Einzug) und @code{line-width}
 983 (Zeilenbreite).  Sie werden in der @code{\layout}-Umgebung
 984 eingestellt.  Der erste Befehl bestimmt den Einzug der ersten
 985 Zeile, der zweite die Zeilenlänge der weiteren Notenzeilen.
 986
 987 Wenn @code{ragged-right} eingestellt ist (als in der
 988 @code{\layout}-Umgebung auf den Wert @code{#t} gesetzt wurde),
 989 werden die Systeme linksbündig gesetzt und nicht bis zum
 990 rechten Rand hin durchgezogen, sondern den Noten entsprechend
 991 gesetzt.  Das ist oftmals nützlich für kleine Notenfragmente
 992 und um zu überprüfen, wie eng die Noten natürlicherweise
 993 gesetzt werden würden.
 994
 995 Die Option @code{ragged-last} verhält sich ähnlich zu @code{ragged-right},
 996 aber wirkt sich nur auf die letzte Zeile eines Stückes aus.
 997
 998 @example
 999 \layout @{
1000 indent = #0
1001 line-width = #150
1002 ragged-last = ##t
1003 @}
1004 @end example
1005
1006 @cindex regelmäßige Zeilenumbrüche
1007 @cindex Zeilenumbrüche in Intervallen
1008
1009 Um Zeilenumbrüche zu erzwingen, die in festgelegten Intervallen
1010 stattfinden, kann der Befehl @code{\break} in Kombination
1011 mit unsichtbaren Noten und einer Wiederholung eingesetzt
1012 werden.  Das folgende Beispiel etwa setzt die nächsten
1013 28 Takte (im 4/4-Takt) in Zeilen zu jeweils 4 Takten:
1014
1015 @example
1016 << \repeat unfold 7 @{
1017          s1 \noBreak s1 \noBreak
1018          s1 \noBreak s1 \break @}
1019    @notation{Hier die Noten}
1020 >>
1021 @end example
1022
1023 Eine Zeilenumbruchkonfiguration kann auch als eine @code{.ly}-Datei
1024 automatisch gespeichert werden.  Damit kann die vertikale Ausrichtung
1025 während eines zweiten Programmdurchlaufs angepasst werden um die
1026 Seiten besser zu füllen.  Diese Eigenschaft ist recht neu und
1027 kompliziert.  Mehr Einzelheiten finden sich in
1028 @rlsr{Spacing}.
1029
1030 @funindex \break
1031 @funindex \noBreak
1032
1033 @predefined
1034 @code{\break},
1035 @code{\noBreak}.
1036 @endpredefined
1037
1038 @seealso
1039 Referenz der Interna:
1040 @rinternals{LineBreakEvent}.
1041
1042 Schnipsel:
1043 @rlsr{Spacing}.
1044
1045 @knownissues
1046
1047 Zeilenumbrüche können nur gesetzt werden, wenn eine
1048 @qq{richtige} Taktlinie vorliegt.  Wenn eine Note
1049 über die Taktlinie übersteht, wie etwa in folgendem
1050 Beispiel:
1051
1052 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
1053 c4 c2 << c2 {s4 \break } >>  % this does nothing
1054 c2 c4 |           % a break here would work
1055 c4 c2 c4 ~ \break % as does this break
1056 c4 c2 c4
1057 @end lilypond
1058
1059 @noindent
1060 kann ein Umbruchbefehl nicht ausgeführt werden.  Dieses
1061 Verhalten kann jedoch vermieden werden, indem der
1062 @code{Forbid_line_break_engraver} aus dem Stimmen-Kontext
1063 entfernt wird.
1064
1065 @lilypond[quote,ragged-right,verbatim]
1066 \new Voice \with {
1067   \remove Forbid_line_break_engraver
1068 } {
1069   c4 c2 << c2 {s4 \break } >>  % now the break is allowed
1070   c2 c4
1071 }
1072 @end lilypond
1073
1074 @noindent
1075 Entsprechend werden Umbrüche auch verhindert, wenn Balken über
1076 Taktlinien reichen.  Das kann mit folgendem Befehl verhindert
1077 werden: @code{\override Beam #'breakable = ##t}.
1078
1079
1080 @node Seitenumbrüche
1081 @subsection Seitenumbrüche
1082 @translationof Page breaking
1083
1084 @cindex Seitenumbrüche
1085 @cindex Umbrüche, Seite
1086
1087 Die Standardseitenumbrüche können verändert werden, indem
1088 man die Befehle @code{\pageBreak} bzw. @code{\noPageBreak}
1089 benutzt.  Sie verhalten sich analog zu den Befehlen
1090 @code{\break} und @code{\noBreak}.  Sie sollten an einem
1091 Taktstrich notiert werden.  Diese Befehle erzwingen bzw.
1092 verbieten einen Seitenumbruch.  Mit dem @code{\pageBreak}-Befehl
1093 wird natürlich gleichzeitig auch ein Zeilenumbruch erzwungen.
1094
1095 Die @code{\pageBreak} und @code{\noPageBreak}-Befehle können
1096 auch auf der höchsten Ebene einer Datei benutzt werden, etwa
1097 zwischen Partituren und Textbeschriftungen.
1098
1099 Es gibt auch vertikale Gegenstücke zu den Variablen
1100 @code{ragged-right} und @code{ragged-last}:
1101 @code{ragged-bottom} und @code{ragged-last-bottom}.  Wenn diese
1102 Variablen auf @code{##t} gesetzt werden, werden im ersten
1103 Fall die Notensysteme auf allen Seiten eng nach oben orientiert
1104 gesetzt werden.  Im zweiten Fall bezieht sich dies nur auf die
1105 letzte Seite.
1106
1107 Zu Einzelheiten siehe @ref{Vertikale Abstände}.
1108
1109 Seitenumbrüche werden von der @code{page-breaking}-Funktion errechnet.
1110 LilyPond kennt drei Algorithmen um Seitenumbrüche zu errechnen:
1111 @code{ly:optimal-breaking}, @code{ly:page-turn-breaking} und
1112 @code{ly:minimal-breaking}.  Der Standard ist @code{ly:optimal-breaking},
1113 aber der Wert kann in der @code{\paper}-Umgebung geändert werden:
1114
1115 @example
1116 \paper@{
1117   #(define page-breaking ly:page-turn-breaking)
1118 @}
1119 @end example
1120
1121 @funindex \bookpart
1122
1123 When a book has many scores and pages, the page breaking problem may be
1124 difficult to solve, requiring large processing time and memory.  To ease
1125 the page breaking process, @code{\bookpart} blocks are used to divide
1126 the book into several parts: the page breaking occurs separately on each
1127 part.  Different page breaking functions may also be used in different
1128 book parts.
1129
1130 @example
1131 \bookpart @{
1132   \header @{
1133     subtitle = "Vorwort"
1134   @}
1135   \paper @{
1136      %% In einem Abschnitt, der vor allem Text hat,
1137      %% funktioniert womöglich ly:minimal-breaking besser
1138      #(define page-breaking ly:minimal-breaking)
1139   @}
1140   \markup @{ @dots{} @}
1141   @dots{}
1142 @}
1143 \bookpart @{
1144   %% In diesem Abschnitt mit Noten wird
1145   %% die Standard-Seitenumbruchsfunktion benutzt.
1146   \header @{
1147     subtitle = "Erster Satz"
1148   @}
1149   \score @{ @dots{} @}
1150   @dots{}
1151 @}
1152 @end example
1153
1154 @funindex \pageBreak
1155 @funindex \noPageBreak
1156
1157 @predefined
1158 @code{\pageBreak},
1159 @code{\noPageBreak}.
1160 @endpredefined
1161
1162 @seealso
1163 Schnipsel:
1164 @rlsr{Spacing}.
1165
1166
1167 @node Optimale Seitenumbrüche
1168 @subsection Optimale Seitenumbrüche
1169 @translationof Optimal page breaking
1170
1171 @funindex ly:optimal-breaking
1172
1173 Die @code{ly:optimal-breaking}-Funktion ist die Standardmethode für
1174 LilyPond, um Seitenumbrüche zu errechnen.  Hiermit wird versucht,
1175 Seitenumbrüche zu finden, die das Stauchen oder Strecken von Zeilen
1176 minimieren, sowohl horizontal als auch vertikal.  Anders als die
1177 @code{ly:page-turn-breaking}-Funktion hat diese Methode keine
1178 Möglichkeit, Überlegungen zum Umblättern mit einzubeziehen.
1179
1180 @seealso
1181 Schnipsel:
1182 @rlsr{Spacing}.
1183
1184
1185 @node Optimale Umbrüche zum Blättern
1186 @subsection Optimale Umbrüche zum Blättern
1187 @translationof Optimal page turning
1188
1189 @funindex ly:page-turn-breaking
1190
1191 Es ist oft nötig, die Seiten so umzubrechen, dass sich eine Pause am
1192 Ende jeder zweiten Seite befindet, damit der Musiker es leichter hat,
1193 die Seite umzublättern ohne das Spielen zu Unterbrechen.  Die
1194 @code{ly:page-turn-breaking}-Funktion versucht, Seitenumbrüche zu
1195 finden, die das Stauchen oder Strecken von Zeilen minimieren und
1196 gleichzeitig auch noch Seitenumbrüchen an angegebenen Stellen
1197 den Vorrang zu geben.
1198
1199 Die Funktion wird in zwei Schritten eingesetzt.  Zunächst muss sie
1200 in der @code{\paper}-Umgebung aktiviert werden, wie gezeigt in
1201 @ref{Seitenumbrüche}.  Dann muss noch angegeben werden, welche Stellen
1202 bevorzugt für Seitenumbrüche benutzt werden sollen.
1203
1204 Für diesen zweiten Schritt gibt es zwei Methoden.  Am Einfachsten ist
1205 es, die möglichen Seitenumbrüche mit dem Befehl @code{\allowPageTurn}
1206 an jeder Stelle manuell anzugeben.
1207
1208 Wenn Ihnen das zu aufwändig ist, können Sie den @code{Page_turn_engraver}
1209 zu einem @code{Staff}- oder @code{Voice}-Kontext hinzufügen.  Dieser
1210 Engraver durchsucht den entsprechenden Kontext nach Stellen ohne Noten.
1211 (Es wird also nicht nach Pausen gesucht, sondern nach Stellen ohne
1212 Noten.  Dieses Verhalten verhindert, dass an polyphonen Stellen umgebrochen
1213 wird, wo nur in einer Stimme Pausen vorhanden sind.)  Wenn eine
1214 derartige Stelle ohne Noten gefunden wird, fügt der Engraver den
1215 Befehl @code{\allowPageTurn} am letzten Taktstrich des Abschnitts ein.  Wenn
1216 in dem Abschnitt ein besonderer Taktstrich vorkommt (wie etwa ein
1217 Doppelstrich), wird der Befehl nach diesem Taktstrich gesetzt.
1218
1219 @funindex minimumPageTurnLength
1220
1221 Der @code{Page_turn_engraver} liest die Kontexteigenschaft
1222 @code{minimumPageTurnLength} um zu erkennen, wie lang eine Stelle
1223 frei von Noten sein muss, damit ein Seitenumbruch in Frage kommt.  Der
1224 Standardwert hierfür ist @code{#(ly:make-moment 1 1)}.  Wenn Sie
1225 Seitenumbrüche zum Umblättern ausschalten wollen, können Sie
1226 einen sehr großen Wert angeben.
1227
1228 @example
1229 \new Staff \with @{ \consists "Page_turn_engraver" @}
1230 @{
1231   a4 b c d |
1232   R1 | % Ein Seitenumbruch zum Umblättern erlaubt
1233   a4 b c d |
1234   \set Staff.minimumPageTurnLength = #(ly:make-moment 5 2)
1235   R1 | % Seitenumbruch nicht erlaubt
1236   a4 b r2 |
1237   R1*2 | % Seitenumbruch erlaubt
1238   a1
1239 @}
1240 @end example
1241
1242 @funindex minimumRepeatLengthForPageTurn
1243
1244 Der @code{Page_turn_engraver} erkennt Wiederholungen vom Typ @code{volta}.
1245 Ein Seitenumbruch zum Umblättern wird nur zugelassen, wenn vor und nach
1246 der Wiederholung genug Zeit ist, um die Seite wieder zurückzublättern.
1247 Wenn die Wiederholung sehr kurz ist, kann auch Umblättern verboten
1248 werden.  Wenn Sie die Kontexteigenschaft
1249 @code{minimumRepeatLengthForPageTurn} definieren, erlaubt der
1250 @code{Page_turn_engraver} nur Umblättern in Wiederholungen, deren
1251 Dauer länger als dieser Wert ist.
1252
1253 Die Seitenumblätter-Befehle @code{\pageTurn}, @code{\noPageTurn} und
1254 @code{\allowPageTurn} können auch auf oberster Dateiebene benutzt
1255 werden, etwa zwischen Partituren und Textabschnitten.
1256
1257 @funindex \pageTurn
1258 @funindex \noPageTurn
1259 @funindex \allowPageTurn
1260
1261 @predefined
1262 @code{\pageTurn},
1263 @code{\noPageTurn},
1264 @code{\allowPageTurn}.
1265 @endpredefined
1266
1267 @seealso
1268 Schnipsel:
1269 @rlsr{Spacing}.
1270
1271 @knownissues
1272
1273 In einer Partitur sollte nur ein @code{Page_turn_engraver} vorkommen.  Wenn
1274 mehr als einer definiert werden, stören sie sich gegenseitig.
1275
1276
1277 @node Minimale Seitenumbrüche
1278 @subsection Minimale Seitenumbrüche
1279 @translationof Minimal page breaking
1280
1281 @funindex ly:minimal-breaking
1282
1283 Die @code{ly:minimal-breaking}-Funktion benötigt nur minimale Berechnungen,
1284 um die Seitenumbrüche zu bestimmen.  Die Seite wird mit möglichst
1285 vielen Systemen gefüllt und dann zur nächsten Seite gewechselt.  Die
1286 Funktion kann benutzt werden um Partituren mit vielen Seiten zu
1287 setzen, wenn die anderen Seitenumbruchsfunktionen zu langsam wären
1288 oder zu viel Speicher beanspruchen.  Auch für Seiten mit viel Text
1289 ist die Funktion geeignet.  Sie wird folgendermaßen aktiviert:
1290
1291 @example
1292 \paper @{
1293   #(define page-breaking ly:minimal-breaking)
1294 @}
1295 @end example
1296
1297
1298 @seealso
1299 Schnipsel:
1300 @rlsr{Spacing}.
1301
1302
1303 @node Ausdrückliche Umbrüche
1304 @subsection Ausdrückliche Umbrüche
1305 @translationof Explicit breaks
1306
1307 Es kann vorkommen, dass LilyPond direkte @code{\break} oder
1308 @code{\pageBreak}-Befehl nicht beachtet.  Mit folgenden
1309 Einstellungen kann dieses Verhalten ausgeschaltet werden:
1310
1311 @example
1312 \override NonMusicalPaperColumn #'line-break-permission = ##f
1313 \override NonMusicalPaperColumn #'page-break-permission = ##f
1314 @end example
1315
1316 Wenn @code{line-break-permission} die Einstellung falsch
1317 (@code{##f}) hat, werden Zeilenumbrüche nur an den Befehlen
1318 @code{\break} eingefügt und nirgendwo anders.  Wenn
1319 @code{page-break-permission} die Einstellung falsch
1320 (@code{##f}) hat, werden Seitenumbrüche nur an den Befehlen
1321 @code{\pageBreak} eingefügt und nirgendwo anders.
1322
1323 @lilypond[quote,verbatim]
1324 \paper {
1325   indent = #0
1326   ragged-right = ##t
1327   ragged-bottom = ##t
1328 }
1329
1330 \score {
1331   \new Score \with {
1332     \override NonMusicalPaperColumn #'line-break-permission = ##f
1333     \override NonMusicalPaperColumn #'page-break-permission = ##f
1334   } {
1335     \new Staff {
1336       \repeat unfold 2 { c'8 c'8 c'8 c'8 } \break
1337       \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
1338       \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
1339       \repeat unfold 8 { c'8 c'8 c'8 c'8 } \pageBreak
1340       \repeat unfold 8 { c'8 c'8 c'8 c'8 } \break
1341       \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
1342       \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
1343       \repeat unfold 2 { c'8 c'8 c'8 c'8 }
1344     }
1345   }
1346 }
1347 @end lilypond
1348
1349 @seealso
1350 Schnipsel:
1351 @rlsr{Spacing}.
1352
1353
1354 @node Eine zusätzliche Stimme für Umbrüche benutzen
1355 @subsection Eine zusätzliche Stimme für Umbrüche benutzen
1356 @translationof Using an extra voice for breaks
1357
1358 Zeilen- und Seitenumbruchbefehle werden normalerweise direkt
1359 zusammen mit den Noten eingegeben.
1360
1361 @example
1362 \new Score @{
1363   \new Staff @{
1364     \repeat unfold 2 @{ c'4 c'4 c'4 c'4 @}
1365     \break
1366     \repeat unfold 3 @{ c'4 c'4 c'4 c'4 @}
1367   @}
1368 @}
1369 @end example
1370
1371 Hierdurch sind zwar die Befehle @code{\break} und @code{\pageBreak}
1372 einfach zu notieren, es werden aber Informationen zur Notation
1373 mit Informationen zur Anordnung auf der Seite vermischt.  Man kann
1374 diese Informationen auch voneinander trennen, indem man eine zusätzliche
1375 Stimme einfügt, in der Zeilen- und Seitenumbrüche vorgenommen werden.
1376 Diese zusätzliche Stimme enthält nur unsichtbare Noten und die
1377 Umbruchbefehle:
1378
1379 @lilypond[quote,verbatim]
1380 \new Score {
1381   \new Staff <<
1382      \new Voice {
1383         s1 * 2 \break
1384         s1 * 3 \break
1385         s1 * 6 \break
1386         s1 * 5 \break
1387      }
1388      \new Voice {
1389         \repeat unfold 2 { c'4 c'4 c'4 c'4 }
1390         \repeat unfold 3 { c'4 c'4 c'4 c'4 }
1391         \repeat unfold 6 { c'4 c'4 c'4 c'4 }
1392         \repeat unfold 5 { c'4 c'4 c'4 c'4 }
1393      }
1394   >>
1395 }
1396 @end lilypond
1397
1398 Mit dieser Herangehensweise kann der Code insbesondere
1399 dann klarer notiert werden, wenn man Einstellungen der
1400 @code{line-break-system-details}-Eigenschaft oder
1401 anderer Eigenschaften von
1402 @code{NonMusicalPaperColumnGrob} vornimmt (hierzu auch
1403 @ref{Vertikale Abstände}).
1404
1405 @lilypond[quote,verbatim]
1406 \new Score {
1407   \new Staff <<
1408      \new Voice {
1409
1410         \overrideProperty "Score.NonMusicalPaperColumn"
1411         #'line-break-system-details #'((Y-offset . 0))
1412         s1 * 2 \break
1413
1414         \overrideProperty "Score.NonMusicalPaperColumn"
1415         #'line-break-system-details #'((Y-offset . 35))
1416         s1 * 3 \break
1417
1418         \overrideProperty "Score.NonMusicalPaperColumn"
1419         #'line-break-system-details #'((Y-offset . 70))
1420         s1 * 6 \break
1421
1422         \overrideProperty "Score.NonMusicalPaperColumn"
1423         #'line-break-system-details #'((Y-offset . 105))
1424         s1 * 5 \break
1425      }
1426      \new Voice {
1427         \repeat unfold 2 { c'4 c'4 c'4 c'4 }
1428         \repeat unfold 3 { c'4 c'4 c'4 c'4 }
1429         \repeat unfold 6 { c'4 c'4 c'4 c'4 }
1430         \repeat unfold 5 { c'4 c'4 c'4 c'4 }
1431      }
1432   >>
1433 }
1434 @end lilypond
1435
1436
1437 @seealso
1438 Notationsreferenz:
1439 @ref{Vertikale Abstände}.
1440
1441 Schnipsel:
1442 @rlsr{Spacing}.
1443
1444
1445 @node Vertikale Abstände
1446 @section Vertikale Abstände
1447 @translationof Vertical spacing
1448
1449 @cindex vertikale Positionierung
1450 @cindex Positionierung, vertikal
1451 @cindex Abstände, vertikal
1452
1453 Vertikale Abstände werden durch drei Eigenschaften
1454 bestimmt:  wieviel Platz frei ist (etwa Papiergröße
1455 und Ränder), wieviel Platz zwischen Systemgruppen
1456 (engl. system) gesetzt werden soll und wieviel
1457 Platz zwischen Notensystemen (engl. staff, Pl. staves)
1458 innerhalb von Gruppen gesetzt wird.
1459
1460 @menu
1461 * Vertikale Abstände innerhalb eines Systems::
1462 * Vertikale Abstände zwischen Systemen::
1463 * Explizite Positionierung von Systemen::
1464 * Vermeidung von vertikalen Zusammenstößen::
1465 @end menu
1466
1467
1468 @node Vertikale Abstände innerhalb eines Systems
1469 @subsection Vertikale Abstände innerhalb eines Systems
1470 @translationof Vertical spacing inside a system
1471
1472 @cindex Abstand zwischen Notensystemen
1473 @cindex Notensystemabstand
1474 @cindex Platz zwischen Notensystemen
1475 @cindex Platz innerhalb von Systemgruppen
1476 @cindex Systemgruppen, Abstände innerhalb
1477
1478 Die Höhe jeder Systemgruppe wird in zwei Schritten bestimmt.  Zunächst
1479 werden alle Systeme anhand des vorhandenen Platzes aufgeteilt.  Dann
1480 werden die nicht-Notensysteme (also Akkorde oder Gesangstext) zwischen
1481 den Systemen verteilt.
1482
1483 @unnumberedsubsubsec Abstand zwischen Notensystemen
1484
1485 Abstand zwischen Notensystemen wird durch die Eigenschaft
1486 @code{staff-staff-spacing} des @code{VerticalAxisGroup}-Grobs kontrolliert.
1487 Diese Eigenschaft ist eine Aliste mit vier Elementen: @var{Abstand},
1488 @var{minimum-distance}, @var{Verschiebung} und @var{Dehnbarkeit}:
1489
1490 @itemize
1491 @item
1492 @var{Abstand} ist die Größe des dehnbaren Platzes zwischen der Mittellinie
1493 eines Notensystems und der Mittellinie des nächsten.
1494
1495 @item
1496 @var{minimum-distance} (Minimal-Abstand) setzt einen Minimalwert für den
1497 Abstand zwischen der Mittellinie eines Notensystems und der Mittellinie des
1498 nächsten fest.  Das heißt, dass auf einer Seite mit vielen Systemen, die gestaucht
1499 werden soll, der Abstand zwischen den Systemen nie geringer sein wird als
1500 der Wert von @var{minimum-distance}.
1501
1502 @item
1503 @var{Verschiebung} ist der freie Platz, der zwischen dem unteren Rand eines
1504 Systems und dem oberen des nächsten frei bleiben muss.  Das unterscheidet sich
1505 von @code{minimum-distance} dadurch, dass die Auswirkung von @var{Verschiebung}
1506 von der Höhe der Objekte im System abhängt.  @var{Verschiebung} wird also
1507 wahrscheinlich eingesetzt, wenn ein Notensystem viele Noten tief unter den
1508 Notenlinien aufweist.
1509
1510 @item
1511 @var{Dehnbarkeit} kontrolliert die Leichtigkeit, mit der dehnbarer Abstand
1512 gedehnt wird, wenn die Systeme gedehnt werden.  Große Werte führen dazu, dass
1513 ein System mehr gedehnt wird, während ein Wert von @code{0} die Abstände vollständig
1514 daran hindert, gedehnt zu werden.  Wenn nicht definiert, hat @var{Dehnbarkeit}
1515 einen Wert von @code{Abstand - minimum-distance}.
1516 @end itemize
1517
1518 @lilypond[verbatim]
1519 #(set-global-staff-size 16)
1520 \new StaffGroup <<
1521   % Since space is small and there is no minimum-distance, the distance
1522   % between this staff and the next will be determined by padding.
1523   \new Staff \with {
1524     \override VerticalAxisGroup #'staff-staff-spacing =
1525       #'((space . 1) (padding . 1))
1526   }
1527   { \clef bass c, }
1528   % Since space is small and nothing sticks out very far, the distance
1529   % between this staff and the next will be determined by minimum-distance.
1530   \new Staff \with {
1531     \override VerticalAxisGroup #'staff-staff-spacing =
1532       #'((space . 1) (minimum-distance . 12))
1533   }
1534   { \clef bass c, }
1535   % By setting padding to a negative value, staves can be made to collide.
1536   \new Staff \with {
1537     \override VerticalAxisGroup #'staff-staff-spacing =
1538       #'((space . 4) (padding . -10))
1539   }
1540   { \clef bass c, }
1541   \new Staff { \clef bass c, }
1542 >>
1543 @end lilypond
1544
1545 In Orchester- und großen Partituren werden Systeme normalerweise gruppiert.
1546 Der Abstand zwischen den Gruppen ist normalerweise größer als der Abstand
1547 zwischen Notensystemen der selben Gruppe.  Der Abstand kann mit dem
1548 @code{StaffGrouper}-Grob beeinflusst werden:  Der Standardwert von
1549 @code{staff-staff-spacing} für @code{VerticalAxisGroup} ist eine
1550 Callback-Funktion, die nach einem @code{StaffGrouper}-Grob sucht, der ein
1551 Notensystem enthält.  Wenn sie einen @code{StaffGrouper}-Grob findet und das
1552 hierin enthaltene System ist in der Mitte einer Gruppe, wird der Wert von
1553 @code{staff-staff-spacing} von @code{StaffGrouper} ausgelesen und
1554 ausgegeben.  Wenn das enthaltene Notensystem das letzte einer Gruppe ist,
1555 wird die @code{staffgroup-staff-spacing}-Eigenschaft von @code{StaffGrouper}
1556 ausgelesen und ausgegeben.  Wenn kein @code{StaffGrouper}-Grob gefunden
1557 wird, wird @var{default-staff-staff-spacing} aus der jeweiligen
1558 @code{VerticalAxisGroup} ausgelesen und ausgegeben.
1559
1560 @lilypond[verbatim]
1561 #(set-global-staff-size 16)
1562 <<
1563   \new PianoStaff \with {
1564     \override StaffGrouper #'staff-staff-spacing #'space = #1
1565     \override StaffGrouper #'staff-staff-spacing #'padding = #0
1566     \override StaffGrouper #'staffgroup-staff-spacing #'space = #20
1567   }
1568   <<
1569     \new Staff c'1
1570     \new Staff c'1
1571   >>
1572
1573   \new StaffGroup \with {
1574     \override StaffGrouper #'staff-staff-spacing #'space = #1
1575     \override StaffGrouper #'staff-staff-spacing #'padding = #0
1576   }
1577   <<
1578     \new Staff c'1
1579     \new Staff c'1
1580   >>
1581 >>
1582 @end lilypond
1583
1584 @unnumberedsubsubsec Abstand von Nicht-Notensystem-Zeilen
1585
1586 Nachdem die Position der Notensysteme bestimmt ist, werden die
1587 Nicht-Notensystem-Zeilen zwischen den Notensystemen ausgerichtet.  Jede
1588 dieser Zeile hat eine @code{staff-affinity}-Eigenschaft, mit der ihre
1589 vertikale Ausrichtung bestimmt wird.  Zum Beispiel erstellt
1590
1591 @example
1592 \new Lyrics \with @{ \override VerticalAxisGroup #'staff-affinity = #DOWN @}
1593 @end example
1594
1595 @noindent
1596 einen Gesangstext-Kontext, der sehr nah an dem sich darunter befindlichen
1597 System liegt.  Wenn @code{staff-affinity} auf einen Wert gesetzt wird, der
1598 keine Zahl ist (wie etwa @code{#f}), wird die Zeile wie ein Notensystem
1599 behandelt.  Wenn andererseits @code{staff-affinity} für ein Notensystem
1600 definiert wird, wird es wie ein Nicht-Notensystem behandelt.
1601
1602 Nicht-Notensystem-Zeilen lassen drei Eigenschaften für ihre Abstandseinstellungen
1603 zu.  Jede dieser Eigenschaften ist eine Aliste des gleichen Formats wie
1604 @code{staff-staff-spacing} oben.
1605
1606 @itemize
1607
1608 @item
1609 Wenn die nächste Zeile in der Richtung von @code{staff-affinity} ein
1610 Notensystem ist, ergibt sich aus dem Wert von
1611 @code{nonstaff-relatedstaff-spacing} der Abstand zwischen dem
1612 Nicht-Notensystem und dem Notensystem.  Wenn @code{staff-affinity}
1613 @code{CENTER} ist, dann wird @code{nonstaff-relatedstaff-spacing} in beide
1614 Richtungen benutzt.
1615
1616 @item
1617 Wenn die nächste Zeile in der Richtung von @code{staff-affinity} ein
1618 Nicht-Notensystem ist, ergibt sich aus dem Wert von
1619 @code{nonstaff-nonstaff-spacing} der Abstand zwischen den beiden
1620 Nicht-Notensystemen.
1621
1622 @item
1623 Wenn die nächste Zeile der der entgegengesetzten Richtung von
1624 @code{staff-affinity} ein Notensystem ist, dann gibt
1625 @code{nonstaff-unrelatedstaff-spacing} den Abstand zwischen dem
1626 Nicht-Notensystem und dem Notensystem.  Das kann benutzt werden, um einen
1627 Minimalabstand zwischen einer Gesangstextzeiel und dem dazugehörigen
1628 Notensystem zu verlangen.
1629
1630 @end itemize
1631
1632 @lilypond[verbatim]
1633 #(set-global-staff-size 16)
1634 \layout {
1635   \context {
1636     \Lyrics
1637     % By default, Lyrics are placed close together.  Here, we allow them to
1638     % be stretched more widely.
1639     \override VerticalAxisGroup
1640       #'nonstaff-nonstaff-spacing #'stretchability = #1000
1641   }
1642 }
1643
1644 \new StaffGroup
1645 <<
1646   \new Staff \with {
1647     \override VerticalAxisGroup #'staff-staff-spacing = #'((space . 30)) }
1648     { c'1 }
1649   \new Lyrics \with {
1650     \override VerticalAxisGroup #'staff-affinity = #UP }
1651     \lyricmode { up }
1652   \new Lyrics \with {
1653     \override VerticalAxisGroup #'staff-affinity = #CENTER }
1654     \lyricmode { center }
1655   \new Lyrics \with {
1656     \override VerticalAxisGroup #'staff-affinity = #DOWN }
1657     \lyricmode { down }
1658   \new Staff
1659     { c'1 }
1660 >>
1661 @end lilypond
1662
1663
1664 @seealso
1665 Schnipsel:
1666 @rlsr{Spacing}.
1667
1668 @c @lsr{spacing,page-spacing.ly},
1669 @c @lsr{spacing,alignment-vertical-spacing.ly}.
1670
1671 Referenz der Interna:
1672 @rinternals{VerticalAxisGroup},
1673 @rinternals{VerticalAlignment},
1674 @rinternals{Axis_group_engraver}.
1675
1676 @knownissues
1677 Aufeinanderfolgende Nicht-Notensystem-Zeilen sollten nicht-ansteigende
1678 @var{staff-affinity}-Werte von oben nach unten.  Das Verhalten von
1679 beispielsweise
1680
1681 @example
1682 <<
1683   \new Staff c
1684   \new Lyrics \with @{ \override VerticalAxisGroup #'staff-affinity = #DOWN @}
1685   \new Lyrics \with @{ \override VerticalAxisGroup #'staff-affinity = #UP @}
1686   \new Staff c
1687 >>
1688 @end example
1689
1690 ist nicht definiert.
1691
1692 Eine Nicht-Notensystem-Zeile unter einem Notensystem sollte
1693 @var{staff-affinity} als @code{UP} definiert haben.  Gleichfalls
1694 sollte eine Nicht-Notensystem-Zeile über einem System
1695 @var{staff-affinity} als @code{DOWN} definiert haben.
1696
1697
1698 @node Vertikale Abstände zwischen Systemen
1699 @subsection Vertikale Abstände zwischen Systemen
1700 @translationof Vertical spacing between systems
1701
1702 Der Mechanismus, der Abstände zwischen zwei Systemgruppen kontrolliert, ist dem
1703 sehr ähnlich, der Abstände innerhalb einer Systemgruppe kontrolliert
1704 (siehe @ref{Abstände innerhalb eines Systems}).  Der Hauptunterschied ist,
1705 dass die Variablen, die Abstände zwischen Systemgruppen definieren, in der
1706 @code{\paper}-Umgebung und nicht als Grob-Eigenschaften definiert werden.
1707 Diese Variablen der @code{\paper}-Umbgebung sind @var{system-system-spacing},
1708 @var{score-system-spacing}, @var{markup-system-spacing},
1709 @var{score-markup-spacing}, @var{markup-markup-spacing},
1710 @var{top-system-spacing}, @var{top-markup-spacing} und
1711 @var{last-bottom-spacing}.  Beachten Sie, dass diese Variablen
1712 Nicht-Notensystem-zeilen ignorieren.  Beispielsweise kontrolliert
1713 @var{system-system-spacing} den Abstand der mittleren Notenlinie des
1714 tiefsten Systems einer Gruppe zur mittleren Notenlinie des höchsten
1715 Notensystems der nächsten Gruppe, egal ob dazwischen Gesangstext gesetzt
1716 ist oder nicht.  Siehe auch @ref{Vertikale Dimensionen} für eine
1717 Beschreibung dieser Variablen.
1718
1719 Es gibt zwei weiter Variablen der @code{\paper}-Umgebung, die die vertikale
1720 Aufteilung beeinflussen: wenn @code{ragged-bottom} wahr (@code{##t}) ist,
1721 dann wird keine Seite gedehnt (was bedeutet, dass weder der Platz zwischen
1722 Systemgruppen noch der Platz innerhalb von Systemgruppen gedehnt wird).  Wenn
1723 @code{ragged-last-bottom} wahr (@code{##t}) ist, dann wird die letzte Seite
1724 nicht gedehnt.
1725
1726 @seealso
1727 Schnipsel:
1728 @rlsr{Spacing}.
1729
1730
1731 @node Explizite Positionierung von Systemen
1732 @subsection Explizite Positionierung von Systemen
1733 @translationof Explicit staff and system positioning
1734
1735 Man kann die Einstellungen des @code{VerticalAxisGroup}-Objekts
1736 und der @code{\paper}-Umgebung, wie sie im vorigen Abschnitt
1737 erklärt wurden, als eine Sammlung verschiedenerer Einstellmöglichkeiten
1738 verstehen, die vor allem die Größe des vertikalen Platzes zwischen
1739 Notensystemen und Gruppen auf der Seite kontrollieren.
1740
1741 Die vertikale Platzverteilung kann aber auch auf andere Weise
1742 eingestellt werden: mit den Optionen von
1743 @code{NonMusicalPaperColumn #'line-break-system-details}.  Während
1744 Einstellungen in @code{VerticalAxisGroup} und @code{\paper} Füllplatz
1745 definieren, werden mit
1746 @code{NonMusicalPaperColumn #'line-break-system-details} absolute vertikale
1747 Positionen auf der Seite festgelegt.
1748
1749 @code{NonMusicalPaperColumn #'line-break-system-details} akzeptiert eine
1750 Liste aus drei unterschiedlichen Einstellungen:
1751
1752 @itemize
1753 @item @code{X-offset}
1754 @item @code{Y-offset}
1755 @item @code{alignment-distances}
1756 @end itemize
1757
1758 Veränderungen von Grobs (wozu auch @code{NonMusicalPaperColumn} gehört),
1759 können an drei unterschiedlichen Stellen in der Quelldatei vorgenommen
1760 werde:
1761
1762 @itemize
1763 @item mitten im Notentext
1764 @item in einer @code{\context}-Umgebung
1765 @item in einer @code{\with}-Umgebung
1766 @end itemize
1767
1768 Wenn der Grob @code{NonMusicalPaperColumn} verändert werden soll,
1769 wird der @code{\override}-Befehl in der @code{\context} oder
1770 @code{\with}-Umgebung eingesetzt.  Wenn die Veränderungen aber
1771 mitten im Notentext stattfinden sollen, müssen Sie den Befehl
1772 @code{\overrideProperty} einsetzen.  Einige Beispiele für eine
1773 Veränderungen von @code{NonMusicalPaperColumn} mit dem
1774 @code{\overrideProperty}-Befehl sind hier aufgelistet:
1775
1776 @example
1777 \overrideProperty NonMusicalPaperColumn
1778   #'line-break-system-details #'((X-offset . 20))
1779
1780 \overrideProperty NonMusicalPaperColumn
1781   #'line-break-system-details #'((Y-offset . 40))
1782
1783 \overrideProperty NonMusicalPaperColumn
1784   #'line-break-system-details #'((X-offset . 20) (Y-offset . 40))
1785
1786 \overrideProperty NonMusicalPaperColumn
1787   #'line-break-system-details #'((alignment-distances . (0 -15)))
1788
1789 \overrideProperty NonMusicalPaperColumn
1790   #'line-break-system-details #'((X-offset . 20) (Y-offset . 40)
1791                                  (alignment-distances . (0 -15)))
1792 @end example
1793
1794 Um zu verstehen, wie jede dieser unterschiedlichen Einstellungen
1795 funktioniert, wollen wir uns ein Beispiel vornehmen, dass überhaupt
1796 keine Einstellungen (d.h. @code{override}-Befehle) enthält:
1797
1798 @c \book { } is required in these examples to ensure the spacing
1799 @c overrides can be seen between systems. -np
1800
1801 @lilypond[quote]
1802 \header { tagline = ##f }
1803 \paper { left-margin = 0\mm }
1804 \book {
1805   \score {
1806     <<
1807       \new Staff <<
1808         \new Voice {
1809           s1*5 \break
1810           s1*5 \break
1811           s1*5 \break
1812         }
1813         \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
1814       >>
1815       \new Staff {
1816         \repeat unfold 15 { d'4 d' d' d' }
1817       }
1818     >>
1819   }
1820 }
1821 @end lilypond
1822
1823 Diese Partitur nimmt Zeilen- und Seitenumbruchinformationen in einer
1824 eigenen Stimme vor.  Mit dieser Methode kann die Layout-Information
1825 einfach von den Noten getrennt werden, was sehr hilfreich ist, wenn
1826 das Beispiel komplizierter wird.  Siehe auch
1827 @ref{Eine zusätzliche Stimme für Umbrüche benutzen}.
1828
1829 Ausdrückliche @code{\break}-Befehle teilen die Noten in sechs Takte
1830 lange Zeilen.  Die vertikale Platzverteilung wird von LilyPond
1831 errechnet.  Um den vertikalen Beginn einer jeden Systemgruppe
1832 genau anzugeben, kann @code{Y-offset} in der
1833 @code{line-break-system-details}-Eigenschaft des
1834 @code{NonMusicalPaperColumn}-Grobs wie in dem Beispiel
1835 ersichtlich benutzt werden:
1836
1837 @lilypond[quote]
1838 \header { tagline = ##f }
1839 \paper { left-margin = 0\mm }
1840 \book {
1841   \score {
1842     <<
1843       \new Staff <<
1844         \new Voice {
1845           \overrideProperty #"Score.NonMusicalPaperColumn"
1846             #'line-break-system-details #'((Y-offset . 0))
1847           s1*5 \break
1848           \overrideProperty #"Score.NonMusicalPaperColumn"
1849             #'line-break-system-details #'((Y-offset . 40))
1850           s1*5 \break
1851           \overrideProperty #"Score.NonMusicalPaperColumn"
1852             #'line-break-system-details #'((Y-offset . 80))
1853           s1*5 \break
1854         }
1855         \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
1856       >>
1857       \new Staff {
1858         \repeat unfold 15 { d'4 d' d' d' }
1859       }
1860     >>
1861   }
1862 }
1863 @end lilypond
1864
1865 In der @code{line-break-system-details}-Eigenschaft kann eine Liste
1866 mit vielen Einstellungen eingegeben werden, aber hier wird nur eine
1867 Einstellung angegeben.  Die @code{Y-offset}-Eigenschaft bestimmt
1868 hier die exakte vertikale Position auf der Seite, an welcher jede
1869 neue Systemgruppe begonnen wird.
1870
1871 Da jetzt der exakte Beginn eines jeden Systems explizit festgelegt wurde,
1872 können wir auch den exakten Beginn eines jeden Notensystems in der
1873 Gruppe festlegen.  Dies geschieht mit der @code{alignment-distances}-Eigenschaft
1874 von @code{line-break-system-details}.
1875
1876 @lilypond[quote]
1877 \header { tagline = ##f }
1878 \paper { left-margin = 0\mm }
1879 \book {
1880   \score {
1881     <<
1882       \new Staff <<
1883         \new Voice {
1884           \overrideProperty #"Score.NonMusicalPaperColumn"
1885             #'line-break-system-details #'((Y-offset . 20)
1886                                            (alignment-distances . (15)))
1887           s1*5 \break
1888           \overrideProperty #"Score.NonMusicalPaperColumn"
1889             #'line-break-system-details #'((Y-offset . 60)
1890                                            (alignment-distances . (15)))
1891           s1*5 \break
1892           \overrideProperty #"Score.NonMusicalPaperColumn"
1893             #'line-break-system-details #'((Y-offset . 100)
1894                                            (alignment-distances . (15)))
1895           s1*5 \break
1896         }
1897         \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
1898       >>
1899       \new Staff {
1900         \repeat unfold 15 { d'4 d' d' d' }
1901       }
1902     >>
1903   }
1904 }
1905 @end lilypond
1906
1907 Dem @code{line-break-system-details}-Attribut des
1908 @code{NonMusicalPaperColumn}-Grobs werden zwei Eigenschaften
1909 zugewiesen.  Auch wenn die Liste (alist) von
1910 @code{line-break-system-details} sehr viel mehr Platzierungsparameter
1911 akzeptiert, müssen hier nu die Parameter @code{Y-offset} und
1912 @code{alignment-distances} gesetzt werden, um den vertikalen Beginn
1913 jedes Systems und jeder Systemgruppe zu kontrollieren.  @code{Y-offset}
1914 bestimmt also die vertikale Position von Systemgruppen und @code{alignment-distances}
1915 die vertikale Position von einzelnen Notensystemen.
1916
1917 @lilypond[quote]
1918 \header { tagline = ##f }
1919 \paper { left-margin = 0\mm }
1920 \book {
1921   \score {
1922     <<
1923       \new Staff <<
1924         \new Voice {
1925           \overrideProperty #"Score.NonMusicalPaperColumn"
1926             #'line-break-system-details #'((Y-offset . 0)
1927                                            (alignment-distances . (30 10)))
1928           s1*5 \break
1929           \overrideProperty #"Score.NonMusicalPaperColumn"
1930             #'line-break-system-details #'((Y-offset . 60)
1931                                            (alignment-distances . (10 10)))
1932           s1*5 \break
1933           \overrideProperty #"Score.NonMusicalPaperColumn"
1934             #'line-break-system-details #'((Y-offset . 100)
1935                                            (alignment-distances . (10 30)))
1936           s1*5 \break
1937         }
1938         \new Voice { \repeat unfold 15 { c'4 c' c' c' } }
1939       >>
1940       \new StaffGroup <<
1941         \new Staff { \repeat unfold 15 { d'4 d' d' d' } }
1942         \new Staff { \repeat unfold 15 { e'4 e' e' e' } }
1943       >>
1944     >>
1945   }
1946 }
1947 @end lilypond
1948
1949 Einige Dinge sollten beachtet werden:
1950
1951 @itemize
1952 @item Wenn @code{alignment-distances} benutzt wird, werden Gesangtextzeilen
1953 nicht als ein System gezählt.
1954
1955 @item Die Einheiten der Zahlen, die für @code{X-offset},
1956 @code{Y-offset} und @code{alignment-distances} benutzt werden, werden als
1957 Vielfaches des Abstandes zwischen zwei Notenlinien gewertet.  Positive
1958 Werte verschieben Systeme und Gesangstext nach oben, negative Werte nach
1959 unten.
1960
1961 @item Weil die Einstellungen von @code{NonMusicalPaperColumn #'line-break-system-details}
1962 es möglich machen, Notensysteme und Gruppen an beliebigen Stellen auf der
1963 Seite zu platzieren, kann man damit auch Ränder überschreiben oder sogar
1964 Notensysteme übereinander platzieren.  Sinnvolle Werte für diese
1965 Parameter werden derartiges Verhalten vermeiden.
1966 @end itemize
1967
1968
1969 @seealso
1970 Schnipsel:
1971 @rlsr{Spacing}.
1972
1973
1974 @node Vermeidung von vertikalen Zusammenstößen
1975 @subsection Vermeidung von vertikalen Zusammenstößen
1976 @translationof Vertical collision avoidance
1977
1978 @cindex Vermeidung von vertikalen Zusammenstößen
1979 @cindex Zusammenstöße, vertikal, vermeiden
1980 @cindex vertikale Zusammenstöße, vermeiden
1981 @cindex Kollisionen, vertikal, vermeiden
1982
1983 @funindex outside-staff-priority
1984 @funindex outside-staff-padding
1985 @funindex outside-staff-horizontal-padding
1986
1987 Intuitiv gibt es in der Notation einige Objekte, die zu dem Notensystem
1988 gehören, und einige andere, die immer außerhalb des Notensystems
1989 positioniert werden sollten.  Zu diesen letzteren gehören etwa
1990 Übungszeichen, Textbeschriftung und Dynamikbezeichnung (die als
1991 Objekte außerhalb des Systems bezeichnet werden können).  LilyPonds
1992 Regeln um diese Objekte zu positionieren lautet: so nah am Notensystem
1993 wie möglich, aber gerade so weit weg, dass sie nicht mit anderen
1994 Objekten zusammenstoßen.
1995
1996 Dabei setzt LilyPond die @code{outside-staff-priority}-Eigenschaft
1997 ein um herauszufinden, ob ein Grob ein Objekt außerhalb des Systems
1998 ist: wenn @code{outside-staff-priority} eine Zahl ist, dann handelt
1999 es sich um ein Objekt außerhalb des Systems.  Zusätzlich teilt
2000 @code{outside-staff-priority} noch mit, in welcher Reihenfolge
2001 die Objekte außerhalb des Systems gesetzt werden sollen.
2002
2003 Zuerst werden alle Objekte gesetzt, die nicht außerhalb des Systems
2004 gehören.  Dann werden die Objekte außerhalb des Systems nach dem Wert
2005 ihrer @code{outside-staff-priority}  (in aufsteigender Anordnung)
2006 sortiert.  Eins nach dem anderen werden diese Objekte schließlich
2007 genommen und so platziert, dass sie nicht mit den Objekten zusammenstoßen,
2008 die bereits platziert worden sind.  Wenn also zwei Objekte außerhalb
2009 des Systems um den gleichen Platz streiten, wird das mit dem
2010 geringeren Wert von @code{outside-staff-priority} näher an das
2011 entsprechende Notensystem gesetzt.
2012
2013 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
2014 c4_"Text"\pp
2015 r2.
2016 \once \override TextScript #'outside-staff-priority = #1
2017 c4_"Text"\pp % this time the text will be closer to the staff
2018 r2.
2019 % by setting outside-staff-priority to a non-number,
2020 % we disable the automatic collision avoidance
2021 \once \override TextScript #'outside-staff-priority = ##f
2022 \once \override DynamicLineSpanner #'outside-staff-priority = ##f
2023 c4_"Text"\pp % now they will collide
2024 @end lilypond
2025
2026 Der Platz, der zwischen einem Objekt außerhalb des Systems und
2027 dem vorhergehenden Objekt eingefügt werden kann (auch als
2028 padding bezeichnet), kann durch @code{outside-staff-padding}
2029 kontrolliert werden.
2030
2031 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
2032 \once \override TextScript #'outside-staff-padding = #0
2033 a'^"This text is placed very close to the note"
2034 \once \override TextScript #'outside-staff-padding = #3
2035 c^"This text is padded away from the previous text"
2036 c^"This text is placed close to the previous text"
2037 @end lilypond
2038
2039 Standardmäßig werden Objekte außerhalb des Systems so gesetzt,
2040 dass sie eine horizontale Überschneidung mit einem der
2041 vorher gesetzten Grobs vermeiden.  Das kann zu Situationen
2042 führen, in denen Objekte sehr dicht nebeneinander gesetzt
2043 werden.  Der vertikale Platz zwischen Notensystemen kann
2044 auch gesetzt werden, sodass Objekte außerhalb des Systems
2045 ineinander greifen. Mit der Eigenschaft
2046 @code{outside-staff-horizontal-padding} können Objekte vertikal
2047 verschoben werden und derartige Situationen kommen nicht
2048 vor.
2049
2050 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
2051 % the markup is too close to the following note
2052 c4^"Text"
2053 c4
2054 c''2
2055 % setting outside-staff-horizontal-padding fixes this
2056 R1
2057 \once \override TextScript #'outside-staff-horizontal-padding = #1
2058 c,,4^"Text"
2059 c4
2060 c''2
2061 @end lilypond
2062
2063 @seealso
2064 Schnipsel:
2065 @rlsr{Spacing}.
2066
2067
2068 @node Horizontale Abstände
2069 @section Horizontale Abstände
2070 @translationof Horizontal spacing
2071
2072 @cindex horizontale Platzierung
2073 @cindex horizontale Anordnung
2074 @cindex Anordnung, horizontal
2075
2076 @menu
2077 * Überblick über horizontale Abstände::
2078 * Eine neuer Bereich mit anderen Abständen::
2079 * Horizontale Abstände verändern::
2080 * Zeilenlänge::
2081 * Proportionale Notation::
2082 @end menu
2083
2084
2085 @node Überblick über horizontale Abstände
2086 @subsection Überblick über horizontale Abstände
2087 @translationof Horizontal spacing overview
2088
2089 Die Setzmaschine interpretiert unterschiedliche Notendauern als
2090 dehnbare Abstände (engl. spring) unterschiedlicher Länge.  Längere
2091 Dauern erhalten mehr Platz, kürzere weniger.  Die kürzeste Dauer
2092 erhält eine feste Breite (die mit @code{shortest-duration-space}
2093 im @code{SpacingSpanner}-Objekt kontrolliert werden kann).  Je
2094 länger die Dauer, umso mehr Platz erhält die Note: wenn ihre
2095 Dauer verdoppelt wird, wird ein bestimmter Platz hinzugefügt
2096 (dessen Breite durch @code{spacing-increment} bestimmt werden
2097 kann).
2098
2099 Das folgende Stück beispielsweise enthält Halbe, Viertel und Achtel.
2100 Die Achtelnote wird gefolgt von einem Notenkopfabstand (NKA).  Die
2101 Viertel wird von 2 NKA gefolgt, die Halbe von 3 NKA usw.
2102
2103 @lilypond[quote,fragment,verbatim,relative=1]
2104 c2 c4. c8 c4. c8 c4. c8 c8
2105 c8 c4 c4 c4
2106 @end lilypond
2107
2108 Normalerweise ist @code{spacing-increment} definiert als 1.2 mal
2109 der Abstand zwischen zwei Notenlinien, was in etwa die Breite eines
2110 Notenkopfes ist.  @code{shortest-duration-space} ist definiert als
2111 2.0, was bedeutet, dass die kürzeste Note 2.4 Notenlinienabstände
2112 2.0 mal der Wert von @code{spacing-increment}) horizontalen
2113 Abstand erhält.  Der Abstand wird von der linken Kante des Symbols
2114 errechnet, so dass die kürzeste Note üblicherweise von 1 NKA
2115 Abstand gefolgt wird.
2116
2117 Wenn diese Herangehensweise konsequent angewandt würde, würde eine
2118 einzige Zweiunddreißigstel eine Partitur, in der vor allem Achtel und
2119 Sechzehntel vorkommen, sehr weit auseinanderdehnen.  Die kürzeste
2120 Note wäre nun keine Sechzehntel mehr, sondern eine Zweiunddreißigstel,
2121 wodurch an jede Note der Wert von 1 NKA hinzugefügt würde.  Um das
2122 zu vermeiden, ist die kürzeste Dauer für die Platzverteilung nicht die
2123 kürzeste Note einer Partitur, sondern die, die am häufigsten vorkommt.
2124
2125 Die Notendauer, die am häufigsten vorkommt, wird auf folgende
2126 Weise bestimmt: in jedem Takt wird die kürzeste Note bestimmt.  Die
2127 häufigste kürzeste Note wird dann als Grundlage für die Platzverteilung
2128 der Noten herangezogen, mit der Bedingung, dass diese kürzeste
2129 Note immer ein Achtel oder kürzer sein soll.  Die kürzeste Dauer
2130 wird ausgegeben, wenn @code{lilypond} mit der Option @code{--verbose}
2131 aufgerufen wird.
2132
2133 Diese Dauern können aber auch angepasst werden.  Wenn Sie die Eigenschaft
2134 @code{common-shortest-duration} in dem @code{SpacingSpanner} setzen,
2135 dann wird hiermit die Grunddauer für die Platzverteilung eingestellt.
2136 Die maximale Dauer für diesen Grundwert (normalerweise eine Achtel)
2137 wird definiert mit @code{base-shortest-duration}.
2138
2139 @funindex common-shortest-duration
2140 @funindex base-shortest-duration
2141 @funindex stem-spacing-correction
2142 @funindex spacing
2143
2144 Noten, die noch kürzer sind als die häufigste kürzeste Note, werden
2145 durch einen Platz voneinander getrennt, der proportional zu ihrer
2146 Dauer in Beziehung zur häufigsten kürzesten Note ist.  Wenn also
2147 nur ein paar Sechzehntel zu dem obigen Beispiel hinzugefügt werden,
2148 würden sie von 1/2 NKA gefolgt werden:
2149
2150 @lilypond[quote,fragment,verbatim,relative=2]
2151 c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
2152 @end lilypond
2153
2154 In dem @emph{Aufsatz zum automatisierten Notensatz} wurde erklärt, dass die
2155 Richtung der Notenhälse die Platzverteilung beeinflusst (siehe
2156 @ressay{Optischer Ausgleich}).  Das wird
2157 kontrolliert durch die @code{stem-spacing-correction}-Eigenschaft
2158 in dem @code{NoteSpacing}-Objekt.  Dieses Objekt wird für jeden
2159 @code{Voice}-Kontext erstellt.  Das @code{StaffSpacing}-Objekt (in
2160 einem @code{Staff}-Kontext erstellt) enthält die gleiche Eigenschaft,
2161 um die Verteilung von Hälsen neben Taktlinien zu kontrollieren.  In
2162 dem folgenden Beispiel werden diese Einstellungen gezeigt, einmal
2163 mit den Standardwerten und dann mit größeren Werten, damit man sie
2164 besser sieht:
2165
2166 @lilypond[quote,ragged-right]
2167 {
2168   c'4 e''4 e'4 b'4 |
2169   b'4 e''4 b'4 e''4|
2170   \override Staff.NoteSpacing #'stem-spacing-correction = #1.5
2171   \override Staff.StaffSpacing #'stem-spacing-correction = #1.5
2172   c'4 e''4 e'4 b'4 |
2173   b'4 e''4 b'4 e''4|
2174 }
2175 @end lilypond
2176
2177 Proportionale Notation ist unterstützt, siehe @ref{Proportionale Notation}.
2178
2179 @seealso
2180 Schnipsel:
2181 @rlsr{Spacing}.
2182
2183 Referenz der Interna:
2184 @rinternals{SpacingSpanner},
2185 @rinternals{NoteSpacing},
2186 @rinternals{StaffSpacing},
2187 @rinternals{NonMusicalPaperColumn}.
2188
2189 @knownissues
2190
2191 Es gibt keine sinnvolle Möglichkeit, die horizontale Verteilung der
2192 Noten zu unterdrücken.  Die folgende Problemumgehung, mit der
2193 dehnbare Abstände (padding) eingesetzt werden, kann benutzt
2194 werden, um zusätzlichen Platz in eine Partitur einzufügen.
2195
2196 @example
2197  \once \override Score.SeparationItem #'padding = #10
2198 @end example
2199
2200 Es gibt derzeit keine Möglichkeit, den Platz zu verringern.
2201
2202
2203 @node Eine neuer Bereich mit anderen Abständen
2204 @subsection Eine neuer Bereich mit anderen Abständen
2205 @translationof New spacing area
2206
2207 @cindex horizontale Notenabstände, Abschnitte definierten
2208 @cindex Notenabstände, Abschnitte definieren
2209 @cindex Abschnitte definieren, Notenabstände
2210
2211 Neue Abschnitte mit unterschiedlichen Notenabstandsparametern
2212 können mit dem Befehl @code{newSpacingSection} begonnen werden.
2213 Das ist hilfreich, wenn in verschiedenen Abschnitten die
2214 Verhältnisse von kurzen und langen Noten sehr unterschiedlich
2215 ausfallen.
2216
2217 Im folgenden Beispiel wird durch die neue Taktart ein neuer
2218 Abschnitt begonnen, in dem die Sechzehntel weiter außeinander
2219 gesetzt werden sollen.
2220
2221 @lilypond[relative,fragment,verbatim,quote]
2222 \time 2/4
2223 c4 c8 c
2224 c8 c c4 c16[ c c8] c4
2225 \newSpacingSection
2226 \time 4/16
2227 c16[ c c8]
2228 @end lilypond
2229
2230 Der @code{\newSpacingSection}-Befehl erstellt ein neues
2231 @code{SpacingSpanner}-Objekt, weshalb auch neue Anpassungen
2232 mit dem @code{\override}-Befehl an dieser Stelle eingesetzt
2233 werden können.
2234
2235 @seealso
2236 Schnipsel:
2237 @rlsr{Spacing}.
2238
2239 Referenz der Interna:
2240 @rinternals{SpacingSpanner}.
2241
2242
2243 @node Horizontale Abstände verändern
2244 @subsection Horizontale Abstände verändern
2245 @translationof Changing horizontal spacing
2246
2247 @cindex Notenabstände, horizontal
2248 @cindex horizontale Abstände
2249 @cindex horizontale Notenabstände
2250
2251 Die horizontalen Abstände können mit der
2252 @code{base-shortest-duration}-Eigenschaft
2253 verändert werden.  In den folgenden Beispielen
2254 werden die gleichen Noten eingesetzt, zuerst
2255 ohne die Eigenschaft zu verändern, im zweiten
2256 Beispiel dann mit einem anderen Wert.  Größere
2257 Werte für @code{ly:make-moment} ergeben dichtere
2258 Noten.  @code{ly:make-moment} erstellt eine Dauer,
2259 die als Bruch notiert wird, sodass @code{1 4}
2260 eine größere Dauer ist als @code{1 16}.
2261
2262 @lilypond[verbatim,line-width=12\cm]
2263 \score {
2264   \relative c'' {
2265     g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
2266     g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2267     d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
2268     g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2269   }
2270 }
2271 @end lilypond
2272
2273 @lilypond[verbatim,line-width=12\cm]
2274 \score {
2275   \relative c'' {
2276     g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
2277     g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2278     d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
2279     g4 e e2 | f4 d d2 | c4 e g g | c,1 |
2280   }
2281   \layout {
2282     \context {
2283       \Score
2284       \override SpacingSpanner
2285                 #'base-shortest-duration = #(ly:make-moment 1 16)
2286     }
2287   }
2288 }
2289 @end lilypond
2290
2291
2292 @snippets
2293
2294 Standardmäßig wird die Platzverteilung in Triolen und andern
2295 rhythmischen Aufteilungen nach verschiedenen nicht von der
2296 Dauer abgeleiteten Faktoren (wie Versetzungszeichen,
2297 Schlüsselwechseln usw.) berechnet.  Um diese Symbole zu
2298 ignorieren und eine gleichmäßige Verteilung der Noten
2299 zu erzwingen, kann die gleichmäßige Dehnung (engl.
2300 uniform stretching) zu Beginn einer Partitur eingeschaltet
2301 werden:
2302
2303 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
2304 \new Score \with {
2305   \override SpacingSpanner #'uniform-stretching = ##t
2306 } <<
2307   \new Staff{
2308     \times 4/5 {
2309       c8 c8 c8 c8 c8
2310     }
2311     c8 c8 c8 c8
2312   }
2313   \new Staff{
2314     c8 c8 c8 c8
2315     \times 4/5 {
2316       c8 c8 c8 c8 c8
2317     }
2318   }
2319 >>
2320 @end lilypond
2321
2322 Wenn @code{strict-note-spacing} eingestellt ist, werden Noten
2323 gesetzt, ohne dass Schlüssel, Taktlinie oder Verzierungsnoten
2324 zusätzlichen Platz erhalten.
2325
2326 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
2327 \override Score.SpacingSpanner #'strict-note-spacing = ##t
2328 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c]  c32[ c32] }
2329 @end lilypond
2330
2331
2332 @seealso
2333 Schnipsel:
2334 @rlsr{Spacing}.
2335
2336
2337 @node Zeilenlänge
2338 @subsection Zeilenlänge
2339 @translationof Line length
2340
2341 @cindex Seitenumbrüche
2342 @cindex Umbrechen von Seiten
2343 @cindex Zeilenlänge
2344 @cindex Länge von Zeilen
2345
2346 @funindex indent
2347 @funindex line-width
2348 @funindex ragged-right
2349 @funindex ragged-last
2350
2351 @c Although line-width can be set in \layout, it should be set in paper
2352 @c block, to get page layout right.
2353 @c Setting indent in \paper block makes not much sense, but it works.
2354
2355 @c Bit verbose and vague, use examples?
2356 Die grundlegenden Einstellungen, die Einfluss auf die Zeilenlänge
2357 haben, sind @code{indent} (Einzug) und @code{line-width}
2358 (Zeilenbreite).  Sie werden in der @code{\layout}-Umgebung
2359 eingestellt.  Der erste Befehl bestimmt den Einzug der ersten
2360 Zeile, der zweite die Zeilenlänge der weiteren Notenzeilen.
2361
2362 Wenn @code{ragged-right} eingestellt ist (als in der
2363 @code{\layout}-Umgebung auf den Wert @code{#t} gesetzt wurde),
2364 werden die Systeme linksbündig gesetzt und nicht bis zum
2365 rechten Rand hin durchgezogen, sondern den Noten entsprechend
2366 gesetzt.  Das ist oftmals nützlich für kleine Notenfragmente
2367 und um zu überprüfen, wie eng die Noten natürlicherweise
2368 gesetzt werden würden.   Die normale Einstellung ist unwahr
2369 (@code{#f}, aber wenn eine Partitur nur aus einer Zeile besteht,
2370 ist der Standardwert wahr.
2371
2372 Die Option @code{ragged-last} verhält sich ähnlich zu @code{ragged-right},
2373 aber wirkt sich nur auf die letzte Zeile eines Stückes aus.
2374 Für diese letzte Zeile gibt es keine Einschränkungen.  Das
2375 Resultat erinnert an Textabsätze im Blocksatz, wo die letzte
2376 Zeile des Absatzes mit ihrer natürlichen Länge gesetzt wird.
2377
2378 @example
2379 \layout @{
2380 indent = #0
2381 line-width = #150
2382 ragged-last = ##t
2383 @}
2384 @end example
2385
2386 @seealso
2387 Schnipsel:
2388 @rlsr{Spacing}.
2389
2390
2391 @node Proportionale Notation
2392 @subsection Proportionale Notation
2393 @translationof Proportional notation
2394
2395 LilyPond hat Unterstützung für proportionale Notation.  Dabei handelt
2396 es sich um eine horizontale Platzverteilung, die jeder Note einen
2397 exakt ihrer Dauer entsprechenden Platz zuordnet.  Man kann es vergleichen
2398 mit der Notenplatzierung auf einem Raster.  In einigen Partituren
2399 des späten 20. und frühen 21. Jahrhunderts wird dies proportionale
2400 Notation benutzt, um sehr komplizierte rhythmische Verhältnisse
2401 klarer darzustellen, oder um einen Zeitstrahl oder ähnliche Graphiken
2402 direkt in die Partitur zu integrieren.
2403
2404 LilyPond hat Unterstützung für fünf verschiedene Einstellungen der
2405 proportionalen Notation, die alle zusammen oder jede für sich
2406 benutzt werden können:
2407
2408 @itemize
2409 @item @code{proportionalNotationDuration} (proportionale Notendauer)
2410 @item @code{uniform-stretching} (gleichmäßige Dehnung)
2411 @item @code{strict-note-spacing} (strenge Notenverteilung)
2412 @item @code{\remove Separating_line_group_engraver} (entferne Liniengruppentrennungsengraver)
2413 @item @code{\override PaperColumn #'used = ##t} (PapierSpalte benutzt = wahr)
2414 @end itemize
2415
2416 In den Beispielen unten werden diese fünf unterschiedlichen Einstellungen
2417 für die proportionale Notation vorgestellt und ihre Wirkungen
2418 untereinander illustriert.
2419
2420 Es soll mit diesem 1 Takt langen Beispiel begonnen werden, in welchem
2421 die klassischen Abstände und Flattersatz (ragged-right) eingesetzt werden:
2422
2423 @lilypond[quote,verbatim,ragged-right]
2424 \new Score <<
2425   \new RhythmicStaff {
2426     c'2
2427     c'16 c'16 c'16 c'16
2428     \times 4/5 {
2429       c'16 c'16 c'16 c'16 c'16
2430     }
2431   }
2432 >>
2433 @end lilypond
2434
2435 Die Halbe, mit der der Takt beginnt, braucht weitaus weniger
2436 Platz als die Hälfte des Taktes.  Gleichermaßen haben die
2437 Sechzehntel und die Sechzehntel-Quintolen (oder Zwanzigstel),
2438 mit denen der Takt endet, insgesamt weitaus mehr als die Hälfte
2439 der Taktbreite.
2440
2441 Im klassischen Notensatz kann dieses Verhalten genau das gewünschte
2442 Ergebnis bringen, weil dadurch horizontaler Platz von der Halben
2443 weggenommen werden kann und so insgesamt Platz in dem Takt eingespart
2444 wird.
2445
2446 Wenn allerdings ein Zeitstrahl oder andere zeitliche ablaufende
2447 Graphiken über oder unter dem Takt eingefügt werden soll, braucht man
2448 eine Notenplatzierung, die exakt der von ihnen eingenommenen Dauer
2449 entspricht.  Auf folgende Art wird die proportionale Notation
2450 eingeschaltet:
2451
2452 @lilypond[quote,verbatim,ragged-right]
2453 \new Score \with {
2454   proportionalNotationDuration = #(ly:make-moment 1 20)
2455 } <<
2456   \new RhythmicStaff {
2457     c'2
2458     c'16 c'16 c'16 c'16
2459     \times 4/5 {
2460       c'16 c'16 c'16 c'16 c'16
2461     }
2462   }
2463 >>
2464 @end lilypond
2465
2466 Die Halbe zu Beginn des Taktes und die schnelleren Noten in der zweiten
2467 Takthälfte nehmen jetzt genau den gleichen horizontalen Platz ein.  Jetzt
2468 könnte man einen Zeitstrahl mit dem Takt synchronisieren.
2469
2470 Die Einstellung von @code{proportionalNotationDuration} gehört zum
2471 @code{Score}-Kontext.  Kontexteinstellungen können an drei verschiedenen
2472 Stellen in der Quelldatei geschrieben werden: in einer @code{\with}-Umgebung,
2473 in einer @code{\context}-Umgebung oder direkt in den Noten mit dem
2474 @code{\set}-Befehl.  Alle drei Positionen sind gleichwertig und es hängt
2475 vom Benutzer ab, welche bevorzugt wird.
2476
2477 Die Eigenschaft @code{proportionalNotationDuration} braucht ein Argument,
2478 welches die Referenzdauer ist, anhand welcher alle Noten platziert werden.
2479 Hier wird die LilyPond Scheme-Funktion @code{make-moment} eingesetzt.  Sie
2480 braucht zwei Argumente: einen Zähler und einen Nenner, die einen Bruch einer
2481 Ganzen darstellen.  Die Funktion @code{#(ly:make-moment 1 20)} ergibt also
2482 eine Referenzdauer von einer Zwanzigstel.  Genauso gut können etwa die Dauern
2483 @code{#(ly:make-moment 1 16)}, @code{#(ly:make-moment 1 8)} oder
2484 @code{#(ly:make-moment 3 97)} eingesetzt werden.
2485
2486 Die richtige Referenzdauer, mit der eine vernünftige Verteilung der Noten
2487 proportional möglich ist, muss durch Ausprobieren herausgefunden werden.
2488 Dabei sollte man mit einer Dauer beginnen, die der kleinsten Note des
2489 Stückes nahekommt.  Kleine Referenzdauern lassen die Noten sehr gedehnt
2490 erscheinen, größere Referenzdauern zwingen sie dichter zusammen.
2491
2492 @lilypond[quote,verbatim,ragged-right]
2493 \new Score \with {
2494   proportionalNotationDuration = #(ly:make-moment 1 8)
2495 } <<
2496   \new RhythmicStaff {
2497     c'2
2498     c'16 c'16 c'16 c'16
2499     \times 4/5 {
2500       c'16 c'16 c'16 c'16 c'16
2501     }
2502   }
2503 >>
2504
2505 \new Score \with {
2506   proportionalNotationDuration = #(ly:make-moment 1 16)
2507 } <<
2508   \new RhythmicStaff {
2509     c'2
2510     c'16 c'16 c'16 c'16
2511     \times 4/5 {
2512       c'16 c'16 c'16 c'16 c'16
2513     }
2514   }
2515 >>
2516
2517 \new Score \with {
2518   proportionalNotationDuration = #(ly:make-moment 1 32)
2519 } <<
2520   \new RhythmicStaff {
2521     c'2
2522     c'16 c'16 c'16 c'16
2523     \times 4/5 {
2524       c'16 c'16 c'16 c'16 c'16
2525     }
2526   }
2527 >>
2528 @end lilypond
2529
2530 Man muss beachten, dass die Referenzdauer nicht zu groß ist
2531 (wie die Achtel in dem Beispiel oben), denn dadurch werden
2532 die Noten so dicht gesetzt, dass sich eventuell sogar Notenköpfe
2533 von sehr kleinen Notenwerten überschneiden können.  Die proportionale
2534 Notation nimmt üblicherweise mehr Platz ein als die klassische
2535 Platzverteilung.  Der rhythmischen Klarheit muss ein eng gesetztes
2536 Notenbild geopfert werden.
2537
2538 In Folgenden soll betrachtet werden, wie sich überlappende
2539 rhythmische Aufteilungen am besten positioniert werden.  Als Referenz
2540 wird das erste Beispiel herangezogen, zu welchem ein zweites
2541 System mit anderen rhythmischen Werten hinzugefügt wird:
2542
2543 @lilypond[quote,verbatim,ragged-right]
2544 \new Score <<
2545   \new RhythmicStaff {
2546     c'2
2547     c'16 c'16 c'16 c'16
2548     \times 4/5 {
2549       c'16 c'16 c'16 c'16 c'16
2550     }
2551   }
2552   \new RhythmicStaff {
2553     \times 8/9 {
2554       c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
2555     }
2556   }
2557 >>
2558 @end lilypond
2559
2560 Die Platzaufteilung ist schlecht, weil die gleichlangen Noten des
2561 untersten Systems nicht gleichmäßig verteilt sind.  Im klassischen
2562 Notensatz kommen komplexe rhythmische Verhältnisse wie dieses sehr
2563 selten vor, sodass der Notensatz nicht in Hinsicht auf sie optimiert
2564 ist.  @code{proportionalNotationDuration} hilft in
2565 dieser Situation deutlich:
2566
2567 @lilypond[quote,verbatim,ragged-right]
2568 \new Score \with {
2569   proportionalNotationDuration = #(ly:make-moment 1 20)
2570 } <<
2571   \new RhythmicStaff {
2572     c'2
2573     c'16 c'16 c'16 c'16
2574     \times 4/5 {
2575       c'16 c'16 c'16 c'16 c'16
2576     }
2577   }
2578   \new RhythmicStaff {
2579     \times 8/9 {
2580       c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
2581     }
2582   }
2583 >>
2584 @end lilypond
2585
2586 Aber bei sehr genauer Betrachtung sind die Noten der zweiten Hälfte
2587 der Nonole doch immer noch eine Spur weiter gesetzt als die Noten
2588 der ersten Hälfte.  Um wirklich gleichmäßige Abstände zu erzwingen,
2589 sollte auch noch die gleichmäßige Dehnung angeschaltet werden:
2590
2591 @lilypond[quote,verbatim,ragged-right]
2592 \new Score \with {
2593   proportionalNotationDuration = #(ly:make-moment 1 20)
2594   \override SpacingSpanner #'uniform-stretching = ##t
2595 } <<
2596   \new RhythmicStaff {
2597     c'2
2598     c'16 c'16 c'16 c'16
2599     \times 4/5 {
2600       c'16 c'16 c'16 c'16 c'16
2601     }
2602   }
2603   \new RhythmicStaff {
2604     \times 8/9 {
2605       c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
2606     }
2607   }
2608 >>
2609 @end lilypond
2610
2611 Das Beispiel mit den zwei Systemen ist nun exakt nach den
2612 rhythmischen Werten der Noten gesetzt, sodass ein Zeitstrahl
2613 oder ähnliches eingefügt werden könnte.
2614
2615 Alle Einstellungen zur proportionalen Notation erwarten,
2616 dass die @code{uniform-stretching}-Eigenschaft des
2617 @code{SpacingSpanner}-Objekts auf wahr gesetzt wird.  Andernfalls
2618 kann es vorkommen, dass bestimmte Abstände (etwa von
2619 unsichtbaren Noten) nicht richtig gesetzt werden.
2620
2621 Das @code{SpacingSpanner}-Objekt ist ein abstraktes Grob, dass sich im
2622 @code{Score}-Kontext befindet.  Genauso wie die Einstellungen
2623 von @code{proportionalNotationDuration} können auch diese
2624 Veränderungen an den drei Stellen in der Quelldatei vorkommen:
2625 in der @code{\with}-Umgebung innerhalb von @code{Score}, in
2626 einer @code{\context}-Umgebung oder direkt im Notentext.
2627
2628 Standardmäßig gibt es nur ein @code{SpacingSpanner} pro @code{Score}.
2629 Das heißt, dass @code{uniform-stretching} für die gesamte Partitur
2630 (d.h. für die Reichweite von @code{Score}) entweder an- oder
2631 ausgeschaltet ist.  Man kann allerdings in einer Partitur unterschiedliche
2632 Abschnitte mit verschiedenem Platzierungsverhalten definieren.
2633 Hierzu ist der Befehl @code{\newSpacingSection} da.  Siehe auch @ref{Eine neuer Bereich mit anderen Abständen}.
2634
2635 Im Folgenden soll gezeigt werden, wie sich der @code{Separating_line_group_engraver}
2636 auswirkt und warum er normalerweise für proportionale Notation ausgeschaltet wird.
2637 In diesem Beispiel wird verdeutlicht, dass vor jeder ersten Note eines Notensystems
2638 immer etwas zusätzlicher Platz gesetzt wird:
2639
2640 @lilypond[quote,verbatim,ragged-right]
2641 \paper {
2642   indent = #0
2643 }
2644
2645 \new Staff {
2646   c'1
2647   \break
2648   c'1
2649 }
2650 @end lilypond
2651
2652 Der gleiche horizontale Platz wird vor eine Noten gesetzt, wenn sie
2653 einer Taktart, einem Schlüssel oder einer Tonartbezeichnung folgt.
2654 Dieser Platz wird durch @code{Separating_line_group_engraver}
2655 eingefügt; wenn wir ihn aus der Partitur entfernen, entfällt
2656 auch dieser zusätzliche Platz:
2657
2658 @lilypond[quote,verbatim,ragged-right]
2659 \paper {
2660   indent = #0
2661 }
2662
2663 \new Staff \with {
2664   \remove Separating_line_group_engraver
2665 } {
2666   c'1
2667   \break
2668   c'1
2669 }
2670 @end lilypond
2671
2672 Nichtmusikalische Elemente wie Takt- und Tonartangaben, Schlüssel und
2673 Versetzungszeichen sind problematisch in proportionaler
2674 Notation.  Keine dieser Elemente hat eine rhythmische Dauer, aber
2675 alle brauchen horizontalen Platz.  Das Problem wird auf unterschiedliche
2676 Weise gelöst.
2677
2678 Es ist manchmal möglich, Probleme mit Tonarten zu lösen, indem keine
2679 benutzt werden.  Das ist durchaus eine ernstzunehmende Option, weil
2680 die meisten Partituren mit proportionaler Notation für heutige
2681 Musik geschrieben werden.  Ähnliches gilt für Taktarten, insbesondere,
2682 wenn ein Zeitstrahl in die Partitur eingearbeitet werden soll.
2683 In den meisten Partituren kommt jedoch irgendeine Taktart vor.
2684 Schlüssel und Versetzungszeichen sind noch wichtiger; auf
2685 sie kann selten verzichtet werden.
2686
2687 Eine Lösungsmöglichkeit ist es, die @code{strict-note-spacing}-Eigenschaft
2688 des @code{SpacingSpanner}-Objekts zu benutzen.  Zum Vergleich
2689 die beiden Partituren unten:
2690
2691 @lilypond[quote,verbatim,ragged-right]
2692 \new Staff {
2693   \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
2694   c''8
2695   c''8
2696   c''8
2697   \clef alto
2698   d'8
2699   d'2
2700 }
2701
2702 \new Staff {
2703   \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
2704   \override Score.SpacingSpanner #'strict-note-spacing = ##t
2705   c''8
2706   c''8
2707   c''8
2708   \clef alto
2709   d'8
2710   d'2
2711 }
2712 @end lilypond
2713
2714 Bei beiden handelt es sich um proportionale Notation, aber
2715 die Platzverteilung im oberen Beispiel ist zu weit wegen
2716 des Schlüsselwechsels.  Die Platzverteilung des zweiten
2717 Beispiels dagegen bleibt rhythmisch korrekt.
2718 @code{strict-note-spacing} bewirkt, dass Takt- und
2719 Tonartbezeichnungen, Schlüssel und Versetzungszeichen
2720 keine Rolle bei der Berechnung der Abstände spielen.
2721
2722 Zusätzlich zu den hier vorgestellten Einstellungen gibt es
2723 noch eine Reihe von Möglichkeiten, die oft in proportionaler
2724 Notation benutzt werden.  Dazu gehören:
2725
2726 @itemize
2727 @item @code{\override SpacingSpanner #'strict-grace-spacing = ##t}
2728 @item @code{tupletFullLength = ##t}
2729 @item @code{\override Beam #'breakable = ##t}
2730 @item @code{\override Glissando #'breakable = ##t}
2731 @item @code{\override TextSpanner #'breakable = ##t}
2732 @item @code{\remove Forbid_line_break_engraver in the Voice context}
2733 @end itemize
2734
2735 Diese Einstellungen bewirken, dass auch Verzierungsnoten proportional
2736 gesetzt werden, dass Klammern von rhythmischen Gruppen bis zu den
2737 Anfangs- und Endpunkten ausgedehnt werden und lassen dehnbare
2738 Objekte wie Balken und Glissandi auch über Taktstriche hinweg zu.
2739
2740 @seealso
2741 Notationsreferenz:
2742 @ref{Eine neuer Bereich mit anderen Abständen}.
2743
2744 Schnipsel:
2745 @rlsr{Spacing}.
2746
2747
2748 @node Die Musik auf weniger Seiten zwingen
2749 @section Die Musik auf weniger Seiten zwingen
2750 @translationof Fitting music onto fewer pages
2751
2752 Manchmal kommt es vor, dass nur ein oder zwei Systeme auf die
2753 nächste Seite geraten, obwohl es so aussieht, als ob auf der
2754 vorigen Seite genügend Platz ist, um diese Systeme auch noch
2755 unterzubringen.
2756
2757 Wenn man derartige Platzierungsprobleme untersucht, ist die
2758 Funktion @code{annotate-spacing} von sehr großer Hilfe.  Hiermit
2759 wird in den Musiksatz zusätzlich Information darüber ausgegeben,
2760 wieviel Platz bestimmten Parametern zugewiesen wird.  Genaueres
2761 hierzu in @ref{Abstände anzeigen lassen}.
2762
2763 @menu
2764 * Abstände anzeigen lassen::
2765 * Abstände verändern::
2766 @end menu
2767
2768
2769 @node Abstände anzeigen lassen
2770 @subsection Abstände anzeigen lassen
2771 @translationof Displaying spacing
2772
2773 @cindex Platzierung, Layouteinstellungen
2774
2775 @funindex annotate-spacing
2776
2777 Die Dimensionen von vertikalen und horizontalen Platzierungsvariablen,
2778 die veränderbar sind, lassen sich mit ihren aktuellen Werten im
2779 Notentext anzeigen, wenn man die Funktion
2780 @code{annotate-spacing} in der @code{\paper}-Umgebung einschaltet:
2781
2782 @c need to have \book{} otherwise we get the separate systems. -hwn
2783 @lilypond[verbatim,quote]
2784 #(set-default-paper-size "a6" 'landscape)
2785 \book {
2786   \score { { c4 } }
2787   \paper { annotate-spacing = ##t }
2788 }
2789 @end lilypond
2790
2791 @noindent
2792 Alle Layoutdimensionen werden in Notenlinienzwischenräumen
2793 aufgelistet, unabhängig von den Einheiten, mit denen sie in der
2794 @code{\paper}- oder @code{\layout}-Umgebung definiert worden
2795 sind.  In dem letzten Beispiel hat @code{paper-height} einen Wert von
2796 59.75 Notenlinienzwischenräumen und @code{staff-size}
2797 Systemhöhe) ist 20 Punkte.  Dabei gilt:
2798
2799 @multitable {1 Notenlinienzwischenraum} {Systemgröße)/4 * (25.4/72.27) mm}
2800
2801 @item 1 Punkt
2802 @tab = (25.4/72.27) mm
2803
2804 @item 1 Notenlinienzwischenraum
2805 @tab = (@code{staff-size})/4 pts
2806 @item
2807 @tab = (@code{staff-size})/4 * (25.4/72.27) mm
2808
2809 @end multitable
2810
2811 In diesem Fall ist ein @code{staff-space} (Notenlinienzwischenraum)
2812 etwa gleich 1.757 mm.  Deshalb entspricht der Wert von 95.75
2813 @code{staff-space} für @code{paper-height} (Papierhöhe) 105 mm,
2814 die Höhe eines quer gelegten A6-Papiers.  Die Paare (@var{a},@var{b}) sind
2815 Intervalle, wobei @var{a} der untere Rand und @var{b} der
2816 obere Rand des Intervalls.
2817
2818 @seealso
2819
2820 Notationsreferenz:
2821 @ref{Die Notensystemgröße einstellen}
2822
2823 Schnipsel:
2824 @rlsr{Spacing}.
2825
2826
2827 @node Abstände verändern
2828 @subsection Abstände verändern
2829 @translationof Changing spacing
2830
2831 Die Ausgabe von @code{annotate-spacing} bietet sehr viele
2832 Details zu den vertikalen Dimensionen einer Partitur.  Zu Information,
2833 wie Seitenränder und andere Layout-Variablen geändert werden
2834 können, siehe @ref{Seitenformatierung}.
2835
2836 Neben Rändern gibt es einige weitere Optionen, Platz zu sparen:
2837
2838 @itemize
2839 @item
2840 LilyPond kann die Systeme so dicht wie möglich platzieren (damit
2841 so viele Systeme wie möglich auf eine Seite passen), aber sie
2842 dann so anordnen, dass kein weißer Rand unten auf der Seite entsteht.
2843
2844 @example
2845 \paper @{
2846   system-system-spacing = #'((padding . 0) (space . 0.1))
2847   ragged-last-bottom = ##f
2848   ragged-bottom = ##f
2849 @}
2850 @end example
2851
2852 @item
2853 Die Anzahl der Systeme kann reduziert werden.  Das kann auf
2854 zwei Arten helfen: wenn einfach nur ein Wert gesetzt wird, auch
2855 wenn es die gleiche Anzahl ist, die auch schon vorher von LilyPond
2856 erstellt wurde, kann manchmal dazu führen, dass mehr Systeme
2857 auf eine Seite gesetzt werden.  Das liegt daran, dass ein
2858 Schritt im Notensatz ausgelassen wird, der die Seitenverteilung
2859 nur grob einschätzt, sodass eine bessere Seitenverteilung
2860 entsteht.  Auch wenn man eine Verringerung der Anzahl an Systemen
2861 erzwingt, kann oft eine Seite eingespart werden.  Wenn LilyPond
2862 die Musik etwa auf 11 Systeme verteilt, kann man die Benutzung von
2863 nur 10 Systemen erzwingen.
2864
2865 @example
2866 \paper @{
2867   system-count = #10
2868 @}
2869 @end example
2870
2871 @item
2872 Vermeidung von Objekten, die den vertikalen Abstand von Systemen
2873 vergrößern, hilft oft. Die Verwendung von Klammern bei Wiederholungen
2874 etwa braucht mehr Platz. Wenn die Noten innerhalb der Klammern  auf
2875 zwei Systeme verteilt sind, brauchen sie mehr Platz, als wenn sie
2876 nur auf einer Zeile gedruckt werden.
2877
2878 Ein anderes Beispiel ist es, Dynamik-Zeichen, die besonders
2879 weit @qq{hervorstehen}, zu verschieben.
2880
2881 @lilypond[verbatim,quote]
2882 \relative c' {
2883   e4 c g\f c
2884   \override DynamicText #'extra-offset = #'( -2.2 . 2.0)
2885   e4 c g\f c
2886 }
2887 @end lilypond
2888
2889 @item
2890 Die horizontalen Abstände können mit der
2891 @code{SpacingSpanner}-Eigenschaft verändert werden.  Siehe
2892 @ref{Horizontale Abstände verändern} für Einzelheiten.  Dieses
2893 Beispiel zeigt die normalen Abstände:
2894
2895 @lilypond[verbatim,quote]
2896 \score {
2897   \relative c'' {
2898     g4 e e2 |
2899     f4 d d2 |
2900     c4 d e f |
2901     g4 g g2 |
2902     g4 e e2 |
2903   }
2904 }
2905 @end lilypond
2906
2907 @noindent
2908 Das nächste Beispiel verändert @code{common-shortest-duration} (die
2909 häufigste kürzeste Note) von @code{1/4} zu @code{1/2}.  Die Viertelnote
2910 ist dennoch die häufigste Note in diesem Abschnitt, sodass der
2911 Notentext zusammengedrängt, wird, wenn eine Halbe als Standard
2912 angegeben wird:
2913
2914 @lilypond[verbatim,quote]
2915 \score {
2916   \relative c'' {
2917     g4 e e2 |
2918     f4 d d2 |
2919     c4 d e f |
2920     g4 g g2 |
2921     g4 e e2 |
2922   }
2923   \layout {
2924     \context {
2925       \Score
2926       \override SpacingSpanner
2927         #'common-shortest-duration = #(ly:make-moment 1 2)
2928     }
2929   }
2930 }
2931 @end lilypond
2932
2933 @noindent
2934 Die @code{common-shortest-duration}-Eigenschaft kann nicht
2935 dynamisch verändert werden, darum muss sie immer in der
2936 @code{\context}-Umgebung definiert werden und wirkt sich somit
2937 auf eine ganze @code{\score}-Umgebung aus.
2938
2939 @end itemize
2940
2941 @seealso
2942 Notationsreferenz:
2943 @ref{Seitenformatierung},
2944 @ref{Horizontale Abstände verändern}.
2945
2946 Schnipsel:
2947 @rlsr{Spacing}.