@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@ignore
- Translation of GIT committish: d96023d8792c8af202c7cb8508010c0d3648899d
+ Translation of GIT committish: fc1ca638e0b5f66858b9b7a073ceefc1eccb3ed2
When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
+ version that you are working on. For details, see the Contributors'
+ Guide, node Updating translation committishes.
@end ignore
-@c \version "2.12.0"
+@c \version "2.15.20"
+
+@c Translators: Till Paala
@node Abstände
noch die vertikale Platzverteilung zu eng oder zu weit gesetzt wird.
Einstellungen, die das Layout beeinflussen, können in zwei Umgebungen
-gesetzt werden: Die @code{\paper @{...@}}-Umgebung wird außerhalb einer
-@code{\score @{...@}}-Umgebung geschrieben und enthält Einstellungen,
-die für das gesamte Dokument gelten. Die @code{\layout @{...@}}-Umgebung
-wird innerhalb von einer @code{\score @{...@}}-Umgebung notiert und
-enthält die Einstellungen für eine bestimmte Partitur. Wenn Sie
-nur eine @code{\score @{...@}}-Umgebung in der Datei haben, haben
-beide Umgebungen den gleichen Effekt. Die Befehle, die in diesem Abschnitt
-erklärt werden, können in beiden Umgebungen nach Bedarf gesetzt werden.
+gesetzt werden: in der @code{\paper @{...@}}- und der @code{\layout @{...@}}-Umgebung.
+Die @code{\paper}-Umgebung enthält Einstellungen des Seitenlayouts, die für
+alle Partituren innerhalb eines @code{\book} die gleichen sein sollen, wie
+etwa Papierhöhe oder ob Seitenzahlen ausgegeben werden sollen. Siehe
+@ref{Seitenlayout}. Die @code{\layout}-Umbegung enthält Layouteinstellungen
+der Partitur selber, wie etwa die Zahl der Systeme oder den Platz zwischen
+Systemgruppen usw. Siehe @ref{Partiturlayout}.
@menu
-* Papier und Seiten::
-* Notenlayout::
+* Seitenlayout::
+* Partiturlayout::
* Umbrüche::
* Vertikale Abstände::
* Horizontale Abstände::
@end menu
-@node Papier und Seiten
-@section Papier und Seiten
-@translationof Paper and pages
+@node Seitenlayout
+@section Seitenlayout
+@translationof Page layout
-Dieser Abschnitt behandelt die Grenzen, die Notationsgebiete
-definieren.
+Dieser Abschnitt behandelt Seitenlayout-Optionen innerhalb der @code{\paper}-Umgebung.
@menu
-* Papierformat::
-* Seitenformatierung::
+* Die \paper-Umgebung::
+* Papierformat und automatische Skalierung::
+* Vertikale \paper-Variablen mit festen Abständen::
+* Vertikale \paper-Variablen mit flexiblen Abständen::
+* \paper-Variablen für horizontale Abstände::
+* Andere \paper-Variablen::
@end menu
-@node Papierformat
-@subsection Papierformat
-@translationof Paper size
+@node Die \paper-Umgebung
+@subsection Die @code{\paper}-Umgebung
+@translationof The \paper block
@cindex Papiergröße
@cindex Größe, Papier
@cindex Seitegröße
@cindex Größe, Seite
+Die @code{\paper}-Umgebung kann innerhalb einer @code{\book}-, nicht aber
+innerhalb einer @code{\score}-Umgebung vorkommen. Einstellungen in
+@code{\paper} wirken sich auf das gesamte Buch aus, welches viele einzelne
+Partituren beinhalten kann. Einstellungen, die in der @code{\paper}-Umgebung
+vorkommen können, beinhalten:
+
+@itemize
+
+@item
+die @code{set-paper-size}-Scheme-Funktion,
+
+@item
+@code{\paper}-Variablen, die zum Verändern des Seitenlayouts eingesetzt werden und
+
+@item
+Beschriftungsdefinitionen, mit denen das Layout von Kopf- und Fußleisten sowie
+Titeln beeinflusst wird.
+
+@end itemize
+
+Die @code{set-paper-size}-Funktion wird im nächsten Abschnitt behandelt:
+@ref{Papierformat und automatische Skalierung}. Die @code{\paper}-Variablen,
+die das Seitenlayout beeinflussen, werden in späteren Abschnitten behandelt.
+Die Beschriftungsdefinitionen für Kopf- und Fußzeilen sowie Titeln werden behandelt
+in @ref{Eigene Kopf und Fußzeilen sowie Titel}.
+
+Die meisten @code{\paper}-Variablen funktionieren nur innerhalb der
+@code{\paper}-Umgebung. Die wenigen, die auch in der @code{\layout}-Umgebung
+funktionieren, finden sich in @ref{Die \layout-Umgebung}.
+
+Außer wenn anders angegeben, werden alle @code{\paper}-Variablen, die
+Abständen auf der Seite antsprechen, in Millimetern gemessen, es sei denn,
+eine andere Maßeinheit ist definiert. Beispielsweise wird mit folgender
+Definition der obere Rand (top-margin) 10 mm breit definiert:
+
+@example
+\paper @{
+ top-margin = 10
+@}
+@end example
+
+Damit etwa @code{0.5} Zoll benutzt werden, muss @code{\in} dem Maß nachgestellt werden:
+
+@example
+\paper @{
+ top-margin = 0.5\in
+@}
+@end example
+
+Mögliche Maßeinheiten sind @code{\mm}, @code{\cm}, @code{\in} und
+@code{\pt}. Diese Maßeinheiten sind einfach Werte, um von Millimetern
+zu Konvertieren, sie sind in @file{ly/paper-defaults-init.ly} definiert.
+Um Missverständnisse zu vermeiden, wird normalerweise @code{\mm} geschrieben,
+auch wenn es eigentlich nicht notwendig wäre.
+
+Man kann die @code{\paper}-Werte auch mit Scheme definieren. Die Scheme-Entsprechung
+der obigen Definition ist:
+
+@example
+\paper @{
+ #(define top-margin (* 0.5 in))
+@}
+@end example
+
+@seealso
+Notationsreferenz
+@ref{Papierformat und automatische Skalierung},
+@ref{Eigene Kopf und Fußzeilen sowie Titel},
+@ref{Die \layout-Umgebung}.
+
+Installierte Dateien:
+@file{ly/paper-defaults-init.ly}.
+
+
+@node Papierformat und automatische Skalierung
+@subsection Papierformat und automatische Skalierung
+@translationof Paper size and automatic scaling
+
+@cindex Papierformat
+@cindex Seitenformat
+
+@funindex \paper
+
+@menu
+* Das Papierformat einstellen::
+* Automatische Skalierung auf ein Papierformat::
+@end menu
+
+
+@node Das Papierformat einstellen
+@unnumberedsubsubsec Das Papierformat einstellen
+@translationof Setting paper size
+
Zwei Funktionen ermöglichen es, die Papiergröße zu ändern:
@code{set-default-paper-size} und @code{set-paper-size}.
@code{set-default-paper-size} muss auf der obersten Ebene in
-der Quelldatei gesetzt werden, @code{set-paper-size} hingegegen
+der Quelldatei gesetzt werden, @code{set-paper-size} hingegen
muss sich in einer @code{\paper}-Umgebung befinden:
@example
@end example
@noindent
+Auf oberster Ebene kann @code{set-default-paper-size} überall vor der ersten
+@code{\paper}-Umgebung aufgerufen werden. Innerhalb einer @code{\paper}-Umgebung
+ist der beste Platz für @code{set-paper-size} gleich am Anfang, über der Liste
+der Variablen-Definitionen. Der Grund dafür wird behandelt in
+@ref{Automatische Skalierung auf ein Papierformat}
+
@code{set-default-paper-size} bestimmt die Größe aller Seiten, während
@code{set-paper-size} nur die Seitengröße für die Seiten definiert,
auf die sich die aktuelle @code{\paper}-Umgebung bezieht. Wenn die
-@code{\paper}-Umgebung auf der höchsten Ebene steht, bezieht sich die
+@code{\paper}-Umgebung gleich am Anfang der Datei steht, bezieht sich die
Papiergröße auf alle Seiten, wenn sie aber innerhalb einer
@code{\book}-Umgebung definiert wird, nur auf die Seiten innerhalb
dieses Buches.
@code{letter}, @code{legal} und @code{11x17} (auch als
Tabloit bekannt). Sehr viel mehr Formate sind unterstützt.
Einzelheiten finden sich in der Datei
-@file{scm/@/paper@/.scm} in der Definition von
+@file{scm/paper.scm} in der Definition von
@code{paper-alist}.
@warning{Das Standardformat ist @code{a4}.}
Weitere Papierformate können hinzugefügt werden, indem die
Definition von @code{paper-alist} in der Datei
-@file{scm/@/paper@/.scm} verändert wird. Derartige
+@file{scm/paper.scm} verändert wird. Derartige
Änderungen werden jedoch bei einer Aktualisierung des
Programmes überschrieben.
@funindex landscape
Wenn das Symbol @code{'landscape} als Argument an die Funktion
-@code{set-default-paper-size}gehänt wird, werden die Seiten um
+@code{set-default-paper-size} gehängt wird, werden die Seiten um
90° gedreht und die Notensysteme entsprechend breiter gesetzt.
@example
#(set-default-paper-size "a6" 'landscape)
@end example
-Wenn man die Seitengröße setzt, werden einige Variablen der
-@code{\paper}-Umgebung verändert, wie etwa Seitenränder. Um
-eine bestimmte Papiergröße mit veränderten @code{\paper}-Variablen
-zubenuttzen, muss die Papiergröße definiert werden, bevor diese
-Variablen neu gesetzt werden.
+@seealso
+Notationsreferenz:
+@ref{Automatische Skalierung auf ein Papierformat}.
+Installierte Dateien:
+@file{scm/paper.scm}.
+
+
+
+@node Automatische Skalierung auf ein Papierformat
+@unnumberedsubsubsec Automatische Skalierung auf ein Papierformat
+@translationof Automatic scaling to paper size
+
+Wenn das Papierformat mit einer der Scheme-Funktionen
+(@code{set-default-paper-size} oder @code{set-paper-size}) geändert wird,
+werden die Werte einiger @code{\paper}-Variablen automatisch an die
+neue Größe angepasst. Um die automatische Skalierung für eine bestimmte
+Variable zu umgehen, kann die Variable definiert werden, nachdem man
+das Papierformat angegeben hat. Es sollte beachtet werden, dass die
+automatische Anpassung nicht ausgelöst wird, wenn man nur die
+@code{paper-height} oder @code{paper-width}-Variablen verändert, obwohl
+@code{paper-width} andere Werte beeinflussen kann (das muss von der automatischen
+Skalierung unterschieden werden und wird unten behandelt). Die Funktionen
+@code{set-default-paper-size} und @code{set-paper-size} werden behandelt
+in @ref{Das Papierformat einstellen}.
+
+Die vertikalen Dimensionen, die durch die automatische Skalierung verändert
+werden sind: @code{top-margin} und @code{bottom-margin} (siehe
+@ref{Vertikale \paper-Variablen mit festen Abständen}). Die horizontalen
+Dimensionen, die durch die automatische Skalierung verändert werden, sind
+@code{left-margin}, @code{right-margin}, @code{inner-margin}, @code{outer-margin},
+@code{binding-offset}, @code{indent} und @code{short-indent} (siehe
+@ref{\paper-Variablen für horizontale Abstände}).
+
+Die Standardwerte für diese Dimensionen sind in
+@file{ly/paper-defaults-init.ly} definiert, wobei interne Variablen mit den
+Bezeichnungen @code{top-margin-default}, @code{bottom-margin-default}, usw.
+benutzt werden. Das sind die Werte für die Standardpapiergröße
+@code{a4}. Zum Vergleich: @code{a4} hat Werte von @code{297\mm} für
+@code{paper-height} und @code{210\mm} für @code{paper-width}.
@seealso
+Notationsreferenz:
+@ref{Vertikale \paper-Variablen mit festen Abständen},
+@ref{\paper-Variablen für horizontale Abstände}.
+
Installierte Dateien:
-@file{scm/@/paper@/.scm}.
+@file{ly/paper-defaults-init.ly},
+@file{scm/paper.scm}.
-Schnipsel:
-@rlsr{Spacing}.
-@node Seitenformatierung
-@subsection Seitenformatierung
-@translationof Page formatting
+@node Vertikale \paper-Variablen mit festen Abständen
+@unnumberedsubsubsec Vertikale @code{\paper}-Variablen mit festen Abständen
+@translationof Fixed vertical spacing \paper variables
-Ränder, Kopf- und Fußzeilen und andere Layoutvariablen werden
-entsprechend dem Papierformat automatisch gesetzt.
+@warning{Einige @code{@bs{}paper}-Dimensionen werden automatisch nach
+Papierformat skaliert, was zu ungewolltem Verhalten führen kann. Siehe
+@ref{Automatische Skalierung auf ein Papierformat}.}
-Dieser Abschnitt zeigt einige der Papiervariablen, die geändert
-werden können.
+Standardwerte (vor der Skalierung) sind definiert in
+@file{ly/paper-defaults-init.ly}.
-@menu
-* Vertikale Dimensionen::
-* Horizontale Dimensionen::
-* Weitere Layout-Variablen::
-@end menu
+@table @code
+@item paper-height
+@funindex paper-height
+Die Höhe der Seite, standardmäßig nicht definiert. Die automatische
+Skalierung einiger vertikalen Dimensionen wird hiervon nicht betroffen.
-@node Vertikale Dimensionen
-@unnumberedsubsubsec Vertikale Dimensionen
-@translationof Vertical dimensions
+@item top-margin
+@funindex top-margin
-Diese Variablen werden benutzt um andere vertikale Verhältnisse
-auf einer Seite zu produzieren:
+Der Rand zwischen dem oberen Ende der Seite und dem oberen Ende
+des bedruckbaren Bereichs. Wenn das Papierformat verändert wurde, wird
+der Standardwert dieser Dimension entsprechend skaliert.
-@funindex \paper
-@funindex after-title-space
-@funindex before-title-space
-@funindex between-system-padding
-@funindex between-system-space
-@funindex between-title-space
+@item bottom-margin
@funindex bottom-margin
-@funindex foot-separation
-@funindex head-separation
-@funindex page-top-space
-@funindex paper-height
-@funindex top-margin
-
-@table @code
-@item after-title-space
+Der Rand zwischen dem unteren Ende der Seite und dem unteren Ende des
+bedruckbaren Bereichs. Wenn das Papierformat verändert wurde, wird
+der Standardwert dieser Dimension entsprechend skaliert.
-Die Größe des Abstands zwischen der Überschrift und dem ersten
-Notensystem. Standard: @code{5\mm}.
+@item ragged-bottom
+@funindex ragged-bottom
-@item before-title-space
+Wenn auf wahr gesetzt, werden die Systeme nicht vertikal bis zum unteren
+Seitenrand verteilt. Sollte auf wahr gesetzt sein für Stücke, die nur
+ein bis zwei Notensystemgruppen pro Seite haben, etwa Orchesterpartituren.
-Die Größe des Abstands zwischen dem letzten Notensystem einer
-Partitur und dem Titel der nächsten Partitur. Standard: @code{10\mm}.
+@item ragged-last-bottom
+@funindex ragged-last-bottom
-@item between-system-padding
+Wenn auf falsch gesetzt, werden die Systeme vertikal auf der letzten Seite
+verteilt. Bei Stücken, die grob zwei oder mehr Seiten füllen, sollten es auf
+wahr gesetzt werden. Hiermit wird auch die letzte Seite von Teilen eines
+@code{\book}, die mit @code{\bookpart} erstellt sind, beeinflusst.
-Der Mindestabstand zwischen dem untersten Symbol in einem Notensystem
-und dem obersten Symbol im sich darunter befindlichen System.
-Standard: @code{4\mm}.
+@end table
-Wenn dieser Wert erhöht wird, werden Systeme, deren @qq{bounding box}
-sich beinahe berühren, weiter auseinander gezogen.
+@seealso
+Notationsreferenz:
+@ref{Automatische Skalierung auf ein Papierformat}.
-@item between-system-space
+Installierte Dateien:
+@file{ly/paper-defaults-init.ly}.
-Der Abstand zwischen Systemen. Das ist der ideale Abstand zwischen
-der Mitte des eines Systems (bzw. des untersten Systems einer Systemgruppe)
-und der Mitte des nächsten Systems (bzw. des obersten System der
-nächsten Systemgruppe). Standard: @code{20\mm}.
+Schnipsel:
+@rlsr{Spacing}.
-Wenn dieser Wert erhöhrt wird, erscheinen die Noten auf der Seite gleichmäßiger,
-wobei sie aber auch mehr Platz einnehmen.
+@knownissues
-@item between-title-space
+Die Titel (aus der @code{\header}-Umgebung) werden als Systemgruppe
+behandelt, sodass @code{ragged-bottom} und @code{ragged-last-bottom} auch
+zusätzlichen Abstand zwischen den Titel und dem ersten System einer
+Paritur einfügt.
-Der Abstand zwischen aufeinanderfolgenden Überschriften (etwa die
-Überschrift für ein @code{book} und die Überschrift einer Partitur.
-Standard: @code{2\mm}.
+Explizit definierte Papierformate überschreiben alle vom Benutzer erstellte
+Randeinstellung für die Ränder oben und unten.
-@item bottom-margin
-Der Rand zwischen der Fußzeile und dem unteren Rand der Seite.
-Standard: @code{6\mm}.
+@node Vertikale \paper-Variablen mit flexiblen Abständen
+@unnumberedsubsubsec Vertikale @code{\paper}-Variablen mit flexiblen Abständen
+@translationof Flexible vertical spacing \paper variables
-@item foot-separation
+In den meisten Fällen bietet es sich an, dass die vertikalen
+Abstände zwischen bestimmten Objekten (wie Ränder, Titel,
+Notensystemgruppen und einzelne Partituren) flexibel gehalten
+werden, sodass sie je nach Situation gedehnt oder komprimiert
+werden können. Es gibt eine Anzahl von Variablen für die
+@code{\paper}-Umgebung, mit denen man das Dehnungsverhalten dieser
+Dimensionen beeinflussen kann. Sie finden sich unten aufgelistet.
-Der Abstand zwischen dem untersten Notensystem und der Fußzeile.
-Standard: @code{4\mm}.
+Dabei sollte beachtet werden, dass die Variablen, die in diesem
+Abschnitt behandelt werden, nicht die Platzierung und das
+Dehnungsverhalten von Notensystemen innerhalb der einzelnen
+Systemgruppen behandelt. Die Dehnung zwischen Notensystemen
+wird mit Grob-Eigenschaften kontrolliert, deren Einstellungen
+normalerweise innerhalb der @code{\score}-Umgebung vorgenommen
+werden, und nicht innerhalb der @code{\paper}-Umgebung. Siehe auch
+@ref{Flexible vertikale Abstände in Systemgruppen}.
-@item head-separation
+@menu
+* Struktur der Alisten für flexible vertikale Abstände::
+* Liste der flexiblen vertikalen Abstandsvariablen in \paper::
+@end menu
-Der Abstand zwischen dem obersten System und der Kopfzeile. Standard:
-@code{4\mm}.
-@item page-top-space
+@node Struktur der Alisten für flexible vertikale Abstände
+@unnumberedsubsubsec Struktur der Alisten für flexible vertikale Abstände
+@translationof Structure of flexible vertical spacing alists
-Der Abstand von der Oberkante des druckbaren Bereichs bis zur
-Mitte des ersten Notensystems. Das funktioniert nur für Systeme,
-die nicht vertikal ausgedehnt sind. Hohe Systeme bzw. Systemgruppen
-werden mit ihrer @qq{bounding box} an der Oberkante des
-druckbaren Bereichs ausgerichtet. Standard: @code{12\mm}.
+Jede der flexiblen vertikalen Abstandsvariablen ist eine Aliste (eine assoziative Liste), die
+vier @emph{Schlüssel} (engl. key) enthält:
-@item paper-height
+@itemize
-Die Höhe der Seite. Standard: Die Höhe des aktuellen Papierformats.
-Zu Einzelheiten siehe @ref{Papierformat}.
+@item
+@code{basic-distance} (Grund-Abstand) -- der vertikale Abstand, gemessen in
+Systemzwischenräumen, zwischen den @emph{Referenzpunkten}
+zweier Elemente, wenn keine Zusammenstöße vorkommen würden und
+keine Dehnung oder Kompression stattfindet. Der Referenzpunkt
+einer (Titel-)Beschriftung (auf höchster Ebene) ist sein
+höchster Punkt und der Referenzpunkt einer Systemgruppe ist
+der vertikale Mittelpunkt des nächsten @code{StaffSymbol}
+-- sogar wenn eine Nicht-Notensystemzeile (wie etwa ein
+@code{Lyrics}-Kontext) dazwischen kommt. Werte für @code{basic-distance},
+die weniger als entweder @code{padding} oder @code{minimum-distance}
+sind, haben keine Bedeutung, weil der sich daraus ergebende
+Abstand niemals weniger als entweder @code{padding} oder
+@code{minimum-distance} ergibt.
-@item top-margin
+@item
+@code{minimum-distance} (minimaler Abstand) -- der kleinste
+erlaubte vertikale Abstand, gemessen in Systemzwischenräumen,
+zwischen den Referenzpunkten der zwei Elemente, wenn Kompression
+stattfindet. Werte für @code{minimum-distance}, die geringer als
+@code{padding} sind, haben keine Bedeutung, weil der sich daraus
+ergebende Abstand niemals weniger als @code{padding} ergibt.
-Der Rand zwischen der Kopfzeile und dem oberen Rand der Seite. Standard:
-@code{5\mm}.
+@item
+@code{padding} (Verschiebung) -- der minimal benötigte vertikale blanke
+Freiraum zwischen den Bounding-Boxen (oder Skyline) der zwei Objekten, gemessen in Notenlinienabständen.
+
+@item @code{stretchability} (Dehnbarkeit) -- ein einheitsloses
+Maß der Leichtigkeit, mit der sich die Dimension dehnen lässt (ohne
+dass Zusammenstöße auftreten). Wenn es null ist, wird der Abstand
+nicht gedehnt (außer ein Zusammenstoß würde auftreten), wenn es
+positiv ist, hängt die Wichtigkeit der Dehnbarkeit eines bestimmten
+Objekts nur noch von seiner Beziehung zu dem Wert des anderen Objekts
+ab. Beispielsweise wennn eine Dimension die doppelte Dehnbarkeit als
+die andere hat, wird sie auch zweimal so einfach gedehnt. Werte sollten
+nicht-negativ und reale Zahlen sein. Der Wert @code{+inf.0}
+ruft einen @code{programming_error} hervor und wird ignoriert, aber
+@code{1.0e7} kann für einen so gut wie unendlich dehnbaren Abstand eingesetzt
+werden. Wenn der Wert nicht gesetzt wird, ist der Standardwert
+der von @code{basic-distance}. Die Wahrscheinlichkeit einer Dimension, sich
+zu verkleinern, kann man nicht direkt beeinflussen, sondern sie ergibt sich
+aus (@code{space}@tie{}@minus{}@tie{}@code{minimum-distance}).
-@end table
+@end itemize
+Wenn eine Seite einen nicht ausgeglichenen unteren Rand hat, ist der
+resultierende Abstand der größte von:
-@snippets
+@itemize
-Kopf- und Fußzeile werden von den Funktionen @code{make-footer} und
-@code{make-header} erstellt, welche in der @code{\paper}-Umgebung definiert
-werden. Die Standardeinstellungen sind in den Dateien
-@file{ly/paper-defaults.ly} und @code{ly/titling-init.ly} dargestellt.
+@item
+@code{basic-distance},
-Das Seitenlayout wird durch zwei Funktionen der @code{\paper}-Umgebung
-bestimmt: @code{page-music-height} und @code{page-make-stencil}. Die erste
-teilt dem Zeilenumbruchsalgorithmus mit, wieviel Platz auf einer Seite
-belegt werden kann, die zweite hingegegen erstellt die konkrete Seite,
-nachdem sie die Systeme entgegengenommen hat, die auf der Seite platziert
-werden sollen.
+@item
+@code{minimum-distance} und
-Beispiel:
+@item
+@code{padding} plus der kleinste nötige Abstand, um Zusammenstöße
+zu vermeiden.
-@example
-\paper@{
- paper-width = 2\cm
- top-margin = 3\cm
- bottom-margin = 3\cm
- ragged-last-bottom = ##t
-@}
-@end example
+@end itemize
-Das nächste Beispiel zentriert Seitenzahlen unten auf jeder Seite:
+Spezifische Methoden, um Alisten zu verändern, werden behandelt in
+@ref{Alisten verändern}. Das folgende Beispiel demonstriert beide Arten,
+wie diese Alisten verändert werden können. Der erste Aufruf verändert
+nur einen Schlüsselwert einzeln, während der zweite die Variable
+vollständig neu definiert:
@example
\paper @{
- print-page-number = ##t
- print-first-page-number = ##t
- oddHeaderMarkup = \markup \fill-line @{ " " @}
- evenHeaderMarkup = \markup \fill-line @{ " " @}
- oddFooterMarkup = \markup @{ \fill-line @{
- \bold \fontsize #3 \on-the-fly #print-page-number-check-first
- \fromproperty #'page:page-number-string @} @}
- evenFooterMarkup = \markup @{ \fill-line @{
- \bold \fontsize #3 \on-the-fly #print-page-number-check-first
- \fromproperty #'page:page-number-string @} @}
+ system-system-spacing #'basic-distance = #8
+ score-system-spacing =
+ #'((basic-distance . 12)
+ (minimum-distance . 6)
+ (padding . 1)
+ (stretchability . 12))
@}
@end example
-Werte der @code{\paper}-Umgebung können in Scheme definiert werden. In diesem
-Fall sind @code{mm}, @code{in}, @code{pt} und @code{cm} Variablen,
-die in der Datei @file{paper-defaults.ly} mit Millimeter-Werten definiert
-sind. Darum muss der Wert 2 cm in dem Beispiel unten multilpliziert werden
-muss:
-@example
-\paper @{
- #(define bottom-margin (* 2 cm))
-@}
-@end example
+@node Liste der flexiblen vertikalen Abstandsvariablen in \paper
+@unnumberedsubsubsec Liste der flexiblen vertikalen Abstandsvariablen in @code{\paper}
+@translationof List of flexible vertical spacing \paper variables
+
+Die Bezeichnungen dieser Variablen entsprechen dem Format
+@code{@var{obere}-@var{untere}-platzierung}, wobei @code{@var{obere}}
+und @code{@var{untere}} die zu platzierenden Elemente darstellen. Jeder
+Abstand wird zwischen den Referenzpunkten der beiden Elemente gemessen
+(siehe Beschreibung der Alistenstruktur oben). In diesen Variablenbezeichnungen
+bedeutet @q{@code{markup}} (Beschriftung) sowohl
+@emph{Titelbeschriftungen} (@code{bookTitleMarkup} oder
+@code{scoreTitleMarkup}) als auch @emph{Beschriftungen auf höchster Ebene}
+(siehe @ref{Die Dateistruktur}). Alle Entfernungen werden in Systemzwischenräumen
+gemessen.
+
+Standardwerte sind in @file{ly/paper-defaults-init.ly} definiert.
+
+@c TODO: Where do headers/footers fit in? -mp
+
+@table @code
+@item markup-system-spacing
+@funindex markup-system-spacing
+
+der Abstand zwischen einer (Titel-)Beschriftung (auf höchster Ebene) und der
+darauf folgenden Systemgruppe.
+
+@item score-markup-spacing
+@funindex score-markup-spacing
+
+der Abstand zwischen dem letzten System einer Partitur und der darauf folgenden
+(Titel-)Beschriftung (auf höchster Ebene).
+
+@item score-system-spacing
+@funindex score-system-spacing
+
+der Abstand zwischen dem letzten System einer Partitur und dem ersten
+System der folgenden Partitur, wenn keine (Titel-)Beschriftung (auf höchster
+Ebene) dazwischen vorkommt.
+
+@item system-system-spacing
+@funindex system-system-spacing
+
+der Abstand zwischen zwei Systemgruppen der selben Partitur.
+
+@item markup-markup-spacing
+@funindex markup-markup-spacing
+
+der Abstand zwischen zwei (Titel-)Beschriftungen (auf höchster Ebene).
+
+@item last-bottom-spacing
+@funindex last-bottom-spacing
+
+der Abstand vom letzten System oder Beschriftung auf höchster Ebene auf
+einer Seite zum unteren Rand des bedruckbaren Bereichs (also bis zum Anfang
+des unteren Randes).
+
+@item top-system-spacing
+@funindex top-system-spacing
+
+der Abstand zwischen dem oberen Rand des bedruckbaren Bereichs (also dem Ende
+des oberen Rands) und dem ersten System auf der Seite, wenn keine
+(Titel-)Beschriftung (auf höchster Ebene) dazwischen kommt.
+
+@item top-markup-spacing
+@funindex top-markup-spacing
+
+der Abstand vom oberen Rand des bedruckbaren Bereichs (also dem Ende des
+oberen Randes) zur ersten (Titel-)Beschriftung (auf höchster Ebene) auf
+einer Seite, wenn keine Systemgruppe dazwischen kommt.
+@end table
@seealso
Notationsreferenz:
-@ref{Vertikale Abstände zwischen Systemen}.
+@ref{Flexible vertikale Abstände in Systemgruppen}.
+
+Installierte Dateien:
+@file{ly/paper-defaults-init.ly}.
Schnipsel:
@rlsr{Spacing}.
-@node Horizontale Dimensionen
-@unnumberedsubsubsec Horizontale Dimensionen
-@translationof Horizontal dimensions
-@funindex horizontal-shift
-@funindex indent
-@funindex left-margin
-@funindex line-width
-@funindex paper-width
-@funindex short-indent
+@node \paper-Variablen für horizontale Abstände
+@unnumberedsubsubsec \paper-Variablen für horizontale Abstände
+@translationof Horizontal spacing \paper variables
+
+@warning{Einige @code{@bs{}paper}-Dimensionen werden automatische
+entsprechend dem Papierformat skaliert und können deshalb ungewollte
+Resultate haben. Siehe @ref{Automatische Skalierung auf ein Papierformat}.}
+
+@menu
+* \paper-Variablen für Breite und Ränder::
+* \paper-Variablen für zweiseitigen Satz::
+* \paper-Variablen für Verschiebungen und Einrückungen::
+@end menu
+
-@warning{Wenn @code{paper-width} manuell gesetzt wird, müssen
-möglicherweise auch die Werte von @code{line-width},
-@code{left-margin}, @code{indent} und @code{short-indent} angepasst
-werden.}
+@node \paper-Variablen für Breite und Ränder
+@unnumberedsubsubsec \paper-Variablen für Breite und Ränder
+@translationof \paper variables for widths and margins
+
+Standardwerte (vor der Skalierung), die hier nicht aufgelistet
+sind, finden sich in @file{ly/paper-defaults-init.ly}.
-Es gibt einige Variablen, die die horizontalen Dimensionen der Seite
-beeinflussen:
@table @code
-@item horizontal-shift
+@item paper-width
+@funindex paper-width
-Der Wert, um den alle Systeme (und auch Überschriften und Systemtrenner)
-nach rechts verschoben werden. Standard: @code{0.0}.
+Die Breide der Seite, standardmäßig nicht definiert. Während
+@code{paper-width} keine Auswirkungen auf die automatische
+Skalierung einiger horizontaler Dimensionen hat, beeinflusst es
+dennoch die @code{line-width}-Variable. Wenn sowohl @code{paper-width}
+als auch @code{line-width} definiert sind, dann werden auch
+@code{left-margin} und @code{right-margin} aktualisiert. Siehe auch
+@code{check-consistency}.
-@item indent
+@item line-width
+@funindex line-width
-Der Einzug für das erste System einer Partitur. Standard:
-@code{paper-width} geteilt durch @code{14}, definiert in
-@code{set-default-paper-size} bzw. @code{set-paper-size}.
+Die horizontale Ausdehnung der Notenlinien in nicht-eingerückten,
+Systemen mit Ausgleich zum rechten Rand, entspricht
+@code{(paper-width@tie{}@minus{}@tie{}left-margin@tie{}@minus{}@tie{}right-margin)}
+wenn nicht definiert. Wenn @code{line-width} definiert ist und sowohl
+@code{left-margin} als auch @code{right-margin} nicht definiert sind, dann
+werden die Ränder aktualisiert, sodass die Systeme mittig auf der Seite
+zentriert werden. Siehe auch @code{check-consistency}. Diese Variable
+kann auch in der @code{\layout}-Umgebung definiert werden.
@item left-margin
+@funindex left-margin
-Der Rand zwischen dem linken Rand der Seite und dem Anfang der Notensysteme.
-Standard: @code{10\mm}, definiert in
-@code{set-default-paper-size} oder @code{set-paper-size}.
+Der Rand zwischen der linken Papierkante und dem Beginn der Systeme
+ohne Einrückungen. Wenn das Papierformat verändert wird, wird auch
+der Standardwert dieser Dimension entsprechend skaliert. Wenn
+@code{left-margin} nicht definiert ist und sowohl @code{line-width}
+als auch @code{right-margin} definiert sind, dann wird @code{left-margin}
+auf den Wert
+@code{(paper-width@tie{}@minus{}@tie{}line-width@tie{}@minus{}@tie{}right-margin)}
+gesetzt. Wenn nur @code{line-width} definiert ist, dann werden beide
+Ränder auf den Wert
+@code{((paper-width@tie{}@minus{}@tie{}line-width)@tie{}/@tie{}2)}
+gesetzt und die Systeme demzufolge auf der Seite zentriert. Siehe auch
+@code{check-consistency}.
+
+@item right-margin
+@funindex right-margin
+
+Der Rand zwischen der rechten Papierkante und dem Ende der Systeme mit
+Randausgleich (@qq{Blocksatz}). Wenn das Papierformat geändert wird,
+wird auch der Standardwert dieser Dimension entsprechend skaliert. Wenn
+@code{right-margin} nicht definiert ist und sowohl @code{line-width} als
+auch @code{left-margin} definiert sind, dann wird @code{right-margin} auf den
+Wert @code{(paper-width@tie{}@minus{}@tie{}line-width@tie{}@minus{}@tie{}left-margin)}
+gesetzt. Wenn nur @code{line-width} definiert ist, dann werden beide Ränder
+auf den Wert
+@code{((paper-width@tie{}@minus{}@tie{}line-width)@tie{}/@tie{}2)}
+gesetzt und die Systeme demzufolge auf der Seite zentriert. Siehe auch
+@code{check-consistency}.
+
+@item check-consistency
+@funindex check-consistency
+
+Wenn wahr, wird eine Warnung ausgegeben, sollten @code{left-margin},
+@code{line-width} und @code{right-margin} zusammen nicht exakt den
+Wert von @code{paper-width} ergeben, und die Werte (außer
+@code{paper-width}) mit ihren Standardwerten belegt (wenn nötig auf
+das entsprechende Papierformat skaliert). Wenn falsch werden derartige
+Inkonsistenzen ignoriert und die Systeme dürfen auch über den Seitenrand
+hinausragen.
-@item line-width
+@item ragged-right
+@funindex ragged-right
-Die Breite der Notensystems. Standard: @code{paper-width} minus
-@code{20\mm}, dfiniert in @code{set-default-paper-size} bzw.
-@code{set-paper-size}.
+Wenn wahr, werden Notensysteme nicht über die gesamte Zeilenbreite
+gestreckt, sondern sie enden horizontal entsprechend den enthaltenen
+Noten. Standard: @code{#t} (wahr) für Partituren mit einem System
+und @code{#f} (falsch) für Partituren mit zwei oder mehr Systemen.
+Diese Variable kann auch in der @code{\layout}-Umgebung definiert werden.
-@item paper-width
+@item ragged-last
+@funindex ragged-last
+
+Wenn wahr, wird das letzte Notensystem einer Partitur nicht über die
+gesamte Zeilenbreite gestreckt, sondern es endet horizontal entsprechend
+den enthaltenen Noten. Standard: @code{#f} (falsch). Diese Variable
+kann auch in der @code{\layout}-Umgebung definiert werden.
+
+@end table
+
+@seealso
+Notationsreferenz:
+@ref{Automatische Skalierung auf ein Papierformat}.
+
+Installierte Dateien:
+@file{ly/paper-defaults-init.ly}.
+
+@knownissues
+Explizit definierte Papierformate überschreiben alle vom Benutzer erstellte
+Randeinstellung für die Ränder oben und unten.
+
+
+@node \paper-Variablen für zweiseitigen Satz
+@unnumberedsubsubsec @code{\paper}-Variablen für zweiseitigen Satz
+@translationof \paper variables for two-sided mode
+
+Standardwerte (vor der Skalierung) sind definiert in
+@file{ly/paper-defaults-init.ly}.
+
+@table @code
-Die Breite der Seite. Standard: Die Breite des aktuellen
-Papierformats. Zu Einzelheiten siehe @ref{Papierformat}.
+@item two-sided
+@funindex two-sided
+
+@cindex Bundsteg
+@cindex Binderand
+
+Wenn auf wahr (@code{##t}) gesetzt, werden @code{inner-margin}, @code{outer-margin}
+und @code{binding-offset} zusammen benutzt, um die Ränder der Seite in Abhängigkeit
+von einer geraden oder ungeraden Seitennummer zu errechnen. Damit werden die
+Werte von @code{left-margin} und @code{right-margin} überschrieben. Standard:
+@code{##f}.
+
+@item inner-margin
+@funindex inner-margin
+
+Der Rand, den alle Seiten auf der Innenseite haben, wenn sie Teil eines
+Buches (@code{\book}) sind. Wenn das Papierformat verändert wird,
+wird der Standardwert dieser Dimension entsprechend skaliert. Funktioniert
+nur, wenn @code{two-sided} wahr ist.
+
+@item outer-margin
+@funindex outer-margin
+
+Der Rand, den alle Seiten auf der Außenseite haben, wenn sie Teil eines Buches
+sind. Wenn das Papierformat verändert wird,
+wird der Standardwert dieser Dimension entsprechend skaliert. Funktioniert nur,
+wenn @code{two-sided} wahr ist.
+
+@item binding-offset
+@funindex binding-offset
+
+Der Wert, um welchen @code{inner-margin} erhöht wird, um sicherzugehen, dass
+nichts in der Bindung verschwindet. Wenn das Papierformat verändert wird,
+wird der Standardwert dieser Dimension entsprechend skaliert. Funktioniert nur,
+wenn @code{two-sided} wahr ist.
+
+@end table
+
+@seealso
+Notationsreferenz:
+@ref{Automatische Skalierung auf ein Papierformat}.
+
+Installierte Dateien:
+@file{ly/paper-defaults-init.ly}.
+
+
+@node \paper-Variablen für Verschiebungen und Einrückungen
+@unnumberedsubsubsec @code{\paper}-Variablen für Verschiebungen und Einrückungen
+@translationof \paper variables for shifts and indents
+
+
+Standardwerte (vor der Skalierung), die hier nicht aufgeführt sind,
+sind definiert in @file{ly/paper-defaults-init.ly}.
+
+@table @code
+
+@item horizontal-shift
+@funindex horizontal-shift
+
+@c This default value is buried in the middle of page.scm. -mp
+
+Der Wert, um den alle Systeme (und auch Überschriften und Systemtrenner)
+nach rechts verschoben werden. Standard: @code{0.0\mm}.
+
+@item indent
+@funindex indent
+
+Der Einzug für das erste System einer Partitur. Wenn das Papierformat
+verändert wird, wird der Standardwert dieser Dimension entsprechend skaliert.
+Diese Variable kann auch in der @code{\layout}-Umgebung definiert werden.
@item short-indent
+@funindex short-indent
Der Einzug für alle Systeme einer Partitur ausschließlich das
-erste System. Standard: @code{0}, dfiniert in
-@code{set-default-paper-size} bzw. @code{set-paper-size}.
+erste System. Wenn das Papierformat
+verändert wird, wird der Standardwert dieser Dimension entsprechend skaliert.
+Diese Variable kann auch in der @code{\layout}-Umgebung definiert werden.
@end table
-
@seealso
+Notationsreferenz:
+@ref{Automatische Skalierung auf ein Papierformat}.
+
+Installierte Dateien:
+@file{ly/paper-defaults-init.ly}.
+
Schnipsel:
@rlsr{Spacing}.
-@knownissues
+@node Andere \paper-Variablen
+@subsection Andere @code{\paper}-Variablen
+@translationof Other \paper variables
-Die Option @code{right-margin} ist definiert, bestimmt aber nicht den
-rechten Rand der Seite. Der Wert für den rechten Rand ergibt sich
-aus den Werten des linken Randes (@code{left-margin}) und der Zeilenbreite
-(@code{line-width}).
+@menu
+* \paper-Variablen für den Zeilenumbruch::
+* \paper-Variablen für den Seitenumbruch::
+* \paper-Variablen für Seitenzahlen::
+* Verschiedene \paper-Variablen::
+@end menu
-@node Weitere Layout-Variablen
-@unnumberedsubsubsec Weitere Layout-Variablen
-@translationof Other layout variables
+@node \paper-Variablen für den Zeilenumbruch
+@unnumberedsubsubsec @code{\paper}-Variablen für den Zeilenumbruch
+@translationof \paper variables for line breaking
+@c TODO: Mention that ly:optimal-breaking is on by default? -mp
-Diese Variablen können verwendet werden, um das allgemeine Layout der Seite
-anzupassen.
+@table @code
-@funindex auto-first-page-number
-@funindex blank-last-page-force
-@funindex blank-page-force
-@funindex first-page-number
-@funindex page-breaking-between-system-padding
-@funindex page-count
-@funindex page-limit-inter-system-space
-@funindex page-limit-inter-system-space-factor
-@funindex page-spacing-weight
-@funindex print-all-headers
-@funindex print-first-page-number
-@funindex print-page-number
-@funindex ragged-bottom
-@funindex ragged-last
-@funindex ragged-last-bottom
-@funindex ragged-right
-@funindex system-separator-markup
+@item max-systems-per-page
+@funindex max-systems-per-page
+
+Die maximale Anzahl an Notensystemgruppen, die auf einer Seite gesetzt werden. Das
+wird zur Zeit nur von dem @code{ly:optimal-breaking}-Algorithmus
+unterstützt. Standard: nicht gesetzt.
+
+@item min-systems-per-page
+@funindex min-systems-per-page
+
+Die minimale Anzahl an Notensystemgruppen, die auf einer Seite gesetzt werden. Das
+kann dazu führen, dass Seiten zu dicht gefüllt werden, wenn der Wert
+zu groß gewählt wird. Die Option ist zur Zeit nur von dem
+@code{ly:optimal-breaking}-Algorithmus unterstützt. Standard: nicht gesetzt.
+
+@item systems-per-page
+@funindex systems-per-page
+
+Die Anzahl an Systemen, die auf jede Seite gesetzt werden sollen.
+Diese Option wird zur Zeit nur von dem @code{ly:optimal-breaking}-Algorithmus
+unterstützt. Standard: nicht gesetzt.
+
+@item system-count
@funindex system-count
-@table @code
+Die Anzahl der Systeme, auf denen eine Partitur gesetzt werden soll.
+Standard: nicht gesetzt. Diese Variablen kann auch in der
+@code{\layout}-Umgebung definiert werden.
-@item auto-first-page-number
+@end table
-Der Seitenumbruchsalgorithmus wird davon beeinflusst, ob die erste
-Seitenzahl gerade oder ungerade ist. Wenn die Variable auf wahr
-gesetzt wird, entscheidet der Seitenumbruchsalgorithmus selber,
-ob die Noten auf einer geraden oder ungeraden Seite beginnen sollen.
-Das hat dann zur Folge, dass die erste Seite entweder bleibt wie
-sie ist oder um eins erhöht wird. Standard: @code{##f}.
+@seealso
+Notationsreferenz:
+@ref{Zeilenumbrüche}.
-@ignore
-FIXME: this variable is used, but I don't know what it does. -pm
+@node \paper-Variablen für den Seitenumbruch
+@unnumberedsubsubsec @code{\paper}-Variablen für den Seitenumbruch
+@translationof \paper variables for page breaking
+
+Standardwerte, die hier nicht aufgelistet sind, finden sich in
+@file{ly/paper-defaults-init.ly}
+
+@table @code
+
@item blank-after-score-page-force
@funindex blank-after-score-page-force
-Default: @code{2}.
-
-@end ignore
+Die Strafpunke, die erteilt werden, wenn eine leere Seite nach einer
+Partitur und vor der nächsten vorkommt. Der Standardwert hiervon ist
+kleiner als @code{blank-page-force}, sodass leere Seiten nach einer Partitur
+leeren Seiten innerhalb einer Partitur vorgezogen werden.
@item blank-last-page-force
+@funindex blank-last-page-force
Die Strafpunkte, wenn eine Partitur auf einer ungeraden Seite
-beendet wird. Stadnard: @code{0}.
+beendet wird. Standard: @code{0}.
@item blank-page-force
+@funindex blank-page-force
Die Strafpunkte, wenn eine leere Seite mitten in einer Partitur
auftritt. Das wird nicht benutzt von @code{ly:optimal-breaking},
weil hiermit niemals leere Seiten mitten in einer Partitur zugelassen
-werden. Standard: @code{5}.
-
-@item first-page-number
-
-Der Wert der Seitenzahl auf der ersten Seite. Standard: @code{#1}.
-
-@item max-systems-per-page
-
-Die maximale Anzahl an Notensystemen, die auf einer Seite gesetzt werden. Das
-wird zur Zeit nur von dem @code{ly:optimal-breaking}-Alghoritmus
-unterstützt. Standard: nicht gesetzt.
+werden.
-@item min-systems-per-page
+@item page-breaking
+@funindex page-breaking
-Die minimale Anzahl an Notensystemen, die auf einer Seite gesetzt werden. Das
-kann dazu führen, dass Seiten zu dicht gefüllt werden, wenn der Wert
-zu groß gewählt wird. Die Option ist zur Zeit nur von dem
-@code{ly:optimal-breaking}-Alghoritmus unterstützt. Standard: nicht gesetzt.
+Der Algorithmus, der für Seitenumbrüche eingesetzt wird. Mögliche
+Algorithmen sind: @code{ly:minimal-breaking} (minimale Umbrüche),
+@code{ly:page-turn-breaking} (Umbrüche an guten Stellen zum Umblättern)
+und @code{ly:optimal-breaking}.
-@item page-breaking-between-system-padding
+@item page-breaking-system-system-spacing
+@funindex page-breaking-system-system-spacing
Überlistet die Seitenumbruchfunktion, indem ihr ein anderer Wert
-für @code{between-system-padding} mitgeteilt wird, als in Wirklichkeit
-eingestellt ist. Wenn diese Variable beispielsweise auf einen
-deutlich größeren Wert als @code{between-system-padding} gesetzt
+für @code{system-system-spacing} mitgeteilt wird, als in Wirklichkeit
+eingestellt ist. Wenn beispielsweise
+@code{page-breaking-system-system-spacing #'padding} auf einen
+deutlich größeren Wert als @code{system-system-spacing #'padding} gesetzt
wird, setzt die Seitenumbruchsfunktion weniger Systeme auf eine
Seite. Standard: nicht gesetzt.
@item page-count
+@funindex page-count
Die Zahl der Seiten, die für eine Partitur benutzt werden sollen.
Standard: nicht gesetzt.
-@item page-limit-inter-system-space
+@end table
-Wenn wahr, wird Platz zwischen Systemen eingeschränkt, wenn viel
-Platz auf der Seite ist. Standard: @code{##f}. Einzelheiten siehe
-@ref{Vertikale Abstände zwischen Systemen}.
+@seealso
+Notationsreferenz:
+@ref{Seitenumbrüche},
+@ref{Optimale Seitenumbrüche},
+@ref{Optimale Umbrüche zum Blättern},
+@ref{Minimale Seitenumbrüche}.
-@item page-limit-inter-system-space-factor
+Installierte Dateien:
+@file{ly/paper-defaults-init.ly}.
-Der Faktor, der von @code{page-limit-inter-system-space} verwendet
-wird. Standard: @code{1.4}. Einzelheiten siehe
-@ref{Vertikale Abstände zwischen Systemen}.
-@item page-spacing-weight
+@node \paper-Variablen für Seitenzahlen
+@unnumberedsubsubsec @code{\paper}-Variablen für Seitenzahlen
+@translationof \paper variables for page numbering
-Die relative Gewichtung von (vertikalem) Abstand auf der Seite und
-(horizontalem) Abstand innerhalb der Zeilen. Hohe Werte gewichten
-die vertikalen Abstände mehr. Standard: @code{#10}.
+Standardwerte, die hier nicht aufgelistet sind, finden sich in
+@file{ly/paper-defaults-init.ly}
-@item print-all-headers
+@table @code
-Wenn wahr, werden alle Einträge des Titelfeldes (@code{\header}-Umgebung)
-für jede Partitur ausgegeben. Normalerweise wird nur die
-Satzbezeichnung und die Opuszahl (@code{piece} und @code{opus})
-ausgegeben. Standard: @code{##f}.
+@item auto-first-page-number
+@funindex auto-first-page-number
+@cindex Seitenzahlen, automatische Nummerierung
-@item print-first-page-number
+Der Seitenumbruchsalgorithmus wird davon beeinflusst, ob die erste
+Seitenzahl gerade oder ungerade ist. Wenn die Variable auf wahr
+gesetzt wird, entscheidet der Seitenumbruchsalgorithmus selber,
+ob die Noten auf einer geraden oder ungeraden Seite beginnen sollen.
+Das hat dann zur Folge, dass die erste Seite entweder bleibt wie
+sie ist oder um eins erhöht wird. Standard: @code{#f}.
-Wenn wahr, wird auch auf der ersten Seite die Seitenzahl ausgegeben.
-Standard: @code{##f}.
+@item first-page-number
+@funindex first-page-number
+@cindex Sietenzahlen, erste definieren
-@item print-page-number
+Der Wert der Seitenzahl auf der ersten Seite.
-Wenn falsch, werden Seitenzahlen nicht ausgegeben. Standard:
-@code{##t}.
+@item print-first-page-number
+@funindex print-first-page-number
-@item ragged-bottom
+Wenn wahr, wird auch auf der ersten Seite die Seitenzahl ausgegeben.
+Standard: @code{#f}.
-Wenn wahr, werden die Systeme nicht gleichmäßig über die Seite
-verteilt sondern am oberen Seitenrand beginnend eng angeordnet.
-Das wirkt sich nicht auf die letzte Seite aus. Standard: @code{##f}.
+@item print-page-number
+@funindex print-page-number
+@cindex Seitenzahlen, unterdrücken
-Die Variable sollte auf wahr gesetzt werden für Stücke, die nur
-zwei oder drei Systeme pro Seite haben, wie etwa Orchesterpartituren.
+Wenn falsch, werden Seitenzahlen nicht ausgegeben.
-@item ragged-last
+@end table
-Wenn wahr, wird die letzte Notenzeile einer Partitur nicht bis
-zum Zeilenende durchgezogen, sondern entsprechend mit Noten
-gefüllt und dann abgebrochen. Standard: @code{##f}.
+@seealso
+Installierte Dateien:
+@file{ly/paper-defaults-init.ly}.
-@item ragged-last-bottom
+@knownissues
+Ungrade Seitenzahlen befinden sich immer auf der rechten Seite.
+Wenn Sie die Noten auf Seite 1 beginnen lassen wollen, müssen Sie
+eine leere Seite nach dem Deckblatt einfügen, damit die Noten
+auf der rechten Seite mit Seite 1 beginnen.
-Wenn falsch, werden Systeme gleichmäßig über die letzte Seite
-verteilt. Standard: @code{##t}.
-Stücke, die zwei oder mehr Seiten gut füllen, sollten die Option auf wahr
-gesetzt haben.
+@node Verschiedene \paper-Variablen
+@unnumberedsubsubsec Verschiedene @code{\paper}-Variablen
+@translationof Miscellaneous \paper variables
+@table @code
-Sie wirkt sich auch auf die letzte Seite von Buchteilen aus, d.h.
-Teilen eines Buches, die mit der @code{\bookpart}-Umgebung erstellt werden.
+@item page-spacing-weight
+@funindex page-spacing-weight
-@item ragged-right
+Die relative Gewichtung von (vertikalem) Abstand auf der Seite und
+(horizontalem) Abstand innerhalb der Zeilen. Hohe Werte gewichten
+die vertikalen Abstände mehr. Standard: @code{10}.
-Wenn wahr, werden Systeme nicht im Blocksatz gesetzt, sondern erhalten
-nur ihre normale Breite. Standard: @code{##f}.
+@item print-all-headers
+@funindex print-all-headers
-Wenn eine Partitur nur ein System hat, ist der Standardwert @code{##t}.
+Wenn wahr, werden alle Einträge des Titelfeldes (@code{\header}-Umgebung)
+für jede Partitur (@code{\score}) ausgegeben. Normalerweise wird nur die
+Satzbezeichnung und die Opuszahl (@code{piece} und @code{opus})
+ausgegeben. Standard: @code{#f}.
@item system-separator-markup
+@funindex system-separator-markup
Ein Beschriftungsobjekt, das zwischen zwei Systeme gesetzt wird. Das
wird oft in Orchesterpartituren eingesetzt. Standard: nicht gesetzt.
-
-Der Beschriftungsbefehl @code{\slashSeparator} kann für einen Trenner
+Der Beschriftungsbefehl @code{\slashSeparator}, definiert in
+@file{ly/titling-init.ly}, kann für einen Trenner
benutzt werden, etwa so:
-@lilypond[quote,ragged-right]
-#(set-default-paper-size "a6" 'landscape)
+@lilypond[quote,verbatim,noragged-right,line-width=30\mm]
+#(set-default-paper-size "a8")
+
\book {
- \score {
- \relative { c1 \break c1 }
- }
\paper {
system-separator-markup = \slashSeparator
}
+ \header {
+ tagline = ##f
+ }
+ \score {
+ \relative c'' { c1 \break c1 \break c1 }
+ }
}
@end lilypond
-@item system-count
+@end table
-Die Anzahl der Systeme, auf denen eine Partitur gesetzt werden soll.
-Standard: nicht gesetzt.
-@item systems-per-page
-@funindex systems-per-page
+@seealso
+Installierte Dateien:
+@file{ly/titling-init.ly}.
-Die Anzahl an Systemen, die auf jede Seite gesetzt werden sollen.
-Diese Option wird zur Zeit nur von dem @code{ly:optimal-breaking}-Alghoritmus
-unterstützt. Standard: nicht gesetzt.
+Schnipsel:
+@rlsr{Spacing}.
+
+
+@knownissues
+
+Die Standard-Kopfzeilendefinition setzt die Seitenzahl und das
+@code{instrument}-Feld aus der @code{\header}-Umgebung in eine
+Zeile.
+
+
+
+@node Partiturlayout
+@section Partiturlayout
+@translationof Score layout
+
+@menu
+* Die \layout-Umgebung
+* Die Notensystemgröße einstellen::
+@end menu
+
+
+@node Die \layout-Umgebung
+@subsection Die @code{\layout}-Umgebung
+@translationof The \layout block
+
+@cindex Partitur, Layout
+@cindex Layout, Partitur
+@funindex \layout
+
+Während die @code{\paper}-Umgebung Einstellungen für die Formatierung
+der Seiten eines gesamten Dokuments enthalten, enthält die
+@code{\layout}-Umgebung Einstellungen für einzelne Partituren. Um
+Layoutoptionen für Partituren global einzustellen, müssen sie in einer
+@code{\layout}-Umgebung gesetzt werden, die sich auf höchster Ebene in
+der Datei befindet. Um sie für einzelne Partituren festzulegen, muss die
+@code{\layout}-Umgebung innerhalb der @code{\score}-Umgebung nach den Noten
+eingetraten werden. Einstellungen, die in einer @code{\layout}-Umgebung
+vorkommen können, beinhalten:
+
+@itemize
+@item die @code{layout-set-staff-size}-Scheme-Funktion,
+@item Kontextveränderungen in @code{\context}-Umgebungen und
+@item @code{\paper}-Variablen, die das Aussehen einer Partitur beeinflussen.
+@end itemize
+
+Die @code{layout-set-staff-size}-Funktion wird im nächsten Abschnitt behandelt,
+@ref{Die Notensystemgröße einstellen}. Kontextveränderungen werden in einem
+eigenen Kapitel behandelt, siehe @ref{Umgebungs-Plugins verändern} and
+@ref{Die Standardeinstellungen von Kontexten ändern}. Die @code{\paper}-Variablen,
+die innerhalb der @code{\layout}-Umgebungen erlaubt sind, sind:
+
+@itemize
+
+@item
+@code{line-width}, @code{ragged-right} und @code{ragged-last}
+(siehe @ref{\paper-Variablen für Breite und Ränder})
+
+@item
+@code{indent} und @code{short-indent}
+(siehe @ref{\paper-Variablen für Verschiebungen und Einrückungen})
+
+@item
+@code{system-count}
+(siehe @ref{\paper-Variablen für den Zeilenumbruch})
+
+@end itemize
+
+Hier ist ein Beispiel für eine @code{\layout}-Umgebung:
+
+@example
+\layout @{
+ indent = 2\cm
+ \context @{
+ \StaffGroup
+ \override StaffGrouper #'staff-staff-spacing #'basic-distance = #8
+ @}
+ \context @{
+ \Voice
+ \override TextScript #'padding = #1
+ \override Glissando #'thickness = #3
+ @}
+@}
+@end example
-@end table
@seealso
+Notationsreferenz:
+@ref{Die Standardeinstellungen von Kontexten ändern},
+@ref{Die Notensystemgröße einstellen},
+@ref{Umgebungs-Plugins verändern}.
+
Schnipsel:
@rlsr{Spacing}.
-@knownissues
-
-Die Standard-Kopfzeilendefinition setzt die Seitenzahl und das
-@code{instrument}-Feld aus der @code{\header}-Umgebung in eine
-Zeile.
-
-Die Überschriften (aus der @code{\header}-Umgebung) werden als
-ein System interpretiert, sodass @code{ragged-bottom} und
-@code{ragged-last-bottom} Platz zwischen die Überschrift und
-das erste System der Partitur setzen.
-
-
-@node Notenlayout
-@section Notenlayout
-@translationof Music layout
-
-@menu
-* Die Notensystemgröße einstellen::
-* Partiturlayout::
-@end menu
-
@node Die Notensystemgröße einstellen
@subsection Die Notensystemgröße einstellen
Um die Systemgröße global für alle Partituren einer
Datei (bzw. einer @code{\book}-Umgebung) zu verändern,
-geht man wie folgt vor:
+wird @code{set-global-staff-size} benutzt:
@example
#(set-global-staff-size 14)
@example
\score@{
- ...
- \layout@{
- #(layout-set-staff-size 15)
+ @dots{}
+ \layout @{
+ #(layout-set-staff-size 15)
@}
@}
@end example
Notenlinien.
-@node Partiturlayout
-@subsection Partiturlayout
-@translationof Score layout
-
-@cindex Partitur, Layout
-@cindex Layout, Partitur
-
-@funindex \layout
-
-Während die @code{\paper}-Umgebung Einstellungen für die Formatierung
-der Seiten eines gesamten Dokuments enthalten, enthält die
-@code{\layout}-Umgebung Einstellungen für einzelne Parituren.
-
-@example
-\layout @{
- indent = 2.0\cm
- \context @{ \Staff
- \override VerticalAxisGroup #'minimum-Y-extent = #'(-6 . 6)
- @}
- \context @{ \Voice
- \override TextScript #'padding = #1.0
- \override Glissando #'thickness = #3
- @}
-@}
-@end example
-
-@seealso
-Notationsreferenz:
-@ref{Die Standardeinstellungen von Kontexten ändern}.
-
-Schnipsel:
-@rlsr{Spacing}.
-
-
@node Umbrüche
@section Umbrüche
@translationof Breaks
@cindex Umbrüche von Zeilen
Zeilenumbrüche werden normalerweise automatisch erstellt. Sie
-werden so ausgewählt, dass die Zeilen weder gedrängt nocht zu
+werden so ausgewählt, dass die Zeilen weder gedrängt noch zu
weit gespreizt wirken und aufeinander folgende Seiten einen
-ähnlichen Grauwert haben. In seltenen Fällen kann es jedoch
-nötig sein, manuell Zeilenumbrüche einzufügen. Das geschieht
-mit dem Befehl @code{\break}. Hiermit wird direkt nach dem Befehl
-ein Zeilenumbruch erzwungen. Zeilenumbrüche können jedoch nur
-am Ende von @qq{vollständigen} Takten stattfinden. Damit sind
-Takte gemeint, in welchen alle Noten mit der letzten Taktzeit
-komplett abgeschlossen sind und nicht über das Taktende hinausragen.
-Wenn Sie einen Zeilenumbruch an einer Stelle benötigen, an der
-keine Taktlinie vorliegt, können Sie mit @code{\bar ""} eine
+ähnlichen Grauwert haben.
+
+Einen manuellen Zeilenumbruch fügt man mit dem Befehl @code{\break}
+ein:
+
+@lilypond[quote,ragged-right,relative=2,verbatim]
+c4 c c c | \break
+c4 c c c |
+@end lilypond
+
+Normalerweise wird ein @code{\break} in der Mitte eines Takes ignoriert
+und eine Warnung ausgegeben. Um einen Zeilenumbruch in der Mitte eines
+Taktes zu erzwingen, können Sie mit @code{\bar ""} eine
unsichtbare Taktlinie hinzufügen, die dann den Zeilenumbruch
-erlaubt. Wiederum gilt, dass keine Noten überstehen dürfen,
-sonst wird diese unsichtbare Taktlinie ignoriert.
+erlaubt.
+
+@lilypond[quote,ragged-right,relative=2,verbatim]
+c4 c c
+\bar "" \break
+c |
+c4 c c c |
+@end lilypond
+
+Ein @code{\break} an einem Taktstrich wird auch ignoriert, wenn der letzte
+Takt mitten in einer Note endet, wenn etwa eine N-tole in unterschiedlichen
+Takten beginnt und endet. Damit @code{\break} auch in derartigen Situationen
+funktioniert, muss @code{Forbid_line_break_engraver} aus der
+@code{Voice}-Umgebung entfernt werden. Dabei sollte beachtet werden, dass
+manuell hervorgerufene Umbrüche parallel mit den Noten hinzugefügt werden
+müssen.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Voice \with {
+ \remove Forbid_line_break_engraver
+} \relative c'' {
+ <<
+ { c2. \times 2/3 { c4 c c } c2. | }
+ { s1 | \break s1 | }
+ >>
+}
+@end lilypond
+
+Genauso werden normalerweise Zeilenumbrüche auch verhindert, wenn Balken
+über die Taktenden hinausragen. Dieses Verhalten kann verändert werden,
+indem man @code{\override Beam #'breakable = ##t} einstellt:
+
+@lilypond[quote,ragged-right,relative=2,verbatim]
+\override Beam #'breakable = ##t
+c2. c8[ c | \break
+c8 c] c2. |
+@end lilypond
Mit dem Befehl @code{\noBreak} wird ein Zeilenumbruch an dem
entsprechenden Taktstrich verboten.
Die grundlegenden Einstellungen, die Einfluss auf die Zeilenlänge
haben, sind @code{indent} (Einzug) und @code{line-width}
(Zeilenbreite). Sie werden in der @code{\layout}-Umgebung
-einestellt. Der erste Befehl bestimmt den Einzug der ersten
+eingestellt. Der erste Befehl bestimmt den Einzug der ersten
Zeile, der zweite die Zeilenlänge der weiteren Notenzeilen.
-Wenn @code{ragged-right} eingestellt ist (als in der
+Wenn @code{ragged-right} eingestellt ist (also in der
@code{\layout}-Umgebung auf den Wert @code{#t} gesetzt wurde),
werden die Systeme linksbündig gesetzt und nicht bis zum
rechten Rand hin durchgezogen, sondern den Noten entsprechend
@example
\layout @{
indent = #0
-line-width = #150
+line-width = #150\mm
ragged-last = ##t
@}
@end example
Um Zeilenumbrüche zu erzwingen, die in festgelegten Intervallen
stattfinden, kann der Befehl @code{\break} in Kombination
-mit unsichtbaren Noten und einer Wiederholung eingesetzt
+mit unsichtbaren Noten und einer Wiederholung (@code{\repeat}) eingesetzt
werden. Das folgende Beispiel etwa setzt die nächsten
-28 Takte (im 4/4-Takt) in Zeilen zu jeweils 4 Takten:
+28 Takte (im 4/4-Takt) in Zeilen zu jeweils 4 Takten (die auch nur hier
+umgebrochen werden):
@example
-<< \repeat unfold 7 @{
- s1 \noBreak s1 \noBreak
- s1 \noBreak s1 \break @}
- @notation{Hier die Noten}
+<<
+ \repeat unfold 7 @{
+ s1 \noBreak s1 \noBreak
+ s1 \noBreak s1 \break
+ @}
+ @{ @var{Hier die Noten@dots{}} @}
>>
@end example
-Eine Zeilenumbruchkonfiguration kann auch als eine @code{.ly}-Datei
+Eine Zeilenumbruchkonfiguration kann auch als eine @file{.ly}-Datei
automatisch gespeichert werden. Damit kann die vertikale Ausrichtung
während eines zweiten Programmdurchlaufs angepasst werden um die
Seiten besser zu füllen. Diese Eigenschaft ist recht neu und
kompliziert. Mehr Einzelheiten finden sich in
@rlsr{Spacing}.
-@funindex \break
-@funindex \noBreak
-
@predefined
+@funindex \break
@code{\break},
+@funindex \noBreak
@code{\noBreak}.
@endpredefined
@seealso
-Referenz der Interna:
-@rinternals{LineBreakEvent}.
+Notationsreferenz:
+@ref{\paper-Variablen für den Zeilenumbruch}.
Schnipsel:
@rlsr{Spacing}.
-@knownissues
-
-Zeilenumbrüche können nur gesetzt werden, wenn eine
-@qq{richtige} Taktlinie vorliegt. Wenn eine Note
-über die Taktlinie übersteht, wie etwa in folgendem
-Beispiel:
-
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-c4 c2 << c2 {s4 \break } >> % this does nothing
-c2 c4 | % a break here would work
-c4 c2 c4 ~ \break % as does this break
-c4 c2 c4
-@end lilypond
-
-@noindent
-kann ein Umbruchbefehl nicht ausgeführt werden. Dieses
-Verhalten kann jedoch vermieden werden, indem der
-@code{Forbid_line_break_engraver} aus dem Stimmen-Kontext
-entfernt wird.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Voice \with {
- \remove Forbid_line_break_engraver
-} {
- c4 c2 << c2 {s4 \break } >> % now the break is allowed
- c2 c4
-}
-@end lilypond
-
-@noindent
-Entsprechend werden Umbrüche auch verhindert, wenn Balken über
-Taktlinien reichen. Das kann mit folgendem Befehl verhindert
-werden: @code{\override Beam #'breakable = ##t}.
+Referenz der Interna:
+@rinternals{LineBreakEvent}.
@node Seitenumbrüche
@subsection Seitenumbrüche
@translationof Page breaking
-@cindex Seiteumbrüche
+@cindex Seitenumbrüche
@cindex Umbrüche, Seite
Die Standardseitenumbrüche können verändert werden, indem
Es gibt auch vertikale Gegenstücke zu den Variablen
@code{ragged-right} und @code{ragged-last}:
@code{ragged-bottom} und @code{ragged-last-bottom}. Wenn diese
-Variablen auf @code{##t} gesetzt werden, werden im ersten
+Variablen auf @code{#t} (wahr) gesetzt werden, werden im ersten
Fall die Notensysteme auf allen Seiten eng nach oben orientiert
gesetzt werden. Im zweiten Fall bezieht sich dies nur auf die
letzte Seite.
-
-Zu Einzelheiten siehe @ref{Vertikale Abstände}.
+Zu Einzelheiten siehe @ref{Vertikale \paper-Variablen mit festen Abständen}.
Seitenumbrüche werden von der @code{page-breaking}-Funktion errechnet.
LilyPond kennt drei Algorithmen um Seitenumbrüche zu errechnen:
@}
@end example
-Der alte Algorithmus für Umbruch hat die Bezeichnung
-@code{optimal-page-breaks}. Wenn Sie Problememit der neuen
-Umbruchsfunktion haben, können sie die alte vorläufig wieder
-aktivieren.
-
@funindex \bookpart
-When a book has many scores and pages, the page breaking problem may be
-difficult to solve, requiring large processing time and memory. To ease
-the page breaking process, @code{\bookpart} blocks are used to divide
-the book into several parts: the page breaking occurs separately on each
-part. Different page breaking functions may also be used in different
-book parts.
+Wenn ein Buch (@code{\book}) viele Parituren und Seiten hat, kann die
+Seitenaufteilung schwer zu ermitteln sein und viel Zeit und Prozessorlast
+in Anspruch nehmen. Um den Seitenumbruchsprozess zu vereinfachen,
+werden @code{\bookpart}-Umgebungen benutzt, um das Buch in mehrere Teil
+zu trennen: Die Seitenumbrüche werden seperat für jeden Teil berechnet.
+Unterschiedliche Seitenumbruchsfunktionen können in unterschiedlichen
+Buchteilen benutzt werden.
@example
\bookpart @{
@}
@end example
-@funindex \pageBreak
-@funindex \noPageBreak
+
+
@predefined
+@funindex \pageBreak
@code{\pageBreak},
+@funindex \noPageBreak
@code{\noPageBreak}.
@endpredefined
@seealso
+Notationsreferenz:
+@ref{\paper-Variablen für den Seitenumbruch}.
+
Schnipsel:
@rlsr{Spacing}.
Ende jeder zweiten Seite befindet, damit der Musiker es leichter hat,
die Seite umzublättern ohne das Spielen zu Unterbrechen. Die
@code{ly:page-turn-breaking}-Funktion versucht, Seitenumbrüche zu
-finden, died das Stauchen oder Strecken von Zeilen minimieren und
-gleichzeitig auch noch Seitenumbrüchen an angegebenen Stellen
+finden, die das Stauchen oder Strecken von Zeilen minimieren und
+gleichzeitig auch noch Seitenumbrüchen an angegebenen Stellen
den Vorrang zu geben.
Die Funktion wird in zwei Schritten eingesetzt. Zunächst muss sie
@funindex minimumPageTurnLength
-Der @code{Page_turn_engraver} list die Kontexteigenschaft
+Der @code{Page_turn_engraver} liest die Kontexteigenschaft
@code{minimumPageTurnLength} um zu erkennen, wie lang eine Stelle
frei von Noten sein muss, damit ein Seitenumbruch in Frage kommt. Der
-Standardwert hierfür ist @code{#(ly:make-moment 1 1)}. Wenn Sie
+Standardwert hierfür ist @code{(ly:make-moment 1 1)}. Wenn Sie
Seitenumbrüche zum Umblättern ausschalten wollen, können Sie
einen sehr großen Wert angeben.
Die Seitenumblätter-Befehle @code{\pageTurn}, @code{\noPageTurn} und
@code{\allowPageTurn} können auch auf oberster Dateiebene benutzt
-werden, etwa zwischen Parituren und Textabschnitten.
+werden, etwa zwischen Partituren und Textabschnitten.
-@funindex \pageTurn
-@funindex \noPageTurn
-@funindex \allowPageTurn
@predefined
+@funindex \pageTurn
@code{\pageTurn},
+@funindex \noPageTurn
@code{\noPageTurn},
+@funindex \allowPageTurn
@code{\allowPageTurn}.
@endpredefined
@example
\paper @{
- #(define page-breaking ly:minimal-breaking)
+ page-breaking = #ly:minimal-breaking
@}
@end example
ragged-bottom = ##t
}
+music = \relative c'' { c8 c c c }
+
\score {
- \new Score \with {
- \override NonMusicalPaperColumn #'line-break-permission = ##f
- \override NonMusicalPaperColumn #'page-break-permission = ##f
- } {
- \new Staff {
- \repeat unfold 2 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 8 { c'8 c'8 c'8 c'8 } \pageBreak
- \repeat unfold 8 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 6 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 4 { c'8 c'8 c'8 c'8 } \break
- \repeat unfold 2 { c'8 c'8 c'8 c'8 }
+ \new Staff {
+ \repeat unfold 2 { \music } \break
+ \repeat unfold 4 { \music } \break
+ \repeat unfold 6 { \music } \break
+ \repeat unfold 8 { \music } \pageBreak
+ \repeat unfold 8 { \music } \break
+ \repeat unfold 6 { \music } \break
+ \repeat unfold 4 { \music } \break
+ \repeat unfold 2 { \music }
+ }
+ \layout {
+ \context {
+ \Score
+ \override NonMusicalPaperColumn #'line-break-permission = ##f
+ \override NonMusicalPaperColumn #'page-break-permission = ##f
}
}
}
@end lilypond
+
@seealso
Schnipsel:
@rlsr{Spacing}.
zusammen mit den Noten eingegeben.
@example
-\new Score @{
+music = \relative c'' @{ c4 c c c @}
+
+\score @{
\new Staff @{
- \repeat unfold 2 @{ c'4 c'4 c'4 c'4 @}
- \break
- \repeat unfold 3 @{ c'4 c'4 c'4 c'4 @}
+ \repeat unfold 2 @{ \music @} \break
+ \repeat unfold 3 @{ \music @}
@}
@}
@end example
Umbruchbefehle:
@lilypond[quote,verbatim]
-\new Score {
+music = \relative c'' { c4 c c c }
+
+\score {
+ \new Staff <<
+ \new Voice {
+ s1 * 2 \break
+ s1 * 3 \break
+ s1 * 6 \break
+ s1 * 5 \break
+ }
+ \new Voice {
+ \repeat unfold 2 { \music }
+ \repeat unfold 3 { \music }
+ \repeat unfold 6 { \music }
+ \repeat unfold 5 { \music }
+ }
+ >>
+}
+@end lilypond
+
+Mit dieser Herangehensweise kann der Code insbesondere
+dann klarer notiert werden, wenn man Einstellungen der
+@code{line-break-system-details}-Eigenschaft oder
+anderer Eigenschaften von
+@code{NonMusicalPaperColumnGrob} vornimmt (hierzu auch
+@ref{Vertikale Abstände}).
+
+@lilypond[quote,verbatim]
+music = \relative c'' { c4 c c c }
+
+\score {
\new Staff <<
- \new Voice {
- s1 * 2 \break
- s1 * 3 \break
- s1 * 6 \break
- s1 * 5 \break
- }
- \new Voice {
- \repeat unfold 2 { c'4 c'4 c'4 c'4 }
- \repeat unfold 3 { c'4 c'4 c'4 c'4 }
- \repeat unfold 6 { c'4 c'4 c'4 c'4 }
- \repeat unfold 5 { c'4 c'4 c'4 c'4 }
- }
+ \new Voice {
+ \overrideProperty "Score.NonMusicalPaperColumn"
+ #'line-break-system-details #'((Y-offset . 0))
+ s1 * 2 \break
+
+ \overrideProperty "Score.NonMusicalPaperColumn"
+ #'line-break-system-details #'((Y-offset . 35))
+ s1 * 3 \break
+
+ \overrideProperty "Score.NonMusicalPaperColumn"
+ #'line-break-system-details #'((Y-offset . 70))
+ s1 * 6 \break
+
+ \overrideProperty "Score.NonMusicalPaperColumn"
+ #'line-break-system-details #'((Y-offset . 105))
+ s1 * 5 \break
+ }
+ \new Voice {
+ \repeat unfold 2 { \music }
+ \repeat unfold 3 { \music }
+ \repeat unfold 6 { \music }
+ \repeat unfold 5 { \music }
+ }
>>
}
@end lilypond
-Mit dieser Herangehensweise kann der Code insbesondere
-dann klarer notiert werden, wenn man Einstellungen der
-@code{line-break-system-details}-Eigenschaft oder
-anderer Eigenschaften von
-@code{NonMusicalPaperColumnGrob} vornimmt (hierzu auch
-@ref{Vertikale Abstände}).
-@lilypond[quote,verbatim]
-\new Score {
- \new Staff <<
- \new Voice {
+@seealso
+Notationsreferenz:
+@ref{Vertikale Abstände}.
+
+Schnipsel:
+@rlsr{Spacing}.
+
+
+@node Vertikale Abstände
+@section Vertikale Abstände
+@translationof Vertical spacing
+
+@cindex vertikale Positionierung
+@cindex Positionierung, vertikal
+@cindex Abstände, vertikal
+
+Vertikale Abstände werden durch drei Eigenschaften
+bestimmt: wieviel Platz frei ist (etwa Papiergröße
+und Ränder), wieviel Platz zwischen Systemgruppen
+(engl. system) gesetzt werden soll und wieviel
+Platz zwischen Notensystemen (engl. staff, Pl. staves)
+innerhalb von Gruppen gesetzt wird.
+
+@menu
+* Flexible vertikale Abstände in Systemgruppen::
+* Explizite Positionierung von Systemen::
+* Vermeidung von vertikalen Zusammenstößen::
+@end menu
+
+
+@node Flexible vertikale Abstände in Systemgruppen
+@subsection Flexible vertikale Abstände in Systemgruppen
+@translationof Flexible vertical spacing within systems
+
+@cindex Abstand zwischen Notensystemen
+@cindex Notensystemabstand
+@cindex Platz zwischen Notensystemen
+@cindex Platz innerhalb von Systemgruppen
+@cindex Systemgruppen, Abstände innerhalb
+
+Drei unterschiedliche Mechanismen kontrollieren das flexible Abstandaufteilung
+in Systemgruppen, einer für jede der folgenden Kathegorien:
+
+@itemize
+
+@item
+@emph{ungruppierte Systeme},
+
+@item
+@emph{Systemgruppen} (Systeme innerhalb einer @code{staff-group} wie etwa
+@code{ChoirStaff} usw.) und
+
+@item
+@emph{Nicht-Notensystemzeilen} (wie etwa @code{Lyrics} (Gesangstext),
+@code{ChordNames} (Akkordbezeichnungen) usw.).
+
+@end itemize
+
+Die Höhe jeder Systemgruppe wird in zwei Schritten bestimmt. Zunächst
+werden alle Systeme anhand des vorhandenen Platzes aufgeteilt. Dann
+werden die nicht-Notensysteme (also Akkorde oder Gesangstext) zwischen
+den Systemen verteilt.
+
+Es ist zu beachten, dass der Platzverteilungsmechanismus, der in diesem
+Abschnitt behandelt wird, nur die vertikale Platzierung von Systemen und
+nicht-Systemzeilen in einzelnen Systemgruppen behandelt. Die vertikale
+Platzierung zwischen einzelnen Systemgruppen, Partituren, Beschriftungen
+usw. und den Rändern wird durch @code{\paper}-Variablen kontrolliert, die
+@ref{Vertikale \paper-Variablen mit flexiblen Abständen}.
+
+@menu
+* Eigenschaften für Abstände innerhalb von Systemgruppen::
+* Abstände von nicht gruppierten Notensystemen::
+* Abstände von gruppierten Notensystemen::
+* Abstände von nicht-Notensystemzeilen::
+@end menu
+
+
+@node Eigenschaften für Abstände innerhalb von Systemgruppen
+@unnumberedsubsubsec Eigenschaften für Abstände innerhalb von Systemgruppen
+@translationof Within-system spacing properties
+
+@funindex staff-affinity
+@funindex staffgroup-staff-spacing
+@funindex staff-staff-spacing
+@funindex nonstaff-unrelatedstaff-spacing
+@funindex nonstaff-relatedstaff-spacing
+@funindex nonstaff-nonstaff-spacing
+@funindex default-staff-staff-spacing
+@funindex minimum-Y-extent
+@funindex extra-offset
+@funindex self-alignment-X
+@funindex X-offset
+@funindex VerticalAxisGroup
+
+Der vertikalen Platzierungsmechanismen für Abstände innerhalb von Systemgruppen
+werden durch zwei Gruppen von Grob-Eigenschaften kontrolliert. Die erste
+Gruppe ist mit dem @code{VerticalAxisGroup}-Grob verknüpft, der von allen
+Notensystemen und Nicht-Notensystemzeilen erstellt wird. Die zweite Gruppe
+ist mit dem @code{StaffGrouper}-Grob verknüpft, der von Systemgruppen erstellt
+werden kann, aber nur, wenn das explizit verlangt wird. Die einzelnen Eigenschaften
+werden am Ende dieses Abschnitts beschrieben.
+
+Die Bezeichnungen dieser Eigenschaften (mit Außnahmen von @code{staff-affinity})
+haben das Format @code{@var{Element1}-@var{Element2}-spacing}, wobei
+@code{@var{Element1}} und @code{@var{Element2}} die Elemente sind, deren
+Abstände eingestellt werden sollen. Dabei ist allerdings zu beachten, dass
+@code{@var{Element2}} sich nicht notwendigerweise unterhalb von
+@code{@var{Element1}} befindet; beispielsweise
+@code{nonstaff-relatedstaff-spacing} (Nicht-Notensystem-verwandtesNotensystem)
+misst von dem Nicht-Notensystem nach oben, wenn @code{staff-affinity}
+(Richtung, an der sich ein System ausrichtet) auf @code{UP} (nach oben)
+eingestellt ist.
+
+Jeder Abstand wird zwischen den @emph{Referenzpunkten} der zwei Objekten
+gemessen. Der Referenzpunkt eines Notensystems ist die vertikale Mitte
+seines @code{StaffSymbol}-Objekts (also die Mittellinie, wenn
+@code{line-count} (Notenlinienzähler) ungrade ist, oder der mittlere
+Zwischenraum, wenn @code{line-count} grade ist). Die Referenzpunkte für
+einzelne Nicht-Notensystemzeilen ergibt sich aus der folgenden Tabelle:
+
+@multitable {Nicht-Notensystemzeile} {Referenzpunkt}
+@headitem Nicht-Notensystemzeile @tab Referenzpunkt
+@item @code{ChordNames} @tab Grundlinie
+@item @code{NoteNames} @tab Grundlinie
+@item @code{Lyrics} @tab Grundlinie
+@item @code{Dynamics} @tab vertikale Mitte
+@item @code{FiguredBass} @tab höchster Punkt
+@item @code{FretBoards} @tab Oberlinie
+@end multitable
+
+Im nächsten Bild zeigen horizontale Striche die Positionen dieser
+Referenzpunkte an:
+
+@lilypond[quote,noragged-right,line-width=110\mm]
+#(define zero-space '((padding . -inf.0) (basic-distance . 0)))
+
+alignToZero = \with {
+ \override VerticalAxisGroup #'nonstaff-relatedstaff-spacing = #zero-space
+ \override VerticalAxisGroup #'nonstaff-nonstaff-spacing = #zero-space
+}
+lowerCaseChords = \with {
+ chordNameLowercaseMinor = ##t
+}
+staffAffinityDown = \with {
+ \override VerticalAxisGroup #'staff-affinity = #DOWN
+}
+labelContext =
+#(define-music-function
+ (parser location context)
+ (string?)
+ #{ s1*0^\markup { \typewriter #context } #})
+
+\layout {
+ \context { \Dynamics \alignToZero }
+ \context { \FiguredBass \alignToZero }
+ \context { \Lyrics \alignToZero }
+ \context { \NoteNames \alignToZero \staffAffinityDown }
+ \context { \ChordNames \alignToZero
+ \staffAffinityDown
+ \lowerCaseChords }
+ \context { \FretBoards \alignToZero \staffAffinityDown }
+ \context { \Score
+ \override BarLine #'stencil = ##f
+ \override DynamicText #'self-alignment-X = #-1
+ \override FretBoard #'X-offset = #1.75
+ \override InstrumentName #'minimum-Y-extent = #'(-2 . 2)
+ \override InstrumentName #'extra-offset = #'(0 . -0.5)
+ \override TextScript #'minimum-Y-extent = #'(-2 . 3)
+ \override TimeSignature #'stencil = ##f
+ }
+}
+
+%% These contexts have reference points at the baseline:
+%% ChordNames, NoteNames, and Lyrics
+<<
+ \new ChordNames { \chords { g1:m } }
+ \new NoteNames { s1 | g1 | }
+ \new RhythmicStaff {
+ \set RhythmicStaff.instrumentName = #"baseline "
+ \textLengthOn
+ \labelContext "ChordNames " s1 |
+ \labelContext "NoteNames " s1 |
+ \labelContext "Lyrics" s1 |
+ }
+ \new Lyrics { \lyrics { \skip 1*2 | ghijk1 | } }
+>>
+
+%% The reference point for Dynamics is its vertical center
+<<
+ \new RhythmicStaff {
+ \set RhythmicStaff.instrumentName = #"vertical center "
+ \labelContext "Dynamics" s1*3
+ }
+ \new Dynamics { s1\mp s\fp }
+>>
+
+%% The reference point for FiguredBass is its highest point
+<<
+ \new RhythmicStaff {
+ \set RhythmicStaff.instrumentName = #"highest point "
+ \labelContext "FiguredBass" s1
+ }
+ \new FiguredBass { \figuremode { <6 5>1 } }
+>>
+
+%% The reference point for FretBoards is the top line
+\include "predefined-guitar-fretboards.ly"
+<<
+ \new FretBoards { \chordmode { e1 } }
+ \new RhythmicStaff {
+ \set RhythmicStaff.instrumentName = #"top line "
+ \labelContext "FretBoards " s1
+ }
+>>
+@end lilypond
+
+Jeder der vertikalen Platzierungs-Grobeigenschaften (außer
+@code{staff-affinity}) benutzt die gleiche Alistenstruktur
+wie die @code{\paper}-Variablen, behandelt in
+@ref{Vertikale \paper-Variablen mit flexiblen Abständen}. Besondere
+Methoden um Alisten zu verändern finden sich in
+@ref{Alisten verändern}. Grob-Eigenschaften sollten mit
+dem @code{\override}-Befehle innerhalb einer @code{\score}-
+oder @code{\layout}-Umgebung angepasst werden, nicht innerhalb einer
+@code{\paper}-Umgebung.
+
+Das folgende Beispiel zeigt die beiden Arten, Alisten zu modifizieren.
+Der erste Aufruf verändert nur einen Schlüsselwert einzlen, während
+der zweite die Eigenschaft komplett neu definiert:
+
+@example
+\new Staff \with @{
+ \override VerticalAxisGroup #'default-staff-staff-spacing
+ #'basic-distance = #10
+@} @{ @dots{} @}
+
+\new Staff \with @{
+ \override VerticalAxisGroup #'default-staff-staff-spacing =
+ #'((basic-distance . 10)
+ (minimum-distance . 9)
+ (padding . 1)
+ (stretchability . 10))
+@} @{ @dots{} @}
+@end example
+
+Um Platzierungseinstellungen global vorzunehmen, müssen sie in der
+@code{\layout}-Umgebung vorgenommen werden:
+
+@example
+\layout @{
+ \context @{
+ \Staff
+ \override VerticalAxisGroup #'default-staff-staff-spacing
+ #'basic-distance = #10
+ @}
+@}
+@end example
+
+Standardeinstellungen für die vertikalen Platzierungs-Grobeigenscahften
+finden sich in @rinternals{VerticalAxisGroup} und
+@rinternals{StaffGrouper} aufgelistet. Standardveränderungen für bestimmte
+Typen von Nicht-Notensystemzeilen finden sich im relevanten Abschnitt in
+in @rinternals{Contexts} aufgelistet.
+
+
+@subsubheading Eigenschaften des @code{VerticalAxisGroup}-Grobs
+
+@code{VerticalAxisGroup}-Eigenschaften werden normalerweise mit einem
+@code{\override}-Befehl auf @code{Staff}-(Notensystem-)Ebene (oder
+entsprechend) vorgenommen.
+
+@table @code
+@item staff-staff-spacing
+System-System-Platzierung
+
+Wird benutzt, um den Abstand zwischen dem aktuellen Notensystem und dem
+Notensystem direkt darunter in der gleichen Notensystemgruppe zu bestimmen,
+auch wenn eine oder mehrere Nicht-Notensystemzeilen (wie etwa @code{Lyrics})
+dazwischen stehen. Gilt nicht für das unterste System einer Systemgruppe.
+
+Die Eigenschaft @code{staff-staff-spacing} einer @code{VerticalAxisGroup}
+ist eine Scheme-Funktion, welche die Eigenschaften vom @code{StaffGrouper}-Grob
+den Notensystemen zuweist, wenn sie einer Systemgruppe angehören, bzw.
+die @code{default-staff-staff-spacing}-Eigenschaft bei einem einzelnen Notensystem.
+Dadurch können Systeme unterschiedlich in Abhängigkeit von ihrer Zugehörigkeit
+zu einer Gruppe (StaffGroup) platziert werden. Wenn gleichmäßige Aufteilung
+ohne Berücksichtigung von Gruppierungen gewünscht ist, kann diese Funktion durch
+eine flexible Platzierungs-Aliste ersetzt werden, wobei man die vollständige
+Redefinition auf die oben gezeigte Weise vornehmen muss.
+
+@item default-staff-staff-spacing
+Normale-System-System-Platzierung
+
+Eine flexible Platzierungs-Aliste, die den Wert von @code{staff-staff-spacing}
+für ungruppierte Notensysteme einstellt, es sei denn,
+@code{staff-staff-spacing} wirde explizit mit @code{\override} eingestellt.
+
+@item staff-affinity
+System-Anziehung
+
+Die Richtung des Systems, die benutzt wird, um die aktuelle
+Nicht-Notensystemzeile zu platzieren. Mögliche Werte sind
+@code{UP} (nach oben), @code{DOWN} (nach unten) und
+@code{CENTER} (mittig). Wenn @code{CENTER} wird die Nicht-Notensystemzeile
+vertikal mittig zwischen den beiden nächsten Systemen oben und unten
+platziert, außer Zusammenstöße und andere Platzierungsprobleme verhindern
+das. Aufeinanderfolgende Nicht-Notensystemzeilen sollten nicht-aufsteigende
+@code{staff-affinity} von oben nach unten haben; also ein Nicht-Notensystemzeile
+mit @code{UP} sollte nicht direkt auf eine mit @code{DOWN} folgen.
+Nicht-Notensystemzeilen über einem Notensystem sollten @code{DOWN}
+benutzen, unter einem Notensystem dagegen @code{UP}. Wenn
+@code{staff-affinity} für eine Notensystem eingestellt wird, wird es wie
+eine Nicht-Notensystemzeile behandelt. Wenn @code{staff-affinity}
+auf @code{#f} gesetzt wird, wird eine Nicht-Notensystemzeile wie ein
+Notensystem behandelt. Wird @code{staff-affinity} auf @code{UP},
+@code{CENTER} oder @code{DOWN} gesetzt, wird das Notensystem als
+Nicht-Notensystemzeile plaziert.
+
+
+@item nonstaff-relatedstaff-spacing
+Nicht-Notensystem-verwandtesSystem-Platzierung
+
+Der Abstand zwischen der aktuellen Nicht-Notensystemzeile und
+dem nächsten Notensystem in der Richtung von @code{staff-affinity},
+wenn keine Nicht-Notensystemzeilen dazwischen auftreten und @code{staff-affinity}
+entweder @code{UP} oder @code{DOWN} ist. Wenn @code{staff-affinity}
+@code{CENTER} ist, dann wird @code{nonstaff-relatedstaff-spacing} für die
+nächsten Notensysteme auf @emph{beiden} Seiten benutzt, auch wenn andere
+Nicht-Notensystemzeilen zwischen der aktuellen und einem der Notensystem
+auftreten. Das heißt, dass die Platzierung eine Nicht-Notensystemzeile
+sowohl von den umliegenden Notensystemen als auch den umliegenden
+Nicht-Notensystemzeilen abhängt. Wenn @code{stretchability} einer dieser
+Platzierungstypen auf einen kleinen Wert gesetzt wird, dominiert diese
+Platzierung. Wird es dagegen auf einen großen Wert gesetzt, hat die
+Platzierung dieses Objekts nur einen kleinen Einfluss.
+
+@item nonstaff-nonstaff-spacing
+Nicht-Notensystemzeile-Nicht-Notensystemzeile-Platzierung
+
+Der Abstand zwischen der aktuellen Nicht-Notensystemzeile und der
+Nicht-Notensystemzeile in der Richtung von @code{staff-affinity},
+wenn beide sich auf der gleichen Seite des verwandten Notensystems
+befinden und @code{staff-affinity} entweder @code{UP} oder @code{DOWN} ist.
+
+@item nonstaff-unrelatedstaff-spacing
+Nicht-Notensystemzeile-Nicht-verwandtesSystem-Platzierung
+
+Der Abstand zwischen der aktuellen Nicht-Notensystemzeile und
+dem Notensystem in der gegenüberliegenden Richtung von @code{staff-affinity},
+wenn keine anderen Nicht-Notensystemzeilen dazwischen auftreten und
+@code{staff-affinity} entweder @code{UP} oder @code{DOWN} ist. Das kann
+benutzt werden, um einen Minimalfüllabstand (padding) zwischen einer
+@code{Lyrics}-Gesangstextzeile und dem zugehörigen Notensystem zu verlangen.
+@end table
+
+
+@subsubheading Eigenschaften des @code{StaffGrouper}-Grobs
+
+@code{StaffGrouper}-Eigenschaften werden normalerweise mit einem
+@code{\override}-Befehl auf @code{StaffGroup}-Ebene (oder
+entsprechend) eingestellt.
+
+@table @code
+@item staff-staff-spacing
+Notensystem-Notensystem-Abstand
+
+Der Abstand zwischen zwei aufeinanderfolgenden Notensystemen in
+der aktuellen @code{StaffGroup}. Die @code{staff-staff-spacing}-Eigenschaft
+des @code{VerticalAxisGroup}-Grobs eines einzelnen Notensytems
+kann mit @code{\override} in andere Platzierungswerte für dieses Notensystem
+geändert werden.
+
+@item staffgroup-staff-spacing
+Systemgruppe-System-Abstand
+
+Der Abstand zwischen dem letzten Notensystem der aktuellen @code{StaffGroup}
+und dem Notensystem dirket darunter in der selben Notensystemgruppe,
+auch wenn eine oder mehrere Nicht-Notensystemzeilen (wie etwa
+Gesangstext) zwischen den zwei Notensystemen vorkommen. Gilt nicht
+für das letzte Notensystem einer Systemgruppe. Die
+@code{staff-staff-spacing}-Eigenschaft des @code{VerticalAxisGroup}-Grobs
+individueller Notensysteme kann mit @code{\override} in andere Platzierungswerte
+für dieses Notensystem geändert werden.
+@end table
+
+@seealso
+Notationsreferenz:
+@ref{Vertikale \paper-Variablen mit flexiblen Abständen},
+@ref{Alisten verändern}.
+
+Referenz der Interna:
+@rinternals{Contexts},
+@rinternals{VerticalAxisGroup},
+@rinternals{StaffGrouper}.
+
+Installierte Dateien:
+@file{ly/engraver-init.ly},
+@file{scm/define-grobs.scm}.
- \overrideProperty "Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 0))
- s1 * 2 \break
- \overrideProperty "Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 35))
- s1 * 3 \break
+@node Abstände von nicht gruppierten Notensystemen
+@unnumberedsubsubsec Abstände von nicht gruppierten Notensystemen
+@translationof Spacing of ungrouped staves
- \overrideProperty "Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 70))
- s1 * 6 \break
+@emph{Notensysteme} (wie etwa @code{Staff}, @code{DrumStaff},
+@code{TabStaff} usw.) sind Kontexte, die eine oder mehrere Stimmen-Kontexte
+enthalten, aber keine anderen Notensysteme enthalten können.
- \overrideProperty "Score.NonMusicalPaperColumn"
- #'line-break-system-details #'((Y-offset . 105))
- s1 * 5 \break
- }
- \new Voice {
- \repeat unfold 2 { c'4 c'4 c'4 c'4 }
- \repeat unfold 3 { c'4 c'4 c'4 c'4 }
- \repeat unfold 6 { c'4 c'4 c'4 c'4 }
- \repeat unfold 5 { c'4 c'4 c'4 c'4 }
- }
- >>
+Folgende Eigenschaften beeinflussen die Abstände von @emph{nicht gruppierten}
+Notensystemen:
+
+@itemize
+@item @code{VerticalAxisGroup}-Eigenschaften:
+@itemize
+@item @code{default-staff-staff-spacing}
+@item @code{staff-staff-spacing}
+@end itemize
+@end itemize
+
+Diese Eigenschaften sind einzlen oben behandelt worden, siehe
+@ref{Eigenschaften für Abstände innerhalb von Systemgruppen}.
+
+Zusätzliche Eigenschaften kommen hinzu für Notensysteme, die Teil
+einer Gruppieren (@code{StaffGroup}) werden, siehe
+@ref{Abstände von gruppierten Notensystemen}.
+
+Folgendes Beispiel zeigt, wie die @code{default-staff-staff-spacing}-Eigenschaft
+sich auf die Platzierung von nicht-gruppierten Notensystemen auswirken kann.
+Wenn man die gleichen @code{\override}-Befehle auf @code{staff-staff-spacing}
+anwendet, ergäbe das den selben Effekt, würde sich aber auch in Fällen auswirken,
+in denen die Systeme gruppiert sind.
+
+@lilypond[verbatim,quote,staffsize=16]
+\layout {
+ \context {
+ \Staff
+ \override VerticalAxisGroup #'default-staff-staff-spacing =
+ #'((basic-distance . 8)
+ (minimum-distance . 7)
+ (padding . 1))
+ }
}
-@end lilypond
+<<
+ % The very low note here needs more room than 'basic-distance
+ % can provide, so the distance between this staff and the next
+ % is determined by 'padding.
+ \new Staff { b,2 r | }
+
+ % Here, 'basic-distance provides enough room, and there is no
+ % need to compress the space (towards 'minimum-distance) to make
+ % room for anything else on the page, so the distance between
+ % this staff and the next is determined by 'basic-distance.
+ \new Staff { \clef bass g2 r | }
+
+ % By setting 'padding to a negative value, staves can be made to
+ % collide. The lowest acceptable value for 'basic-distance is 0.
+ \new Staff \with {
+ \override VerticalAxisGroup #'default-staff-staff-spacing =
+ #'((basic-distance . 3.5)
+ (padding . -10))
+ } { \clef bass g2 r | }
+ \new Staff { \clef bass g2 r | }
+>>
+@end lilypond
@seealso
-Notationsreferenz:
-@ref{Vertikale Abstände}.
+Installierte Dateien:
+@file{scm/define-grobs.scm}.
Schnipsel:
@rlsr{Spacing}.
+Referenz der Interna:
+@rinternals{VerticalAxisGroup}.
-@node Vertikale Abstände
-@section Vertikale Abstände
-@translationof Vertical spacing
-
-@cindex vertikale Positionierung
-@cindex Positionierung, vertikal
-@cindex Abstände, vertikal
-
-Vertikale Abstände werden durch drei Eigenschaften
-bestimmt: wieviel Platz frei ist (etwa Papiergröße
-und Ränder), wieviel Platz zwischen Systemgruppen
-(engl. system) gesetzt werden soll und wieviel
-Platz zwischen Notensystemen (engl. staff, Pl. staves)
-innerhalb von Gruppen gesetzt wird.
-@menu
-* Vertikale Abstände innerhalb eines Systems::
-* Vertikale Abstände zwischen Systemen::
-* Explizite Positionierung von Systemen::
-* Vertikale Abstände mit zwei Durchgängen::
-* Vermeidung von vertikalen Zusammenstößen::
-@end menu
+@node Abstände von gruppierten Notensystemen
+@unnumberedsubsubsec Abstände von gruppierten Notensystemen
+@translationof Spacing of grouped staves
+In Orchesterpartituren und anderen großen Partituren werden Notensysteme
+normalerweise in Gruppen zusammengefasst. Der Platz zwischen Gruppen
+ist normalerweise größer als der Zwischenraum zwischen einzlenen
+Notensystemen der gleichen Gruppe.
-@node Vertikale Abstände innerhalb eines Systems
-@subsection Vertikale Abstände innerhalb eines Systems
-@translationof Vertical spacing inside a system
+@emph{Gruppierte Notensysteme} (wie @code{StaffGroup}, @code{ChoirStaff},
+@code{GrandStaff} usw.) sind Kontexte, die mehr als ein Notensystem
+gleichzeitig enthalten können.
-@cindex Abstand zwischen Notensystemen
-@cindex Notensystemabstand
-@cindex Platz zwischen Notensystemen
-@cindex Platz innerhalb von Systemgruppen
-@cindex Systemgruppen, Abstände innerhalb
+Folgende Eigenschaften beeinflussen die Platzierung von Notensystemen
+innerhalb von Gruppen:
-Die Höhe jeder Notensystemgruppe (engl. system) wird automatisch errechnet.
-Um einzelne Notensysteme daran zu hindern, sich zu überschneiden,
-werden Minimalabstände festgelegt. Indem man diese ändert,
-können die Systeme enger zusammen gerückt werden. Dadurch
-brauchen die Gruppen weniger Platz und es passen mehr Gruppen
-auf eine Seite.
-
-Normalerweise werden die Notensysteme vertikal gestapelt. Damit
-die Systeme einen bestimten Abstand einhalten, haben sie
-Füllabstände, die in der Eigenschaft @code{minimum-Y-extent}
-definiert sind. Wenn diese Eigenschaft für ein
-@code{VerticalAxisGroup}-Objekt gesetzt wird, kann eingestellt
-werden, wieviel Platz nach unten oder oben die vertikale Linie
-(also das Notensystem oder eine Textzeile) einnimmt. Die
-Eigenschaft braucht ein Zahlenpaar; der Standardwert ist
-@code{#'(-4 . 4)}. Um also ein Notensystem schmaler zu machen,
-kann man schreiben:
+@itemize
+@item @code{VerticalAxisGroup}-Eigenschaften:
+@itemize
+@item @code{staff-staff-spacing}
+@end itemize
+@item @code{StaffGrouper}-Eigenschaften:
+@itemize
+@item @code{staff-staff-spacing}
+@item @code{staffgroup-staff-spacing}
+@end itemize
+@end itemize
-@example
-\override Staff.VerticalAxisGroup #'minimum-Y-extent = #'(-3 . 3)
-@end example
+Diese Grob-Eigenschaften sind weiter oben einzeln beschrieben, siehe
+@ref{Eigenschaften für Abstände innerhalb von Systemgruppen}.
-@noindent
-Damit wird die vertikale Größe des Systems auf jeweils drei
-Notenlinienzwischenräume nach oben und unten von der Systemmitte
-aus eingestellt. Der Wert @code{(-3 . 3)} wird als ein
-Intervall ausgewertet, dessen Zentrum bei 0 liegt; deshalb
-ist die erste Zahl immer negativ. Die Zahlen müssen nicht
-gleich sein: man kann etwa die Ausdehnung nach unten vergrößern,
-indem man @code{(-6 . 4)} setzt.
-
-Nachdem die Seitenumbrüche bestimmt wurden, wird die vertikale
-Platzverteilung innerhalb jeder Systemgruppe neu ausgewertet
-um die Seite so gleichmäßig wie möglich zu füllen. Wenn auf
-einer Seite viel Platz übrigbleibt, werden die Gruppen etwas
-gedehnt um die Seite besser auszufüllen. Die Größe dieser
-Dehnung kann mit der @code{max-stretch}-Eigenschaft
-des @code{VerticalAlignment}-Grobs eingestellt werden.
-Standardmäßig hat @code{max-stretch} den Wert 0, sodass
-die Dehnung ausgeschaltet ist. Um sie einzuschalten, kann
-als guter Wert für @code{max-stretch} der Wert von
-@code{ly:align-interface::calc-max-stretch} eingesetzt werden.
-
-In manchen Situationen sollen zwar die meisten Systeme gedehnt
-werden, einige Gruppen sollen aber einen festen Abstand einhalten.
-Das kann etwa der Fall sein, wenn ein Klaviersystem in der
-Mitte einer Orchesterpartitur vorkommt. Mit der
-@code{keep-fixed-while-stretching}-Eigenschaft des
-@code{VerticalAxisGroup}-Objektes kann das erreicht werden.
-Wenn sie auf @code{##t} gesetzt wird, wird das entsprechende
-System (oder die Textzeile) nicht von der Zeile entfernt, die
-sich direkt darüber befindet. Man müsste diese Einstellung
-als beispielsweise für das zweite Notensystem eines Klaviersystems
-vornehmen:
-
-@lilypond[verbatim]
-#(set-default-paper-size "a6")
-#(set-global-staff-size 14.0)
+Das folgende Beispiel zeigt, wie Eigenscchaften des
+@code{StaffGrouper}-Grobs die Platzierung von gruppierten Notensystemen
+beeinflussen kann:
-\book {
-\paper {
- ragged-last-bottom = ##f
+@lilypond[verbatim,quote,staffsize=16]
+\layout {
+ \context {
+ \Score
+ \override StaffGrouper #'staff-staff-spacing #'padding = #0
+ \override StaffGrouper #'staff-staff-spacing #'basic-distance = #1
+ }
}
-\new Score \with
-{
- \override VerticalAlignment #'max-stretch = #ly:align-interface::calc-max-stretch
-}
-{
-\new GrandStaff
<<
- \new StaffGroup
- <<
- \new Staff {c' d' e' f'}
- \new Staff {c' d' e' f'}
- \new Staff {c' d' e' f'}
- >>
-
- \new PianoStaff
- <<
- \new Staff {c' d' e' f'}
- \new Staff \with {
- \override VerticalAxisGroup #'keep-fixed-while-stretching = ##t
- }
- {c' d' e' f'}
+ \new PianoStaff \with {
+ \override StaffGrouper #'staffgroup-staff-spacing #'basic-distance = #20
+ } <<
+ \new Staff { c'1 }
+ \new Staff { c'1 }
>>
- \new StaffGroup
- <<
- \new Staff {c' d' e' f'}
- \new Staff {c' d' e' f'}
+ \new StaffGroup <<
+ \new Staff { c'1 }
+ \new Staff { c'1 }
>>
>>
-}
-}
@end lilypond
-Die vertikale Ausrichtung von Notensystemen wird
-von dem @code{VerticalAlignment}-Objekt vorgenommen.
-Die Kontextparameter für die vertikale Ausdehnung
-werden für den @code{Axis_group_engraver} angegeben.
-
@seealso
+Installierte Dateien:
+@file{scm/define-grobs.scm}.
+
Schnipsel:
@rlsr{Spacing}.
-@c @lsr{spacing,page-spacing.ly},
-@c @lsr{spacing,alignment-vertical-spacing.ly}.
-
Referenz der Interna:
-@rinternals{VerticalAlignment},
-@rinternals{Axis_group_engraver}.
+@rinternals{VerticalAxisGroup},
+@rinternals{StaffGrouper}.
-@node Vertikale Abstände zwischen Systemen
-@subsection Vertikale Abstände zwischen Systemen
-@translationof Vertical spacing between systems
+@node Abstände von nicht-Notensystemzeilen
+@unnumberedsubsubsec Abstände von nicht-Notensystemzeilen
+@translationof Spacing of non-staff lines
-Der Platz zwischen Notensystembruppen wird von vier
-Variablen in der @code{\paper}-Umgebung kontrolliert:
+@emph{Nicht-Notensystemzeilen} (wie @code{Lyrics}, @code{ChordNames}
+usw.) sind Kontexte, deren Layoutobjekte wie Notensysteme gesetzt
+werden (also als horizontale Zeilen zwischen Notensystemen). Genau
+gesagt sind Nicht-Notensystemzeilen Nicht-Notensystemkontexte, die
+ein @code{VerticalAxisGroup}-Layoutobjekt erstellen.
-@example
-\paper @{
- between-system-space = 1.5\cm
- between-system-padding = #1
- ragged-bottom=##f
- ragged-last-bottom=##f
-@}
-@end example
+Folgende Eigenschaften beeinflussen die Abstände von Nicht-Notensystemzeilen:
-Wenn nur ein paar schmale Systeme auf eine Seite gesetzt werden,
-kann die vertikale Platzverteilung recht negativ ausfallen, so
-dass etwa ein System ganz oben auf der Seite und das nächste
-unten auf der Seite erscheint, mit einer großen Lücke dazwischen.
-Um derartige Situationen zu umgehen, kann der Platz, der zwischen
-Gruppen eingefügt wird, begrenzt werden. Dieses Verhalten wird
-aktiviert, indem die @code{page-limit-inter-system-space}-Variable
-in der @code{\paper}-Umgebung auf @code{##t} gesetzt wird. Die
-Variable @code{page-limit-inter-system-space-factor} bestimmt,
-um wieviel der Platz zwischen Gruppen gedehnt werden darf: Bei
-einem Wert von @code{1.3} etwa darf der Platz 30% größer sein
-als er es wäre, wenn die Seite mit der Option @code{ragged-bottom}
-gesetzt worden wäre.
-
-Im folgenden Beispiel würde das zweite System der ersten Seite
-unten auf der Seite gesetzt werden, wenn der Platz zwischen
-den Systemen nicht begrenzt wäre. Weil aber die Begrenzung
-eingesetzt wurde, wird das zweite System näher am ersten
-platziert. Wenn @code{page-limit-inter-system-space-factor}
-auf @code{1} gesetzt wird, wäre die Platzverteilung die gleiche
-auf einer Seite mit @code{ragged-bottom}, wie etwa die letzte
-Seite einer Partitur.
-
-@lilypond[verbatim]
-#(set-default-paper-size "a6")
-\book {
- \paper {
- page-limit-inter-system-space = ##t
- page-limit-inter-system-space-factor = 1.3
-
- oddFooterMarkup = \markup "page bottom"
- evenFooterMarkup = \markup "page bottom"
- oddHeaderMarkup = \markup \fill-line {
- "page top" \fromproperty #'page:page-number-string }
- evenHeaderMarkup = \markup \fill-line {
- "page top" \fromproperty #'page:page-number-string }
+@itemize
+@item @code{VerticalAxisGroup}-Eigenschaften:
+@itemize
+@item @code{staff-affinity}
+@item @code{nonstaff-relatedstaff-spacing}
+@item @code{nonstaff-nonstaff-spacing}
+@item @code{nonstaff-unrelatedstaff-spacing}
+@end itemize
+@end itemize
+
+Diese Grob-Eigenschaften sind weiter oben einzlen beschrieben; siehe
+@ref{Eigenschaften für Abstände innerhalb von Systemgruppen}.
+
+Das folgende Beispiel zeigt, wie die @code{nonstaff-nonstaff-spacing}-Eigenschaft
+die Platzierung von aufeinanderfolgenden Nicht-Notensystemzeilen beeinflussen
+kann. Indem hier der Wert von @code{stretchability} auf einen sehr hohen Wert
+gesetzt wird, kann der Gesangstext sehr viel weiter als normal gespreizt
+werden:
+
+@lilypond[verbatim,quote,staffsize=16]
+\layout {
+ \context {
+ \Lyrics
+ \override VerticalAxisGroup
+ #'nonstaff-nonstaff-spacing #'stretchability = #1000
}
- \new Staff << \repeat unfold 4 { g'4 g' g' g' \break }
- { s1*2 \pageBreak } >>
}
+
+\new StaffGroup
+<<
+ \new Staff \with {
+ \override VerticalAxisGroup #'staff-staff-spacing = #'((basic-distance . 30))
+ } { c'1 }
+ \new Lyrics \with {
+ \override VerticalAxisGroup #'staff-affinity = #UP
+ } \lyricmode { up }
+ \new Lyrics \with {
+ \override VerticalAxisGroup #'staff-affinity = #CENTER
+ } \lyricmode { center }
+ \new Lyrics \with {
+ \override VerticalAxisGroup #'staff-affinity = #DOWN
+ } \lyricmode { down }
+ \new Staff { c'1 }
+>>
@end lilypond
@seealso
-Schnipsel:
+Installierte Dateien:
+@file{ly/engraver-init.ly},
+@file{scm/define-grobs.scm}.
+
+Schnispel:
@rlsr{Spacing}.
+@c @lsr{spacing,page-spacing.ly},
+@c @lsr{spacing,alignment-vertical-spacing.ly}.
+
+Referenz der Interna:
+@rinternals{Contexts},
+@rinternals{VerticalAxisGroup}.
+
+
+
+
+
+
+
+
@node Explizite Positionierung von Systemen
@subsection Explizite Positionierung von Systemen
@translationof Explicit staff and system positioning
-Man kann die Einstellungen des @code{VerticalAxisGroup}-Objekts
-und der @code{\paper}-Umgebung, wie sie im vorigen Abschnitt
+Man kann die flexiblen Einstellungen der vertikalen Abstände, wie sie im
+vorigen Abschnitt
erklärt wurden, als eine Sammlung verschiedenerer Einstellmöglichkeiten
verstehen, die vor allem die Größe des vertikalen Platzes zwischen
Notensystemen und Gruppen auf der Seite kontrollieren.
Die vertikale Platzverteilung kann aber auch auf andere Weise
eingestellt werden: mit den Optionen von
@code{NonMusicalPaperColumn #'line-break-system-details}. Während
-Einstellungen in @code{VerticalAxisGroup} und @code{\paper} Füllplatz
-definieren, werden mit
+der flexible vertikale Abstandsmechanismus vertikalen Füllplatz
+definiert, werden mit
@code{NonMusicalPaperColumn #'line-break-system-details} absolute vertikale
Positionen auf der Seite festgelegt.
@code{NonMusicalPaperColumn #'line-break-system-details} akzeptiert eine
-Liste aus fünf unterschiedlichen Einstellungen:
+Liste aus drei unterschiedlichen Einstellungen:
@itemize
@item @code{X-offset}
@item @code{Y-offset}
-@item @code{alignment-offsets}
-@item @code{alignment-extra-space}
-@item @code{fixed-alignment-extra-space}
+@item @code{alignment-distances}
@end itemize
Veränderungen von Grobs (wozu auch @code{NonMusicalPaperColumn} gehört),
#'line-break-system-details #'((Y-offset . 40))
\overrideProperty NonMusicalPaperColumn
- #'line-break-system-details #'((X-offset . 20) (Y-offset . 40))
+ #'line-break-system-details #'((X-offset . 20)
+ (Y-offset . 40))
\overrideProperty NonMusicalPaperColumn
- #'line-break-system-details #'((alignment-offsets . (0 -15)))
+ #'line-break-system-details #'((alignment-distances . (15)))
\overrideProperty NonMusicalPaperColumn
- #'line-break-system-details #'((X-offset . 20) (Y-offset . 40)
- (alignment-offsets . (0 -15)))
+ #'line-break-system-details #'((X-offset . 20)
+ (Y-offset . 40)
+ (alignment-distances . (15)))
@end example
Um zu verstehen, wie jede dieser unterschiedlichen Einstellungen
funktioniert, wollen wir uns ein Beispiel vornehmen, dass überhaupt
-keine Einstellungen (d.h. @code{override}-Befehle) enthält:
+keine Einstellungen (d.h. @code{\override}-Befehle) enthält:
@c \book { } is required in these examples to ensure the spacing
@c overrides can be seen between systems. -np
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
@code{NonMusicalPaperColumn}-Grobs wie in dem Beispiel
ersichtlich benutzt werden:
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
hier die exakte vertikale Position auf der Seite, an welcher jede
neue Systemgruppe begonnen wird.
-Da jetzt der exakte Beginn eines jeden Systems explizit festgelegt wurde,
+Da jetzt der exakte Beginn einer jeden Systemgruppe explizit festgelegt wurde,
können wir auch den exakten Beginn eines jeden Notensystems in der
-Gruppe festlegen. Dies geschieht mit der @code{alignment-offsets}-Eigenschaft
+Gruppe festlegen. Dies geschieht mit der @code{alignment-distances}-Eigenschaft
von @code{line-break-system-details}.
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
\new Voice {
\overrideProperty #"Score.NonMusicalPaperColumn"
#'line-break-system-details #'((Y-offset . 20)
- (alignment-offsets . (0 -15)))
+ (alignment-distances . (15)))
s1*5 \break
\overrideProperty #"Score.NonMusicalPaperColumn"
#'line-break-system-details #'((Y-offset . 60)
- (alignment-offsets . (0 -15)))
+ (alignment-distances . (15)))
s1*5 \break
\overrideProperty #"Score.NonMusicalPaperColumn"
#'line-break-system-details #'((Y-offset . 100)
- (alignment-offsets . (0 -15)))
+ (alignment-distances . (15)))
s1*5 \break
}
\new Voice { \repeat unfold 15 { c'4 c' c' c' } }
@end lilypond
Dem @code{line-break-system-details}-Attribut des
-@code{NonMusicalPaperColumn}-Grobs werden zwei Eigenschaften
-zugewiesen. Auch wenn die Liste (alist) von
+@code{NonMusicalPaperColumn}-Grobs werden zwei unterschiedliche Eigenschaften
+zugewiesen. Auch wenn die Aliste der Attribute von
@code{line-break-system-details} sehr viel mehr Platzierungsparameter
-akzeptiert, müssen hier nu die Parameter @code{Y-offset} und
-@code{alignment-offsets} gesetzt werden, um den vertikalen Beginn
+akzeptiert (wie etwa ein korrespondierendes @code{X-offset}-Paar), müssen
+hier nur die Parameter @code{Y-offset} und
+@code{alignment-distances} gesetzt werden, um den vertikalen Beginn
jedes Systems und jeder Systemgruppe zu kontrollieren. @code{Y-offset}
-bestimmt also die vertikale Position von Systemgruppen und @code{alignment-offsets}
+bestimmt also die vertikale Position von Systemgruppen und @code{alignment-distances}
die vertikale Position von einzelnen Notensystemen.
-@lilypond[quote]
+@lilypond[verbatim,quote,staffsize=16]
\header { tagline = ##f }
\paper { left-margin = 0\mm }
\book {
\new Voice {
\overrideProperty #"Score.NonMusicalPaperColumn"
#'line-break-system-details #'((Y-offset . 0)
- (alignment-offsets . (0 -30 -40)))
+ (alignment-distances . (30 10)))
s1*5 \break
\overrideProperty #"Score.NonMusicalPaperColumn"
#'line-break-system-details #'((Y-offset . 60)
- (alignment-offsets . (0 -10 -20)))
+ (alignment-distances . (10 10)))
s1*5 \break
\overrideProperty #"Score.NonMusicalPaperColumn"
#'line-break-system-details #'((Y-offset . 100)
- (alignment-offsets . (0 -10 -40)))
+ (alignment-distances . (10 30)))
s1*5 \break
}
\new Voice { \repeat unfold 15 { c'4 c' c' c' } }
Einige Dinge sollten beachtet werden:
@itemize
-@item Wenn @code{alignment-offsets} benutzt wird, werden Gesangtextzeilen
-als ein System gezählt.
+@item Wenn @code{alignment-distances} benutzt wird, werden Gesangstextzeilen
+nicht als ein System gezählt.
@item Die Einheiten der Zahlen, die für @code{X-offset},
-@code{Y-offset} und @code{alignment-offsets} benutzt werden, werden als
+@code{Y-offset} und @code{alignment-distances} benutzt werden, werden als
Vielfaches des Abstandes zwischen zwei Notenlinien gewertet. Positive
Werte verschieben Systeme und Gesangstext nach oben, negative Werte nach
unten.
@rlsr{Spacing}.
-@node Vertikale Abstände mit zwei Durchgängen
-@subsection Vertikale Abstände mit zwei Durchgängen
-@translationof Two-pass vertical spacing
-
-@warning{Vertikale Positionierung in zwei Durchgängen ist veraltet
-(deprecated) und wird in zukünftigen Versionen von LilyPond entfernt
-werden. Systeme werden jetzt automatisch in einem einzigen
-Durchlauf gedehnt. Siehe auch @ref{Vertikale Abstände innerhalb eines Systems}.}
-
-Um Systeme zu dehnen, sodass sie den restlichen Platz auf der Seite
-auffüllen, kann ein Verfahren benutzt werden, dass die Positionierung
-in zwei Durchläufen ermittelt:
-
-@enumerate
-@item Im ersten Durchlauf wird der Platz berechnet, um den jede
-Systemgruppe gedehnt werden sollte und in eine Datei geschrieben.
-@item Im zweiten Durchlauf werden die Systemgruppen anhand der
-Daten aus dieser Datei entsprechend gedehnt.
-@end enumerate
-
-Die @code{ragged-bottom}-Eigenschaft fügt den Platz zwischen
-Systemgruppen ein, während mit der Technik in zwei Durchläufen
-die Systemgruppen selber gedehnt werden.
-
-Um dieses Verhalten zu erzeugen, muss die @code{tweak-key}-Eigenschaft
-in der @code{\layout}-Umgebung jeder Partitur definiert werden und diese
-Anpassungen dann in jeder Paritur mit dem Befehl @code{\scoreTweak}
-angewandt werden.
-
-@quotation
-@verbatim
-%% die erstellte Layout-Datei einfügen
-\includePageLayoutFile
-
-\score {
- \new StaffGroup <<
- \new Staff <<
- %% Anpassungen für diese Partitur einfügen
- \scoreTweak "scoreA"
- { \clef french c''1 \break c''1 }
- >>
- \new Staff { \clef soprano g'1 g'1 }
- \new Staff { \clef mezzosoprano e'1 e'1 }
- \new Staff { \clef alto g1 g1 }
- \new Staff { \clef bass c1 c1 }
- >>
- \header {
- piece = "Score with tweaks"
- }
- %% Definieren, wie die Anpassungen für diese Datei genannt werden:
- \layout { #(define tweak-key "scoreA") }
-}
-@end verbatim
-@end quotation
-
-Für den ersten Durchgang sollte die @code{dump-tweaks}-Option gesetzt
-werden, damit die Layout-Datei erstellt wird.
-
-@example
-lilypond -dbackend=null -d dump-tweaks <file>.ly
-lilypond <file>.ly
-@end example
-
-
-@seealso
-Schnipsel:
-@rlsr{Spacing}.
-
-
@node Vermeidung von vertikalen Zusammenstößen
@subsection Vermeidung von vertikalen Zusammenstößen
@translationof Vertical collision avoidance
wie möglich, aber gerade so weit weg, dass sie nicht mit anderen
Objekten zusammenstoßen.
-Dabei setzt LilyPon die @code{outside-staff-priority}-Eigenschaft
+Dabei setzt LilyPond die @code{outside-staff-priority}-Eigenschaft
ein um herauszufinden, ob ein Grob ein Objekt außerhalb des Systems
ist: wenn @code{outside-staff-priority} eine Zahl ist, dann handelt
es sich um ein Objekt außerhalb des Systems. Zusätzlich teilt
geringeren Wert von @code{outside-staff-priority} näher an das
entsprechende Notensystem gesetzt.
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+@lilypond[quote,ragged-right,relative=2,verbatim]
c4_"Text"\pp
r2.
\once \override TextScript #'outside-staff-priority = #1
padding bezeichnet), kann durch @code{outside-staff-padding}
kontrolliert werden.
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+@lilypond[quote,ragged-right,relative=2,verbatim]
\once \override TextScript #'outside-staff-padding = #0
a'^"This text is placed very close to the note"
\once \override TextScript #'outside-staff-padding = #3
verschoben werden und derartige Situationen kommen nicht
vor.
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+@lilypond[quote,ragged-right,relative=2,verbatim]
% the markup is too close to the following note
c4^"Text"
c4
Notenkopfes ist. @code{shortest-duration-space} ist definiert als
2.0, was bedeutet, dass die kürzeste Note 2.4 Notenlinienabstände
2.0 mal der Wert von @code{spacing-increment}) horizontalen
-Abstand erhält. Der Abstand wirdvon der linken Kande des Symbols
+Abstand erhält. Der Abstand wird von der linken Kante des Symbols
errechnet, so dass die kürzeste Note üblicherweise von 1 NKA
Abstand gefolgt wird.
häufigste kürzeste Note wird dann als Grundlage für die Platzverteilung
der Noten herangezogen, mit der Bedingung, dass diese kürzeste
Note immer ein Achtel oder kürzer sein soll. Die kürzeste Dauer
-wird ausgegeben, wenn @code{lilypond} mit der Option @code{--verbose}
+wird ausgegeben, wenn @code{lilypond} mit der Option @option{--verbose}
aufgerufen wird.
Diese Dauern können aber auch angepasst werden. Wenn Sie die Eigenschaft
Noten, die noch kürzer sind als die häufigste kürzeste Note, werden
durch einen Platz voneinander getrennt, der proportional zu ihrer
Dauer in Beziehung zur häufigsten kürzesten Note ist. Wenn also
-nur ein paar Sechszehntel zu dem obigen Beispiel hinzugefügt werden,
+nur ein paar Sechzehntel zu dem obigen Beispiel hinzugefügt werden,
würden sie von 1/2 NKA gefolgt werden:
@lilypond[quote,fragment,verbatim,relative=2]
c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
@end lilypond
-In der Einleitung (siehe @rlearning{Notensatz}) wurde erklärt, dass die
-Richtung der Notenhälse die Platzverteilung beeinflusst. Das wird
+In dem @emph{Aufsatz zum automatisierten Notensatz} wurde erklärt, dass die
+Richtung der Notenhälse die Platzverteilung beeinflusst (siehe
+@ressay{Optischer Ausgleich}). Das wird
kontrolliert durch die @code{stem-spacing-correction}-Eigenschaft
in dem @code{NoteSpacing}-Objekt. Dieses Objekt wird für jeden
@code{Voice}-Kontext erstellt. Das @code{StaffSpacing}-Objekt (in
@lilypond[quote,ragged-right]
{
c'4 e''4 e'4 b'4 |
- b'4 e''4 b'4 e''4|
+ b'4 e''4 b'4 e''4 |
\override Staff.NoteSpacing #'stem-spacing-correction = #1.5
\override Staff.StaffSpacing #'stem-spacing-correction = #1.5
c'4 e''4 e'4 b'4 |
- b'4 e''4 b'4 e''4|
+ b'4 e''4 b'4 e''4 |
}
@end lilypond
@rinternals{StaffSpacing},
@rinternals{NonMusicalPaperColumn}.
+Aufsatz über den automatischen Notensatz:
+@ressay{Optischer Ausgleich}.
+
@knownissues
Es gibt keine sinnvolle Möglichkeit, die horizontale Verteilung der
ausfallen.
Im folgenden Beispiel wird durch die neue Taktart ein neuer
-Abschnitt begonnen, in dem die Sechszehntel weiter außeinander
+Abschnitt begonnen, in dem die Sechzehntel weiter außeinander
gesetzt werden sollen.
@lilypond[relative,fragment,verbatim,quote]
\context {
\Score
\override SpacingSpanner
- #'base-shortest-duration = #(ly:make-moment 1 16)
+ #'base-shortest-duration = #(ly:make-moment 1 16)
}
}
}
Schlüsselwechseln usw.) berechnet. Um diese Symbole zu
ignorieren und eine gleichmäßige Verteilung der Noten
zu erzwingen, kann die gleichmäßige Dehnung (engl.
-uniform stretching) zu Beginn einer Partitur eingeschaltet
+uniform stretching) zu Beginn einer Partitur
+mit @code{Score.SpacingSpanner #'uniform-stretching} eingeschaltet
werden:
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-\new Score \with {
- \override SpacingSpanner #'uniform-stretching = ##t
-} <<
- \new Staff{
- \times 4/5 {
- c8 c8 c8 c8 c8
+@lilypond[quote,ragged-right,verbatim]
+\score {
+ <<
+ \new Staff {
+ \times 4/5 {
+ c8 c8 c8 c8 c8
+ }
+ c8 c8 c8 c8
}
- c8 c8 c8 c8
- }
- \new Staff{
- c8 c8 c8 c8
- \times 4/5 {
- c8 c8 c8 c8 c8
+ \new Staff {
+ c8 c8 c8 c8
+ \times 4/5 {
+ c8 c8 c8 c8 c8
+ }
+ }
+ >>
+ \layout {
+ \context {
+ \Score
+ \override SpacingSpanner #'uniform-stretching = ##t
}
}
->>
+}
@end lilypond
Wenn @code{strict-note-spacing} eingestellt ist, werden Noten
-gesetzt, ohne dass Schlüssel, Taktlinine oder Verzierungsnoten
+gesetzt, ohne dass Schlüssel, Taktlinie oder Verzierungsnoten
zusätzlichen Platz erhalten.
@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
Die grundlegenden Einstellungen, die Einfluss auf die Zeilenlänge
haben, sind @code{indent} (Einzug) und @code{line-width}
(Zeilenbreite). Sie werden in der @code{\layout}-Umgebung
-einestellt. Der erste Befehl bestimmt den Einzug der ersten
+eingestellt. Der erste Befehl bestimmt den Einzug der ersten
Zeile, der zweite die Zeilenlänge der weiteren Notenzeilen.
Wenn @code{ragged-right} eingestellt ist (als in der
rechten Rand hin durchgezogen, sondern den Noten entsprechend
gesetzt. Das ist oftmals nützlich für kleine Notenfragmente
und um zu überprüfen, wie eng die Noten natürlicherweise
-gesetzt werden würden.
+gesetzt werden würden. Die normale Einstellung ist unwahr
+(@code{#f}), aber wenn eine Partitur nur aus einer Zeile besteht,
+ist der Standardwert wahr.
Die Option @code{ragged-last} verhält sich ähnlich zu @code{ragged-right},
aber wirkt sich nur auf die letzte Zeile eines Stückes aus.
Für diese letzte Zeile gibt es keine Einschränkungen. Das
Resultat erinnert an Textabsätze im Blocksatz, wo die letzte
-Zeile des Absatzes mit ihrer natürlichen Länge gestzt wird.
+Zeile des Absatzes mit ihrer natürlichen Länge gesetzt wird.
+@c Note that for text there are several options for the last line.
+@c While Knuth TeX uses natural length, lead typesetters use the same
+@c stretch as the previous line. eTeX uses \lastlinefit to
+@c interpolate between both these solutions.
@example
\layout @{
die klassischen Abstände und Flattersatz (ragged-right) eingesetzt werden:
@lilypond[quote,verbatim,ragged-right]
-\new Score <<
- \new RhythmicStaff {
- c'2
- c'16 c'16 c'16 c'16
- \times 4/5 {
- c'16 c'16 c'16 c'16 c'16
+\score {
+ <<
+ \new RhythmicStaff {
+ c'2
+ c'16 c'16 c'16 c'16
+ \times 4/5 {
+ c'16 c'16 c'16 c'16 c'16
+ }
}
- }
->>
+ >>
+}
@end lilypond
Die Halbe, mit der der Takt beginnt, braucht weitaus weniger
Platz als die Hälfte des Taktes. Gleichermaßen haben die
-Sechszehntel und die Sechszehntel-Quintolen (oder Zwanzigstel),
+Sechzehntel und die Sechzehntel-Quintolen (oder Zwanzigstel),
mit denen der Takt endet, insgesamt weitaus mehr als die Hälfte
der Taktbreite.
eingeschaltet:
@lilypond[quote,verbatim,ragged-right]
-\new Score \with {
- proportionalNotationDuration = #(ly:make-moment 1 20)
-} <<
- \new RhythmicStaff {
- c'2
- c'16 c'16 c'16 c'16
- \times 4/5 {
- c'16 c'16 c'16 c'16 c'16
+\score {
+ <<
+ \new RhythmicStaff {
+ c'2
+ c'16 c'16 c'16 c'16
+ \times 4/5 {
+ c'16 c'16 c'16 c'16 c'16
+ }
+ }
+ >>
+ \layout {
+ \context {
+ \Score
+ proportionalNotationDuration = #(ly:make-moment 1 20)
}
}
->>
+}
@end lilypond
Die Halbe zu Beginn des Taktes und die schnelleren Noten in der zweiten
Die Einstellung von @code{proportionalNotationDuration} gehört zum
@code{Score}-Kontext. Kontexteinstellungen können an drei verschiedenen
Stellen in der Quelldatei geschrieben werden: in einer @code{\with}-Umgebung,
-in einer @code{\context}-Unmgebung oder direkt in den Noten mit dem
+in einer @code{\context}-Umgebung oder direkt in den Noten mit dem
@code{\set}-Befehl. Alle drei Positionen sind gleichwertig und es hängt
vom Benutzer ab, welche bevorzugt wird.
welches die Referenzdauer ist, anhand welcher alle Noten platziert werden.
Hier wird die LilyPond Scheme-Funktion @code{make-moment} eingesetzt. Sie
braucht zwei Argumente: einen Zähler und einen Nenner, die einen Bruch einer
-Ganzen darstellen. Die Funktion @code{#(ly:make-moment 1 20)} ergibt also
+Ganzen darstellen. Die Funktion @code{(ly:make-moment 1 20)} ergibt also
eine Referenzdauer von einer Zwanzigstel. Genauso gut können etwa die Dauern
-@code{#(ly:make-moment 1 16)}, @code{#(ly:make-moment 1 8)} oder
-@code{#(ly:make-moment 3 97)} eingesetzt werden.
+@code{(ly:make-moment 1 16)}, @code{(ly:make-moment 1 8)} oder
+@code{(ly:make-moment 3 97)} eingesetzt werden.
Die richtige Referenzdauer, mit der eine vernünftige Verteilung der Noten
proportional möglich ist, muss durch Ausprobieren herausgefunden werden.
erscheinen, größere Referenzdauern zwingen sie dichter zusammen.
@lilypond[quote,verbatim,ragged-right]
-\new Score \with {
- proportionalNotationDuration = #(ly:make-moment 1 8)
-} <<
- \new RhythmicStaff {
- c'2
- c'16 c'16 c'16 c'16
- \times 4/5 {
- c'16 c'16 c'16 c'16 c'16
+\score {
+ <<
+ \new RhythmicStaff {
+ c'2
+ c'16 c'16 c'16 c'16
+ \times 4/5 {
+ c'16 c'16 c'16 c'16 c'16
+ }
+ }
+ >>
+ \layout {
+ \context {
+ \Score
+ proportionalNotationDuration = #(ly:make-moment 1 8)
}
}
->>
+}
-\new Score \with {
- proportionalNotationDuration = #(ly:make-moment 1 16)
-} <<
- \new RhythmicStaff {
- c'2
- c'16 c'16 c'16 c'16
- \times 4/5 {
- c'16 c'16 c'16 c'16 c'16
+\score {
+ <<
+ \new RhythmicStaff {
+ c'2
+ c'16 c'16 c'16 c'16
+ \times 4/5 {
+ c'16 c'16 c'16 c'16 c'16
+ }
+ }
+ >>
+ \layout {
+ \context {
+ \Score
+ proportionalNotationDuration = #(ly:make-moment 1 16)
}
}
->>
+}
-\new Score \with {
- proportionalNotationDuration = #(ly:make-moment 1 32)
-} <<
- \new RhythmicStaff {
- c'2
- c'16 c'16 c'16 c'16
- \times 4/5 {
- c'16 c'16 c'16 c'16 c'16
+\score {
+ <<
+ \new RhythmicStaff {
+ c'2
+ c'16 c'16 c'16 c'16
+ \times 4/5 {
+ c'16 c'16 c'16 c'16 c'16
+ }
+ }
+ >>
+ \layout {
+ \context {
+ \Score
+ proportionalNotationDuration = #(ly:make-moment 1 32)
}
}
->>
+}
@end lilypond
Man muss beachten, dass die Referenzdauer nicht zu groß ist
System mit anderen rhythmischen Werten hinzugefügt wird:
@lilypond[quote,verbatim,ragged-right]
-\new Score <<
- \new RhythmicStaff {
- c'2
- c'16 c'16 c'16 c'16
- \times 4/5 {
- c'16 c'16 c'16 c'16 c'16
+\score {
+ <<
+ \new RhythmicStaff {
+ c'2
+ c'16 c'16 c'16 c'16
+ \times 4/5 {
+ c'16 c'16 c'16 c'16 c'16
+ }
}
- }
- \new RhythmicStaff {
- \times 8/9 {
- c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
+ \new RhythmicStaff {
+ \times 8/9 {
+ c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
+ }
}
- }
->>
+ >>
+}
@end lilypond
Die Platzaufteilung ist schlecht, weil die gleichlangen Noten des
dieser Situation deutlich:
@lilypond[quote,verbatim,ragged-right]
-\new Score \with {
- proportionalNotationDuration = #(ly:make-moment 1 20)
-} <<
- \new RhythmicStaff {
- c'2
- c'16 c'16 c'16 c'16
- \times 4/5 {
- c'16 c'16 c'16 c'16 c'16
+\score {
+ <<
+ \new RhythmicStaff {
+ c'2
+ c'16 c'16 c'16 c'16
+ \times 4/5 {
+ c'16 c'16 c'16 c'16 c'16
+ }
}
- }
- \new RhythmicStaff {
- \times 8/9 {
- c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
+ \new RhythmicStaff {
+ \times 8/9 {
+ c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
+ }
+ }
+ >>
+ \layout {
+ \context {
+ \Score
+ proportionalNotationDuration = #(ly:make-moment 1 20)
}
}
->>
+}
@end lilypond
Aber bei sehr genauer Betrachtung sind die Noten der zweiten Hälfte
-der Nonole doch immernoch eine Spur weiter gesetzt als die Noten
+der Nonole doch immer noch eine Spur weiter gesetzt als die Noten
der ersten Hälfte. Um wirklich gleichmäßige Abstände zu erzwingen,
-sollte auch noch die gleichmäßige Dehnung angeschaltet werden:
+sollte auch noch die gleichmäßige Dehnung (@code{uniform-stretching}) angeschaltet werden, die eine Eigenschaft von @code{SpacingSpanner} ist:
@lilypond[quote,verbatim,ragged-right]
-\new Score \with {
- proportionalNotationDuration = #(ly:make-moment 1 20)
- \override SpacingSpanner #'uniform-stretching = ##t
-} <<
- \new RhythmicStaff {
- c'2
- c'16 c'16 c'16 c'16
- \times 4/5 {
- c'16 c'16 c'16 c'16 c'16
+\score {
+ <<
+ \new RhythmicStaff {
+ c'2
+ c'16 c'16 c'16 c'16
+ \times 4/5 {
+ c'16 c'16 c'16 c'16 c'16
+ }
}
- }
- \new RhythmicStaff {
- \times 8/9 {
- c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
+ \new RhythmicStaff {
+ \times 8/9 {
+ c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8
+ }
+ }
+ >>
+ \layout {
+ \context {
+ \Score
+ proportionalNotationDuration = #(ly:make-moment 1 20)
+ \override SpacingSpanner #'uniform-stretching = ##t
}
}
->>
+}
@end lilypond
Das Beispiel mit den zwei Systemen ist nun exakt nach den
Alle Einstellungen zur proportionalen Notation erwarten,
dass die @code{uniform-stretching}-Eigenschaft des
-@code{SpacingSpanner}-Objekts auf wahr gesetzt wird. Andernfalls
+@code{SpacingSpanner}-Objekts auf wahr (@code{#t}) gesetzt wird. Andernfalls
kann es vorkommen, dass bestimmte Abstände (etwa von
unsichtbaren Noten) nicht richtig gesetzt werden.
Abschnitte mit verschiedenem Platzierungsverhalten definieren.
Hierzu ist der Befehl @code{\newSpacingSection} da. Siehe auch @ref{Eine neuer Bereich mit anderen Abständen}.
-Im Folgenden soll gezeigt werden, wie sich der @code{Separating_line_group_engraver}
+Im Folgenden soll gezeigt werden, wie sich der
+@code{Separating_line_group_engraver}
auswirkt und warum er normalerweise für proportionale Notation ausgeschaltet wird.
In diesem Beispiel wird verdeutlicht, dass vor jeder ersten Note eines Notensystems
immer etwas zusätzlicher Platz gesetzt wird:
}
@end lilypond
-Der gleiche horizontale Platz wird vor eine Noten gesetzt, wenn sie
+Der gleiche horizontale zusätzliche Platz wird vor eine Noten gesetzt, wenn sie
einer Taktart, einem Schlüssel oder einer Tonartbezeichnung folgt.
Dieser Platz wird durch @code{Separating_line_group_engraver}
eingefügt; wenn wir ihn aus der Partitur entfernen, entfällt
}
@end lilypond
-Nichmusikalische Elemente wir Takt- und Tonartangaben, Schlüssel und
+Nichtmusikalische Elemente wie Takt- und Tonartangaben, Schlüssel und
Versetzungszeichen sind problematisch in proportionaler
Notation. Keine dieser Elemente hat eine rhythmische Dauer, aber
alle brauchen horizontalen Platz. Das Problem wird auf unterschiedliche
die meisten Partituren mit proportionaler Notation für heutige
Musik geschrieben werden. Ähnliches gilt für Taktarten, insbesondere,
wenn ein Zeitstrahl in die Partitur eingearbeitet werden soll.
-In den meisten Parituren kommt jedoch irgendeine Taktart vor.
+In den meisten Partituren kommt jedoch irgendeine Taktart vor.
Schlüssel und Versetzungszeichen sind noch wichtiger; auf
sie kann selten verzichtet werden.
keine Rolle bei der Berechnung der Abstände spielen.
Zusätzlich zu den hier vorgestellten Einstellungen gibt es
-noch eine Reihe von Möglichkteiten, die oft in proportionaler
+noch eine Reihe von Möglichkeiten, die oft in proportionaler
Notation benutzt werden. Dazu gehören:
@itemize
@item @code{\remove Forbid_line_break_engraver in the Voice context}
@end itemize
-Diese Einstellungn bewirken, dass auch Verzierungsnoten proportional
+Diese Einstellungen bewirken, dass auch Verzierungsnoten proportional
gesetzt werden, dass Klammern von rhythmischen Gruppen bis zu den
Anfangs- und Endpunkten ausgedehnt werden und lassen dehnbare
Objekte wie Balken und Glissandi auch über Taktstriche hinweg zu.
Funktion @code{annotate-spacing} von sehr großer Hilfe. Hiermit
wird in den Musiksatz zusätzlich Information darüber ausgegeben,
wieviel Platz bestimmten Parametern zugewiesen wird. Genaueres
-hierzug in
-@ref{Abstände anzeigen lassen}.
+hierzu in @ref{Abstände anzeigen lassen}.
@menu
* Abstände anzeigen lassen::
@translationof Changing spacing
Die Ausgabe von @code{annotate-spacing} bietet sehr viele
-Details zu den vertikalen Dimensionen einer Paritur. Zu Information,
+Details zu den vertikalen Dimensionen einer Partitur. Zu Information,
wie Seitenränder und andere Layout-Variablen geändert werden
-können, siehe @ref{Seitenformatierung}.
+können, siehe @ref{Seitenlayout}.
Neben Rändern gibt es einige weitere Optionen, Platz zu sparen:
@itemize
@item
-LilyPond kann die Systeme so dicht wie möglich platzieren (damit
-so viele Systeme wie möglich auf eine Seite passen), aber sie
+LilyPond kann die Systeme so dicht wie möglich platzieren (damit
+so viele Systeme wie möglich auf eine Seite passen), aber sie
dann so anordnen, dass kein weißer Rand unten auf der Seite entsteht.
@example
\paper @{
- between-system-padding = #0.1
- between-system-space = #0.1
+ system-system-spacing = #'((padding . 0) (basic-distance . 0.1))
ragged-last-bottom = ##f
ragged-bottom = ##f
@}
@end example
@item
-Die Anzahl der Systeme kann reduziert werden. Das kann auf
+Die Anzahl der Systeme kann erzwungen werden. Das kann auf
zwei Arten helfen: wenn einfach nur ein Wert gesetzt wird, auch
wenn es die gleiche Anzahl ist, die auch schon vorher von LilyPond
erstellt wurde, kann manchmal dazu führen, dass mehr Systeme
Schritt im Notensatz ausgelassen wird, der die Seitenverteilung
nur grob einschätzt, sodass eine bessere Seitenverteilung
entsteht. Auch wenn man eine Verringerung der Anzahl an Systemen
-erzwingt, kann oft eine Seite eingespart werden. Wenn LilyPond
-die Musik etwa auf 11 Systeme verteilt, kann man die Benutzung von
+erzwingt, kann oft eine Seite eingespart werden. Wenn LilyPond
+die Musik etwa auf 11 Systeme verteilt, kann man die Benutzung von
nur 10 Systemen erzwingen.
@example
@end example
@item
-Vermeidung von Objekten, die den vertikalen Abstand von Systemen
-vergrößern, hilft oft. Die Verwendung von Klammern bei Wiederholungen
-etwa braucht mehr Platz. Wenn die Noten innerhalb der Klammern auf
-zwei Systeme verteilt sind, brauchen sie mehr Platz, als wenn sie
+Vermeidung (oder Verminderung) von Objekten, die den vertikalen Abstand von Systemen
+vergrößern, hilft oft. Die Verwendung von Klammern bei Wiederholungen
+(oder alternativen Wiederholungen)
+etwa braucht mehr Platz. Wenn die Noten innerhalb der Klammern auf
+zwei Systeme verteilt sind, brauchen sie mehr Platz, als wenn sie
nur auf einer Zeile gedruckt werden.
-Ein anderes Beispiel ist es, Dynamik-Zeichen, die besonders
+Ein anderes Beispiel ist es, Dynamik-Zeichen, die besonders
weit @qq{hervorstehen}, zu verschieben.
-@lilypond[verbatim,quote]
-\relative c' {
- e4 c g\f c
- \override DynamicText #'extra-offset = #'( -2.2 . 2.0)
- e4 c g\f c
-}
+@lilypond[verbatim,quote,relative=1]
+e4 c g\f c
+e4 c g-\tweak #'X-offset #-2.7 -\tweak #'Y-offset #2.5 \f c
@end lilypond
@item
-Die horizontalen Abstände können mit der
+Die horizontalen Abstände können mit der
@code{SpacingSpanner}-Eigenschaft verändert werden. Siehe
@ref{Horizontale Abstände verändern} für Einzelheiten. Dieses
Beispiel zeigt die normalen Abstände:
@seealso
Notationsreferenz:
-@ref{Seitenformatierung},
+@ref{Seitenlayout},
@ref{Horizontale Abstände verändern}.
Schnipsel:
projects / lilypond.git / blobdiff