Documentation/de/user/introduction.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @c This file is part of lilypond.tely
   3 @ignore
   4     Translation of GIT committish: 718cc970304f6b9a3bb990259a048c06e56f4e48
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  See TRANSLATION for details.
   8 @end ignore
   9
  10 @node Introduction
  11 @chapter Introduction
  12
  13
  14 @menu
  15 * Engraving::
  16 * Automated engraving::
  17 * What symbols to engrave?::
  18 * Music representation::
  19 * Example applications::
  20 * About this manual::
  21 @end menu
  22
  23
  24 @node Engraving
  25 @section Engraving
  26
  27 Die Kunst des Notensatzes wird auch als Notenstich bezeichnet. Dieser
  28 Begriff stammt aus dem traditionellen Notendruck. Noch etwa bis vor 20
  29 Jahren wurden Noten erstellt, indem man sie in eine Zink- oder Zinnplatte
  30 schnitt oder mit Stempeln schlug. Diese Platte wurde dann mit Druckerschwärze
  31  versehen, so dass sie in geschnittenen und gestempelten Vertiefungen
  32 blieb. Diese Vertiefungen schwärzten dann ein auf die Platte gelegtes
  33 Papier. Das Gravieren wurde vollständig von Hand erledigt. Es war darum
  34 sehr mühsam, Korrekturen anzubringen, weshalb man von vornherein richtig
  35  schneiden musste. Es handelte sich dabei um ein sehr spezialisiertes Handwerk.
  36
  37 Heutzutage wird fast alle gedruckte Musik von Computern erstellt. Das
  38 hat einige deutliche Vorteile: Drucke sind billiger als die gravierten
  39 Platten und der Computersatz kann per E-Mail verschickt werden. Leider
  40 hat der intensive Einsatz des Computers die graphische Qualität
  41 des Notensatzes vermindert. Mit dem Computer erstellte Noten sehen
  42 langweilig und mechanisch aus, was es erschwert, von ihnen zu spielen.
  43
  44
  45 @c introduce illustrating aspects of engraving, font...
  46 Die Abbildung unten illustriert den Unterschied zwischen
  47 traditionellem Notensatz und einem typischen Computersatz. Das
  48 dritte Bild zeigt, wie LilyPond die Formen des traditionellen
  49 Satzes nachahmt. Das linke Bild zeigt ein eingescanntes b-Vorzeichen
  50 aus einer 2000 herausgegebenen Edition. Das mittlere Bild
  51 zeigt das b-Vorzeichen der selben Musik aus einer handgestochenen
  52  Bärenreiter-Ausgabe. Das linke Bild zeigt die typischen Makel
  53 des Computer-Satzes: Die Notenlinien sind sehr dünn, die Schwärze
  54 des Vorzeichens entspricht den dünnen Linien und hat eine gerade
  55 Form mit scharfen Ecken und Kanten. Im Gegensatz dazu hat das
  56 Bärenreiter-Vorzeichen dicke, gerade zu sinnlich rundliche
  57 Formen. Unser Symbol für das Vorzeichen hat neben anderen
  58 auch dieses b als Vorbild. Es ist abgerundet und passt zu unseren
  59 Notenlinien, die sehr viel dicker sind als die der entsprechenden
  60 Computer-Ausgabe.
  61
  62 @multitable @columnfractions .125 .25 .25 .25 .125
  63 @item @tab
  64 @ifnotinfo
  65 @iftex
  66 @image{henle-flat-gray,,4cm}
  67 @end iftex
  68 @ifnottex
  69 @image{henle-flat-gray,,,png}
  70 @end ifnottex
  71
  72 @tab
  73 @iftex
  74 @image{baer-flat-gray,,4cm}
  75 @end iftex
  76 @ifnottex
  77 @image{baer-flat-gray,,,png}
  78 @end ifnottex
  79
  80 @tab
  81 @iftex
  82 @image{lily-flat-bw,,4cm}
  83 @end iftex
  84 @ifnottex
  85 @image{lily-flat-bw,,,png}
  86 @end ifnottex
  87 @end ifnotinfo
  88 @ifinfo
  89 @c workaround for makeinfo-4.6: line breaks and multi-column cookies
  90 @image{henle-flat-bw,,,png} @image{baer-flat-bw,,,png}
  91 @image{lily-flat-bw,,,png}
  92 @end ifinfo
  93
  94 @item @tab
  95 Henle (2000)
  96 @tab
  97 Bärenreiter (1950)
  98 @tab
  99 LilyPond Feta-Schriftart (2003)
 100
 101 @end multitable
 102
 103
 104 @cindex Musiksymbole
 105 @cindex Schriftart
 106 @cindex Dichte
 107 @cindex Balance
 108
 109 @c introduce illustrating aspects of engraving, spacing...
 110 Die Verteilung der Noten innerhalb des Taktes sollte ihrer Dauer
 111 entsprechen. Moderne Partituren zeigen diese Verhältnisse jedoch
 112 mit einer mathematischen Präzision, die nur sehr schlechte
 113 Ergebnisse bringt. Im nächsten Beispiel ist ein Motiv zweimal
 114 gesetzt: einmal mit den exakten mathematischen Längenverhältnissen, dann
 115 mit kleinen Korrekturen. Welches von beiden ist mit dieser Korrektur
 116 gesetzt?
 117
 118 @cindex Optischer Ausgleich
 119 @c file spacing-optical.
 120 @c need to include it here,  because we want two images.
 121 @lilypond
 122 \paper {
 123   ragged-right = ##t
 124   indent = #0.0
 125 }
 126
 127 music = {
 128    c'4 e''4 e'4 b'4 |
 129    \stemDown
 130    b'8[ e'' a' e'']
 131    \stemNeutral
 132    e'8[ e'8 e'8 e'8]
 133 }
 134
 135 \score
 136 {
 137   \music
 138   \layout {
 139     \context {
 140       \Staff
 141       \override NoteSpacing #'stem-spacing-correction = #0.6
 142     }
 143   }
 144 }
 145 @end lilypond
 146
 147 @lilypond
 148 \paper {
 149   ragged-right = ##t
 150   indent = #0.0
 151 }
 152
 153 music = {
 154    c'4 e''4 e'4 b'4 |
 155    \stemDown
 156    b'8[ e'' a' e'']
 157    \stemNeutral
 158    e'8[ e'8 e'8 e'8]
 159 }
 160 \score
 161 {
 162   \music
 163   \layout {
 164     \context {
 165       \Staff
 166       \override NoteSpacing #'stem-spacing-correction = #0.0
 167       \override NoteSpacing #'same-direction-correction = #0.0
 168       \override StaffSpacing #'stem-spacing-correction = #0.0
 169     }
 170   }
 171 }
 172 @end lilypond
 173
 174 @cindex normale Rhythmen
 175 @cindex normale Abstände
 176
 177 In diesem Ausschnitt kommen nur Viertel vor, Noten, die in einem
 178  gleichmäßigen Rhythmus gespielt werden. Die Abstände sollten das
 179  widerspiegeln. Leider lässt uns aber das Auge im Stich: es beachtet
 180  nicht nur den Abstand von aufeinander folgenden Notenköpfen, sondern
 181  auch den ihrer Hälse. Also müssen Noten, deren Hälse in direkter
 182  Folge zuerst nach oben und dann nach unten ausgerichtet sind, weiter
 183  auseinander gezogen werden, während die unten/oben-Folge engere
 184  Abstände fordert, und das alles auch noch in Abhängigkeit von der
 185 vertikalen Position der Noten. Das obere Beispiel ist mit dieser
 186 Korrektur gesetzt, das unter ohne. In letzterem Fall bilden sich
 187 für das Auge bei unten/oben-Folgen Notenklumpen mit schmalen Abständen
 188 zwischen den Notenhälsen.
 189
 190 @cindex Typographie
 191
 192 Musiker sind üblicherweise zu zu konzentriert, die Musik aufzuführen,
 193 als dass sie das Aussehen der Noten studieren könnten; und diese
 194 Erbsenzählerei der typographischen Details mag akademisch wirken.
 195 Das ist aber nicht gerechtfertigt. Unser Beispielstück hat einen
 196 monotonen Rhythmus, und wenn alle Zeilen gleich aussehen, wird
 197 das Notenblatt zu einem Labyrinth. Wenn der Spieler auch nur
 198 einmal wegschaut oder kurze Zeit unkonzentriert ist, findet er
 199 nicht mehr zurück zu der Stelle, an der er war.
 200
 201 Der dichtere Eindruck, den die dickeren Notenlinien und schwereren
 202 Notationssymbole schaffen, eignet sich auch besser für Noten,
 203 die weit vom Leser entfernt stehen, etwa auf einem Notenständer.
 204 Eine sorgfältige Verteilung der Zwischenräume erlaubt es, die
 205 Noten sehr dicht zu setzen, ohne dass die Symbole zusammenklumpen.
 206 Dadurch werden unnötige Seitenumbrüche vermieden, sodass man
 207 nicht so oft blättern muss.
 208
 209 Hier eine übliche Charakteristik der Typographie: Das Layout sollte
 210 schön sein, nicht um seiner selbst willen, sondern um dem Leser
 211 zu helfen. Für Aufführungsmaterial wie Partituren ist das um
 212 so wichtiger. Ein Spieler kann den Noten nur eine begrenzte
 213 Aufmerksamkeit schenken. Und je weniger Aufmerksamkeit nötig
 214 ist, um die Noten zu erfassen, um so mehr Zeit können sie in
 215 die Aufführung selber stecken. So wirkt sich gute Typographie
 216 direkt in eine verbesserte Aufführung aus!
 217
 218 Die Beispiele haben gezeigt, dass der Notensatz eine subtile und
 219 komplexe Kunst ist und gute Ergebnisse nur mit viel Erfahrung
 220 erlangt werden können, die Musiker normalerweise nicht haben.
 221 LilyPond stellt unser Bemühen dar, die graphische Qualität
 222 handgestochener Notenseiten ins Computer-Zeitalter zu transportieren
 223 und sie für normale Musiker erreichbar zu machen. Wir haben
 224 unsere Algorithmen, die Gestalt der Symbole und die Programm-Einstellungen
 225 darauf abgestimmt, einen Ausdruck zu erzielen, der der Qualität
 226 der alten Editionen entspricht, die wir so gerne betrachten
 227 und von denen wir gerne spielen.
 228
 229
 230
 231 @node Automated engraving
 232 @section Automated engraving
 233
 234 Wie sollen wir also jetzt die Typographie anwenden?
 235 Wie können wir erwarten, dass wir in der Lage wären,
 236 ein Programm zu schreiben, dass den Beruf des
 237 Notenstechers ersetzt, wo dieser doch mehr als zehn
 238 Jahre braucht, um ein Meister zu werden?
 239
 240 Wir können es tatsächlich nicht! Da Typographie allein
 241 durch das menschliche Auge bestimmt ist, kann der Mensch
 242 nicht ersetzt werden. Aber sehr viel mechanische Arbeit
 243 kann erleichtert werden. Indem etwa LilyPond die üblichen
 244 Situationen kennt und bewältigt, können die restlichen
 245 Fehler von Hand beseitigt werden. Das ist schon ein
 246 großer Fortschritt im Vergleich mit den existierenden
 247 Programmen. Und mit der Zeit können immer mehr Fälle
 248 automatisiert werden, so dass immer weniger Eingriffe
 249 von Hand notwendig werden.
 250
 251 Als wir anfingen, haben wir ein Programm mit C++
 252 geschrieben. Das heißt aber, dass der Funktionsumfang
 253 des Programms vom Anfang an durch die Entwickler festgelegt
 254  ist. Das erschien uns aber nicht ausreichend:
 255
 256 @itemize @bullet
 257 @item Wenn LilyPond Fehler macht, muss der Benutzer die
 258 Einstellungen ändern können. Er muss also Zugang zur
 259 Formatierungsmaschinerie haben. Also können die Regeln und
 260 Einstellungen nicht beim Kompilieren des Programms festgelegt
 261 werden, sondern sie müssen während des Laufes zugänglich sein.
 262
 263
 264 @item Notensatz ist eine Frage des Augenmaßes, und damit auch vom
 265  Geschmack abhängig. Benutzer können mit unseren Entscheidungen
 266 unzufrieden sein. Darum müssen also auch die Definitionen des
 267 typographischen Stils dem Benutzer zugänglich sein.
 268
 269 @item Schließlich verfeinern wir unseren Formatierungsalgorithmus
 270 immer weiter, also müssen die Regeln auch flexibel sein. Die
 271  C++-Sprache zwingt zu einer bestimmten Gruppierungsmethode,
 272 die nicht den Regeln für den Notensatz entspricht.
 273 @end itemize
 274
 275 Diese Probleme wurden angegangen, indem ein Übersetzer für
 276 die Scheme-Programmiersprache integriert wurde und Teile
 277 von LilyPond in Scheme neu geschrieben wurden. Die derzeitige
 278 Formatierungsarchitektur ist um die Notation von graphischen
 279 Objekten herum aufgebaut, die von Scheme-Variablen und -Funktionen
 280 beschrieben werden. Diese Architektur umfasst Formatierungsregeln,
 281 typographische Stile und individuelle Formatierungsentscheidungen.
 282 Der Benutzer hat direkten Zugang zu den meisten dieser Einstellungen.
 283
 284 Scheme-Variablen steuern Layout-Entscheidungen. Zum Beispiel haben
 285 viele graphische Objekte eine Richtungsvariable, die zwischen
 286 oben und unten (oder rechts und links) wählen kann. Hier etwa
 287 sind zwei Akkorde mit Akzenten und Arpeggien.
 288 Beim ersten Akkord sind alle Objekte nach unten (oder links)
 289  ausgerichtet, beim zweiten nach oben (rechts).
 290
 291 @lilypond[quote,ragged-right]
 292 \new Score \with {
 293    \override SpacingSpanner #'spacing-increment = #3
 294    \override TimeSignature #'transparent = ##t
 295 } \relative {
 296    \stemDown <e g b>4_>-\arpeggio
 297    \override Arpeggio #'direction = #RIGHT
 298    \stemUp <e g b>4^>-\arpeggio
 299 }
 300 @end lilypond
 301
 302 @noindent
 303 Der Prozess des Notensatzes besteht für das Programm darin,
 304 die Variablen der graphischen Objekte zu lesen und zu
 305 schreiben. Einige Variablen haben festgelegte Werte. So
 306 ist etwa die Dicke von vielen Linien – ein Charakteristikum
 307 des typographischen Stils – von vornherein festgelegt.
 308 Wenn sie geändert werden, ergibt sich ein anderer typographischer Eindruck.
 309
 310 @lilypond[quote,ragged-right]
 311 fragment = {
 312    \clef bass f8 as8
 313    c'4-~ c'16 as g f e16 g bes c' des'4
 314 }
 315 <<
 316    \new Staff \fragment
 317    \new Staff \with {
 318       \override Beam #'thickness = #0.3
 319       \override Stem #'thickness = #0.5
 320       \override Bar #'thickness = #3.6
 321       \override Tie #'thickness = #2.2
 322       \override StaffSymbol #'thickness = #3.0
 323       \override Tie #'extra-offset = #'(0 .  0.3)
 324       }
 325       \fragment
 326 >>
 327 @end lilypond
 328 Formatierungsregeln sind auch von vornherein festgelegt.
 329 Jedes Objekt hat Variablen, die Vorgänge beschreiben.
 330 Diese Vorgänge machen die eigentlich Satzarbeit, und
 331 wenn man sie durch andere ersetzt, kann ihr Verhalten
 332 verändert werden. Im nächsten Beispiel wird die Regel,
 333  mit der die Notenköpfe gezeichnet werden, verändert.
 334
 335 @lilypond[quote,ragged-right]
 336 #(set-global-staff-size 30)
 337
 338 #(define (mc-squared grob orig current)
 339   (let* ((interfaces (ly:grob-interfaces grob))
 340          (pos (ly:grob-property grob 'staff-position)))
 341     (if (memq 'note-head-interface interfaces)
 342         (begin
 343           (ly:grob-set-property! grob 'stencil ly:text-interface::print)
 344           (ly:grob-set-property! grob 'font-family 'roman)
 345           (ly:grob-set-property! grob 'text
 346             (make-raise-markup -0.5
 347               (case pos
 348                 ((-5) (make-simple-markup "m"))
 349                 ((-3) (make-simple-markup "c "))
 350                 ((-2) (make-smaller-markup (make-bold-markup "2")))
 351                 (else (make-simple-markup "bla")))))))))
 352
 353 \new Voice \relative c' {
 354    \stemUp
 355    \set autoBeaming = ##f
 356    \time 2/4
 357    <d f g>4
 358    \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil
 359    \once \override NoteHead #'font-size = #-7
 360    \once \override NoteHead #'font-family = #'sans
 361    \once \override NoteHead #'font-series = #'bold
 362    <d f g>
 363    \once \override NoteHead #'style = #'cross
 364    <d f g>
 365    \applyOutput #'Voice #mc-squared
 366    <d f g>
 367    <<
 368       { d8[ es-( fis^^ g] fis2-) }
 369       \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
 370    >>
 371 }
 372 @end lilypond
 373
 374
 375
 376 @node What symbols to engrave?
 377 @section What symbols to engrave?
 378
 379 @cindex Notensatz
 380 @cindex Typographie
 381
 382 Während des Notensatzprozesses entscheidet sich, wo
 383 Symbole platziert werden. Das kann aber nur gelingen,
 384 wenn vorher entschieden wird, @emph{welche} Symbole
 385 gesetzt werden sollen, also welche Notation benutzt
 386 werden soll.
 387
 388 Die heutige Notation ist ein System zur Musikaufzeichnung,
 389 das sich über die letzten 1000 Jahre entwickelt hat. Die
 390 Form, die heute üblicherweise benutzt wird, stammt aus dem
 391 frühen Barock. Auch wenn sich die grundlegenden Formen (also
 392 die Notenköpfe, das Fünfliniensystem) nicht verändert hat,
 393 entwickeln sich die Details trotzdem immer noch weiter, um
 394 die Errungenschaften der Neuen Musik darstellen zu können. Die
 395 Notation umfasst also 500 Jahre Musikgeschichte. Ihre Anwendung
 396 reicht von monophonen Melodien bis zu ungeheurem Kontrapunkt
 397 für großes Orchester.
 398
 399 Orchester. Wie bekommen wir dieses vielköpfige Monster zu fassen?
 400 Unsere Lösung ist es, eine strikte Trennung zwischen der Notation,
 401 also welche Symbole benutzt werden, und dem Satz, also wohin sie
 402 gesetzt werden, zu machen. Um das Problem anzupacken, haben wir
 403 es in kleine (programmierbare) Happen zerteilt, so dass jede Art
 404 von Symbol durch ein eigenes Plugin verarbeitet wird. Alle Plugins
 405  kooperieren durch die LilyPond-Architektur. Sie sind vollständig
 406 modular und unabhängig und können somit auch unabhängig voneinander
 407  entwickelt werden. Der Schreiber, der die Musik in Graphik umwandelt,
 408  ist ein Kopist oder Notenstecher (engl. engraver). Darum werden
 409 die Plugins  als @code{engraver} bezeichnet.
 410
 411 Im nächsten Beispiel wird gezeigt, wie mit dem Plugin für die Notenköpfe,
 412 dem @code{Note_heads_engraver} (@qq{Notenkopfstecher}) der Satz begonnen wird.
 413
 414 @lilypond[quote,ragged-right]
 415 \include "engraver-example.ily"
 416
 417 \score {
 418    \topVoice
 419    \layout {
 420    \context {
 421       \Voice
 422       \remove "Stem_engraver"
 423       \remove "Phrasing_slur_engraver"
 424       \remove "Slur_engraver"
 425       \remove "Script_engraver"
 426       \remove "Beam_engraver"
 427       \remove "Auto_beam_engraver"
 428    }
 429    \context {
 430       \Staff
 431       \remove "Accidental_engraver"
 432       \remove "Key_engraver"
 433       \remove "Clef_engraver"
 434       \remove "Bar_engraver"
 435       \remove "Time_signature_engraver"
 436       \remove "Staff_symbol_engraver"
 437       \consists "Pitch_squash_engraver"
 438    }
 439 }
 440 }
 441 @end lilypond
 442
 443 @noindent
 444 Dann fügt ein @code{Staff_symbol_engraver} (@qq{Notensystemstecher})
 445 die Notenlinien hinzu.
 446
 447 @lilypond[quote,ragged-right]
 448 \include "engraver-example.ily"
 449
 450 \score {
 451   \topVoice
 452   \layout {
 453     \context {
 454       \Voice
 455       \remove "Stem_engraver"
 456       \remove "Phrasing_slur_engraver"
 457       \remove "Slur_engraver"
 458       \remove "Script_engraver"
 459       \remove "Beam_engraver"
 460       \remove "Auto_beam_engraver"
 461     }
 462     \context {
 463       \Staff
 464       \remove "Accidental_engraver"
 465       \remove "Key_engraver"
 466       \remove "Clef_engraver"
 467       \remove "Bar_engraver"
 468       \consists "Pitch_squash_engraver"
 469       \remove "Time_signature_engraver"
 470     }
 471   }
 472 }
 473 @end lilypond
 474
 475 @noindent
 476 Der @code{Clef_engraver} (@qq{Notenschlüsselstecher}) definiert
 477 eine Referenzstelle für das System.
 478
 479 @lilypond[quote,ragged-right]
 480 \include "engraver-example.ily"
 481
 482 \score {
 483   \topVoice
 484   \layout {
 485     \context {
 486       \Voice
 487       \remove "Stem_engraver"
 488       \remove "Phrasing_slur_engraver"
 489       \remove "Slur_engraver"
 490       \remove "Script_engraver"
 491       \remove "Beam_engraver"
 492       \remove "Auto_beam_engraver"
 493     }
 494     \context {
 495       \Staff
 496       \remove "Accidental_engraver"
 497       \remove "Key_engraver"
 498       \remove "Bar_engraver"
 499       \remove "Time_signature_engraver"
 500     }
 501   }
 502 }
 503 @end lilypond
 504
 505 @noindent
 506 Der @code{Stem_engraver} (@qq{Halsstecher}) schließlich fügt
 507  Hälse hinzu.
 508
 509 @lilypond[quote,ragged-right]
 510 \include "engraver-example.ily"
 511
 512 \score {
 513   \topVoice
 514   \layout {
 515     \context {
 516       \Voice
 517       \remove "Phrasing_slur_engraver"
 518       \remove "Slur_engraver"
 519       \remove "Script_engraver"
 520       \remove "Beam_engraver"
 521       \remove "Auto_beam_engraver"
 522     }
 523     \context {
 524       \Staff
 525       \remove "Accidental_engraver"
 526       \remove "Key_engraver"
 527       \remove "Bar_engraver"
 528       \remove "Time_signature_engraver"
 529     }
 530   }
 531 }
 532 @end lilypond
 533
 534 @noindent
 535 Dem @code{Stem_engraver} wird jeder Notenkopf mitgeteilt,
 536 der vorkommt. Jedes Mal wenn ein (oder mehrere bei einem Akkord)
 537 Notenkopf erscheint, wird ein Hals-Objekt erstellt und an den
 538 Kopf geheftet. Wenn wir dann noch engraver für Balken, Bögen,
 539 Akzente, Vorzeichen, Taktlinien, Taktangaben und Tonartbezeichnungen
 540 hinzufügen, erhalten wir eine vollständige Notation.
 541
 542
 543 @lilypond[quote,ragged-right]
 544 \include "engraver-example.ily"
 545 \score { \topVoice }
 546 @end lilypond
 547
 548 Dieses System funktioniert gut für monophone Musik, aber wie geht
 549 es mit Polyphonie? Hier müssen sich mehrere Stimmen ein System teilen.
 550
 551 @lilypond[quote,ragged-right]
 552 \include "engraver-example.ily"
 553 \new Staff << \topVoice \\ \botVoice >>
 554 @end lilypond
 555
 556 In diesem Fall werden das System und die Vorzeichen geteilt, aber die
 557 Hälse, Bögen, Balken usw. sind jeder einzelnen Stimme eigen. Die engraver
 558 müssen also gruppiert werden. Die Köpfe, Hälse, Bögen usw. werden
 559 in einer Gruppe mit dem Namen @qq{Voice context} (Stimmenkontext)
 560 zusammengefasst, die engraver für den Schlüssel, die Vorzeichen,
 561 Taktstriche usw. dagegen in einer Gruppe mit dem Namen @qq{Staff context}
 562 (Systemkontext). Im Falle von Polyphonie hat ein Staff context dann also
 563 mehr als einen Voice context. Auf gleiche Weise können auch mehrere Staff
 564  contexte in einen großen Score context (Partiturkontext) eingebunden werden.
 565
 566 @seealso
 567
 568 Programmreferenz: @internalsref{Contexts}.
 569
 570 @lilypond[quote,ragged-right]
 571 \include "engraver-example.ily"
 572 \score {
 573    <<
 574       \new Staff << \topVoice \\ \botVoice >>
 575       \new Staff << \pah \\ \hoom >>
 576    >>
 577 }
 578 @end lilypond
 579
 580 @node Music representation
 581 @section Music representation
 582
 583 Idealerweise ist das Eingabeformat für ein höheres Satzsystem die
 584 abstrakte Beschreibung des Inhaltes. In diesem Fall wäre das die
 585 Musik selber. Das stellt uns aber vor ein ziemlich großes Problem,
 586 denn wie können wir definieren, was Musik wirklich ist? Anstatt darauf
 587 eine Antwort zu suchen, haben wir die Frage einfach umgedreht. Wir
 588 schreiben ein Programm, das den Notensatz beherrscht und passen das
 589 Format an, so einfach wie möglich zu sein. Wenn es nicht mehr vereinfacht
 590 werden kann, haben wir per Definition nur noch den reinen Inhalt. Unser
 591 Format dient als die formale Definition eines Musiktextes.
 592
 593 Die Syntax ist gleichzeitig die Benutzerschnittstelle bei LilyPond,
 594 darum soll sie einfach zu schreiben sein; z. B. bedeutet
 595
 596 @example
 597 c'4 d'8
 598 @end example
 599
 600 @noindent
 601 eine Viertel c' und eine Achtel d', wie in diesem Beispiel:
 602
 603 @lilypond[quote,fragment]
 604 c'4 d'8
 605 @end lilypond
 606
 607 In kleinem Rahmen ist diese Syntax sehr einfach zu benutzen. In
 608 größeren Zusammenhängen aber brauchen wir Struktur. Wie sonst kann
 609 man große Opern oder Symphonien notieren? Diese Struktur wird
 610 gewährleistet durch sog. music expressions (Musikausdrücke): indem
 611 kleine Fragmente zu größeren kombiniert werden, kann mehr Komplexität
 612 ausgedrückt werden. So etwa hier:
 613
 614 @lilypond[quote,verbatim,fragment,relative=1]
 615 c4
 616 @end lilypond
 617
 618 @noindent
 619 Gleichzeitig erklingende Noten werden hinzugefügt, indem man alle in << und >> einschließt.
 620
 621 @c < > is not a music expression,
 622 @c so we use <<>> iso. <> to drive home the point of
 623 @c expressions.  Don't change this back --hwn.
 624 @example
 625 <<c4 d4 e4>>
 626 @end example
 627
 628 @lilypond[quote,fragment,relative=1]
 629 \new Voice { <<c4 d4 e>> }
 630 @end lilypond
 631
 632 @noindent
 633 Um aufeinanderfolgende Noten darzustellen, werden sie in geschweifte Klammern gefasst:
 634
 635 @code{@{@tie{}@dots{}@tie{}@}}
 636
 637 @example
 638 @{ f4 <<c4 d4 e4>> @}
 639 @end example
 640
 641 @lilypond[quote,relative=1,fragment]
 642 { f4 <<c d e4>> }
 643 @end lilypond
 644
 645 @noindent
 646 Dieses Gebilde ist in sich wieder ein Ausdruck, und kann
 647 daher mit einem anderen Ausdruck kombiniert werden (hier mit einer Halben).
 648
 649 @example
 650 << g2 \\ @{ f4 <<c4 d4 e4>> @} >>
 651 @end example
 652
 653 @lilypond[quote,fragment,relative=2]
 654 \new Voice { << g2 \\ { f4 <<c d e>> } >> }
 655 @end lilypond
 656
 657 Solche geschachtelten Strukturen können sehr gut in einer
 658 kontextunabhängigen Grammatik beschrieben werden. Der Programmcode
 659 für den Satz ist auch mit solch einer Grammatik erstellt. Die Syntax
 660 von LilyPond ist also klar und ohne Zweideutigkeiten definiert.
 661
 662 Die Benutzerschnittstelle und die Syntax werden als erstes vom Benutzer
 663 wahrgenommen. Teilweise ist es eine Frage des Geschmackes und auch ein
 664 Objekt vieler Diskussionen. Auch wenn Geschmacksfragen ihre Berechtigung
 665 haben, sind sie nicht sehr produktiv. Im großen Rahmen von LilyPond
 666 spielt die Eingabe-Syntax nur eine geringe Rolle, denn eine logische
 667 Syntax zu schreiben ist einfach, guten Formatierungscode aber sehr viel
 668 schwieriger. Das kann auch die Zeilenzahl der Programmzeilen zeigen:
 669 Analysieren und Darstellen nimmt nur etwa 10% des Codes ein:
 670
 671 @node Example applications
 672 @section Example applications
 673
 674 Wir haben LilyPond als einen Versuch geschrieben, wie man die Kunst des
 675 Musiksatzes in ein Computerprogramm komprimieren kann. Dieses
 676 Programm kann nun dank vieler harter Arbeitsstunden benutzt werden,
 677 um sinnvolle Aufgaben zu erledigen. Die einfachste ist dabei der
 678 Notendruck.
 679
 680 @lilypond[quote,relative=1,fragment]
 681 \time 2/4 c4 c g'4 g a4 a g2
 682 @end lilypond
 683
 684 @noindent
 685 Indem wir Akkordsymbole und einen Text hinzufügen, erhalten wir
 686 ein Lead Sheet.
 687
 688 @lilypond[quote,ragged-right]
 689 <<
 690    \chords { c2 c f2 c }
 691    \new Staff \relative c' { \time 2/4 c4 c g'4 g a4 a g2 }
 692    \new Lyrics \lyricmode { twin4 kle twin kle lit tle star2 }
 693 >>
 694 @end lilypond
 695
 696 Mehrstimmige Notation und Klaviermusik kann auch gesetzt werden. Das
 697 nächste Beispiel zeigt einige etwas exotischere Konstruktionen:
 698
 699 @lilypondfile[quote,ragged-right]{screech-boink.ly}
 700
 701 Dieses Beispiel wurde vollständig selbst geschrieben, aber das ist nicht
 702 nötig. Da der Satz fast vollständig automatisch abläuft, kann er auch
 703 als eine Ausgabe-Erweiterung für andere Programme dienen, die Musik
 704 manipulieren. So können etwa ganze Datenbanken musikalischer Fragmente automatisch
 705 in Notenbilder umgewandelt werden, die dann auf Internetseiten oder
 706 in Multimediapräsentation Anwendung finden.
 707
 708 Dieses Benutzerhandbuch zeigt eine weiter Möglichkeit: Das Eingabeformat
 709 der Noten ist reiner Text, darum könne sie sehr einfach integriert werden
 710 in andere textbasierte Formate wie etwa @LaTeX{}, HTML oder, wie in diesem
 711 Fall, Texinfo. Durch ein spezielles Programm werden die Eingabefragmente durch
 712 Notenbilder in der resultierenden PDF- oder HTML-Datei ersetzt. Dadurch ist
 713 es sehr einfach, Musik und Text zu kombinieren.
 714
 715
 716
 717 @node About this manual
 718 @section About this manual
 719
 720 Es gibt zwei Handbücher zu LilyPond: das @emph{Benutzerhandbuch} (dieses
 721 Dokument) und das @emph{Handbuch über die Programmbenutzung}.
 722
 723
 724 @subheading User manual
 725
 726 Das Handbuch ist in drei Bücher geteilt.
 727
 728 @subsubheading Learning manual
 729
 730 In diesem Buch wird erklärt, wie man das Programm LilyPond erlernt; mit
 731 einfachen Begriffen werden einige Schlüsselkonzepte erklärt. Die Kapitel
 732 sollten hintereinander gelsen werden.
 733
 734 @itemize @bullet
 735
 736 @item
 737 @ifhtml
 738 Die
 739 @end ifhtml
 740 @emph{@ref{Tutorial}},
 741 stellt eine einfache Einführung in den Musiksatz dar. Neulinge sollten hiermit
 742 beginnen.
 743
 744 @item
 745 @emph{@ref{Putting it all together}},
 746 erklärt generelle Konzepte des LilyPond-Dateiformates. Wenn Sie sich nicht
 747 sicher sind, wohin ein Befehl gesetzt werden soll, lesen Sie hier nach.
 748
 749 @item
 750 @emph{@ref{Working on LilyPond projects}},
 751 zeigt den wirklichen Einsatz von LilyPond und gibt Hinweise, wie einige
 752 Probleme vermieden werden können.
 753
 754 @item
 755 @emph{@ref{Tweaking output}},
 756 stellt dar, wie die Standardeinstellungen von LilyPond verändert werden können.
 757
 758 @end itemize
 759
 760
 761 @subsubheading Notation reference
 762
 763 In diesem Buch werden alle LilyPond-Befehle erklärt, die Notationszeichen
 764 produzieren. Es geht von der Annahme aus, dass der Leser sich mit den
 765 Grundkonzeption des Programmes im Handbuch zum Lernen bekannt gemacht hat.
 766
 767 @itemize @bullet
 768
 769 @item
 770 @emph{@ref{Basic notation}},
 771 erklärt alles über die grundlegenden Notationskonstruktionen. Dieses Kapitel
 772 ist für fast jedes Notationsprojekt  nützlich.
 773
 774 @item
 775 @emph{@ref{Instrument-specific notation}},
 776 erklärt spezifische Schwierigkeiten, die sich bei bestimmten Notationstypen
 777 ergeben. Dieses Kapitel ist nur in entsprechenden Fällen bestimmter Instrumente
 778 oder bei Gesang zu konsultieren.
 779
 780 @item
 781 @emph{@ref{Advanced notation}},
 782 erklärt komplizierte oder unübliche Anwendungen nach Notationsgegenstand geordnet.
 783
 784 @item
 785 @emph{@ref{Changing defaults}},
 786 erklärt, wie des Layout getrimmt werden kann.
 787
 788 @item
 789 @emph{@ref{Non-musical notation}},
 790 zeigt alles, was nicht direkt mit den Noten zu tun hat wie Titel, mehrere Sätze oder
 791 wie man ein MIDI-Instrument auswählt.
 792
 793 @item
 794 @emph{@ref{Spacing issues}},
 795 befasst sich mit globalen Fragen wie der Definition von Papierformaten
 796 oder wie man Seitenumbrüche definiert.
 797
 798 @item
 799 @emph{@ref{Interfaces for programmers}},
 800 demonstriert die Erstellung von musikalischen Funktionen.
 801
 802 @end itemize
 803
 804
 805 @subsubheading Appendices
 806
 807 In diesem Buch werden nützliche Referenztabellen gezeigt.
 808
 809 @itemize @bullet
 810 @item
 811 @ifhtml
 812 Die
 813 @end ifhtml
 814 @emph{@ref{Literature list}},
 815 enthält einige wichtige Quellen für alle, die mehr über Notation und
 816 den Notensatz erfahren wollen.
 817
 818 @item
 819 Die
 820 @emph{@ref{Scheme tutorial}},
 821 stellt eine kurze Einleitung in die Scheme-Sprache dar, mit dem
 822 die musikalischen Funktionen gebildet werden.
 823
 824 @item
 825 @emph{@ref{Notation manual tables}},
 826 sind Tabellen, in denen Akkordbezeichnungen, MIDI-Instrumente,
 827 Farbbezeichnungen und die Zeichen der Feta-Schriftart gesammelt sind.
 828
 829 @item
 830 @emph{@ref{Templates}},
 831 von LilyPond-Stücken. Kopieren Sie einfach hier, fügen Sie in ihre Datei
 832 ein und schreiben Sie noch die Noten dazu. Das ist alles!
 833
 834 @item
 835 Die
 836 @emph{@ref{Cheat sheet}},
 837 zeigt die wichtigsten LilyPond-Befehle.
 838
 839 @item
 840 Der
 841 @emph{@ref{LilyPond command index}},
 842 listet alle Befehle auf, die mit @code{\} anfangen.
 843
 844 @item
 845 Der
 846 @emph{@ref{LilyPond index}},
 847 ist ein vollständiger Index.
 848
 849 @end itemize
 850
 851
 852 @subheading Program usage
 853
 854 In diesem Buch wird erklärt, wie das Programm ausgeführt wird und
 855 wie die Notation von LilyPond in andere Programme integriert werden
 856 kann.
 857
 858 @itemize @bullet
 859
 860 @item
 861 @emph{@rprogram{Install}},
 862 erklärt wie LilyPond installiert wird (inclusive Kompilation, wenn es
 863 nötig sein sollte).
 864
 865 @item
 866 @emph{@rprogram{Setup}},
 867 erklärt wie der Computer eingerichtet wird, damit LilyPond optimal genutzt
 868 werden kann. Hierzu gehören etwa spezielle Umgebungen für bestimmte
 869 Texteditoren.
 870
 871 @item
 872 @emph{@rprogram{Running LilyPond}},
 873 zeigt, wie LilyPond und seine Hilfprogramme gestartet werden. Zusätzlich
 874 wird hier erklärt, wie Quelldateien von alten LilyPond-Versionen aktualisiert
 875 werden können.
 876
 877 @item
 878 @emph{@rprogram{LilyPond-book}},
 879 erklärt die Details, um einen Text mit eingefügten Notenbeispielen (wie
 880 etwa dieses Handbuch) zu
 881 erstellen.
 882
 883 @item
 884 @emph{@rprogram{Converting from other formats}},
 885 erklärt, wie die Konvertierungsprogramme aufgerufen werden. Diese
 886 Programme kommen mit LilyPond zusammen und konvertieren eine Vielzahl
 887 von Notensatzformaten in das @code{.ly}-Format.
 888
 889 @end itemize
 890
 891
 892 @subsubheading Other information
 893
 894 Es gibt einige andere Orte, die sehr wertvolle Information enthalten.
 895 @itemize @bullet
 896 @cindex Dialekt
 897 @cindex Jargon
 898 @cindex Terminologie
 899 @cindex Fremdsprache
 900 @cindex Sprache
 901 @cindex Englische Begriffe
 902
 903 @item
 904 @ifnottex
 905 Das @ref{Top,Musik-Glossar,,music-glossary}, erklärt musikalische Ausdrücke
 906 und stellt Übersetzungen für einige Sprachen bereit. Es ist auch als PDF
 907 erhältlich.
 908 @end ifnottex
 909 @iftex
 910 Das Musik-Glossar erklärt musikalische Ausdrücke
 911 und stellt Übersetzungen für einige Sprachen bereit. Es ist auch als PDF
 912 erhältlich.
 913 @end iftex
 914 Wenn Sie sich mit der Notation von Musik nicht auskennen (und besonders,
 915 wenn Englisch nicht Ihre Muttersprache ist), wird dieses Glossar von
 916 großer Hilfe sein.
 917
 918 @cindex Schnipsel
 919 @cindex LSR
 920 @item
 921 Die
 922 @ifhtml
 923 @uref{source/input/lsr/collated-files.html,Schnipsel}
 924 @end ifhtml
 925 @ifnothtml
 926 Schnipsel
 927 @end ifnothtml
 928 sind eine ausführliche Sammlung kurzer Beispiele, anhand derer Tricks,
 929 Tipps und Spezialfunktionen von LilyPond demonstriert werden. Die meisten
 930 dieser Schnipsel können auch im
 931  @uref{http://lsr.dsi.unimi.it/,LilyPond Schnipsel
 932 Depot} betrachtet werden. Diese Internetseite verfügt auch über ein
 933 durchsuchbares LilyPond-Handbuch.
 934
 935
 936 @item
 937 Die
 938 @iftex
 939 Programmreferenz
 940 @end iftex
 941 @ifnottex
 942 @ref{Top,Programmreferenz,,lilypond-internals}
 943 @end ifnottex
 944 ist eine Sammlung intensiv verlinkter HTML-Seiten,
 945 die alle Details jeder einzelnen LilyPond-Klasse, jedes Objektes und
 946 jeder Funktion erklären. Sie wird direkt aus den Satzdefinitionen
 947 produziert.
 948
 949 So gut wie alle Formatierungsmöglichkeiten, die intern verwendet werden,
 950 sind auch direkt für den Benutzer zugänglich. Alle Variablen z. B., die
 951 Dicke-Werte, Entfernungen usw. kontrollieren, können in den Eingabe-Dateien
 952 verändert werden. Es gibt eine riesige Anzahl von Formatierungsoptionen, und
 953 alle haben einen @qq{Siehe}-Abschnitt, der auf die Dokumentation verweist.
 954 Im HTML-Handbuch haben diese Abschnitte klickbare Links.
 955
 956 Die Programmreferenz ist nur auf englisch erhältlich.
 957
 958
 959 @end itemize
 960
 961 Wenn Sie schon ein erfahrener Benutzer sind, können Sie dieses Handbuch
 962 als Referenz benutzen: Es enthält einen ausführlichen Index@footnote{Wenn
 963 Sie nach etwas suchen und es nicht im Handbuch finden, so gilt das als Fehler.
 964 Bitte schicken Sie in diesem Fall einen Fehlerbericht.}, aber das Dokument
 965 ist auch als
 966 @iftex
 967 große HTML-Seite erhältlich,
 968 @end iftex
 969 @ifhtml
 970 @uref{source/Documentation/user/lilypond-big-page.html, eine große Seite
 971 erhältlich},
 972 @end ifhtml
 973 die auf einfache Art mit der Suchfunktion Ihres Browsers durchsucht werden kann.
 974
 975 Auf allen HTML-Seiten, die Noten eingebettet haben, deren Ausgabe mit LilyPond
 976 vorgenommen wurde, kann die originale Quelldatei durch einen Klick auf das
 977 Bild betrachtet werden.
 978
 979 Der Speicherort der Dokumentationsdateien unterscheidet sich evtl. je
 980 nach Betriebssystem. Manchmal wird hier auf Initialisierungs- oder
 981 Beispieldateien verwiesen. Das Handbuch nimmt dabei an, dass diese
 982 Dateien sich relativ zum Quellverzeichnis befinden. Zum Beispiel würde
 983 der Pfad @file{input/@/lsr/@/Verzeichnis/@/bla@/.ly} etwa auf die Datei
 984 @file{lilypond@/2.x.y/@/input/@/lsr/@/Verzeichnis/@/bla@/.ly} verweisen. In den
 985 Binärpaketen für Unix-Plattformen sind Dokumentation und Beispiele
 986 üblicherweise in einem Verzeichnis wie @file{/usr/@/share/@/doc/@/lilypond/}
 987 gespeichert. Initialisierungsdateien, etwa  @file{scm/@/lily@/.scm},
 988 oder @file{ly/@/engraver@/-init@/.ly}, befinden sich normalerweise im
 989 Verzeichnis @file{/usr/@/share/@/lilypond/}.
 990
 991 @cindex Anpassen der Ausgabe
 992 @cindex Variablen
 993 @cindex Eigenschaften
 994 @cindex properties
 995 @cindex lilypond-internals
 996 @cindex interne Dokumentation
 997 @cindex Scheme
 998 @cindex Erweiterung von LilyPond
 999 @cindex Index
1000
1001 Dieses Handbuch (so wie alle anderen) ist als PDF- oder HTML-Datei von
1002 LilyPonds Internetseite @uref{http://@/www@/.lilypond@/.org/} herunterladbar.