3.2.1 LaTeX

LaTeX ist der de-facto Standard zur Publikation von wissenschaftlichen Texten in Naturwissenschaft und Technik. Es basiert auf dem Schriftsetzer TeX, der die bestmögliche Typographie erzeugt.

Siehe die LaTeX2e-Kurzbeschreibung für eine Einführung in die Benutzung von LaTeX.

lilypond-book stellt folgende Befehle und Umgebungen zu Verfügung, um Noten in LaTeX-Dateien einzufügen:

• den \lilypond{...}-Befehl, womit man direkt kurze LilyPond-Codeabschnitte schreiben kann
• die \begin{lilypond}...\end{lilypond}-Umgebung, mit der man längere LilyPond-Codeabschnitt direkt schreiben kann
• den \lilypondfile{...}-Befehl um eine LilyPond-Datei einzufügen
• den \musicxmlfile{...}-Befehl um eine MusicXML-Datei einzufügen, die dann von musicxml2ly und lilypond bearbeitet wird.

In der Eingabedatei werden Noten mit beliebigen der folgenden Befehle angegeben:

\begin{lilypond}[Optionen,kommen,hierhin]
  IHR LILYPOND-QUELLCODE
\end{lilypond}

\lilypond[Optionen,kommen,hier]{ IHR LILYPOND-QUELLCODE }

\lilypondfile[Optionen,kommen,hier]{Dateiname}

\musicxmlfile[Optionen,kommen,hier]{Dateiname}

Zusätzlich kann mit \lilypondversion die benutzte Versionsnummer von LilyPond angezeigt werden. Der Aufruf von lilypond-book liefert eine Datei, die dann mit LaTeX weiter verarbeitet werden kann.

Dies soll hier an einigen Beispielen gezeigt werden. Die lilypond-Umgebung

\begin{lilypond}[quote,fragment,staffsize=26]
  c' d' e' f' g'2 g'2
\end{lilypond}

erzeugt

Die Kurzversion

\lilypond[quote,fragment,staffsize=11]{<c' e' g'>}

erzeugt

Innerhalb des \lilypond{} Befehls dürfen keine geschwungenen Klammern { oder } vorkommen, weshalb dieser Befehl nur mit der fragment-Option Sinn macht.

Die Standardzeilenlänge wird bestimmt, indem die Angaben in der Dokumentpräambel, also dem Teil der LaTeX Datei vor dem \begin{document}, analysiert werden. Der lilypond-book-Befehl sendet diese Angaben an LaTeX, um herauszufinden, wie breit der Text tatsächlich ist. Die Breite der Notenzeilen wird dann an diese Textbreite angepasst. Ein derartig heuristischer Algorithmus kann natürlich auch versagen, wobei man in diesem Fall die Breite auch explizit durch die line-width Option des \lilypond{} oder \begin{lilypond} Befehls angeben kann.

Jedes Musikbeispiele ruft die folgenden Makros auf, wenn sie vom Benutzer definiert wurden:

• \preLilyPondExample – wird vor der Musik aufgerufen,
• \postLilyPondExample – wird nach der Musik aufgerufen,
• \betweenLilyPondSystem[1] – wird zwischen den einzelnen Systemen aufgerufen, wenn lilypond-book das Beispiel in verschiedene PostScript Dateien getrennt hat. Dieser LaTeX-Befehl muss so definiert werden, dass er genau ein Argument erhält, nämlich die Zahl der bereits in LaTeX eingefügten Dateien dieses Beispiels. Als Standard wird einfach ein \linebreak eingefügt.

Ausgewählte Schnipsel

Manchmal ist es nötig, Musikelemente wie Halte- oder Bindebögen so darzustellen, als ob sie am Ende des Musikausschnittes noch weitergehen würden. Eine solche Ausgabe kann erreicht werden, indem ein Zeilenumbruch in die Notenzeile eingefügt wird und die Ausgabe der folgenden Notenzeile unterdrückt wird.

In LaTeX wird dazu der Befehl \betweenLilyPondSystem einfach derartig programmiert, dass die Ausgabe der einzelnen Notensysteme abgebrochen wird, sobald die gewünschte Anzahl an Systemen erreicht ist. Da \betweenLilyPondSystem zum ersten Mal nach dem ersten System aufgerufen wird, ist die Ausgabe nur eines Systems trivial.

\def\betweenLilyPondSystem#1{\endinput}

\begin{lilypond}[fragment]
  c'1\( e'( c'~ \break c' d) e f\)
\end{lilypond}

Um eine größere Zahl an System nötig, dann muss dementsprechend eine TeX-Bedingung vor dem \endinput benutzt werden:

\def\betweenLilyPondSystem#1{
    \ifnum##1<2\else\endinput\fi
}

Dieses Beispiel bricht nach genau zwei ausgegebenen Notenzeilen ab. Für eine andere Anzahl braucht nur ‚2‘ durch die entsprechende Anzahl ersetzt werden.

Die Definition von \betweenLilyPondSystem bleibt gültig, bis TeX die aktuelle Umgebung in LaTeX verlässt oder der Befehl durch eine neue Definition überschrieben wird. Dies kann etwa folgendermaßen in der LaTeX-Datei geschehen:

\let\betweenLilyPondSystem\undefined

Obige Definition von \betweenLilyPondSystem kann durch die Definition eines TeX-Makros auch verallgemeinert werden,

\def\onlyFirstNSystems#1{
    \def\betweenLilyPondSystem##1{\ifnum##1<#1\else\endinput\fi}
}

wobei diesem Makro \onlyFirstNSystems einfach die Anzahl der gewünschten Systeme übergeben wird:

\onlyFirstNSystems{3}
\begin{lilypond}...\end{lilypond}
\onlyFirstNSystems{1}
\begin{lilypond}...\end{lilypond}

Siehe auch

lilypond-book stellt auch zahlreiche Kommandozeilen-Optionen zur Verfügung. Für eine Liste dieser Optionen und andere hilfreiche Details zur Verarbeitung von LaTeX-Dokumenten, siehe lilypond-book aufrufen.