Documentation/de/user/working.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @c This file is part of lilypond.tely
   3 @ignore
   4     Translation of GIT committish: 550152ed5d5015d13abf2af83b2e040f996a66a4
   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 @c \version "2.11.61"
  11
  12 @node Working on LilyPond projects
  13 @chapter Working on LilyPond projects
  14
  15 Dieses Kapitel erklärt, wie bestimmte häufige Probleme zu
  16 lösen oder ganz zu vermeiden sind.  Wenn Sie schon
  17 Programmiererfahrung mitbringen, erscheinen diese Hinweise
  18 vielleicht überflüssig, aber es wird dennoch empfohlen, dieses Kapitel
  19 zu lesen.
  20
  21
  22 @menu
  23 * Suggestions for writing LilyPond input files::
  24 * When things don't work::
  25 * Scores and parts::
  26 @end menu
  27
  28
  29 @node Suggestions for writing LilyPond input files
  30 @section Suggestions for writing LilyPond input files
  31
  32 Jetzt sind Sie so weit, größere Stücke mit LilyPond zu schreiben --
  33 nicht
  34 nur die kleinen Beispiele aus der Übung, sondern ganze Stücke.
  35 Aber wie geht man das am besten an?
  36
  37 Solange LilyPond Ihre Dateien versteht und die Noten so setzt,
  38 wie Sie das wollen, spielt es eigentlich keine Rolle, wie Ihre
  39 Dateien aussehen.  Es gibt aber trotzdem ein paar Dinge, die man
  40 beim Schreiben von LilyPond-Code berücksichtigen sollte.
  41
  42 @itemize @bullet
  43 @item Was ist, wenn Sie einen Fehler machen?  Die Struktur einer
  44 LilyPond-Datei kann es erleichtern (oder erschweren), bestimmte
  45 Fehler zu finden.
  46
  47 @item Was ist, wenn Sie Ihre Dateien mit jemandem austauschen
  48 wollen?  Oder Ihre Dateien nach einige Jahren noch einmal überarbeiten
  49 wollen?  Manche LilyPond-Dateien versteht man auf den ersten Blick,
  50 über anderen muss man eine Stunde grübeln, um die Struktur zu ahnen.
  51
  52 @item Was ist, wenn sie Ihre Dateien auf eine neuere LilyPond-Version
  53 aktualisieren wollen?  Die Syntax der Eingabesprache verändert sich
  54 allmählich mit Verbesserungen im Programm.  Die meisten Veränderungen
  55 können automatisch durch @code{convert-ly} gelöst werden, aber
  56 bestimmte Änderungen brauchen Handarbeit.  LilyPond-Dateien können
  57 strukturiert werden, damit sie einfacher aktualisierbar sind.
  58 @end itemize
  59
  60 @menu
  61 * General suggestions::
  62 * Typesetting existing music::
  63 * Large projects::
  64 * Saving typing with variables and functions::
  65 * Style sheets::
  66 @end menu
  67
  68
  69 @node General suggestions
  70 @subsection General suggestions
  71
  72 Hier einige Vorschläge, wie Sie Probleme vermeiden oder lösen können:
  73
  74 @itemize @bullet
  75 @item @strong{Schreiben Sie immer mit @code{\version} die
  76 Versionsnummer
  77 in jede Datei}.  Beachten Sie, dass in allen Vorlagen die Versionsnummer
  78 @code{\version "2.11.61"} eingetragen ist.  Es empfiehlt sich, in alle
  79 Dateien, unabhängig von ihrer Größe, den @code{\version}-Befehl
  80 einzufügen.  Persönliche Erfahrung hat gezeigt, dass es ziemlich
  81 frustrierend sein kann zu erinnern, welche Programmversion man etwa
  82 vor einem Jahr verwendet hat.  Auch @code{convert-ly} benötigt die
  83 Versionsnummer.
  84
  85 @item @strong{Benutzen Sie Überprüfungen}: @ruser{Octave checks}, und
  86 @ruser{Bar and bar number checks}.  Wenn Sie hier und da diese
  87 Überprüfungen einfügen, finden Sie einen möglichen Fehler weit
  88 schneller.  Wie oft aber ist @qq{hier und da}?  Das hängt von der
  89 Komplexität der Musik ab.  ei einfachen Stücken reicht es vielleicht
  90 ein- oder zweimal, in sehr komplexer Musik sollte man sie vielleicht
  91 in jeden Takt einfügen.
  92
  93 @item @strong{Ein Takt pro Textzeile}.  Wenn irgendetwas kompliziertes
  94 vorkommt, entweder in der Musik selber oder in der Anpassung der
  95 Ausgabe,
  96 empfiehlt es sich oft, nur einen Takt pro Zeile zu schreiben.
  97 Bildschirmplatz zu sparen, indem Sie acht Takte in eine Zeile zwängen,
  98 hilft nicht weiter, wenn Sie ihre Datei @qq{debuggen} müssen.
  99
 100 @item @strong{Kommentieren Sie ihre Dateien}.  Benutzen Sie entweder
 101 Taktnummern (in regelmäßigen Abständen) oder Verweise auf musikalische
 102 Themen (@qq{Zweites Thema in den Geigen}, @qq{vierte Variation} usw.).
 103 Sie brauchen diese Kommentare vielleicht noch nicht, wenn Sie das Stück
 104 notieren, aber spätestens wenn Sie nach ein paar Jahren etwas
 105 verändern
 106 wollen oder Sie den Quelltext an einen Freund weitergeben wollen,
 107 ist es weitaus komplizierter, die Dateistruktur ohne Kommentare zu
 108 verstehen, als wenn Sie sie rechtzeitig eingefügt hätten.
 109
 110 @item @strong{Schreiben Sie Klammern mit Einrückung}.  Viele
 111 Probleme entstehen durch ungerade Anzahl von  @code{@{} and
 112 @code{@}}-Klammern.
 113
 114 @item @strong{Schreiben Sie Tondauerangaben} am Anfang von
 115 Abschnitten und Bezeichnern.  Wenn Sie beispielsweise
 116  @code{c4 d e} am Anfang eines Abschnittes schreiben,
 117 ersparen Sie sich viele Probleme, wenn Sie ihre Musik
 118 eines Tages umarrangieren wollen.
 119
 120 @item @strong{Trennen Sie Einstellungen} von den eigentlichen
 121 Noten.  Siehe auch @ref{Saving typing with variables and functions}
 122 und
 123 @ref{Style sheets}.
 124
 125 @end itemize
 126
 127
 128 @node Typesetting existing music
 129 @subsection Typesetting existing music
 130
 131 Wenn Sie Musik aus einer fertigen Partitur kopieren (z. B. die
 132 LilyPond-Eingabe einer gedruckten Partitur):
 133
 134 @itemize @bullet
 135
 136 @item Schreiben Sie ein System ihrer Quelle nach dem anderen
 137 (aber trotzdem nur einen Takt pro Textzeile) und überprüfen
 138 Sie jedes System, nachdem Sie es fertig kopiert haben.  Mit dem
 139 @code{showLastLength}-Befehl können Sie den Übersetzungsprozess
 140 beschleunigen. Siehe auch
 141 @ruser{Skipping corrected music}.
 142
 143 @item Definieren Sie @code{mBreak = @{ \break @}} und schreiben Sie
 144  @code{\mBreak} in der Quelldatei immer dann, wenn im Manuskript
 145 ein Zeilenumbruch vorkommt.  Das macht es einfacher, die gesetzte
 146 Zeile mit den ursprünglichen Noten zu vergleichen.  Wenn Sie die
 147 Partitur fertig gestellt haben, könne Sie  @code{mBreak = @{ @}},
 148 also leer definieren, um diese manuellen Zeilenumbrüche zu entfernen.
 149 Damit kann dann LilyPond selber entscheiden, wohin es passende
 150 Zeilenumbrüche platziert.
 151
 152 @end itemize
 153
 154
 155 @node Large projects
 156 @subsection Large projects
 157
 158 Besonders wenn Sie an größeren Projekten arbeiten, ist es
 159 unumgänglich, dass Sie ihre LilyPond-Dateien klar strukturieren.
 160
 161 @itemize @bullet
 162
 163 @item @strong{Verwenden Sie Variablen für jede Stimme}, innerhalb
 164 der Definition sollte so wenig Struktur wie möglich sein.  Die
 165 Struktur des @code{\score}-Abschnittes verändert sich am ehesten,
 166 während die @code{violine}-Definition sich wahrscheinlich mit einer
 167 neuen Programmversion nicht verändern wird.
 168
 169 @example
 170 violine = \relative c'' @{
 171 g4 c'8. e16
 172 @}
 173 ...
 174 \score @{
 175   \new GrandStaff @{
 176     \new Staff @{
 177       \violine
 178     @}
 179   @}
 180 @}
 181 @end example
 182
 183 @item @strong{Trennen Sie Einstellungen von den Noten}.  Diese
 184 Empfehlung wurde schon im Abschnitt @ref{General suggestions} gegeben,
 185 aber für große Projekte ist es unumgänglich.  Muss z. B. die
 186 Definition für @code{fdannp} verändert werden, so braucht
 187 man es nur einmal vorzunehmen und die Noten in der Geigenstimme,
 188 @code{violin}, bleiben unberührt.
 189
 190 @example
 191 fdannp = _\markup@{
 192   \dynamic f \italic \small @{ 2nd @} \hspace #0.1 \dynamic p @}
 193 violin = \relative c'' @{
 194 g4\fdannp c'8. e16
 195 @}
 196 @end example
 197
 198 @end itemize
 199
 200
 201 @node Saving typing with variables and functions
 202 @subsection Saving typing with variables and functions
 203
 204 @cindex Variable
 205 @cindex Bezeichner
 206
 207 Bis jetzt haben Sie immer etwa solche Noten gesehen:
 208
 209 @lilypond[quote,verbatim,ragged-right]
 210 hornNotes = \relative c'' { c4 b dis c }
 211 \score {
 212   {
 213     \hornNotes
 214   }
 215 }
 216 @end lilypond
 217
 218 Das könnte auch nützlich in Minimal-Music sein:
 219
 220 @lilypond[quote,verbatim,ragged-right]
 221 fragA = \relative c'' { a4 a8. b16 }
 222 fragB = \relative c'' { a8. gis16 ees4 }
 223 violin = \new Staff { \fragA \fragA \fragB \fragA }
 224 \score {
 225   {
 226     \violin
 227   }
 228 }
 229 @end lilypond
 230
 231 Sie können diese Bezeichner oder Variablen aber auch für
 232 (eigene) Einstellungen verwenden:
 233
 234 @lilypond[quote,verbatim,ragged-right]
 235 dolce = \markup{ \italic \bold dolce }
 236 padText = { \once \override TextScript #'padding = #5.0 }
 237 fthenp=_\markup{ \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p }
 238 violin = \relative c'' {
 239   \repeat volta 2 {
 240     c4._\dolce b8 a8 g a b |
 241     \padText
 242     c4.^"hi there!" d8 e' f g d |
 243     c,4.\fthenp b8 c4 c-. |
 244   }
 245 }
 246 \score {
 247   {
 248     \violin
 249   }
 250 \layout{ragged-right=##t}
 251 }
 252 @end lilypond
 253
 254 Die Variablen haben in diesem Beispiel deutlich die
 255 Tipparbeit erleichtert.  Aber es lohnt sich, sie zu
 256 einzusetzen, auch wenn man sie nur einmal anwendet,
 257 denn sie vereinfachen die Struktur.
 258 Hier ist das vorangegangene Beispiel ohne
 259 Variablen.  Es ist sehr viel komplizierter zu lesen,
 260 besonders die letzte Zeile.
 261
 262 @example
 263 violin = \relative c'' @{
 264   \repeat volta 2 @{
 265     c4._\markup@{ \italic \bold dolce @} b8 a8 g a b |
 266     \once \override TextScript #'padding = #5.0
 267     c4.^"hi there!" d8 e' f g d |
 268     c,4.\markup@{ \dynamic f \italic \small @{ 2nd @}
 269       \hspace #0.1 \dynamic p @} b8 c4 c-. |
 270   @}
 271 @}
 272 @end example
 273
 274 @c TODO Replace the following with a better example  -td
 275 @c Skylining handles this correctly without padText
 276
 277 Bis jetzt wurde nur statische Substitution vorgestellt
 278 -- wenn LilyPond den Befehl @code{\padText} findet, wird
 279 er ersetzt durch durch unsere vorherige Definition (alles,
 280 was nach dem @code{padtext =} kommt).
 281
 282 LilyPond kennt aber auch nicht-statische Substitutionen (man
 283 kann sie sich als Funktionen vorstellen).
 284
 285 @lilypond[quote,verbatim,ragged-right]
 286 padText =
 287 #(define-music-function (parser location padding) (number?)
 288   #{
 289     \once \override TextScript #'padding = #$padding
 290   #})
 291
 292 \relative c''' {
 293   c4^"piu mosso" b a b
 294   \padText #1.8
 295   c4^"piu mosso" d e f
 296   \padText #2.6
 297   c4^"piu mosso" fis a g
 298 }
 299 @end lilypond
 300
 301 Die Benutzung von Variablen hilft auch, viele Schreibarbeit zu
 302 vermeiden, wenn die Eingabesyntax von LilyPond sich verändert
 303 (siehe auch @ref{Updating old files}).  Wenn nur eine einzige
 304 Definition (etwa @code{\dolce}) für alle Dateien verwendet wird
 305 (vgl. @ref{Style sheets}), muss nur diese einzige Definition
 306 verändert werden, wenn sich die Syntax ändert.  Alle Verwendungen
 307 des Befehles beziehen sich dann auf die neue Definition.
 308
 309 @node Style sheets
 310 @subsection Style sheets
 311
 312 Die Ausgabe, die LilyPond erstellt, kann sehr stark modifiziert
 313 werden, siehe @ref{Tweaking output} für Einzelheiten.  Aber wie
 314 kann man diese Änderungen auf eine ganze Serie von Dateien
 315 anwenden?  Oder die Einstellungen von den Noten trennen?  Das
 316 Verfahren ist ziemlich einfach.
 317
 318 Hier ist ein Beispiel.  Es ist nicht schlimm, wenn Sie nicht auf
 319 Anhieb die Abschnitte mit den ganzen @code{#()} verstehen.  Das
 320 wird im Kapitel @ref{Advanced tweaks with Scheme} erklärt.
 321
 322 @lilypond[quote,verbatim,ragged-right]
 323 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
 324   #:line(#:dynamic "mp" #:text #:italic "dolce" )))
 325 tempoMark = #(define-music-function (parser location markp) (string?)
 326 #{
 327   \once \override Score . RehearsalMark #'self-alignment-X = #left
 328   \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
 329   \mark \markup { \bold $markp }
 330 #})
 331
 332 \relative c'' {
 333   \tempo 4=50
 334   a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
 335   \tempoMark "Poco piu mosso"
 336   cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
 337 }
 338 @end lilypond
 339
 340 Es treten einige Probleme mit überlappenden Symbolen auf. Sie
 341 werden beseitigt mit den Tricks aus dem Kapitel @ref{Moving objects}.
 342 Aber auch die @code{mpdolce} und @code{tempoMark}-Definitionen
 343 können verbessert werden.  Sie produzieren das Ergebnis, das
 344 gewünscht ist, aber es wäre schön, sie auch in anderen Stücken
 345 verwenden zu können.  Man könnte sie natürlich einfach kopieren
 346 und in die anderen Dateien einfügen, aber das ist lästig.  Die
 347 Definitionen verbleiben auch in der Notendatei und diese @code{#()}
 348 sehen nicht wirklich schön aus.  Sie sollen in einer anderen
 349 Datei versteckt werden:
 350
 351 @example
 352 %%% speichern in einer Datei "definitions.ly"
 353 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
 354   #:line(#:dynamic "mp" #:text #:italic "dolce" )))
 355 tempoMark = #(define-music-function (parser location markp) (string?)
 356 #@{
 357   \once \override Score . RehearsalMark #'self-alignment-X = #left
 358   \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
 359   \mark \markup @{ \bold $markp @}
 360 #@})
 361 @end example
 362
 363 Jetzt muss natürlich noch die Notendatei angepasst werden (gespeichert
 364 unter dem Namen @file{"music.ly"}).
 365
 366 @c  We have to do this awkward example/lilypond-non-verbatim
 367 @c  because we can't do the \include stuff in the manual.
 368
 369 @example
 370 \include "definitions.ly"
 371
 372 \relative c'' @{
 373   \tempo 4=50
 374   a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
 375   \once \override Score.RehearsalMark #'padding = #2.0
 376   \tempoMark "Poco piu mosso"
 377   cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
 378 @}
 379 @end example
 380
 381 @lilypond[quote,ragged-right]
 382 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
 383   #:line(#:dynamic "mp" #:text #:italic "dolce" )))
 384 tempoMark = #(define-music-function (parser location markp) (string?)
 385 #{
 386   \once \override Score . RehearsalMark #'self-alignment-X = #left
 387   \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
 388   \mark \markup { \bold $markp }
 389 #})
 390
 391 \relative c'' {
 392   \tempo 4=50
 393   a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
 394   \once \override Score.RehearsalMark #'padding = #2.0
 395   \tempoMark "Poco piu mosso"
 396   cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
 397 }
 398 @end lilypond
 399
 400 Das sieht schon besser aus, aber es sind noch einige Verbesserungen
 401 möglich.
 402 Das Glissando ist schwer zu sehen, also soll es etwas dicker erscheinen
 403 und dichter an den Notenköpfen gesetzt werden.  Das Metronom-Zeichen
 404 soll über dem Schlüssel erscheinen, nicht über der ersten Note.  Und
 405 schließlich kann unser Kompositionsprofessor @qq{C}-Taktangaben
 406 überhaupt nicht leiden, also
 407 müssen sie in @qq{4/4} verändert werden.
 408
 409 Diese Veränderungen sollten Sie aber nicht in der @file{music.ly}-Datei
 410 vornehmen.  Ersetzen Sie die @file{definitions.ly}-Datei hiermit:
 411
 412 @example
 413 %%%  definitions.ly
 414 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
 415   #:line( #:dynamic "mp" #:text #:italic "dolce" )))
 416 tempoMark = #(define-music-function (parser location markp) (string?)
 417 #@{
 418   \once \override Score . RehearsalMark #'self-alignment-X = #left
 419   \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
 420   \mark \markup @{ \bold $markp @}
 421 #@})
 422
 423 \layout@{
 424   \context @{ \Score
 425     \override MetronomeMark #'extra-offset = #'(-9 . 0)
 426     \override MetronomeMark #'padding = #'3
 427   @}
 428   \context @{ \Staff
 429     \override TimeSignature #'style = #'numbered
 430   @}
 431   \context @{ \Voice
 432     \override Glissando #'thickness = #3
 433     \override Glissando #'gap = #0.1
 434   @}
 435 @}
 436 @end example
 437
 438 @lilypond[quote,ragged-right]
 439 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
 440   #:line( #:dynamic "mp" #:text #:italic "dolce" )))
 441 tempoMark = #(define-music-function (parser location markp) (string?)
 442 #{
 443   \once \override Score . RehearsalMark #'self-alignment-X = #left
 444   \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
 445   \mark \markup { \bold $markp }
 446 #})
 447
 448 \layout{
 449   \context { \Score
 450     \override MetronomeMark #'extra-offset = #'(-9 . 0)
 451     \override MetronomeMark #'padding = #'3
 452   }
 453   \context { \Staff
 454     \override TimeSignature #'style = #'numbered
 455   }
 456   \context { \Voice
 457     \override Glissando #'thickness = #3
 458     \override Glissando #'gap = #0.1
 459   }
 460 }
 461
 462 \relative c'' {
 463   \tempo 4=50
 464   a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
 465   \once \override Score.RehearsalMark #'padding = #2.0
 466   \tempoMark "Poco piu mosso"
 467   cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
 468 }
 469 @end lilypond
 470
 471 Das sieht schon besser aus!  Aber angenommen Sie möchten dieses
 472 Stück jetzt veröffentlichen.  Ihr Kompositionsprofessor mag
 473 die @qq{C}-Taktangaben nicht, aber Sie finden sie irgendwie
 474 schöner.  Also kopieren Sie die Datei @file{definitions.ly} nach
 475 @file{web-publish.ly} und verändern diese.  Weil die Noten
 476 in einer PDF-Datei auf dem Bildschirm angezeigt werden sollen,
 477 bietet es sich auch an, die gesamte Ausgabe zu vergrößern.
 478
 479 @example
 480 %%%  definitions.ly
 481 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
 482   #:line( #:dynamic "mp" #:text #:italic "dolce" )))
 483 tempoMark = #(define-music-function (parser location markp) (string?)
 484 #@{
 485   \once \override Score . RehearsalMark #'self-alignment-X = #left
 486   \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
 487   \mark \markup @{ \bold $markp @}
 488 #@})
 489
 490 #(set-global-staff-size 23)
 491 \layout@{
 492   \context @{ \Score
 493     \override MetronomeMark #'extra-offset = #'(-9 . 0)
 494     \override MetronomeMark #'padding = #'3
 495   @}
 496   \context @{ \Staff
 497   @}
 498   \context @{ \Voice
 499     \override Glissando #'thickness = #3
 500     \override Glissando #'gap = #0.1
 501   @}
 502 @}
 503 @end example
 504
 505 @lilypond[quote,ragged-right]
 506 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
 507   #:line( #:dynamic "mp" #:text #:italic "dolce" )))
 508 tempoMark = #(define-music-function (parser location markp) (string?)
 509 #{
 510   \once \override Score . RehearsalMark #'self-alignment-X = #left
 511   \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
 512   \mark \markup { \bold $markp }
 513 #})
 514
 515 #(set-global-staff-size 23)
 516 \layout{
 517   \context { \Score
 518     \override MetronomeMark #'extra-offset = #'(-9 . 0)
 519     \override MetronomeMark #'padding = #'3
 520   }
 521   \context { \Voice
 522     \override Glissando #'thickness = #3
 523     \override Glissando #'gap = #0.1
 524   }
 525 }
 526
 527 \relative c'' {
 528   \tempo 4=50
 529   a4.\mpdolce d8 cis4--\glissando a | b4 bes a2
 530   \once \override Score.RehearsalMark #'padding = #2.0
 531   \tempoMark "Poco piu mosso"
 532   cis4.\< d8 e4 fis | g8(\! fis)-. e( d)-. cis2
 533 }
 534 @end lilypond
 535
 536 In der Notendatei muss jetzt nur noch @code{\include "definitions.ly"}
 537 durch @code{\include "web-publish.ly"} ausgetauscht werden.
 538 Das könnte man natürlich noch weiter vereinfachen.  Also
 539 eine Datei @file{definitions.ly}, die nur die Definitionen
 540 von @code{mpdolce} und @code{tempoMark} enthält, eine Datei
 541 @file{web-publish.ly}, die alle die Änderungen für den
 542 @code{\layout}-Abschnitt enthält und eine Datei @file{university.ly}
 543 für eine Ausgabe, die den Wünschen des Professors entspricht.
 544 Der Anfang der @file{music.ly}-Datei würde dann so aussehen:
 545
 546 @example
 547 \include "definitions.ly"
 548
 549 %%%  Nur eine der beiden Zeilen auskommentieren!
 550 \include "web-publish.ly"
 551 %\include "university.ly"
 552 @end example
 553
 554 Durch diese Herangehensweise kann auch bei der Erstellung
 555 von nur einer Ausgabeversion Arbeit gespart werden.  Ich
 556 benutze ein halbes Dutzend verschiedener Stilvorlagen
 557 für meine Projekte.  Jede Notationsdatei fängt an mit
 558 @code{\include "../global.ly"}, welches folgenden Inhalt hat:
 559
 560
 561 @example
 562 %%%   global.ly
 563 \version "2.11.61"
 564 #(ly:set-option 'point-and-click #f)
 565 \include "../init/init-defs.ly"
 566 \include "../init/init-layout.ly"
 567 \include "../init/init-headers.ly"
 568 \include "../init/init-paper.ly"
 569 @end example
 570
 571
 572 @node When things don't work
 573 @section When things don't work
 574
 575 @menu
 576 * Updating old files::
 577 * Troubleshooting (taking it all apart)::
 578 * Minimal examples::
 579 @end menu
 580
 581 @node Updating old files
 582 @subsection Updating old files
 583
 584 Die Syntax von LilyPond verändert sich ab und zu.  Wenn LilyPond
 585 besser wird, muss auch die Syntax (Eingabesprache) entsprechend
 586 angepasst werden.  Teilweise machen diese Veränderungen die
 587 Eingabesprache einfacher lesbar, teilweise dienen sie dazu, neue
 588 Eigenschaften des Programmes benutzbar zu machen.
 589
 590 LilyPond stellt ein Programm bereit, das Aktualisierungen
 591 vereinfacht: @code{convert-ly}.  Einzelheiten zur Programmbenutzung
 592 finden sich in @rprogram{Updating files with convert-ly}.
 593
 594 Leider kann @code{convert-ly} nicht alle Veränderungen der Syntax
 595 berücksichtigen.  Hier werden einfache @qq{Suchen und
 596 Ersetzen}-Veränderungen vorgenommen (wie etwa @code{raggedright} zu
 597 @code{ragged-right}), aber einige Veränderungen sind zu
 598 kompliziert.  Die Syntax-Veränderungen, die das Programm nicht
 599 berücksichtigt, sind im Kapitel @rprogram{Updating files with
 600 convert-ly} aufgelistet.
 601
 602 Zum Beispiel wurden in LilyPond 2.4 und früheren Versionen
 603 Akzente und Umlaute mit LaTeX-Befehlen eingegeben, ein
 604 @qq{No\"el} etwa ergäbe das französische Wort für Weihnachten.
 605 In LilyPond 2.6 und höher müssen diese Sonderzeichen direkt
 606 als utf-8-Zeichen eingegeben werden, in diesem Fall also @qq{ë}.
 607 @code{convert-ly} kann nicht alle dieser LaTeX-Befehle
 608 verändern, das muss manuell vorgenommen werden.
 609
 610
 611 @node Troubleshooting (taking it all apart)
 612 @subsection Troubleshooting (taking it all apart)
 613
 614 Früher oder später werden Sie in die Lage kommen,
 615 dass LilyPond Ihre Datei nicht kompilieren will.  Die
 616 Information, die LilyPond während der Übersetzung
 617 gibt, können Ihnen helfen, den Fehler zu finden, aber
 618 in vielen Fällen müssen Sie nach der Fehlerquelle
 619 auf die Suche gehen.
 620
 621 Die besten Hilfsmittel sind in diesem Fall das Zeilen-
 622 und Blockkommentar (angezeigt durch @code{%} bzw.
 623 @code{%@{ ... %@}}).  Wenn Sie nicht bestimmen können,
 624 wo sich das Problem befindet, beginnen Sie damit, große
 625 Teile des Quelltextes auszukommentieren.  Nachdem Sie
 626 einen Teil auskommentiert haben, versuchen Sie, die Datei
 627 erneut zu übersetzen.  Wenn es jetzt funktioniert, muss
 628 sich das Problem innerhalb der Kommentare befinden.
 629 Wenn es nicht funktioniert, müssen Sie weitere Teile
 630 auskommentieren bis sie eine Version haben, die funktioniert.
 631
 632 In Extremfällen bleibt nur noch solch ein Beispiel übrig:
 633
 634 @example
 635 \score @{
 636   <<
 637     % \melody
 638     % \harmony
 639     % \bass
 640   >>
 641   \layout@{@}
 642 @}
 643 @end example
 644
 645 @noindent
 646 (also eine Datei ohne Noten).
 647
 648 Geben Sie nicht auf, wenn das vorkommen sollte.  Nehmen
 649 Sie das Kommentarzeichen von einem Teil wieder weg, sagen
 650 wir der Bassstimme, und schauen Sie, ob es funktioniert.
 651 Wenn nicht, dann kommentieren Sie die gesamte Bassstimme
 652 aus, aber nicht den @code{\bass}-Befehl in dem
 653  @code{\score}-Abschnitt:
 654
 655 @example
 656 bass = \relative c' @{
 657 %@{
 658   c4 c c c
 659   d d d d
 660 %@}
 661 @}
 662 @end example
 663
 664 Jetzt beginnen Sie damit, langsam Stück für Stück der
 665 Bassstimme wieder hineinzunehmen, bis Sie die problematische
 666 Zeile finden.
 667
 668 Eine andere nützliche Technik zur Problemlösung ist es,
 669 @ref{Minimal examples} zu konstruieren.
 670
 671
 672 @node Minimal examples
 673 @subsection Minimal examples
 674
 675 Ein Minimalbeispiel ist eine Beispieldatei, die so klein wie
 676 möglich ist.  Diese Beispiele sind sehr viel einfacher zu
 677 verstehen als die langen Originaldateien.  Minimalbeispiele
 678 werden benutzt, um
 679
 680
 681 @itemize
 682 @item Fehlerberichte zu erstellen,
 683 @item eine Hilfeanfrage an die E-Mail-Liste zu schicken,
 684 @item Ein Beispiel zur @uref{http://lsr@/.dsi@/.unimi@/.it/,LilyPond
 685 Schnipselsammlung} hinzuzufügen.
 686 @end itemize
 687
 688 Um ein Beispiel zu konstruieren, das so klein wie möglich ist,
 689 gibt es eine einfache Regel:  Alles nicht Notwendige entfernen.
 690 Wenn Sie unnötige Teile einer Datei entfernen, bietet es sich an,
 691 sie auszukommentieren und nicht gleich zu löschen.  Auf diese Weise
 692 können Sie eine Zeile leicht wieder mit aufnehmen, sollten Sie sie
 693 doch brauchen, anstatt sie von Anfang an neu zu schreiben.
 694
 695 Es gibt zwei Ausnahmen dieser @qq{So klein wie möglich}-Regel:
 696
 697 @itemize
 698 @item Fügen Sie immer einen @code{\version}Befehl ein.
 699 @item Wenn es möglich ist, benutzen Sie @code{\paper@{ ragged-right = ##t @}}
 700 am Beginn des Beispiels.
 701 @end itemize
 702
 703 Der Sinn der Minimalbeispiele ist, dass sie einfach lesbar sind:
 704
 705 @itemize
 706 @item Vermeiden Sie es, komplizierte Noten, Schlüssel oder Taktangaben
 707 zu verwenden, es sei denn, Sie wollen genau an diesen Elementen
 708 etwas demonstrieren.
 709 @item Benutzen Sie keine @code{\override}-Befehle, wenn sie nicht der
 710 Zweck des Beispieles sind.
 711 @end itemize
 712
 713
 714 @node Scores and parts
 715 @section Scores and parts
 716
 717 Orchesternoten werden alle zweimal gesetzt. Erstens als Stimmen für
 718 die Musiker, und dann als große Partitur für den Dirigenten.  Mit
 719 Variablen
 720 kann hier doppelte Arbeit erspart werden. Die Musik muss nur einmal
 721 eingegeben werden und wird in einer Variable abgelegt.  Der Inhalt
 722 dieser
 723 Variable wird dann benutzt, um sowohl die Stimme als auch die Partitur
 724 zu erstellen.
 725
 726 Es bietet sich an, die Noten in eigenen Dateien zu speichern.  Sagen wir
 727 beispielsweise, dass in der Datei @file{Horn-Noten.ly} die folgenden
 728 Noten eines Duetts für Horn und Fagott gespeichert sind:
 729
 730 @example
 731 HornNoten = \relative c @{
 732   \time 2/4
 733   r4 f8 a cis4 f e d
 734 @}
 735 @end example
 736
 737 @noindent
 738 Daraus wird dann eine eigene Stimme gemacht, indem folgende Datei
 739 erstellt
 740 wird:
 741
 742 @example
 743 \include "Horn-Noten.ly"
 744 \header @{
 745   instrument = "Horn in F"
 746 @}
 747
 748 @{
 749  \transpose f c' \HornNoten
 750 @}
 751 @end example
 752
 753 Die Zeile
 754
 755 @example
 756 \include "Horn-Noten.ly"
 757 @end example
 758
 759 @noindent
 760 setzt den Inhalt der Datei @file{Horn-Noten.ly} an die Stelle des
 761 Befehls in die aktuelle Datei.  Damit besteht also eine Definition
 762 für @code{HornNoten}, so dass die Variable verwendet werden kann.
 763 Der Befehl @code{\transpose f@tie{}c'} zeigt an, dass das Argument,
 764 also @code{\HornNoten}, um eine Quinte nach oben transponiert wird.
 765 Klingendes @q{f} wird also als @code{c'} notiert.  Das entspricht
 766 der Notation eines Waldhorns in F.  Die Transposition zeigt die folgende
 767 Ausgabe:
 768
 769 @lilypond[quote,ragged-right]
 770 \transpose f c' \relative c {
 771   \time 2/4
 772   r4 f8 a cis4 f e d
 773 }
 774 @end lilypond
 775
 776 In der Musik für mehrere Instrumente kommt es oft vor, dass eine Stimme
 777 für mehrere Takte nicht spielt.  Das wird mit einer besonderen Pause
 778 angezeigt, dem Pausenzeichen für mehrere Takte (engl. multi-measure
 779 rest).  Sie wird mit dem @emph{großen} Buchstaben @samp{R} eingegeben,
 780 gefolgt von einer Dauer (@code{1}@tie{}für eine Ganze, @code{2}@tie{}
 781 für eine Halbe usw.).  Indem man die Dauer multipliziert, können längere
 782 Pausen erstellt werden.  Z. B. dauert diese Pause drei Takte eines
 783 2/4-Taktes:
 784
 785 @example
 786 R2*3
 787 @end example
 788
 789 Wenn die Stimme gedruckt wird, müssen diese Pausen zusammengezogen
 790 werden.
 791 Das wird durch eine Variable erreicht:
 792
 793 @example
 794 \set Score.skipBars = ##t
 795 @end example
 796
 797 @noindent
 798 Dieser Befehl setzt die Eigenschaft des @code{skipBars} (@qq{überspringe
 799 Takte}) auf wahr (@code{##t}).  Wenn diese Option und die Pause
 800 zu der Musik des Beispiels gesetzt wird, erhält man folgendes Ergebnis:
 801
 802 @lilypond[quote,ragged-right]
 803 \transpose f c' \relative c {
 804   \time 2/4
 805   \set Score.skipBars = ##t
 806   R2*3
 807   r4 f8 a cis4 f e d
 808 }
 809 @end lilypond
 810
 811 Die Partitur wird erstellt, indem alle Noten zusammengesetzt werden.
 812 Angenommen, die andere Stimme trägt den Namen @code{FagottNoten}
 813  und ist in der Datei @file{Fagott-Noten.ly} gespeichert.  Die
 814 Partitur sieht dann folgendermaßen aus:
 815
 816 @example
 817 \include "Fagott-Noten.ly"
 818 \include "Horn-Noten.ly"
 819
 820 <<
 821   \new Staff \HornNoten
 822   \new Staff \FagottNoten
 823 >>
 824 @end example
 825
 826 @noindent
 827 Und mit LilyPond übersetzt:
 828
 829 @lilypond[quote,ragged-right]
 830 \relative c <<
 831   \new Staff {
 832     \time 2/4 R2*3
 833     r4 f8 a cis4 f e d
 834   }
 835   \new Staff {
 836     \clef bass
 837     r4 d,8 f | gis4 c | b bes |
 838     a8 e f4 | g d | gis f
 839   }
 840 >>
 841 @end lilypond
 842
 843