nächstes: Dateiendungen, voriges: Die Musikfragment-Optionen, aufwärts: LilyPond-book
lilypond-book erzeugt abhängig vom Ausgabeformat eine Datei mit einer der folgenden Dateierweiterungen: .tex, .texi, .html oder .xml. Alle .tex, .texi und .xml Dateien müssen noch mit den entsprechenden Programmen (LaTeX, DocBook, etc.) weiter verarbeitet werden, um druckfähige Dateien zu erhalten.
Es existieren zwei Methoden, Ihr LaTeX-Dokument weiter zu verarbeiten, um zu einer druck- oder publikationsfähigen Datei zu gelangen: Zum einen die direkte Erzeugung einer PDF-Datei mit PDFLaTeX, zum anderen die Erzeugung einer DVI daraus einer PostScript-Datei mittels LaTeX und einem DVI-nach-PostScript Konverters wie dvips. Die erste Methode ist einfacher und daher empfehlenswert.1 Welche Methode auch immer benutzt wird, die Konvertierung zwischen PostScript und PDF kann leicht mit Hilfsprogrammen wie ps2pdf und pdf2ps (aus dem Ghostscript Paket) erfolgen.
Um eine PDF-Datei mittels PDFLaTeX zu erzeugen, kann folgendermaßen vorgegangen werden:
lilypond-book --pdf Ihre_Datei.pdftex pdflatex Ihre_Datei.tex
Um eine PDF-Datei mittels LaTeX/dvips/ps2pdf zu erhalten, sind folgende Befehle nötig:
lilypond-book Ihre_Datei.lytex latex Ihre_Datei.tex dvips -Ppdf Ihre_Datei.dvi ps2pdf Ihre_Datei.ps
Die .dvi-Datei, die beim Aufruf von latex erzeugt wird, scheint keine Notenköpfe zu enthalten, was in Ordnung ist. Wenn Sie die Datei wie beschrieben weiter verarbeiten, erscheinen die Notenköpfe korrekt in den .ps und .pdf Dateien.
Der Aufruf von dvips kann einige Warnungen über fehlende Schriftarten ausgeben. Auch dies ist in Ordnung und kann ignoriert werden.
Wenn Sie in der LaTeX-Datei das Papierformat auf Querformat eingestellt
haben, vergessen Sie nicht auf die -t landscape
Option beim
Aufruf von dvips.
Um ein von lilypond-book erzeugtes Texinfo-Dokument zu verarbeiten, gehen Sie wie für alle anderen Texinfo-Dokumente vor: Rufen Sie – abhängig vom gewünschten Ausgabeformat – eines der Programme texi2pdf, texi2dvi, makeinfo oder texi2html auf.
Die Dokumentation von Texinfo liefert dazu nähere Informationen.
lilypond-book unterstützt die folgenden Kommandozeilenoptionen:
-f
Format--format=
Formathtml
, latex
,
texi
(Standardeinstellung), texi-html
oder docbook
.
Ist diese Option nicht angegeben, versucht lilypond-book das
Format anhand des Dateinamens zu bestimmen. Im Moment bedeutet texi
praktisch dasselbe wie texi-html
.
-F
Filter--filter=
Filterlilypond-book --filter='convert-ly --from=2.0.0 -' Mein-Buch.tely
-h
--help
-I
Pfad--include=
Pfad-I
Pfad Option angegeben werden,
damit das entsprechende Programm die Grafiken ebenso findet.
-o
Verzeichnis--output=
Verzeichnislilypond-book --output=out IhreDatei.lytex cd out ...
--skip-lily-check
--skip-png-check
--lily-output-dir=
Verzeichnis--output
angegebenen Verzeichnis Verknüpfungen darauf.
Diese Option ist nützlich, um Zeit zu sparen, wenn Dokumente in
verschiedenen Verzeichnissen viele identische Musikfragmente
enthalten.
--info-images-dir=
Verzeichnis--latex-program=
Programm--left-padding=
EinrückungDie Breite eines eng ausgeschnittenen Notensystems kann variieren
aufgrund von Notationselementen, die über den linken Rand hinausstehen,
wie etwa Taktzahlen und Bezeichnungen der Instrumente. Diese Option
verkürzt die Notenzeile und verschiebt sie um denselben Betrag nach
rechts.
-P
Kommando--process=
Kommandolilypond
. --filter
und --process
können nicht gleichzeitig angegeben werden.
--pdf
-V
--verbose
-v
--version
Der Texinfo-Befehl @pagesizes
wird ignoriert. Ebenso werden
LaTeX-Befehle ignoriert, die den Seitenrand oder die Zeilenlänge
nach der Dokumentpräambel verändern.
Nur der erste \score
-Block eines LilyPond-Fragments wird verarbeitet.
[1] Manchmal kann eine Datei entweder von PDFLaTeX oder von LaTeX nicht korrekt verarbeitet werden, weshalb hier beide Methoden beschrieben werden.
Diese Seite ist für LilyPond-2.11.58 (Entwicklungszweig).
Fehler bitte an http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs melden.
Ihre Vorschläge für die Dokumentation sind willkommen.