-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 8d678d320b2bef3d0ebfc737134d45bcec5e8a56
+ Translation of GIT committish: d415427752fa5fd83b0da189d677481d1c7f3043
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.38"
+@c \version "2.12.0"
+@c Translators: Till Rettig, Reinhold Kainhofer
+@c Translation checkers: Hajo Bäß
@node Introduction
@chapter Introduction
+Dieses Kapitel stellt dem Leser die Idee hinter LilyPond und die Dokumentation
+von LilyPond vor.
@menu
-* Engraving::
-* Automated engraving::
-* What symbols to engrave?::
-* Music representation::
-* Example applications::
-* About this manual::
+* Background::
+* About the documentation::
+@end menu
+
+
+@node Background
+@section Background
+
+Dieser Abschnitt behandelt die allgemeinen Ziele und die Architektur von LilyPond.
+
+@menu
+* Engraving::
+* Automated engraving::
+* What symbols to engrave?::
+* Music representation::
+* Example applications::
@end menu
@node Engraving
-@section Engraving
+@unnumberedsubsec Engraving
+
+@cindex Notensatz
+@cindex Typographie
+@cindex Notengravur
+@cindex Gravur, Notensatz
+@cindex Plattendruck, Noten
Die Kunst des Notensatzes wird auch als Notenstich bezeichnet. Dieser
Begriff stammt aus dem traditionellen Notendruck. Noch bis vor etwa 20
dritte Bild zeigt, wie LilyPond die Formen des traditionellen
Satzes nachahmt. Das linke Bild zeigt ein eingescanntes b-Vorzeichen
aus einer 2000 herausgegebenen Edition. Das mittlere Bild
-zeigt das b-Vorzeichen der selben Musik aus einer handgestochenen
- Bärenreiter-Ausgabe. Das linke Bild zeigt die typischen Makel
+zeigt das b-Vorzeichen derselben Musik aus einer handgestochenen
+Bärenreiter-Ausgabe. Das linke Bild zeigt die typischen Makel
des Computer-Satzes: Die Notenlinien sind sehr dünn, die Schwärze
des Vorzeichens entspricht den dünnen Linien und hat eine gerade
Form mit scharfen Ecken und Kanten. Im Gegensatz dazu hat das
-Bärenreiter-Vorzeichen dicke, gerade zu sinnlich rundliche
+Bärenreiter-Vorzeichen dicke, geradezu sinnlich rundliche
Formen. Unser Symbol für das Vorzeichen hat neben anderen
auch dieses b als Vorbild. Es ist abgerundet und passt zu unseren
Notenlinien, die sehr viel dicker sind als die der entsprechenden
@end ifnottex
@end ifnotinfo
@ifinfo
-@c workaround for makeinfo-4.6: line breaks and multi-column cookies
-@image{henle-flat-bw,,,png} @image{baer-flat-bw,,,png}
+@image{henle-flat-bw,,,png}
+@image{baer-flat-bw,,,,png}
@image{lily-flat-bw,,,png}
@end ifinfo
@cindex normale Rhythmen
@cindex normale Abstände
+@cindex Abstände, normal
+@cindex Rhythmen, normal
In diesem Ausschnitt kommen nur Viertel vor, Noten, die in einem
gleichmäßigen Rhythmus gespielt werden. Die Abstände sollten das
@cindex Typographie
-Musiker sind üblicherweise zu zu konzentriert, die Musik aufzuführen,
-als das Aussehen der Noten zu studieren; und diese
+Musiker sind üblicherweise zu sehr damit beschäftigt, die Musik aufzuführen,
+als dass sie das Aussehen der Noten studieren könnten; und diese
Beschäftigung mit typographischen Details mag akademisch wirken.
Das ist sie aber nicht. Unser Beispielstück hat einen
-monotonen Rhythmus, und wenn alle Zeilen gleich aussehen, wird
+monotonen Rhythmus, und wenn alle Zeilen einförmig aussehen, wird
das Notenblatt zu einem Labyrinth. Wenn der Spieler auch nur
einmal wegschaut oder kurze Zeit unkonzentriert ist, findet er
nicht mehr zurück zu der Stelle, an der er war.
die weit vom Leser entfernt stehen, etwa auf einem Notenständer.
Eine sorgfältige Verteilung der Zwischenräume erlaubt es, die
Noten sehr dicht zu setzen, ohne dass die Symbole zusammenklumpen.
-Dadurch werden unnötige Seitenumbrüche vermieden, sodass man
+Dadurch werden unnötige Seitenumbrüche vermieden, so dass man
nicht so oft blättern muss.
Dies sind die Anforderungen der Typographie: Das Layout sollte
schön sein -- nicht aus Selbstzweck, sondern um dem Leser zu helfen. Für
Aufführungsmaterial ist das umso wichtiger, denn Musiker haben eine begrenzte
-Aufmerksamkeit. Je weniger Mühe nötig ist, die Noten zu erfassen, desto mehr
+Aufnahmefähigkeit. Je weniger Mühe nötig ist, die Noten zu erfassen, desto mehr
Zeit bleibt für die Gestaltung der eigentlichen Musik. Das heißt: Gute
Typographie führt zu besseren Aufführungen!
unsere Algorithmen, die Gestalt der Symbole und die Programm-Einstellungen
darauf abgestimmt, einen Ausdruck zu erzielen, der der Qualität
der alten Editionen entspricht, die wir so gerne betrachten
-und von denen wir gerne spielen.
+und aus denen wir gerne spielen.
@node Automated engraving
-@section Automated engraving
+@unnumberedsubsec Automated engraving
+
+@cindex Notensatz, automatisch
+@cindex automatischer Notensatz
Wie sollen wir also jetzt die Typographie anwenden?
Wie können wir erwarten, dass wir in der Lage wären,
Einstellungen ändern können. Er muss also Zugang zur
Formatierungsmaschinerie haben. Deshalb können die Regeln und
Einstellungen nicht beim Kompilieren des Programms festgelegt
-werden, sondern sie müssen während des Laufes zugänglich sein.
+werden, sondern sie müssen zugänglich sein, während das Programm
+aktiv ist.
@item Notensatz ist eine Frage des Augenmaßes, und damit auch vom
die nicht den Regeln für den Notensatz entspricht.
@end itemize
+@cindex Scheme-Programmiersprache
+
Diese Probleme wurden angegangen, indem ein Übersetzer für
die Programmiersprache Scheme integriert wurde und Teile
von LilyPond in Scheme neu geschrieben wurden. Die derzeitige
\new Score \with {
\override SpacingSpanner #'spacing-increment = #3
\override TimeSignature #'transparent = ##t
-} \relative {
+} \relative c' {
\stemDown <e g b>4_>-\arpeggio
\override Arpeggio #'direction = #RIGHT
\stemUp <e g b>4^>-\arpeggio
}
@end lilypond
+@cindex Formatierung einer Partitur
+@cindex Partitur, Formatierung
+@cindex Formatierungsregeln
+
@noindent
Der Prozess des Notensetzens besteht für das Programm darin,
die Variablen der graphischen Objekte zu lesen und zu
Formatierungsregeln sind auch vorbelegte Variablen. Zu jedem Objekt gehören
Variablen, die Prozeduren enthalten. Diese Prozeduren machen die eigentliche
-Satzarbeit, und wenn man sie durch andere ersetzt, kann die Darstellung
+Satzarbeit aus, und wenn man sie durch andere ersetzt, kann die Darstellung
von Objekten verändert werden. Im nächsten Beispiel wird die Regel, nach der
die Notenköpfe gezeichnet werden, während des Ausschnitts verändert.
(pos (ly:grob-property grob 'staff-position)))
(if (memq 'note-head-interface interfaces)
(begin
- (ly:grob-set-property! grob 'stencil ly:text-interface::print)
- (ly:grob-set-property! grob 'font-family 'roman)
- (ly:grob-set-property! grob 'text
- (make-raise-markup -0.5
- (case pos
- ((-5) (make-simple-markup "m"))
- ((-3) (make-simple-markup "c "))
- ((-2) (make-smaller-markup (make-bold-markup "2")))
- (else (make-simple-markup "bla")))))))))
+ (ly:grob-set-property! grob 'stencil
+ (grob-interpret-markup grob
+ (make-lower-markup 0.5
+ (case pos
+ ((-5) "m")
+ ((-3) "c ")
+ ((-2) (make-smaller-markup (make-bold-markup "2")))
+ (else "bla")))))))))
\new Voice \relative c' {
- \stemUp
- \set autoBeaming = ##f
- \time 2/4
- <d f g>4
- \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil
- \once \override NoteHead #'font-size = #-7
- \once \override NoteHead #'font-family = #'sans
- \once \override NoteHead #'font-series = #'bold
- <d f g>
- \once \override NoteHead #'style = #'cross
- <d f g>
- \applyOutput #'Voice #mc-squared
- <d f g>
- <<
- { d8[ es-( fis^^ g] fis2-) }
- \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
- >>
+ \stemUp
+ \set autoBeaming = ##f
+ \time 2/4
+ <d f g>4
+ \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil
+ \once \override NoteHead #'font-size = #-7
+ \once \override NoteHead #'font-family = #'sans
+ \once \override NoteHead #'font-series = #'bold
+ <d f g>4
+ \once \override NoteHead #'style = #'cross
+ <d f g>4
+ \applyOutput #'Voice #mc-squared
+ <d f g>4
+ <<
+ { d8[ es-( fis^^ g] fis2-) }
+ \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
+ >>
}
@end lilypond
@node What symbols to engrave?
-@section What symbols to engrave?
+@unnumberedsubsec What symbols to engrave?
@cindex Notensatz
@cindex Typographie
+@cindex Stempel
+@cindex Matrize
+@cindex Engraver
+@cindex Plugin
Während des Notensatzprozesses entscheidet sich, wo
Symbole platziert werden. Das kann aber nur gelingen,
wenn vorher entschieden wird, @emph{welche} Symbole
-gesetzt werden sollen, also welche Notation benutzt
+gesetzt werden sollen, also welche Art von Notation benutzt
werden soll.
Die heutige Notation ist ein System zur Musikaufzeichnung,
das sich über die letzten 1000 Jahre entwickelt hat. Die
Form, die heute üblicherweise benutzt wird, stammt aus dem
-frühen Barock. Auch wenn sich die grundlegenden Formen (also
+Barock. Auch wenn sich die grundlegenden Formen (also
die Notenköpfe, das Fünfliniensystem) nicht verändert haben,
entwickeln sich die Details trotzdem immer noch weiter, um
die Errungenschaften der Neuen Musik darstellen zu können. Die
Notation umfasst also 500 Jahre Musikgeschichte. Ihre Anwendung
-reicht von monophonen Melodien bis zu ungeheurem Kontrapunkt
+reicht von monophonen Melodien bis zu ungeheuer komplexem Kontrapunkt
für großes Orchester.
Wie bekommen wir dieses vielköpfige Monster zu fassen?
\include "engraver-example.ily"
\score {
- \topVoice
- \layout {
- \context {
+ \topVoice
+ \layout {
+ \context {
\Voice
\remove "Stem_engraver"
\remove "Phrasing_slur_engraver"
\remove "Script_engraver"
\remove "Beam_engraver"
\remove "Auto_beam_engraver"
- }
- \context {
+ }
+ \context {
\Staff
\remove "Accidental_engraver"
\remove "Key_engraver"
\remove "Time_signature_engraver"
\remove "Staff_symbol_engraver"
\consists "Pitch_squash_engraver"
- }
-}
+ }
+ }
}
@end lilypond
\score { \topVoice }
@end lilypond
+@cindex Polyphonie
+@cindex Mehrstimmigkeit
+@cindex Notensatz, Mehrstimmigkeit
+@cindex Kontexte
+
Dieses System funktioniert gut für monophone Musik, aber wie geht
es mit Polyphonie? Hier müssen sich mehrere Stimmen ein System teilen.
mehr als nur einen Voice-Kontext. Auf gleiche Weise können auch mehrere Staff-Kontexte
in einen großen Score-Kontext (Partiturkontext) eingebunden werden.
+
@seealso
+Programmreferenz: @rinternals{Contexts}.
-Programmreferenz: @internalsref{Contexts}.
@lilypond[quote,ragged-right]
\include "engraver-example.ily"
@end lilypond
@node Music representation
-@section Music representation
+@unnumberedsubsec Music representation
-Idealerweise ist das Eingabeformat für ein höheres Satzsystem die
+@cindex Syntax
+@cindex rekursive Strukturen
+
+Idealerweise ist das Eingabeformat für ein komplexes Satzsystem die
abstrakte Beschreibung des Inhaltes. In diesem Fall wäre das die
Musik selber. Das stellt uns aber vor ein ziemlich großes Problem,
denn wie können wir definieren, was Musik wirklich ist? Anstatt darauf
eine Antwort zu suchen, haben wir die Frage einfach umgedreht. Wir
-schreiben ein Programm, das den Notensatz beherrscht und passen das
-Format an, so einfach wie möglich zu sein. Wenn es nicht mehr vereinfacht
+schreiben ein Programm, das den Notensatz beherrscht und machen das
+Format so einfach wie möglich. Wenn es nicht mehr vereinfacht
werden kann, haben wir per Definition nur noch den reinen Inhalt. Unser
Format dient als die formale Definition eines Musiktextes.
dargestellt werden. So etwa hier:
@lilypond[quote,verbatim,fragment,relative=1]
-c4
+f4
@end lilypond
@noindent
-Gleichzeitig erklingende Noten werden hinzugefügt, indem man alle in << und >> einschließt.
+Gleichzeitig erklingende Noten werden hinzugefügt, indem man alle in @code{<<} und @code{>>} einschließt.
@c < > is not a music expression,
@c so we use <<>> iso. <> to drive home the point of
Analysieren und Darstellen nimmt nur etwa 10% des Codes ein:
@node Example applications
-@section Example applications
+@unnumberedsubsec Example applications
+
+@cindex einfaches Beispiel
+@cindex Beispiel, einfach
Wir haben LilyPond als einen Versuch geschrieben, wie man die Kunst des
Musiksatzes in ein Computerprogramm gießen kann. Dieses
@lilypond[quote,ragged-right]
<<
\chords { c2 c f2 c }
- \new Staff \relative c' { \time 2/4 c4 c g'4 g a4 a g2 }
- \new Lyrics \lyricmode { twin4 kle twin kle lit tle star2 }
+ \new Staff
+ \relative c' {
+ \time 2/4
+ c4 c g' g a a g2
+ }
+ \addlyrics { twin -- kle twin -- kle lit -- tle star }
>>
@end lilypond
Mehrstimmige Notation und Klaviermusik kann auch gesetzt werden. Das
nächste Beispiel zeigt einige etwas exotischere Konstruktionen:
-@lilypondfile[quote,ragged-right]{screech-boink.ly}
+@lilypond[quote]
+\header {
+ title = "Screech and boink"
+ subtitle = "Random complex notation"
+ composer = "Han-Wen Nienhuys"
+}
+
+\score {
+ \context PianoStaff <<
+ \new Staff = "up" {
+ \time 4/8
+ \key c \minor
+ << {
+ \revert Stem #'direction
+ \change Staff = down
+ \set subdivideBeams = ##t
+ g16.[
+ \change Staff = up
+ c'''32
+ \change Staff = down
+ g32
+ \change Staff = up
+ c'''32
+ \change Staff = down
+ g16]
+ \change Staff = up
+ \stemUp
+ \set followVoice = ##t
+ c'''32([ b''16 a''16 gis''16 g''32)]
+ } \\ {
+ s4 \times 2/3 { d'16[ f' g'] } as'32[ b''32 e'' d'']
+ } \\ {
+ s4 \autoBeamOff d''8.. f''32
+ } \\ {
+ s4 es''4
+ } >>
+ }
+
+ \new Staff = "down" {
+ \clef bass
+ \key c \minor
+ \set subdivideBeams = ##f
+ \override Stem #'french-beaming = ##t
+ \override Beam #'thickness = #0.3
+ \override Stem #'thickness = #4.0
+ g'16[ b16 fis16 g16]
+ << \makeClusters {
+ as16 <as b>
+ <g b>
+ <g cis>
+ } \\ {
+ \override Staff.Arpeggio #'arpeggio-direction =#down
+ <cis, e, gis, b, cis>4\arpeggio
+ }
+ >> }
+ >>
+ \midi {
+ \context {
+ \Score
+ tempoWholesPerMinute = #(ly:make-moment 60 8)
+ }
+ }
+ \layout {
+ \context {
+ \Staff
+ \consists Horizontal_bracket_engraver
+ }
+ }
+}
+@end lilypond
Die obenstehenden Beispiele wurde manuell erstellt, aber das ist nicht
die einzige Möglichkeit. Da der Satz fast vollständig automatisch abläuft,
-@node About this manual
-@section About this manual
+@node About the documentation
+@section About the documentation
+
+@cindex Handbuch zum Lernen
+@cindex Glossar
+@cindex Anwendungsbenutzung
+@cindex Schnipselliste
+@cindex Referenz der Interna
+
+Die Dokumentation zu LilyPond ist unterteilt in mehrere Handbücher.
-Es gibt zwei Handbücher zu LilyPond: das @emph{Benutzerhandbuch} (dieses
-Dokument) und das @emph{Handbuch über die Programmbenutzung}.
+@c leave these lines wrapping around. It's some texinfo 4.12 thing. -gp
+@c This is actually a limitation of texi2html. -jm
+@menu
+* About the Learning Manual:: Dieses Handbuch stellt LilyPond vor und vermittelt die Grundkenntnisse, um damit arbeiten zu können.
+* About the Music Glossary:: Dieses Handbuch erklärt zahlreiche musikalische Fachausdrücke inklusive Übersetzungen in verschiedene Sprachen.
+* About the Notation Reference:: Dieses Handbuch stellt den Hauptteil der Dokumentation dar. Es liefert detaillierte Informationen zum Notensatz mit LilyPond. Als Voraussetzung werden die Kenntnisse des @qq{Handbuchs zum Lernen} angenommen.
+* About the Application Usage:: Dieses Handbuch diskutiert den konkreten Aufruf des @qq{lilypond}-Programms und wie LilyPond-Notensatz in andere Programme integriert werden kann.
+* About the Snippet List:: Dies ist eine Sammlung von kurzen LilyPond-Beispielen.
+* About the Internals Reference:: Dieses Dokument liefert Referenzwissen über LilyPonds interne Strukturen und ist vor allem bei der Erstellung von tiefergehenden Optimierungen und Anpassungen hilfreich.
+* Other documentation:: Es existieren noch etliche weitere Teile der Dokumentation, wie etwa die @q{Neueigkeiten} Seite oder das Archiv der Mailingliste.
+@end menu
-@subheading User manual
+@node About the Learning Manual
+@unnumberedsubsec About the Learning Manual
-Das Handbuch ist in drei Bücher geteilt.
+@cindex Handbuch zum Lernen
-@subsubheading Learning manual
+Dieses Handbuch erklärt die Grundbegriffe von LilyPond und stellt
+die fundamentalen Konzepte hinter dem Programm vor. Diese Kapitel sollten
+in linearer Reihenfolge gelesen werden.
-In diesem Buch wird erklärt, wie man das Programm LilyPond erlernt; mit
-einfachen Begriffen werden einige Schlüsselkonzepte erklärt. Die Kapitel
-sollten hintereinander gelesen werden.
+Am Ende jedes Abschnitts findet sich ein Absatz @strong{Siehe auch}, der
+Kreuzreferenzen zu anderen Abschnitten enthält. Beim ersten Durchlesen
+empfiehlt es sich nicht, diesen gleich zu folgen, da meist noch
+zahlreiche Grundbegriffe zum Verständnis fehlen. Wenn Sie sich durch
+das Handbuch zum Lernen geackert haben, wollen Sie vielleicht einzelne
+Abschnitte nochmal durchgehen und dann den Kreuzverweisen zur Vertiefung
+der Zusammenhänge folgen.
-@c we need to completely rewrite this once GDP is finished. -gp
-@ignore
-@itemize @bullet
+@itemize
@item
-@ifhtml
-Die
-@end ifhtml
-@emph{@ref{Tutorial}},
-stellt eine einfache Einführung in den Musiksatz dar. Neulinge sollten hiermit
-beginnen.
+@ref{Introduction}: erklärt den Hintergrund und das Ziel von LilyPond.
+
+@item
+@ref{Tutorial}: liefert eine einfache Einführung in das Setzen von Musik
+mit LilyPond. Neulinge sollten mit diesem Kapitel beginnen.
@item
-@emph{@ref{Fundamental concepts}},
-erklärt generelle Konzepte des LilyPond-Dateiformates. Wenn Sie sich nicht
-sicher sind, wohin ein Befehl gesetzt werden soll, lesen Sie hier nach.
+@ref{Fundamental concepts}: erklärt etliche allgemeine Konzepte
+hinter dem Dateiformat von LilyPond. Wenn Sie sich nicht sicher
+sind, an welcher Stelle Sie einen Befehl in die Datei einfügen sollen,
+ist dieses Kapitel genau das richtige!
@item
-@emph{@ref{Working on LilyPond projects}},
-zeigt den wirklichen Einsatz von LilyPond und gibt Hinweise, wie einige
-Probleme vermieden werden können.
+@ref{Tweaking output}: stellt dar, wie die Standardeinstellungen von
+LilyPond verändert werden können.
@item
-@emph{@ref{Tweaking output}},
-stellt dar, wie die Standardeinstellungen von LilyPond verändert werden können.
-
+@ref{Working on LilyPond projects}: liefert Tipps im praktischen Umgang mit
+Lilypond und gibt Hinweise, wie gängige Fehler vermieden werden können.
+Bevor Sie mit einem großen Projekt beginnen, sollten Sie dieses Kapitel
+unbedingt gelesen haben!
+
@end itemize
+Das Handbuch zum Lernen enthält auch zahlreiche Anhänge, die nicht
+zum linearen Durchlesen geeignet sind. Sie sind allerdings zur späteren
+Referenz sehr gut geeignet:
+
+@itemize
+
+@item
+@ref{Templates}: zeigt einige fertige Dokumentvorlagen für diverse
+Stücke mit unterschiedlichen Charakteristika. Kopieren Sie einfach
+die Vorlagen in Ihre eigene Datei, fügen Sie die Noten hinzu und Sie
+sind fertig!
+
+@item
+@ref{Scheme tutorial}: liefert eine kurze Einführung in Scheme, die
+Programmiersprache, die die Musikfunktionen in LilyPond intern benutzen.
+Dies stellt tiefgehendes Wissen dar, wenn Sie LilyPond bis ins kleinste Detail
+konfigurieren möchten. Die meisten Benutzer brauchen dies jedoch selten bis
+gar nicht.
+
+@end itemize
-@subsubheading Notation reference
+
+@node About the Music Glossary
+@unnumberedsubsec About the Music Glossary
+
+@cindex Idiom
+@cindex Jargon
+@cindex Terminologie
+@cindex Übersetzungen
+@cindex Sprachen
+@cindex Glossar
+@cindex Thesaurus
+@cindex Fremdsprache
+
+@rglosnamed{Top,Das Glossar} erklärt musikalische Fachausdrücke und
+enthält auch deren Übersetzungen in diverse Sprachen. Wenn Sie mit
+Musiknotation oder der (englisch-sprachigen) Musikterminologie nicht vertraut
+sind (vor allem, wenn Englisch nicht Ihre Muttersprache ist), ist es
+sehr empfehlenswert, das Glossar immer wieder zu Rate zu ziehen.
+
+
+@node About the Notation Reference
+@unnumberedsubsec About the Notation Reference
+
+@cindex Notationsreferenz
+@cindex Anhänge
+@cindex Referenz zum Notensatz
In diesem Buch werden alle LilyPond-Befehle erklärt, die Notationszeichen
produzieren. Es geht von der Annahme aus, dass der Leser sich mit den
-Grundkonzeption des Programmes im Handbuch zum Lernen bekannt gemacht hat.
+Grundkonzepten des Programmes im Handbuch zum Lernen bekannt gemacht hat.
@itemize @bullet
@item
-@emph{@ruser{Musical notation}},
+@emph{@ruser{Musical notation}}:
erklärt alles über die grundlegenden Notationskonstruktionen. Dieses Kapitel
ist für fast jedes Notationsprojekt nützlich.
@item
-@emph{@ruser{Specialist notation}},
+@emph{@ruser{Specialist notation}}:
erklärt spezifische Schwierigkeiten, die sich bei bestimmten Notationstypen
ergeben. Dieses Kapitel ist nur in entsprechenden Fällen bestimmter Instrumente
oder bei Gesang zu konsultieren.
@item
-@emph{@ruser{Changing defaults}},
-erklärt, wie des Layout getrimmt werden kann.
-
-@item
-@emph{@ruser{Non-musical notation}},
-zeigt alles, was nicht direkt mit den Noten zu tun hat wie Titel, mehrere Sätze oder
-wie man ein MIDI-Instrument auswählt.
+@emph{@ruser{General input and output}}:
+erläutert allgemeine Informationen über die Eingabedateien von Lilypond und
+wie die Ausgabe gesteuert werden kann.
@item
-@emph{@ruser{Spacing issues}},
+@emph{@ruser{Spacing issues}}:
befasst sich mit globalen Fragen wie der Definition von Papierformaten
oder wie man Seitenumbrüche definiert.
@item
-@emph{@ruser{Interfaces for programmers}},
+@emph{@ruser{Changing defaults}}:
+erklärt, wie des Layout getrimmt werden kann um genau zum gewünschten Ergebnis
+zu kommen.
+
+@item
+@emph{@ruser{Interfaces for programmers}}:
demonstriert die Erstellung von musikalischen Funktionen.
@end itemize
+Ds Benutzerhandbuch enthält auch Anhänge mit nützlichen Referenztabellen.
-@subsubheading Appendices
-
-In diesem Buch werden nützliche Referenztabellen gezeigt.
+@itemize
-@itemize @bullet
@item
-@ifhtml
-Die
-@end ifhtml
-@emph{@ruser{Literature list}},
+Die @ruser{Literature list}
enthält einige wichtige Quellen für alle, die mehr über Notation und
den Notensatz erfahren wollen.
@item
-Die
-@emph{@ref{Scheme tutorial}},
-stellt eine kurze Einleitung in die Scheme-Sprache dar, mit dem
-die musikalischen Funktionen gebildet werden.
-
-@item
-@emph{@ruser{Notation manual tables}},
+@ruser{Notation manual tables}
sind Tabellen, in denen Akkordbezeichnungen, MIDI-Instrumente,
Farbbezeichnungen und die Zeichen der Feta-Schriftart gesammelt sind.
-@item
-@emph{@ref{Templates}},
-von LilyPond-Stücken. Kopieren Sie einfach hier, fügen Sie in ihre Datei
-ein und schreiben Sie noch die Noten dazu. Das ist alles!
-
@item
Die
-@emph{@ruser{Cheat sheet}},
+@emph{@ruser{Cheat sheet}}
zeigt die wichtigsten LilyPond-Befehle.
@item
Der
-@emph{@ruser{LilyPond command index}},
+@emph{@ruser{LilyPond command index}}
listet alle Befehle auf, die mit @code{\} anfangen.
@item
Der
-@emph{@ref{LilyPond index}},
+@emph{@ref{LilyPond index}}
ist ein vollständiger Index.
@end itemize
-@end ignore
-@subheading Program usage
+
+@node About the Application Usage
+@unnumberedsubsec About the Application Usage
+
+@cindex Anwendungsbenutzung
+@cindex Benutzung, lilypond-Programm
+@cindex Integration von LilyPond in andere Programme
In diesem Buch wird erklärt, wie das Programm ausgeführt wird und
wie die Notation von LilyPond in andere Programme integriert werden
@itemize @bullet
@item
-@emph{@rprogram{Install}},
+@emph{@rprogram{Install}}:
erklärt wie LilyPond installiert wird (inklusive Kompilation, wenn es
nötig sein sollte).
@item
-@emph{@rprogram{Setup}},
+@emph{@rprogram{Setup}}:
erklärt wie der Computer eingerichtet wird, damit LilyPond optimal genutzt
werden kann. Hierzu gehören etwa spezielle Umgebungen für bestimmte
Texteditoren.
@item
-@emph{@rprogram{Running LilyPond}},
+@emph{@rprogram{Running LilyPond}}:
zeigt, wie LilyPond und seine Hilfsprogramme gestartet werden. Zusätzlich
wird hier erklärt, wie Quelldateien von alten LilyPond-Versionen aktualisiert
werden können.
@item
-@emph{@rprogram{LilyPond-book}},
+@emph{@rprogram{LilyPond-book}}:
erklärt die Details, um einen Text mit eingefügten Notenbeispielen (wie
etwa dieses Handbuch) zu
erstellen.
@item
-@emph{@rprogram{Converting from other formats}},
+@emph{@rprogram{Converting from other formats}}:
erklärt, wie die Konvertierungsprogramme aufgerufen werden. Diese
Programme kommen mit LilyPond zusammen und konvertieren eine Vielzahl
von Notensatzformaten in das @code{.ly}-Format.
@end itemize
-@subsubheading Other information
-
-Es gibt einige andere Orte, die sehr wertvolle Information enthalten.
-@itemize @bullet
-@cindex Dialekt
-@cindex Jargon
-@cindex Terminologie
-@cindex Fremdsprache
-@cindex Sprache
-@cindex Englische Begriffe
+@node About the Snippet List
+@unnumberedsubsec About the Snippet List
-@item
-@ifnottex
-Das @ref{Top,Musik-Glossar,,music-glossary}, erklärt musikalische Ausdrücke
-und stellt Übersetzungen für einige Sprachen bereit. Es ist auch als PDF
-erhältlich.
-@end ifnottex
-@iftex
-Das Musik-Glossar erklärt musikalische Ausdrücke
-und stellt Übersetzungen für einige Sprachen bereit. Es ist auch als PDF
-erhältlich.
-@end iftex
-Wenn Sie sich mit der Notation von Musik nicht auskennen (und besonders,
-wenn Englisch nicht Ihre Muttersprache ist), wird dieses Glossar von
-großer Hilfe sein.
-
@cindex Schnipsel
@cindex LSR
-@item
-Die
-@ifhtml
-@uref{source/input/lsr/collated-files.html,Schnipsel}
-@end ifhtml
-@ifnothtml
-Schnipsel
-@end ifnothtml
-sind eine ausführliche Sammlung kurzer Beispiele, anhand derer Tricks,
-Tipps und Spezialfunktionen von LilyPond demonstriert werden. Die meisten
-dieser Schnipsel können auch im
- @uref{http://lsr.dsi.unimi.it/,LilyPond Schnipsel
-Depot} betrachtet werden. Diese Internetseite verfügt auch über ein
+@cindex LilyPond Snippet Repository
+@cindex LilyPond-Schnipsel-Depot
+
+Die @rlsrnamed{Top,LilyPond-Schnipsel} sind eine ausführliche Sammlung kurzer
+Beispiele, anhand derer Tricks, Tipps und Spezialfunktionen von LilyPond
+demonstriert werden. Die meisten dieser Schnipsel können auch im
+ @uref{http://lsr.dsi.unimi.it/,LilyPond-Schnipsel-Depot} betrachtet
+werden. Diese Internetseite verfügt auch über ein
durchsuchbares LilyPond-Handbuch.
+Die Liste der Schnipsel zu einem Abschnitt des Benutzerhandbuchs ist auch
+dort jeweils im Abschnitt @strong{Siehe auch} verlinkt.
-@item
-Die
-@iftex
-Programmreferenz
-@end iftex
-@ifnottex
-@ref{Top,Programmreferenz,,lilypond-internals}
-@end ifnottex
-ist eine Sammlung intensiv verlinkter HTML-Seiten,
-die alle Details jeder einzelnen LilyPond-Klasse, jedes Objektes und
-jeder Funktion erklären. Sie wird direkt aus den Satzdefinitionen
-produziert.
+
+@node About the Internals Reference
+@unnumberedsubsec About the Internals Reference
+
+@cindex Referenz der Interna
+
+Die @rinternalsnamed{Top,Referenz der Interna} ist eine Sammlung intensiv
+verlinkter HTML-Seiten, die alle Details jeder einzelnen
+LilyPond-Klasse, jedes Objektes und jeder Funktion erklären. Sie wird
+direkt aus den Satzdefinitionen im Quellcode produziert.
So gut wie alle Formatierungsmöglichkeiten, die intern verwendet werden,
sind auch direkt für den Benutzer zugänglich. Alle Variablen z. B., die
alle haben einen @qq{Siehe}-Abschnitt, der auf die Dokumentation verweist.
Im HTML-Handbuch haben diese Abschnitte klickbare Links.
-Die Programmreferenz ist nur auf englisch erhältlich.
+Die Programmreferenz ist nur auf englisch verfügbar.
-@end itemize
+@node Other documentation
+@unnumberedsubsec Other documentation
-Wenn Sie schon ein erfahrener Benutzer sind, können Sie dieses Handbuch
-als Referenz benutzen: Es enthält einen ausführlichen Index@footnote{Wenn
-Sie nach etwas suchen und es nicht im Handbuch finden, so gilt das als Fehler.
-Bitte schicken Sie in diesem Fall einen Fehlerbericht.}, aber das Dokument
-ist auch als
-@iftex
-große HTML-Seite erhältlich,
-@end iftex
+Es gibt noch eine Reihe weiterer wertvoller Informationsquellen zu LilyPond:
+
+
+@itemize
+
+@item
@ifhtml
-@uref{source/Documentation/user/lilypond-big-page.html, eine große Seite
-erhältlich},
+@ifset bigpage
+@uref{../topdocs/NEWS.html,Neuigkeiten}:
+@end ifset
+@ifclear bigpage
+@uref{../../topdocs/NEWS.html,Neuigkeiten}:
+@end ifclear
@end ifhtml
-die auf einfache Art mit der Suchfunktion Ihres Browsers durchsucht werden kann.
-
-Auf allen HTML-Seiten, die Noten eingebettet haben, deren Ausgabe mit LilyPond
-vorgenommen wurde, kann die originale Quelldatei durch einen Klick auf das
+@ifnothtml
+Neuigkeiten:
+@end ifnothtml
+eine Zusammenfassung der Änderungen in LilyPond seit der letzten Version.
+
+@item @uref{http://lists.gnu.org/archive/html/lilypond-user/,Das Archiv
+der lilypond-user Mailing-Liste}: enthält alle bisher an die Liste
+gesendeten Mails. Viele Fragen werden immer wieder gestellt und auch
+beantwortet. Die Chance, dass Ihre Frage auch schon mal aufgetaucht ist,
+ist also relativ groß. In diesem Fall finden Sie die Antwort in diesem
+Archiv.
+
+@item @uref{http://lists.gnu.org/archive/html/lilypond-devel/,Das Archiv
+der lilypond-devel Mailing-Liste}: enthält alle bisher an die
+Entwicklerliste gesendeten Mails. Diese Diskussionen sind dementsprechend
+technisch gehalten. Wenn Sie eine tiefergehende Frage zu den Interna von
+LilyPond haben, finden Sie die Antwort vielleicht in diesem Archiv.
+
+@item Eingebettete Musikbeispiele: Auf allen HTML-Seiten mit Notenbeispielen,
+die von LilyPond erzeugt wurden, kann die originale Quelldatei durch einen Klick auf das
Bild betrachtet werden.
+@item Initialisierungsdateien von LilyPond:
+
Der Speicherort der Dokumentationsdateien unterscheidet sich evtl. je
nach Betriebssystem. Manchmal wird hier auf Initialisierungs- oder
Beispieldateien verwiesen. Das Handbuch nimmt dabei an, dass diese
@file{lilypond@/2.x.y/@/input/@/lsr/@/Verzeichnis/@/bla@/.ly} verweisen. In den
Binärpaketen für Unix-Plattformen sind Dokumentation und Beispiele
üblicherweise in einem Verzeichnis wie @file{/usr/@/share/@/doc/@/lilypond/}
-gespeichert. Initialisierungsdateien, etwa @file{scm/@/lily@/.scm},
+gespeichert. Initialisierungsdateien, etwa @file{scm/@/lily@/.scm}
oder @file{ly/@/engraver@/-init@/.ly}, befinden sich normalerweise im
Verzeichnis @file{/usr/@/share/@/lilypond/}.
-@cindex Anpassen der Ausgabe
-@cindex Variablen
-@cindex Eigenschaften
-@cindex properties
-@cindex lilypond-internals
-@cindex interne Dokumentation
-@cindex Scheme
-@cindex Erweiterung von LilyPond
-@cindex Index
-
-Dieses Handbuch (so wie alle anderen) ist als PDF- oder HTML-Datei von
-LilyPonds Internetseite @uref{http://@/www@/.lilypond@/.org/} herunterladbar.
+Weiterführende Informationen finden Sie unter @ref{Other sources of information}.
+
+@end itemize
+
projects / lilypond.git / blobdiff