3.2.2 Texinfo

Texinfo ist das Standard-Dokumentationsformat des GNU Projekts. Ein Beispiel für ein Dokument im Texinfo Format ist dieses Handbuch, wobei die HTML-, PDF- und Info-Versionen alle aus demselben Texinfo Dokument erzeugt werden.

lilypond-book stellt die folgenden Befehle und Umgebungen zur Verfügung, im Noten in Texinfo-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 folgenden Befehlen eingegeben:

@lilypond[Optionen,kommen,hier]
  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 aktuelle Versionsnummer von LilyPond angezeigt werden.

Wenn lilypond-book eine derartige Datei verarbeitet, wird eine Texinfo-Datei mit der Erweiterung .texi erzeugt, die @image Befehle für die Ausgabe nach HTML, Info und PDF enthält. lilypond-book erzeugt die entsprechenden Grafiken der Musikbeispiele im EPS- und PDF-Format für die Ausgabe nach PDF und im PNG-Format für die Ausgabe nach HTML und Info.

Hier sollen zwei einfache Beispiele gezeigt werden. Eine lilypond Umgebung

@lilypond[fragment]
c' d' e' f' g'2 g'
@end lilypond

erzeugt

Die Kurzversion

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

erzeugt

Im Gegensatz zu LaTeX erzeugt @lilypond{...} allerdings keine Grafik im Fließtext, sondern setzt sie immer in einen eigenen Absatz.