1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
4 Translation of GIT committish: 354f8ea159bb5216202e5815685fca8bd7e6919c
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..
12 @c Translators: Till Paala, Reinhold Kainhofer
13 @c Translation checkers: Hajo Bäß
17 @translationof Tutorial
19 Dieses Kapitel stellt dem Leser das grundlegende Arbeiten mit LilyPond
23 * Eine Quelldatei übersetzen::
24 * Arbeiten an Eingabe-Dateien::
25 * Wie soll das Handbuch gelesen werden::
29 @node Eine Quelldatei übersetzen
30 @subsection Eine Quelldatei übersetzen
31 @translationof Compiling a file
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.
45 @subsection Noten eingeben
46 @translationof Entering input
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
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.
64 Das erste Beispiel zeigt, wie
65 solch eine einfache Eingabedatei ausschauen kann.
73 Die graphische Ausgabe ist:
75 @c in this case we don't want verbatim
82 @warning{In jeder LilyPond-Datei müssen
83 @strong{@{ geschweifte Klammern @}} um die Noten
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}.}
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.
101 @subheading Ansicht des Ergebnisses
104 @cindex Noten anzeigen
105 @cindex Anzeigen der Noten
106 @cindex Ansicht von Noten
109 @cindex LilyPond unter MacOS X
110 @cindex MacOS X, LilyPond starten
111 @cindex Starten von LilyPond
113 Das Erstellen der Notenausgabe hängt davon ab, welches Betriebssystem
114 und welche Programme Sie benutzen.
119 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
120 @ref{MacOS X, MacOS X} (graphisch)
123 @ref{Windows, @sourceimage{logo-windows,,,}}
124 @ref{Windows, Microsoft Windows} (graphisch)
127 @ref{Kommandozeile, @sourceimage{logo-linux,,,}
128 @sourceimage{logo-freebsd,,,}
129 @sourceimage{logo-macosx,,,}
130 @sourceimage{logo-windows,,,}
132 @ref{Kommandozeile, Alle Betriebssysteme} (Kommandozeile)
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}
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.}
148 @translationof MacOS X
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.}
156 @subsubheading 1. Schritt: Erstellen Sie eine @file{.ly}-Datei
158 Wenn Sie das @command{LilyPond.app}-Symbol doppelt klicken, öffnet
159 sich eine Beispiel-Datei.
161 @sourceimage{Learning_Macos_welcome,,,}
163 Wählen Sie aus den Menüs oben links auf Ihrem Bildschirm
164 @w{@code{File > Save}}.
166 @sourceimage{Learning_Macos_Save_menu,,,}
168 Wählen Sie einen Namen für die Datei, etwa @file{test.ly}.
170 @sourceimage{Learning_Macos_Save_file_with_name,,,}
173 @subsubheading 2. Schritt: Kompilieren (mit LilyPad)
175 Aus den selben Menüs wählen Sie jetzt @w{@code{Compile > Tyepset}}.
177 @sourceimage{Learning_Macos_Typeset_menu,,,}
179 Ein neues Fenster öffnet sich, in dem ein Forschrittslog der
180 Kompilation der von ihnen gerade gespeicherten Datei gezeigt
183 @sourceimage{Learning_Macos_Compiling_log,,,}
185 @subsubheading 3. Schritt: Ausgabe anschauen
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.
191 @sourceimage{Learning_Macos_pdf_output,,,}
194 @subsubheading Andere Befehle
196 Um neue LilyPond-Dateien zu erstellen beginnen sie mit
197 @w{@code{File > New}}
199 @sourceimage{Learning_Macos_New_menu,,,}
202 oder @w{@code{File > Open}} um eine schon existierende Datei zu
203 öffnen und zu editieren.
205 @sourceimage{Learning_Macos_Open_menu,,,}
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.
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.
217 @cindex Windows, LilyPond starten
221 @translationof Windows
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.}
228 @subsubheading 1. Schritt: Erstellen Sie eine @file{.ly}-Datei
230 Wenn sie auf das LilyPond-Symbol auf dem Desktop doppelklicken,
231 öffnet sich ein einfacher Texteditor mit einer Beispieldatei.
233 @sourceimage{Learning_Win7_Welcome_File_Whole,,,}
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.
240 @sourceimage{Learning_Win7_Save_Menu,,,}
242 Wählen Sie einen Namen für Ihre Datei, etwa @file{test.ly}.
244 @sourceimage{Learning_Win7_Save_File_With_Name,,,}
247 @subsubheading Schritt 2a: Kompilieren (mit drag-and-drop)
249 Sie können nach Belieben die Kompilation starten, indem Sie
252 Die Datei auf das LilyPond-Symbol ziehen.
254 @sourceimage{Learning_Win7_Open_Dragndrop,,,}
256 Klicken Sie mit der rechten Maustaste auf die Datei und wählen
257 Sie aus dem Menü @w{@code{Open with > LilyPond}}.
259 @sourceimage{Learning_Win7_Open_Context_Menu,,,}
262 @subsubheading Schritt 2b: Kompilieren (mit Doppelklick)
264 Oder klicken Sie einfach die Datei @file{test.ly} doppelt an.
267 @subsubheading 3. Schritt: Ausgabe anschauen
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.
273 @sourceimage{Learning_Win7_All_Files_Created,,,}
275 Das PDF enthält den Notensatz aus der Datei @file{test.ly}.
277 @sourceimage{Learning_Win7_Pdf_Output,,,}
280 @subsubheading Andere Befehle
282 Um eine neue Datei zu erstellen, wählen Sie @w{@code{File > New}}
283 aus irgendeiner schon erstellten Datei.
285 @sourceimage{Learning_Win7_New_Menu,,,}
288 oder @w{@code{File > Open}}, um eine Datei zu öffnen und zu
289 bearbeiten, die Sie schon vorher gespeichert hatten.
291 @sourceimage{Learning_Win7_Open_Menu,,,}
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.
297 @sourceimage{Learning_Win7_Log_File,,,}
299 Die Log-Datei wird jedes Mal überschrieben, wenn Sie Ihre
300 LilyPond-Datei kompilieren.
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.
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.
311 @cindex Unix, LilyPond starten
314 @subsection Kommandozeile
315 @translationof Command-line
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.}
322 @subsubheading Schritt 1: Erstellen Sie eine @file{.ly}-Datei
325 Erstellen Sie eine Text-Datei mit dem Namen @file{test.ly} und
326 geben Sie folgenden Text ein:
334 @subsubheading Schritt 2: Kompilieren (auf der Kommandozeile)
336 Um die Datei zu kompilieren, geben sie an der Konsole bzw. Kommandozeile
344 Sie werden ungefähr folgende Meldungen sehen:
349 GNU LilyPond @version{}
350 »test.ly« wird verarbeitet
352 Interpretation der Musik...
353 Vorverarbeitung der grafischen Elemente...
354 Ideale Seitenanzahl wird gefunden...
355 Musik wird auf eine Seite angepasst...
357 Layout nach »test.ps« ausgeben...
358 Konvertierung nach »test.pdf«...
361 @subsubheading 3. Schritt: Ausgabe anschauen
363 Als Ergebnis erhalten Sie ein @file{test.pdf}, das Sie mit den
364 Standardprogrammen Ihres Betriebssystemes anschauen können.
368 @node Wie werden Eingabe-Dateien geschrieben
369 @section Wie werden Eingabe-Dateien geschrieben
370 @translationof How to write input files
372 Dieser Abschnitt erklärt die grundlegende LilyPond-Syntax und hilft
373 bei den ersten Anfängen, eine LilyPond-Eingabedatei zu schreiben.
376 * Einfache Notation::
377 * Arbeiten an Eingabe-Dateien::
382 @node Einfache Notation
383 @subsection Einfache Notation
384 @translationof Simple notation
386 @cindex einfache Notation
387 @cindex Notation, einfach
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.
393 @lilypond[verbatim,quote]
400 Diese Einstellungen können verändert werden, aber in den meisten Fällen
401 sind die automatischen Werte durchaus brauchbar.
406 @cindex relativer Modus
409 @cindex Versetzungszeichen und relativer Modus
410 @cindex relativer Modus und Versetzungszeichen
418 Glossar: @rglos{pitch}, @rglos{interval},
419 @rglos{scale}, @rglos{middle C}, @rglos{octave},
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
432 wie sich die deutschen Notennamen benutzen lassen.
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
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.
445 @lilypond[verbatim,quote]
446 % Beginnpunkt auf das mittlere C setzen
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
461 @lilypond[verbatim,quote]
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.
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:
479 @lilypond[verbatim,quote]
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.
496 @lilypond[verbatim,quote]
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
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.
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.
516 @lilypond[verbatim,quote]
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
532 @subheading Tondauern (Rhythmen)
540 @cindex punktierte Noten
542 Glossar: @rglos{beam}, @rglos{duration},
543 @rglos{whole note}, @rglos{half note}, @rglos{quarter note},
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.
553 Wenn keine Dauer bezeichnet wird, wird die der vorhergehenden Note
554 verwendet. Für die erste Note ist eine Viertel als Standard definiert.
556 @lilypond[verbatim,quote]
560 a16 a a a a32 a a a a64 a a a a a a a a2
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,
569 @lilypond[verbatim,quote]
580 @cindex schreiben von Pausen
581 @cindex notieren von Pausen
583 Eine @notation{Pause} wird genauso wie eine Noten eingegeben; ihre
584 Bezeichnung ist @code{r}@tie{}:
586 @lilypond[verbatim,quote]
594 @subheading Taktangabe
601 Glossar: @rglos{time signature}.
603 Die @notation{Taktart} kann mit dem
604 @code{\time}-Befehl definiert werden:
606 @lilypond[verbatim,quote]
618 @subheading Notenschlüssel
629 Glossar: @rglos{clef}.
631 Der @notation{Notenschlüssel} kann mit dem @code{\clef}-Befehl
634 @lilypond[verbatim,quote]
648 @subheading Alles zusammen
650 Hier ist ein kleines Beispiel, dass all diese Definitionen beinhaltet:
652 @lilypond[verbatim,quote]
663 Notationsreferenz: @ruser{Tonhöhen setzen},
664 @ruser{Rhythmen eingeben}, @ruser{Pausen eingeben},
665 @ruser{Taktangabe}, @ruser{Notenschlüssel}.
668 @node Arbeiten an Eingabe-Dateien
669 @subsection Arbeiten an Eingabe-Dateien
670 @translationof Working on input files
672 @cindex geschweifte Klammern
673 @cindex Klammern, geschweift
675 @cindex Zeilenkommentare
676 @cindex Block-Kommentare
677 @cindex Groß- und Kleinschreibung
679 @cindex Großbuchstaben
680 @cindex Kleinbuchstaben
684 @funindex %@{ ... %@}
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.
695 Wenn das jetzt unverständlich erscheint, sind hier die Erklärungen:
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
706 \version "@w{@version{}}"
709 Üblicherweise wird die Versionsbezeichnung oben in die Datei
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.
718 Wenn die Versionsbezeichnung in einer Datei fehlt, gibt LilyPond
719 eine Warnung während der Kompilation der Datei aus.
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.
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
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:
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.
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.
768 @cindex Zeilenkommentare
769 @cindex Blockkommentare
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.
784 % Dieser Kommentar bezieht sich auf das H
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:
799 % Noten für twinkle twinkle hier
803 Diese Zeilen, und die Noten unten werden
804 ignoriert, weil sie sich in einem Block-Kommentar
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
819 Dieser Abschnitt zeigt, wie die Dokumenation effizient gelesen
820 werden kann und erklärt auch einige nützliche Interaktionseigenschaften
824 * Ausgelassenes Material::
825 * Anklickbare Beispiele::
826 * Navigation mit der Tastatur::
827 * Überblick über die Handbücher::
831 @node Ausgelassenes Material
832 @subsection Ausgelassenes Material
833 @translationof Omitted material
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
842 @cindex Dateien konstruieren, Hinweise
843 @cindex Konstruieren von Dateien, Hinweise
844 @cindex Hinweise zur Konstruktion von Dateien
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:
857 ... hier das Beispiel ...
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.
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.
882 @node Anklickbare Beispiele
883 @subsection Anklickbare Beispiele
884 @translationof Clickable examples
886 @warning{Diese Eigenschaft gibt es nur in der HTML-Dokumentation.}
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
899 c-\markup { \bold \huge { Hier klicken! } }
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
909 cut-&-pastable section} bis ganz zum Ende der Datei.
912 @node Navigation mit der Tastatur
913 @subsection Navigation mit der Tastatur
914 @translationof Keyboard navigation
916 @warning{Diese Funktion gibt es nur für die HTML-Version der Handbücher.}
918 @c TODO: once this is figured out, insert it here.
920 Es wird gegenwärtig an dieser Funktion gearbeitet.
924 @node Überblick über die Handbücher
925 @subsection Überblick über die Handbücher
926 @translationof Overview of manuals
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.
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.}
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.
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
950 @rusernamed{Top, Notationsreferenz} anschauen.
953 @strong{Bevor Sie versuchen, die Standardnotation zu verändern}:
954 Lesen Sie @ref{Die Ausgabe verändern} im Handbuch zum Lernen.
957 @strong{Bevor Sie sich an ein größeres Projekt machen}: Lesen
959 @rprogram{Vorschläge, wie man Dateien schreibt}
960 in der Programmbenutzung.