Documentation/de/learning/tutorial.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
   2
   3 @ignore
   4     Translation of GIT committish: 354f8ea159bb5216202e5815685fca8bd7e6919c
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  For details, see the Contributors'
   8     Guide, node Updating translation committishes..
   9 @end ignore
  10
  11 @c \version "2.13.4"
  12 @c Translators: Till Paala, Reinhold Kainhofer
  13 @c Translation checkers: Hajo Bäß
  14
  15 @node Übung
  16 @chapter Übung
  17 @translationof Tutorial
  18
  19 Dieses Kapitel stellt dem Leser das grundlegende Arbeiten mit LilyPond
  20 vor.
  21
  22 @menu
  23 * Eine Quelldatei übersetzen::
  24 * Arbeiten an Eingabe-Dateien::
  25 * Wie soll das Handbuch gelesen werden::
  26 @end menu
  27
  28
  29 @node Eine Quelldatei übersetzen
  30 @subsection Eine Quelldatei übersetzen
  31 @translationof Compiling a file
  32
  33 Dieser Abschnitt führt in die @qq{Kompilation} ein -- den
  34 Bearbeitungsprozess von LilyPond-Eingabedateien (die Sie geschrieben
  35 haben) um eine Ausgabedatei zu erstellen.
  36
  37 @menu
  38 * Noten eingeben::
  39 * MacOS X::
  40 * Windows::
  41 * Kommandozeile::
  42 @end menu
  43
  44 @node Noten eingeben
  45 @subsection Noten eingeben
  46 @translationof Entering input
  47
  48 @cindex Kompilieren
  49 @cindex erstes Beispiel
  50 @cindex Beispiel, erstes
  51 @cindex Übersetzen von Quelltext
  52 @cindex Groß- und Kleinschreibung
  53 @cindex Quelltext, übersetzen
  54 @cindex Großbuchstaben
  55 @cindex Kleinbuchstaben
  56
  57 @qq{Kompilation} ist der Begriff, der benutzt wird, um eine
  58 Lilypond-Eingabedatei mit dem Programm LilyPond in eine
  59 Notenausgabe umzuwandeln.  Ausgabedateien sind in erster Linie
  60 PDF-Dateien (zum Anschauen und Drucken), MIDI (zum Abspielen)
  61 und PNG (für die Benutzung auf Internetseiten).  Die Eingabedateien
  62 von LilyPond sind einfache Textdateien.
  63
  64 Das erste Beispiel zeigt, wie
  65 solch eine einfache Eingabedatei ausschauen kann.
  66
  67 @example
  68 @{
  69   c' e' g' e'
  70 @}
  71 @end example
  72
  73 Die graphische Ausgabe ist:
  74
  75 @c  in this case we don't want verbatim
  76 @lilypond[quote]
  77 {
  78   c' e' g' e'
  79 }
  80 @end lilypond
  81
  82 @warning{In jeder LilyPond-Datei müssen
  83 @strong{@{ geschweifte Klammern @}} um die Noten
  84 oder Gesangstext
  85 gesetzt werden. Vor und hinter den Klammern sollten
  86 Leerzeichen eingegeben werden, damit keine Unklarheiten
  87 in Verbindung mit den eigentlichen Notensymbolen entstehen.
  88 An Anfang und Ende der Zeile können diese Leerzeichen auch
  89 weggelassen werden. Es kann sein, dass in diesem Handbuch
  90 die Klammern in manchen Beispielen fehlen, aber man sollte
  91 immer daran denken, sie in den eigenen Dateien zu benutzen!
  92 Mehr Informationen zu der Darstellung der Beispiele in diesem
  93 Handbuch gibt der Abschnitt @ref{Wie soll das Handbuch gelesen werden}.}
  94
  95 Zusätzlich unterscheidet LilyPond @strong{Groß- und Kleinschreibung}.
  96 @w{@code{ @{ c d e @}}} ist zulässiger Code,
  97 @w{@code{ @{ C D E @}}} dagegen resultiert in einer Fehlermeldung.
  98
  99 @smallspace
 100
 101 @subheading Ansicht des Ergebnisses
 102
 103 @cindex PDF-Datei
 104 @cindex Noten anzeigen
 105 @cindex Anzeigen der Noten
 106 @cindex Ansicht von Noten
 107 @cindex Editoren
 108 @cindex Texteditoren
 109 @cindex LilyPond unter MacOS X
 110 @cindex MacOS X, LilyPond starten
 111 @cindex Starten von LilyPond
 112
 113 Das Erstellen der Notenausgabe hängt davon ab, welches Betriebssystem
 114 und welche Programme Sie benutzen.
 115
 116 @itemize
 117
 118 @item
 119 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
 120 @ref{MacOS X, MacOS X} (graphisch)
 121
 122 @item
 123 @ref{Windows, @sourceimage{logo-windows,,,}}
 124 @ref{Windows, Microsoft Windows} (graphisch)
 125
 126 @item
 127 @ref{Kommandozeile, @sourceimage{logo-linux,,,}
 128 @sourceimage{logo-freebsd,,,}
 129 @sourceimage{logo-macosx,,,}
 130 @sourceimage{logo-windows,,,}
 131 }
 132 @ref{Kommandozeile, Alle Betriebssysteme} (Kommandozeile)
 133
 134 @end itemize
 135
 136 Beachten Sie, dass es eine Reihe an Texteditoren mit besserer
 137 Unterstützung für LilyPond gibt. Mehr dazu im Abschnitt
 138 @rprogram{Unterstützung von Texteditoren}.
 139 @c FIXME: link to @rweb{Alternate input}
 140
 141 @warning{Das erste Mal, wenn Sie LilyPond benutzen, kann es eine
 142 Minute oder länger dauern, weil das Programm zuerst alle Schriftarten,
 143 die auf dem System zur Verfügung stehen, untersucht. Aber nach
 144 diesem ersten Mal läuft LilyPond sehr viel schneller.}
 145
 146 @node MacOS X
 147 @subsection MacOS X
 148 @translationof MacOS X
 149
 150 @warning{Diese Anweisungen gehen davon aus, dass Sie die
 151 LilyPond-Application benutzen.  Wenn Sie eins der Programme benutzen, die in @rweb{Leichteres Editieren} beschrieben sind, schauen
 152 Sie bitte in der Dokumentation nach, wenn Sie Probleme damit haben,
 153 eine Datei zu kompilieren.}
 154
 155
 156 @subsubheading 1. Schritt: Erstellen Sie eine @file{.ly}-Datei
 157
 158 Wenn Sie das @command{LilyPond.app}-Symbol doppelt klicken, öffnet
 159 sich eine Beispiel-Datei.
 160
 161 @sourceimage{Learning_Macos_welcome,,,}
 162
 163 Wählen Sie aus den Menüs oben links auf Ihrem Bildschirm
 164 @w{@code{File > Save}}.
 165
 166 @sourceimage{Learning_Macos_Save_menu,,,}
 167
 168 Wählen Sie einen Namen für die Datei, etwa @file{test.ly}.
 169
 170 @sourceimage{Learning_Macos_Save_file_with_name,,,}
 171
 172
 173 @subsubheading 2. Schritt: Kompilieren (mit LilyPad)
 174
 175 Aus den selben Menüs wählen Sie jetzt @w{@code{Compile > Tyepset}}.
 176
 177 @sourceimage{Learning_Macos_Typeset_menu,,,}
 178
 179 Ein neues Fenster öffnet sich, in dem ein Forschrittslog der
 180 Kompilation der von ihnen gerade gespeicherten Datei gezeigt
 181 wird.
 182
 183 @sourceimage{Learning_Macos_Compiling_log,,,}
 184
 185 @subsubheading 3. Schritt: Ausgabe anschauen
 186
 187 Wenn die Kompilation fertig ist, wird ein PDF mit dem gleichen
 188 Namen wie das Original erstellt und automatisch mit dem
 189 Standard-PDF-Programm geöffnet und angezeigt.
 190
 191 @sourceimage{Learning_Macos_pdf_output,,,}
 192
 193
 194 @subsubheading Andere Befehle
 195
 196 Um neue LilyPond-Dateien zu erstellen beginnen sie mit
 197 @w{@code{File > New}}
 198
 199 @sourceimage{Learning_Macos_New_menu,,,}
 200
 201 @noindent
 202 oder @w{@code{File > Open}} um eine schon existierende Datei zu
 203 öffnen und zu editieren.
 204
 205 @sourceimage{Learning_Macos_Open_menu,,,}
 206
 207 Sie müssen alle Änderungen an der Datei zuerst speichern, bevor Sie
 208 wieder @w{@code{Compile > Tyepset}} wählen.  Wenn das PDF nicht
 209 erscheint, schauen Sie im Fortschrittslog nach Fehlern.
 210
 211 Wenn Sie nicht das Standard-PDF-Programm benutzen, das automatisch
 212 bei Mac OS X dabei ist, und Sie die PDF-Datei noch von einer vorigen
 213 Kompilation geöffnet haben, können weitere Kompilationen fehlschlagen,
 214 bis Sie das Original-PDF schließen.
 215
 216
 217 @cindex Windows, LilyPond starten
 218
 219 @node Windows
 220 @subsection Windows
 221 @translationof Windows
 222
 223 @warning{Diese Anweisungen gehen davon aus, dass Sie den installierten
 224 LilyPad-Editor benutzen.  Wenn Sie eins der Programme benutzen, die in @rweb{Alternate input} beschrieben sind, schauen
 225 Sie bitte in der Dokumentation nach, wenn Sie Probleme damit haben,
 226 eine Datei zu kompilieren.}
 227
 228 @subsubheading 1. Schritt: Erstellen Sie eine @file{.ly}-Datei
 229
 230 Wenn sie auf das LilyPond-Symbol auf dem Desktop doppelklicken,
 231 öffnet sich ein einfacher Texteditor mit einer Beispieldatei.
 232
 233 @sourceimage{Learning_Win7_Welcome_File_Whole,,,}
 234
 235 Aus dem Menü über der Beispieldatei wählen Sie @w{@code{File > Save as}}.
 236 Benutzen Sie nicht @w{@code{File > Save}} für die Beispieldatei,
 237 weil die Datei nicht funktioniert, bis Sie sie mit einem eigenen
 238 Namen gespeichert haben.
 239
 240 @sourceimage{Learning_Win7_Save_Menu,,,}
 241
 242 Wählen Sie einen Namen für Ihre Datei, etwa @file{test.ly}.
 243
 244 @sourceimage{Learning_Win7_Save_File_With_Name,,,}
 245
 246
 247 @subsubheading Schritt 2a: Kompilieren (mit drag-and-drop)
 248
 249 Sie können nach Belieben die Kompilation starten, indem Sie
 250 entweder:
 251
 252 Die Datei auf das LilyPond-Symbol ziehen.
 253
 254 @sourceimage{Learning_Win7_Open_Dragndrop,,,}
 255
 256 Klicken Sie mit der rechten Maustaste auf die Datei und wählen
 257 Sie aus dem Menü @w{@code{Open with > LilyPond}}.
 258
 259 @sourceimage{Learning_Win7_Open_Context_Menu,,,}
 260
 261
 262 @subsubheading Schritt 2b: Kompilieren (mit Doppelklick)
 263
 264 Oder klicken Sie einfach die Datei @file{test.ly} doppelt an.
 265
 266
 267 @subsubheading 3. Schritt: Ausgabe anschauen
 268
 269 Während der Kompilation von @file{test.ly} öffnet sich ein
 270 Kommandofenster sehr schnell und schließt sich wieder.  Drei
 271 zusätzliche Dateien werden in diesem Schritt erstellt.
 272
 273 @sourceimage{Learning_Win7_All_Files_Created,,,}
 274
 275 Das PDF enthält den Notensatz aus der Datei @file{test.ly}.
 276
 277 @sourceimage{Learning_Win7_Pdf_Output,,,}
 278
 279
 280 @subsubheading Andere Befehle
 281
 282 Um eine neue Datei zu erstellen, wählen Sie @w{@code{File > New}}
 283 aus irgendeiner schon erstellten Datei.
 284
 285 @sourceimage{Learning_Win7_New_Menu,,,}
 286
 287 @noindent
 288 oder @w{@code{File > Open}}, um eine Datei zu öffnen und zu
 289 bearbeiten, die Sie schon vorher gespeichert hatten.
 290
 291 @sourceimage{Learning_Win7_Open_Menu,,,}
 292
 293 Sie müssen jede neue Änderung erst speichern, bevor Sie die Datei
 294 kompilieren.  Wenn kein PDF erstellt wird, öffnen Sie die Log-Datei
 295 und schauen Sie nach Fehlern.
 296
 297 @sourceimage{Learning_Win7_Log_File,,,}
 298
 299 Die Log-Datei wird jedes Mal überschrieben, wenn Sie Ihre
 300 LilyPond-Datei kompilieren.
 301
 302 Die PS-Datei wird intern von LilyPond benutzt um das PDF zu erstellen
 303 und kann ignoriert werden.  Sie wird auch jedes Mal neu überschrieben.
 304
 305 Wenn Sie das PDF in einem PDF-Programm anschauen, müssen Sie es
 306 zuerst schließen, bevor Sie eine neue Kompilation durchführen
 307 können, denn es kann einen Fehler bei der Erstellung des neuen
 308 PDFs geben, wenn das alte noch geöffnet ist.
 309
 310
 311 @cindex Unix, LilyPond starten
 312
 313 @node Kommandozeile
 314 @subsection Kommandozeile
 315 @translationof Command-line
 316
 317 @warning{Diese Anweisungen gehen davon aus, dass Sie den installierten
 318 LilyPad-Editor benutzen.  Wenn Sie eins der Programme benutzen, die in @rweb{Alternate input} beschrieben sind, schauen
 319 Sie bitte in der Dokumentation nach, wenn Sie Probleme damit haben,
 320 eine Datei zu kompilieren.}
 321
 322 @subsubheading Schritt 1: Erstellen Sie eine @file{.ly}-Datei
 323
 324
 325 Erstellen Sie eine Text-Datei mit dem Namen @file{test.ly} und
 326 geben Sie folgenden Text ein:
 327
 328 @example
 329 @{
 330   c' e' g' e'
 331 @}
 332 @end example
 333
 334 @subsubheading Schritt 2: Kompilieren (auf der Kommandozeile)
 335
 336 Um die Datei zu kompilieren, geben sie an der Konsole bzw. Kommandozeile
 337
 338 @example
 339 lilypond test.ly
 340 @end example
 341
 342 @noindent
 343 ein.
 344 Sie werden ungefähr folgende Meldungen sehen:
 345
 346
 347 @example
 348 lilypond test.ly
 349 GNU LilyPond @version{}
 350 »test.ly« wird verarbeitet
 351 Analysieren...
 352 Interpretation der Musik...
 353 Vorverarbeitung der grafischen Elemente...
 354 Ideale Seitenanzahl wird gefunden...
 355 Musik wird auf eine Seite angepasst...
 356 Systeme erstellen...
 357 Layout nach »test.ps« ausgeben...
 358 Konvertierung nach »test.pdf«...
 359 @end example
 360
 361 @subsubheading 3. Schritt: Ausgabe anschauen
 362
 363 Als Ergebnis erhalten Sie ein @file{test.pdf}, das Sie mit den
 364 Standardprogrammen Ihres Betriebssystemes anschauen können.
 365
 366
 367
 368 @node Wie werden Eingabe-Dateien geschrieben
 369 @section Wie werden Eingabe-Dateien geschrieben
 370 @translationof How to write input files
 371
 372 Dieser Abschnitt erklärt die grundlegende LilyPond-Syntax und hilft
 373 bei den ersten Anfängen, eine LilyPond-Eingabedatei zu schreiben.
 374
 375 @menu
 376 * Einfache Notation::
 377 * Arbeiten an Eingabe-Dateien::
 378 @end menu
 379
 380
 381
 382 @node Einfache Notation
 383 @subsection Einfache Notation
 384 @translationof Simple notation
 385
 386 @cindex einfache Notation
 387 @cindex Notation, einfach
 388
 389 LilyPond fügt einige Bestandteile des Notenbildes automatisch hinzu. Im
 390 nächsten Beispiel sind nur vier Tonhöhen angegeben, aber LilyPond setzt
 391 trotzdem einen Schlüssel, eine Taktangabe und Notendauern.
 392
 393 @lilypond[verbatim,quote]
 394 {
 395   c' e' g' e'
 396 }
 397 @end lilypond
 398
 399 @noindent
 400 Diese Einstellungen können verändert werden, aber in den meisten Fällen
 401 sind die automatischen Werte durchaus brauchbar.
 402
 403 @subheading Tonhöhen
 404
 405 @cindex Tonhöhen
 406 @cindex relativer Modus
 407 @cindex Apostroph
 408 @cindex Komma
 409 @cindex Versetzungszeichen und relativer Modus
 410 @cindex relativer Modus und Versetzungszeichen
 411
 412 @funindex \relative
 413 @funindex relative
 414 @funindex '
 415 @funindex ,
 416
 417
 418 Glossar: @rglos{pitch}, @rglos{interval},
 419 @rglos{scale}, @rglos{middle C}, @rglos{octave},
 420 @rglos{accidental}.
 421
 422 @c Addition for German users about pitch naming conventions
 423 Die Tonhöhen werden mit Kleinbuchstaben eingegeben, die den Notennamen
 424 entsprechen. Es ist jedoch wichtig zu wissen, dass LilyPond in seiner
 425 Standardeinstellung die englischen Notennamen verwendet. Bis auf eine
 426 Ausnahme entsprechen sie den deutschen, deshalb wird die Voreinstellung
 427 von LilyPond für diese Übung beibehalten. Die @emph{Ausnahme} ist das h -- in
 428 LilyPond muss man anstelle dessen b schreiben! Das deutsche b dagegen
 429 wird als bes notiert, ein his dagegen würde bis geschrieben. Siehe auch
 430 @ruser{Versetzungszeichen} und @ruser{Notenbezeichnungen in anderen Sprachen}, hier
 431 wird beschrieben,
 432 wie sich die deutschen Notennamen benutzen lassen.
 433 @c end addition
 434
 435 Am einfachsten können Noten im @code{\relative}-Modus
 436 eingegeben werden. In diesem Modus wird die Oktave der Note automatisch
 437 gewählt, indem angenommen wird, dass die folgende Note immer so nah
 438 wie möglich in Bezug auf die vorhergehende gesetzt wird, d. h. sie
 439 wird höchstens drei Notenzeilen höher oder tiefer als die vorhergehende
 440 Note gesetzt. Fangen
 441 wir unser erstes Notationsbeispiel mit einer @notation{Tonleiter} an, wo also
 442 die nächste Note immer nur eine Notenlinie über der vorherigen steht.
 443
 444 @c KEEP LY
 445 @lilypond[verbatim,quote]
 446 % Beginnpunkt auf das mittlere C setzen
 447 \relative c' {
 448   c d e f
 449   g a b c
 450 }
 451 @end lilypond
 452
 453 Die erste Note ist ein @notation{eingestrichenes C}. Jede folgende Note
 454 befindet sich so nah wie möglich bei der vorherigen -- das erste
 455 @q{C} ist also das nächste C vom
 456 eingestrichenen C aus gerechnet. Darauf folgt das nächstmögliche
 457 D in Bezug auf die vorhergehende Note. Mit diesen Regeln können
 458 auch Melodien mit größeren Intervallen im @code{\relative}-Modus
 459 gebildet werden:
 460
 461 @lilypond[verbatim,quote]
 462 \relative c' {
 463   d f a g
 464   c b f d
 465 }
 466 @end lilypond
 467
 468 @noindent
 469 Es ist nicht notwendig, dass die erste Note der Melodie mit der
 470 Note beginnt, die die erste Tonhöhe angibt.
 471 Die erste Note (das @q{D}) des vorigen Beispiels ist das nächste D
 472 vom eingestrichenen C aus gerechnet.
 473
 474 Indem man Apostrophe @code{'} (Taste Shift+#) oder Kommata @code{,}
 475 zu dem @w{@code{\relative c' @{}} hinzufügt oder entfernt, kann die
 476 Oktave der ersten Tonhöhe verändert werden:
 477
 478 @c KEEP LY
 479 @lilypond[verbatim,quote]
 480 % zweigestrichenes C
 481 \relative c'' {
 482   e c a c
 483 }
 484 @end lilypond
 485
 486 Der relative Modus kann zunächst verwirrend erscheinen, aber es ist die
 487 einfachste Art, die meisten Melodien zu notieren. Schauen wir uns an,
 488 wie diese relative Berechnung in der Praxis funktioniert. Wenn wir mit
 489 einem H beginnen (@code{b} in der LilyPond-Syntax), welches sich auf der
 490 mittleren Linie im Violinschlüssel befindet, können wir C, D und E
 491 aufwärts notieren, und A, G und F unter dem H. Wenn also die Note, die
 492 auf das H folgt, ein C, D oder E ist, setzt LilyPond es oberhalb des
 493 Hs, wenn es ein A, G oder F ist, wird es darunter gesetzt.
 494
 495 @c KEEP LY
 496 @lilypond[verbatim,quote]
 497 \relative c'' {
 498   b c  % c ist 1 Zeile aufwärts, also c über dem b
 499   b d  % d ist 2 Zeilen aufwärts, oder 5 runter, also d über dem b
 500   b e  % e ist 3 aufwärts oder 4 runter, also e über dem b
 501   b a  % a ist 6 aufwärts oder 1 runter, also a unter dem b
 502   b g  % g ist 5 aufwärts oder 2 runter, also g unter dem b
 503   b f  % f ist 4 aufwärts oder 3 runter, also f unter dem b
 504 }
 505 @end lilypond
 506
 507 Die gleiche Berechnung findet auch statt, wenn eine der Noten erhöht
 508 oder erniedrigt ist. @notation{Versetzungszeichen} werden
 509 @strong{vollständig ignoriert} bei der Berechnung. Genau die
 510 gleiche Berechnung wird analog von jeder folgenden Tonhöhe aus
 511 für die nächste Tonhöhe neu ausgeführt.
 512
 513 Um Intervalle zu notieren, die größer als drei Notenzeilen sind, kann man die Oktave verändern. Mit einem Apostroph @code{'} (Taste Shift+#)
 514 direkt hinter dem Notennamen wird die Oktave um eins erhöht, mit einem Komma @code{,} um eins erniedrigt.
 515
 516 @lilypond[verbatim,quote]
 517 \relative c'' {
 518   a a, c' f,
 519   g g'' a,, f'
 520 }
 521 @end lilypond
 522
 523 @noindent
 524 Um eine Notenhöhe um zwei (oder mehr!) Oktaven zu verändern,
 525 werden sukzessive @code{''} oder @code{,,} benutzt -- es muss
 526 sich dabei wirklich um zwei einzelne Apostrophen und nicht um das
 527 Anführungszeichen @code{"}@tie{} (Taste Shift+2) handeln! Auch
 528 die Anfangsoktave für einen @code{@w{\relative c'}}-Abschnitt kann so
 529 verändert werden.
 530
 531
 532 @subheading Tondauern (Rhythmen)
 533
 534 @cindex Notendauern
 535 @cindex Dauern
 536 @cindex Rhythmus
 537 @cindex Ganze Noten
 538 @cindex Halbe Noten
 539 @cindex Viertelnoten
 540 @cindex punktierte Noten
 541
 542 Glossar: @rglos{beam}, @rglos{duration},
 543 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
 544 @rglos{dotted note}.
 545
 546 Die @notation{Dauer} einer Note wird durch eine Zahl bezeichnet,
 547 die direkt auf den Notennamen folgend eingegeben wird.
 548 @code{1} für eine @notation{ganze Note}, @code{2} für eine
 549 @notation{halbe Note}, @code{4} für eine @notation{Viertelnote}
 550 und so weiter. @notation{Notenhälse} und @notation{Balken} werden
 551 automatisch hinzugefügt.
 552
 553 Wenn keine Dauer bezeichnet wird, wird die der vorhergehenden Note
 554 verwendet. Für die erste Note ist eine Viertel als Standard definiert.
 555
 556 @lilypond[verbatim,quote]
 557 \relative c'' {
 558   a1
 559   a2 a4 a8 a
 560   a16 a a a a32 a a a a64 a a a a a a a a2
 561 }
 562 @end lilypond
 563
 564 Um @notation{punktierte Noten} zu erzeugen, wird einfach ein Punkt
 565 @code{.} hinter die Notendauer geschrieben. Die Dauer einer
 566 punktierten Note muss explizit, also inklusive der Nummer,
 567 angegeben werden.
 568
 569 @lilypond[verbatim,quote]
 570 \relative c'' {
 571   a a a4. a8
 572   a8. a16 a a8. a8 a4.
 573 }
 574 @end lilypond
 575
 576
 577 @subheading Pausen
 578
 579 @cindex Pausen
 580 @cindex schreiben von Pausen
 581 @cindex notieren von Pausen
 582
 583 Eine @notation{Pause} wird genauso wie eine Noten eingegeben; ihre
 584 Bezeichnung ist @code{r}@tie{}:
 585
 586 @lilypond[verbatim,quote]
 587 \relative c'' {
 588   a r r2
 589   r8 a r4 r4. r8
 590 }
 591 @end lilypond
 592
 593
 594 @subheading Taktangabe
 595
 596 @cindex Taktart
 597
 598 @funindex \time
 599 @funindex time
 600
 601 Glossar: @rglos{time signature}.
 602
 603 Die @notation{Taktart} kann mit dem
 604 @code{\time}-Befehl definiert werden:
 605
 606 @lilypond[verbatim,quote]
 607 \relative c'' {
 608   \time 3/4
 609   a4 a a
 610   \time 6/8
 611   a4. a
 612   \time 4/4
 613   a4 a a a
 614 }
 615 @end lilypond
 616
 617
 618 @subheading Notenschlüssel
 619
 620 @cindex Schlüssel
 621 @cindex Alt
 622 @cindex Sopran
 623 @cindex Tenor
 624 @cindex Bass
 625
 626 @funindex \clef
 627 @funindex clef
 628
 629 Glossar: @rglos{clef}.
 630
 631 Der @notation{Notenschlüssel} kann mit dem @code{\clef}-Befehl
 632 gesetzt werden:
 633
 634 @lilypond[verbatim,quote]
 635 \relative c' {
 636   \clef treble
 637   c1
 638   \clef alto
 639   c1
 640   \clef tenor
 641   c1
 642   \clef bass
 643   c1
 644 }
 645 @end lilypond
 646
 647
 648 @subheading Alles zusammen
 649
 650 Hier ist ein kleines Beispiel, dass all diese Definitionen beinhaltet:
 651
 652 @lilypond[verbatim,quote]
 653 \relative c, {
 654   \time 3/4
 655   \clef bass
 656   c2 e8 c' g'2.
 657   f4 e d c4 c, r4
 658 }
 659 @end lilypond
 660
 661
 662 @seealso
 663 Notationsreferenz: @ruser{Tonhöhen setzen},
 664 @ruser{Rhythmen eingeben}, @ruser{Pausen eingeben},
 665 @ruser{Taktangabe}, @ruser{Notenschlüssel}.
 666
 667
 668 @node Arbeiten an Eingabe-Dateien
 669 @subsection Arbeiten an Eingabe-Dateien
 670 @translationof Working on input files
 671
 672 @cindex geschweifte Klammern
 673 @cindex Klammern, geschweift
 674 @cindex Kommentare
 675 @cindex Zeilenkommentare
 676 @cindex Block-Kommentare
 677 @cindex Groß- und Kleinschreibung
 678 @cindex Ausdrücke
 679 @cindex Großbuchstaben
 680 @cindex Kleinbuchstaben
 681
 682 @funindex { ... }
 683 @funindex %
 684 @funindex %@{ ... %@}
 685
 686
 687 LilyPonds Quelldateien ähneln Dateien in den meisten
 688 Programmiersprachen: Sie enthalten eine Versionsbezeichnung,
 689 es ist auf Groß- und Kleinschreibung
 690 zu achten und Leerzeichen werden ignoriert. Ausdrücke werden
 691 mit geschweiften Klammern @{ @} eingeklammert und Kommentare
 692 mit dem Prozentzeichen @code{%} auskommentiert
 693 oder mit @code{%@{ ... %@}} umgeben.
 694
 695 Wenn das jetzt unverständlich erscheint, sind hier die  Erklärungen:
 696
 697 @itemize
 698 @item
 699 @strong{Versionsbezeichnung}:
 700 Jede LilyPond-Datei soll eine Versionsbezeichnung enthalten. Eine
 701 Versionsbezeichnung ist eine Zeile, die die Version von LilyPond
 702 deklariert, für die die Datei geschrieben wurde, wie in dem
 703 Beispiel:
 704
 705 @example
 706 \version "@w{@version{}}"
 707 @end example
 708
 709 Üblicherweise wird die Versionsbezeichnung oben in die Datei
 710 geschrieben.
 711
 712 Die Versionsbezeichnung ist aus zwei Gründen sehr wichtig: 1. kann
 713 man mit ihrer Hilfe automatische Aktualisierungen der Eingabedateien
 714 vornehmen, wenn sich die LilyPond-Syntax ändern sollte. 2. wird
 715 hier die Version von LilyPond beschrieben, die nötig ist, um die
 716 Datei zu kompilieren.
 717
 718 Wenn die Versionsbezeichnung in einer Datei fehlt, gibt LilyPond
 719 eine Warnung während der Kompilation der Datei aus.
 720
 721 @item
 722 @strong{Groß- und Kleinschreibung:}
 723 Die Bedeutung eines Zeichens verändert sich, je
 724 nachdem, ob es groß (@w{@code{A, B, S, T}}) oder klein
 725  (@w{@code{a, b, s, t}}) geschrieben wird. Noten müssen
 726 immer klein geschrieben werden,  @w{@code{@{ c d e @}}} funktioniert,
 727 während @w{@code{@{ C D E @}}} einen Fehler produziert.
 728
 729 @item @strong{Leerzeichen:}
 730 Es spielt keine Rolle, wie viele Leerzeichen oder Tabulatoren oder
 731 leere Zeilen sich zwischen den Zeichen der Quelldatei befinden.
 732 @w{@code{@{ c d e @}}} bedeutet das Gleiche wie
 733 @w{@code{@{ c @ @ @ @ @  d e @}}} oder
 734 @example
 735 @{ c                        d
 736                      e @}
 737 @end example
 738
 739 @noindent
 740 Natürlich ist das letzte Beispiel etwas schwer zu lesen. Eine gute Daumenregel
 741 ist es, Code-Blöcke mit der Tab-Taste oder zwei Leerzeichen einzurücken:
 742 @example
 743 @{
 744   c d e
 745 @}
 746 @end example
 747
 748 Leerzeichen @emph{sind} jedoch nötig, um viele syntaktische Elemente
 749 voneinander zu trennen.  Leerzeichen können also immer @emph{hinzugefügt}
 750 werden, aber sie dürfen nicht @emph{entfernt} werden.  Da fehlende
 751 Leerzeichen sehr seltsame Fehlermeldungen hervorrrufen können, wird
 752 es nahe gelegt, immer ein Leerzeichen vor und nach jedem syntaktischen
 753 Element, etwa vor und nach geschweiften Kklammern, einzufügen.
 754
 755 @item @strong{Ausdrücke:}
 756 Auch der kleinste Abschnitt an LilyPond-Code muss in
 757 @strong{@{ geschweifte Klammern @}} eingeschlossen werden. Diese
 758 Klammern zeigen LilyPond an, dass es sich um einen zusammengehörenden
 759 musikalischen Ausdruck handelt, genauso wie Klammern @q{()} in der Mathematik.
 760 Die Klammern sollten von jeweils einem Leerzeichen umgeben sein, um
 761 Zweideutigkeiten auszuschließen, es sei denn, sie
 762 befinden sich am Anfang oder Ende einer Zeile.
 763 Ein LilyPond-Befehl gefolgt von einem einfachen Ausdruck
 764 in Klammern (wie etwa @code{\relative @{ @}})
 765 wird auch als ein einzelner Musikausdruck gewertet.
 766
 767 @cindex Kommentare
 768 @cindex Zeilenkommentare
 769 @cindex Blockkommentare
 770
 771 @item
 772 @strong{Kommentare:}
 773 Ein Kommentar ist eine Bemerkung für den menschlichen Leser
 774 einer Quelldatei, es wird bei der Dateianalyse durch das Programm
 775 ignoriert, so dass es also keine Auswirkung auf die Druckausgabe der
 776 Noten hat. Es gibt zwei verschiedene Typen von Kommentaren. Das
 777 Prozentzeichen @q{%} geht einem Zeilen-Kommentar voraus: Alles
 778 nach diesem Zeichen wird in dieser Zeile ignoriert.
 779 Üblicherweise wird ein Kommentar @emph{über} dem Code gesetzt,
 780 auf den es sich bezieht.
 781
 782 @example
 783 a4 a a a
 784 % Dieser Kommentar bezieht sich auf das H
 785 b2 b
 786 @end example
 787
 788
 789 Ein Block-Kommentar ist ein ganzer Abschnitt mit einem
 790 Kommentar. Alles, was von @code{%@{}
 791 und @code{%@}} umgeben ist, wird ignoriert. Das heißt,
 792 dass sich ein Block-Kommentar nicht ein einem anderen
 793 Blockkommentar befinden kann. Wenn Sie das versuchen sollten,
 794 beendet schon das erste @code{%@}} @emph{beide}
 795 Block-Kommentare. Das folgende Beispiel zeigt eine
 796 mögliche Anwendung von Kommentaren:
 797
 798 @example
 799 % Noten für twinkle twinkle hier
 800   c4 c g' g a a g2
 801
 802 %@{
 803     Diese Zeilen, und die Noten unten werden
 804     ignoriert, weil sie sich in einem Block-Kommentar
 805     befinden.
 806
 807     f f e e d d c2
 808 %@}
 809 @end example
 810
 811 @end itemize
 812
 813
 814
 815 @node Wie die Handbücher gelesen werden sollen
 816 @section Wie die Handbücher gelesen werden sollen
 817 @translationof How to read the manuals
 818
 819 Dieser Abschnitt zeigt, wie die Dokumenation effizient gelesen
 820 werden kann und erklärt auch einige nützliche Interaktionseigenschaften
 821 der Online-Version.
 822
 823 @menu
 824 * Ausgelassenes Material::
 825 * Anklickbare Beispiele::
 826 * Navigation mit der Tastatur::
 827 * Überblick über die Handbücher::
 828 @end menu
 829
 830
 831 @node Ausgelassenes Material
 832 @subsection Ausgelassenes Material
 833 @translationof Omitted material
 834
 835 @cindex Handbuch, Lesen
 836 @cindex Wie soll das Handbuch gelesen werden
 837 @cindex Lesen des Handbuchs
 838 @cindex Beispiele, klickbar
 839 @cindex klickbare Beispiele
 840 @cindex Vorlagen
 841 @cindex Templates
 842 @cindex Dateien konstruieren, Hinweise
 843 @cindex Konstruieren von Dateien, Hinweise
 844 @cindex Hinweise zur Konstruktion von Dateien
 845
 846 LilyPond-Code muss immer von  @{ @} Zeichen oder einem
 847 @code{@w{\relative c'' @{ ... @}}} umgeben sein, wie
 848 gezeigt in @ref{Arbeiten an Eingabe-Dateien}.
 849 Im Rest dieses Handbuchs werden die meisten Beispiel allerdings darauf
 850 verzichten. Um sie zu reproduzieren, können Sie den entsprechenden
 851 Quellcode kopieren und in eine Textdatei einfügen, aber Sie
 852 @strong{müssen} dabei
 853 @code{@w{\relative c'' @{ @}}} einfügen, wie hier gezeigt:
 854
 855 @example
 856 \relative c'' @{
 857   ... hier das Beispiel ...
 858 @}
 859 @end example
 860
 861 Warum werden die Klammern hier meist weggelassen?  Die meisten
 862 der Beispiele können in ein längeres Musikstück hineinkopiert
 863 werden, und dann ist es natürlich nicht sinnvoll, wenn auch noch
 864 @code{@w{\relative c'' @{ @}}} dazukommt; ein @code{\relative} darf
 865 nicht innerhalb eines anderen @code{\relative} gesetzt werden,
 866 deshalb wird es hier weggelassen, damit die Beispiele auch innerhalb
 867 eines anderen Kontextes funktionieren.  Wenn bei jedem
 868 Beispiel @code{@w{\relative c'' @{ @}}} eingesetzt würde,
 869 könnten Sie die kleinen Beispiele der Dokumentation
 870 nicht einfach zu Ihrem eigenen Notentext hinzufügen.
 871 Die meisten Benutzer wollen
 872 Noten zu einer schon bestehenden Datei irgendwo in der Mitte
 873 hinzufügen, deshalb wurde der relative Modus für die Beispiele
 874 im Handbuch weggelassen.
 875
 876 Denken Sie auch daran, dass jede LilyPond-Datei eine Versionsbezeichnung
 877 haben sollte.  Weil die Beispiele in den Handbüchern Schnipsel
 878 und keine vollständigen Dateien sind, fehlt hier die Versionsbezeichnung.
 879 Sie sollten sie aber immer in Ihre eigenen Dateien einfügen.
 880
 881
 882 @node Anklickbare Beispiele
 883 @subsection Anklickbare Beispiele
 884 @translationof Clickable examples
 885
 886 @warning{Diese Eigenschaft gibt es nur in der HTML-Dokumentation.}
 887
 888 Viele Leute lernen Programme, indem sie einfach herumprobieren. Das
 889 geht auch mit LilyPond. Wenn Sie in der HTML-Version dieses Handbuchs
 890 eine Abbildung in der HTML-Version dieses Handbuches anklicken,
 891 erhalten sie exakt den LilyPond-Code, der
 892 zum Satz der Abbildung benutzt wurde. Versuchen Sie es mit dieser
 893 Abbildung:
 894
 895 @c no verbatim here
 896 @c KEEP LY
 897 @lilypond[quote]
 898 \relative c'' {
 899   c-\markup { \bold \huge { Hier klicken!  } }
 900 }
 901 @end lilypond
 902
 903 Wenn Sie einfach alles kopieren, was im
 904  @qq{ly snippet}-Abschnitt steht, und in eine Text-Datei
 905 einfügen, haben Sie schon eine fertige Vorlage für weitere
 906 Experimente. Damit Sie genau das gleiche Erscheinungsbild wie
 907 bei dem Beispiel selber erreichen, müssen Sie alles kopieren ab der
 908 Zeile @qq{Start
 909 cut-&-pastable section} bis ganz zum Ende der Datei.
 910
 911
 912 @node Navigation mit der Tastatur
 913 @subsection Navigation mit der Tastatur
 914 @translationof Keyboard navigation
 915
 916 @warning{Diese Funktion gibt es nur für die HTML-Version der Handbücher.}
 917
 918 @c TODO: once this is figured out, insert it here.
 919
 920 Es wird gegenwärtig an dieser Funktion gearbeitet.
 921
 922
 923
 924 @node Überblick über die Handbücher
 925 @subsection Überblick über die Handbücher
 926 @translationof Overview of manuals
 927
 928
 929 Es gibt sehr viele Dokumentation für LilyPond. Neue Benutzer sind
 930 oft verwirrt, welche Teile davon sie lesen sollen, und so kommt
 931 es vor, dass machnmal wichtige Abschnitte nicht gelesen werden.
 932
 933 @warning{Bitte überspringen Sie keine wichtigen Teile der
 934 Dokumentation.  Sonst wird es Ihnen später sehr viel schwerer
 935 fallen, spätere Abschnitte zu verstehen.}
 936
 937 @itemize
 938
 939 @item
 940 @strong{Bevor Sie @emph{irgendetwas} ausprobieren}: Lesen Sie die
 941 Abschnitte @ref{Übung} und @ref{Übliche Notation}.  Wenn
 942 Sie auf musikalische Fachbegriffen stoßen, die Sie nicht kennen,
 943 schauen Sie diese im @rglosnamed{Top, Glossar} nach.
 944
 945 @item
 946 @strong{Bevor Sie ein vollständiges Stück notieren}:  Lesen
 947 Sie den Abschnitt @ref{Grundbegriffe} im Handbuch zum Lernen.
 948 Danach können Sie sich die für Ihr Projekt wichtigen Abschnitte
 949 in der
 950 @rusernamed{Top, Notationsreferenz} anschauen.
 951
 952 @item
 953 @strong{Bevor Sie versuchen, die Standardnotation zu verändern}:
 954 Lesen Sie @ref{Die Ausgabe verändern} im Handbuch zum Lernen.
 955
 956 @item
 957 @strong{Bevor Sie sich an ein größeres Projekt machen}: Lesen
 958 Sie den Abschnitt
 959 @rprogram{Vorschläge, wie man Dateien schreibt}
 960 in der Programmbenutzung.
 961
 962 @end itemize
 963