Documentation/de/learning/introduction.itely

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