@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: e831b9b97caae23725709d2fe11a6436240ed580
+ Translation of GIT committish: 2c00bdbfaf62dd90863331c4713e6b29e32c9322
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.51"
+@c \version "2.11.61"
+@c Translators: Till Rettig, Reinhold Kainhofer
@node Introduction
@chapter Introduction
von LilyPond vor.
@menu
-* Background::
-* About the documentation::
+* Background::
+* About the documentation::
@end menu
Dieser Abschnitt behandelt die allgemeinen Ziele und die Architektur von LilyPond.
@menu
-* Engraving::
-* Automated engraving::
-* What symbols to engrave?::
-* Music representation::
-* Example applications::
+* Engraving::
+* Automated engraving::
+* What symbols to engrave?::
+* Music representation::
+* Example applications::
@end menu
@node 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
Jahren wurden Noten erstellt, indem man sie in eine Zink- oder Zinnplatte
@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
@node 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,
ein Programm zu schreiben, dass den Beruf des
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
(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
@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,
\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
+@seealso
Programmreferenz: @rinternals{Contexts}.
+
@lilypond[quote,ragged-right]
\include "engraver-example.ily"
\score {
@node Music representation
@unnumberedsubsec Music representation
+@cindex Syntax
+@cindex rekursive Strukturen
+
Idealerweise ist das Eingabeformat für ein höheres 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,
dargestellt werden. So etwa hier:
@lilypond[quote,verbatim,fragment,relative=1]
-c4
+f4
@end lilypond
@noindent
@node 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
Programm kann nun dank vieler harter Arbeitsstunden benutzt werden,
@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 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.
@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 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 zur Notation mit LilyPond. Als Voraussetzung werden die Kenntnisse des @q{Handbuchs zum Lernen} angenommen.
-* About the Application Usage:: Dieses Handbuch diskutiert den konkreten Aufruf des @q{lilypond} Programms, sowie Betriebssystem-spezifische Aspekte.
-* About the Snippet List:: Dies ist eine Sammlung von kurzen LilyPond Beispielen.
+* 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 existiern noch etliche weitere Teile der Dokumentation, wie etwa die @q{Neueigkeiten} Seite oder das Archiv der Mailingliste.
+* Other documentation:: Es existieren noch etliche weitere Teile der Dokumentation, wie etwa die @q{Neueigkeiten} Seite oder das Archiv der Mailingliste.
@end menu
@node About the Learning Manual
@unnumberedsubsec About the Learning Manual
+@cindex Handbuch zum Lernen
+
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.
-Am Ende jedes Abschnitts findet sich an Absatz @strong{Siehe auch}, der
+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
@cindex Thesaurus
@cindex Fremdsprache
-@rglosnamed{Top,Das Musikglossar} erklärt musikalische Fachausdrücke und
+@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 Musikglossar immer wieder zu Rate zu ziehen.
+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
Grundkonzepten des Programmes im Handbuch zum Lernen bekannt gemacht hat.
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{Changing defaults}},
+@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}},
+@emph{@ruser{Interfaces for programmers}}:
demonstriert die Erstellung von musikalischen Funktionen.
@end itemize
@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
@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
kann.
@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.
@cindex Schnipsel
@cindex LSR
+@cindex LilyPond Snippet Repository
+@cindex LilyPond-Schnipsel-Depot
-Die @rlsrnamed{Top,Schnipsel} sind eine ausführliche Sammlung kurzer
+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
+ @uref{http://lsr.dsi.unimi.it/,LilyPond-Schnipsel-Depot} betrachtet
werden. Diese Internetseite verfügt auch über ein
durchsuchbares LilyPond-Handbuch.
@node About the Internals Reference
@unnumberedsubsec About the Internals Reference
-Die @rinternalsnamed{Top,Programmreferenz} ist eine Sammlung intensiv
+@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.
projects / lilypond.git / blobdiff