[[InArbeit(31.3.2007,Schmooke)]] [[Getestet(edgy, dapper)]]

{{{
#!Wissen
 * [1]: [:Pakete_installieren: Installation von Paketen]
 * [2]: [:Paketquellen freischalten: Bearbeiten von Paketquellen]
 * [3]: [:Terminal: Ein Terminal öffnen]
}}}
[[TableOfContents(2)]]

= Einleitung =
Lilypond ist ein freies Notensatz-Programm für Linux, FreeBSD, MacOS X und Windows. Anders als ''Noteedit'' oder ''Rosegarden'' ist Lilypond kein "What you see is what you get" Programm - die Noten werden ähnlich wie bei ["LaTeX"] in einer einfachen Textdatei gespeichert, die dann von Lilypond in das PDF-Format übersetzt wird. Auch eine MIDI-Datei kann erzeugt werden.

= Installation =
Das folgende Paket muss installiert [1] werden:

 * '''lilypond''' (''universe'', [2])
== Manuelle Installation ==
[[Include(Paketquellen/Warnung_Pakete)]] Es kann auch die aktuelle Version von [http://lilypond.org/web/install/] {en} {de} heruntergeladen werden. Die Entwickler von Lilypond stellen ein Installationsprogramm bereit, da das kompilieren, nach den Angaben der Entwickler, kompliziert sein soll. Hat man das Installationsprogramm heruntergeladen, so kann Lilypond im Terminal [3] mit dem Befehl

{{{
#!Befehl
sudo sh lilypond-X.Y.Z.linux-x86.sh
}}}
installiert werden. Hierbei bezeichnet X.Y.Z die entsprechende Versionsnummer.

=== Deinstallation ===
Das manuell installierte Lilypond kann mit dem Befehl

{{{
#!Befehl
sudo /usr/local/bin/uninstall-lilypond
}}}
wieder gelöscht werden.

= Benutzung =
Eine kurze Einleitung findet sich im sogenannten [http://lilypond.org/web/switch/howto Intensivkurs] {de} , das Studium einer ausführlichen Anleitung ist aber für komplexere Beispiele zu empfehlen. Eine ausführliche Anleitung ist auf der offiziellen Homepage zu finden. Bietet diese nicht die gewünschten Informationen, so kann man in den Archiven der LilyPond [http://lists.gnu.org/mailman/listinfo/lilypond-user Mailingliste] {en} suchen, oder sich auf der Liste anmelden und Fragen stellen. Eine Übersicht über die gebräuchlichsten Befehle zeigt das [http://lilypond.org/doc/v2.6/Documentation/user/lilypond/Cheat-sheet.html#Cheat-sheet Lilypond Cheat Sheet] {en} .

{{{
#!Hinweis
Die Syntax von Lilypond ist zwischen den Major Releases (also z.B. zwischen 2.6 und 2.8) kleineren oder größeren Änderungen unterworfen. Deswegen sollte man darauf achten, die zur verwendeten Version passende Dokumentation zu verwenden. Die Konvertierung von Quelldateien zwischen zwei Versionen übernimmt das Hilfprogramm '''convert-ly''', das mit Lilypond ausgeliefert wird.
}}}
Lilypond-Dateien sind einfache Text-Dateien, ähnlich wie bei ["LaTeX"], mit der Endung '''.ly'''. Auch die Syntax hat eine gewissen Ähnlichkeit zu LaTeX. Die Eingabe der Noten erfolgt sehr intuitiv. 

Hat man ein Stück gesetzt, so kann dies mit

{{{
#!Befehl
lilypond DATEINAME
}}}
in ein PDF-Dokument bzw. in eine MIDI-Datei exportiert werden. Auch andere Ausgabeformate wie PNG oder SVG sind möglich. Eine PNG-Datei wird zum Beispiel mit
{{{
#!Befehl
lilypond --png DATEINAME
}}}
erzeugt.

= Beispiele =

== Beispiel 1 ==

Hier ein einfaches Beispiel:

{{{
#!Text
\header {
  title = "Alle meine Entchen"
}
\version "2.6.3"
<<
\relative c'
{
\time 2/4
\key d \major
d8[ e fis g] a4 a b8[ b b b] a4 r b8[ b b b]
a4 r g8[ g g g] fis4 fis a8[ a a a] d4 r
}
\addlyrics { Al -- le mei -- ne Ent -- chen schwim -- men auf dem See,
schwim -- men auf dem See, Köpf -- chen un -- ters Was -- ser,
Schwänz -- chen in die Höh’ }
>>
}}}

Obiges Beispiel gibt folgendes Resultat: [[Bild(./entchen.png,,zentriert)]]

== Beispiel 2 ==

Und noch ein komplexeres Beispiel mit Kommentaren, diese werden mit dem %-Zeichen eingeleitet. (Achtung: Lilypond Version 2.10.12)

{{{
#!Text

% Die Angabe der Versionsnummer stellt sicher, dass die Datei mit dem Programm convert-ly konvertiert werden kann.
\version "2.10.12"

% Um die Noten auf eine Seite einzupassen, kann die Größe der Systeme per Hand angepasst werden.
#(set-global-staff-size 20)

% Im sogenannten "header" kann man Überschriften u.Ä. setzen.
\header {
        title    = "Belle, qui tiens ma vie"
        composer = "Musik: Thoinot Arbeau (1520-1595)"
        arranger = "Aus \"Orchésgraphie\" (1589)"
        poet     = "Text: 16. Jh."
        tagline  = "- 1 -"
}

global = {
        \key f \major
        \time 2/2
}

% Die Noten können als Variablen abgespeichert werden, damit man im sogenannten "score" Block auf sie zurückgreifen kann.
% Somit können komplexere Dokumente gut strukturiert werden.
SopranNoten = \relative c'' {
                \repeat volta 2 { \partial 2 g2 g4 fis g a bes2 bes4 d c bes bes a bes2 } \break
                bes2 \repeat volta 2 { a4 a g g fis2 d e8( f) g4 g fis }
                \alternative { { g2 bes } { g } } \bar "|."
}
AltNoten = \relative c' {
                \repeat volta 2 { \partial 2 d2 d4 d d f f2 f4 f e f g f f2 }
                f2 \repeat volta 2 { f4 f d es d2 f c4 d d d }
                \alternative { { b2 d } { d } }
}
TenorNoten = \relative c' {
                \repeat volta 2{ \partial 2 bes2 bes4 a bes c d2 d4 bes g d' c c d2 }
                d \repeat volta 2 {c4 d bes c a2 bes g4 bes a a}
                \alternative { { g2 bes } { g } }
}
BassNoten = \relative c' {
                \repeat volta 2 { \partial 2 g2 g4 d g f bes,2 bes4 bes c d es f bes,2 }
                bes'2 \repeat volta 2 { f4 d g c, d2 bes c4 g d' d }
                \alternative { { g,2 g' } { g, } }
}
stropheEins = \lyricmode {
        \set stanza = "1. " Bel -- le, qui tiens ma vi -- e cap -- ti -- ve dans tes yeux,
        viens tôt me se -- cou -- rir, ou me __ fau -- dra mou -- rir, viens rir.
}
stropheEinsWiederholung = \lyricmode {
        qui m'as l'â -- me ra -- vi -- e d'un sou -- riz gra -- ci -- eux,
}
stropheZwei = \lyricmode {
        \set stanza = "2. " Pour -- quoi fuis -- tu, mi -- gnar -- de, si je suis près de toy,
        car tes per -- fec -- ti -- ons chan -- gent __ mes ac -- ti -- ons, car ons.
}
stropheZweiWiederholung = \lyricmode {
        quand tex yeux je re -- gar -- de je me perds de -- dans moy,
}
stropheDrei = \lyricmode {
        \set stanza = "3. " Ap -- pro -- che donc ma bel -- le, ap -- pro -- che toy mon bien,
        pour mon mal ap -- pai -- ser, don -- ne __ moy un bai -- ser. pour ser.
}
stropheDreiWiederholung = \lyricmode {
        ne me sous plus re -- bel -- le puis -- que mon coeur est tien,
}

% Im score-Block wird die Gestaltung der Seite festgesetzt.
\score {
        <<
                \new ChoirStaff <<
                        \new Staff = "frauen" <<
                                \new Voice = "Sopran" { \voiceOne << \global \SopranNoten >> }
                                \new Voice = "Alt" { \voiceTwo << \global \AltNoten >> }
                                \addlyrics { \stropheEins }
                                \addlyrics { \stropheEinsWiederholung }
                                \addlyrics { \stropheZwei }
                                \addlyrics { \stropheZweiWiederholung }
                                \addlyrics { \stropheDrei }
                                \addlyrics { \stropheDreiWiederholung }
                        >>
                        \new Staff = "maenner" <<
                                \new Voice = "Tenor" { \voiceOne << \global \clef bass  \TenorNoten >> }
                                \new Voice = "Bass" { \voiceTwo << \global \clef bass  \BassNoten >> }
                                \addlyrics { \stropheEins }
                                \addlyrics { \stropheEinsWiederholung }
                        >>
                >>
        >>
}

% Das Stück beeinhaltet Wiederholungen, die von der Midi-Ausgabe nicht berücksichtigt werden.
% Um die Wiederholungen in der Midi-Datei auszuspielen, gibt es die Option "unfoldRepeats"
\score {
                \new ChoirStaff <<
                        \new Staff = "Sopran" <<
                                \new Voice = "1" { \global \unfoldRepeats \SopranNoten }
                        >>
                        \new Staff = "Alt" <<
                                \new Voice = "2" { \global \unfoldRepeats \AltNoten }
                        >>
                        \new Staff = "Tenor" <<
                                \new Voice = "3" { \global \unfoldRepeats \TenorNoten }
                        >>
                        \new Staff = "Bass" <<
                                \new Voice = "4" { \global \unfoldRepeats \BassNoten }
                        >>
                >>
   \midi {
     \context {
       \Score
       tempoWholesPerMinute = #(ly:make-moment 120 4)
       }
   }
}
}}}

Obiges Beispiel gibt folgendes Resultat: [[Bild(./belle.png,500,zentriert)]]


= Tipps zur Benutzung =

Da Lilypond keine graphische Benutzeroberfläche bereitstellt, muss man, ähnlich wie bei LaTeX, von Zeit zu Zeit ein PDF-Dokument erstellen um eventuelle Fehler ausfindig zu machen. Möchte man dies nicht im Terminal machen, so kann man zum Beispiel in Kile ein Ausgabeprofil für Lilypond erstellen.
Hierzu benutzt man den Konfigurationsdialog von Kile um ein neues "Build-Tool" zu erzeugen. Als Kommando wählt man zum Beispiel
{{{#!Text
lilypond '%source'
}}}

= Links =
 * [http://www.lilypond.org offizielle Homepage] {en} {de}
 * [http://lilypond.org/web/switch/howto Intensivkurs] {de}
 * [http://lists.gnu.org/mailman/listinfo/lilypond-user Lilypond Mailingliste] {en}
 * [http://www.mutopiaproject.org/ Viele freie Lilypond Beispieldateien] {en}