@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@ignore
- Translation of GIT committish: ab9e3136d78bfaf15cc6d77ed1975d252c3fe506
+ Translation of GIT committish: e5a609e373eae846857f9a6d70a402a3d42b7d94
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.12.0"
+@c \version "2.19.21"
@c Translators: Reinhold Kainhofer, Till Paala
@c Translation checkers: Till Paala
@menu
* lilypond aufrufen::
-* Optionen von lilypond auf der Kommandozeile::
+* Grundlegende Optionen auf der Kommandozeile für LilyPond::
+* Fortgeschrittene Optionen auf der Kommandozeile für LilyPond::
* Umgebungsvariablen::
* LilyPond in chroot-Kerker::
@end menu
@node lilypond aufrufen
-@subsection @command{lilypond} aufrufen
+@unnumberedsubsec @command{lilypond} aufrufen
@translationof Invoking lilypond
@cindex @command{lilypond} aufrufen
werden die weiteren Stücke in durchnummerierte Dateien der Form
@file{Dateiname-1.pdf} ausgegeben. Zusätzlich wird der Wert der
Variable @code{output-suffix} zwischen den ursprünglichen Dateinamen
-und der Zahl eingefügt. Eine Lilypond-Datei @var{Dateiname.ly} mit dem Inhalt
+und der Zahl eingefügt. Eine Lilypond-Datei @file{Dateiname.ly} mit dem Inhalt
@example
#(define output-suffix "Geige")
haben.
-@node Optionen von lilypond auf der Kommandozeile
-@subsection Optionen auf der Kommandozeile für @command{lilypond}
-@translationof Command line options for lilypond
+@node Grundlegende Optionen auf der Kommandozeile für LilyPond
+@unnumberedsubsec Grundlegende Optionen auf der Kommandozeile für LilyPond
+@translationof Basic command line options for LilyPond
Die folgenden Kommandozeilenoptionen werden von @command{lilypond} unterstützt:
@table @code
-@item -e,--evaluate=@var{expr}
-Wertet den Scheme-Ausdruck @var{expr} aus, bevor die @file{.ly} Dateien
-gelesen und interpretiert werden.
-Die @code{-e} Option kann auch mehrfach angegeben werden, die Ausdrücke
-werden nacheinander ausgewertet.
+@item -b, --bigpdfs
+@cindex bigpdfs
-Da der Ausdruck im @code{guile-user} Modul ausgewertet wird, ist bei der
-Definitionen innerhalb von @var{expr} folgendes Vorgehen nötig. An der
-Kommandozeile wird z.B. @code{a} im @code{guile-user} Modul definiert:
+Mit dieser Option generierte PDF-Dateien sind deutlich größer als normal,
+weil keine oder nur minimale Zeichensatz-Optimierung erfolgt. Werden
+jedoch zwei oder mehr solcher PDF-Dateien in @w{@code{pdftex}-},
+@w{@code{xetex}-} oder @w{@code{luatex}}-Dokumente eingebunden und
+anschließend mit ghostscript nachbearbeitet, entstehen deutlich
+kleinere PDF-Dokumente, da ghostscript die Zeichensatzdaten auf
+diesem Weg viel besser komprimieren kann.
+
+Nach
@example
-lilypond -e '(define-public a 42)'
+lilypond -b myfile
@end example
@noindent
-Am Beginn der @file{.ly}-Datei muss dann das @code{guile-user} Modul noch geladen werden, bevor die Definition von @var{a} verfügbar ist:
+sollte @code{ghostscript} wie folgt ausgeführt werden.
@example
-#(use-modules (guile-user))
+gs -q -sDEVICE=pdfwrite -o gsout.pdf myfile.pdf
@end example
+Mit Hilfe von
+@uref{https://code.google.com/p/pdfsizeopt/,@code{pdfsizeopt.py}}
+kann die Ausgabedatei noch mehr verkleinert werden.
-@item -f,--format=@var{Format}
-Bestimmt das Ausgabeformat. Mögliche Werte von @var{Format} sind
-@code{svg}, @code{ps}, @code{pdf} und @code{png}.
-
-Beispiel: @code{lilypond -fpng @var{Dateiname}.ly}
-
-
-
-@item -d,--define-default=@var{Variable}=@var{Wert}
-Damit wird die interne Programmoption @var{Variable} auf den Scheme-Wert
-@var{Wert} gesetzt. Wird kein @var{Wert} angegeben, so wird @var{#t} benutzt.
-Um eine Option auszuschalten, kann der Präfix @code{no-} dem Namen
-@var{Variable} der Variable vorangestellt werden. So ist etwa
-
-@cindex Point and Click, Kommandozeile
-
-@example
--dno-point-and-click
-@end example
-
-@noindent
-dasselbe wie
@example
--dpoint-and-click='#f'
+pdfsizeopt.py --use-multivalent=no gsout.pdf final.pdf
@end example
-Hier sind ein paar interessante Optionen:
+@item -d, --define-default=@var{Variable}=@var{Wert}
+Siehe @ref{Fortgeschrittene Optionen auf der Kommandozeile für LilyPond}.
-@cindex Hilfe, Kommandozeile
+@cindex Scheme, Auswertung von Ausdrücken
+@cindex Auswertung von Ausdrücken, Scheme
-@table @samp
-@item help
-Die Ausführung von @code{lilypond -dhelp} zeigt alle verfügbaren @code{-d}
-Optionen.
+@item -e, --evaluate=@var{expr}
+Wertet den Scheme-Ausdruck @var{expr} aus, bevor die @file{.ly} Dateien
+gelesen und interpretiert werden.
+Die @code{-e} Option kann auch mehrfach angegeben werden, die Ausdrücke
+werden nacheinander ausgewertet.
-@cindex Papierformat, Kommandozeile
+Da der Ausdruck im @code{guile-user} Modul ausgewertet wird, ist bei der
+Definitionen innerhalb von @var{expr} folgendes Vorgehen nötig. An der
+Kommandozeile wird z.B. @code{a} im @code{guile-user} Modul definiert:
-@item paper-size
-Setzt das Standard-Papierformat,
@example
--dpaper-size=\"letter\"
+lilypond -e '(define-public a 42)'
@end example
@noindent
-Die Zeichenkette, die das Format angibt, muss in Anführungszeichen mit Backslash
-( @code{\"} ) stehen.
-
-@cindex sicher, Kommandozeile
-@cindex safe, Kommandozeile
-
-@item safe
-Vertraut der @code{.ly} Datei nicht.
-
-Wenn LilyPond über einen Webserver verfügbar gemacht wird, @b{MUSS} unbedingt
-eine die Optionen @code{--safe} oder @code{--jail} angegeben werden.
-Die @code{--safe} Option verhindert, dass in der .ly-Datei angegebener
-Scheme-Code das System gefährden kann, wie etwa in folgendem Beispiel:
+Am Beginn der @file{.ly}-Datei muss dann das @code{guile-user} Modul noch geladen werden, bevor die Definition von @var{a} verfügbar ist:
-@quotation
-@verbatim
-#(system "rm -rf /")
-{
- c4^#(ly:export (ly:gulp-file "/etc/passwd"))
-}
-@end verbatim
-@end quotation
+@example
+#(use-modules (guile-user))
+@end example
-Mit der @code{-dsafe} Option werden alle Scheme-Ausdrücke einem speziellen
-sicheren Modus ausgewertet. Dieser Modus ist vom GUILE @file{safe-r5rs} Modul
-abgeleitet und fügt noch zahlreiche weitere erlaubte Funktionen der
-LilyPond Programm-Schnittstelle hinzu. Diese Funktionen sind in
-@file{scm/@/safe@/-lily@/.scm} angegeben.
+@warning{Windows-Benutzer müssen doppelte anstelle der einfachen
+Anführungsstriche einsetzen.}
-Zusätzliche verbietet der sichere Modus auch @code{\include} Befehle.
+@cindex Ausgabeformat
-Im sicheren Modus ist es nicht möglich, LilyPond-Variablen nach Scheme
-zu exportieren.
+@item -f, --format=@var{Format}
+Bestimmt das Ausgabeformat. Mögliche Werte von @var{Format} sind
+@code{svg}, @code{ps}, @code{pdf} und @code{png}.
-@code{-dsafe} erkennt jedoch @emph{KEINE} Überbeanspruchung der verfügbaren
-Ressourcen. In diesem Modus ist es also trotzdem möglich, dass LilyPond in einer
-Endlosschleife hängt, z.B. wenn zyklische Datenstrukturen an das Backend
-übergeben werden. Wenn LilyPond also auf einem öffentlich zugänglichen
-Webserver verfügbar gemacht wird, sollte der Prozess sowohl in der CPU-
-als auch in der Speichernutzung limitiert werden.
+Beispiel: @code{lilypond -fpng @var{Dateiname}.ly}
-Der sichere Modus verhindert auch, dass zahlreiche nützliche
-Musikfragmente von LilyPond verarbeitet werden. Die @code{--jail} Option ist
-eine sicherere Alternative, benötigt allerdings auch mehr Aufwand zur
-Einrichtung.
+@item -h, --help
+Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
-@cindex Ausgabeformat, Definition von
+@item -H, --header=@var{FELD}
+Gibt den Inhalt eines Feldes aus dem @code{\header}-Block in die Datei
+@file{Dateiname.@var{FELD}} aus.
-@item backend
-Gibt an, welches Ausgabeformat das LilyPond Backend benutzt. Mögliche Werte
-für diese Option sind:
+@item -i, --init=@var{Initialisierungsdatei}
+Benutzt @var{Initialisierungsdatei} zur gesamten Programminitialisierung. Der
+Standardwert ist @file{init.ly}.
-@table @code
-@item ps
-PostScript-Ausgabeformat.
+@item -I, --include=@var{Verzeichnis}
+Fügt @var{Verzeichnis} zur Liste der Suchpfade hinzu.
-@cindex PostScript Ausgabeformat
+@cindex Dateisuche
+@cindex Suchpfad
-Postscript-Dateien enthalten auch TTF-, Type1- und OTF-Schriften. Allerdings
-wird die gesamte Schriftart eingefügt und nicht nur die benötigten Zeichen.
-Vor allem wenn nicht-westliche Zeichensätze benutzt werden, kann dies zu sehr
-großen Dateien führen.
+Mehrere -I-Optionen können angegeben werden. Die Suche beginnt mit dem
+ersten definierten Verzeichnis und setzt in den weiteren Verzeichnissen
+fort, wenn die gesuchte Datei nicht in dem Verzeichnis gefunden wird.
-@cindex PostScript Ausgabeformat
-@cindex EPS (encapsulated PostScript)
+@cindex Kerker, Programm ausführen
+@cindex Jail, Programm ausführen
-@item eps
-Erzeugt @q{encapsulated PostScript} (EPS). Jede Seite (oder jedes System) wird
-als eigene @file{EPS}-Datei ausgegeben, inklusive Schriftarten. Außerdem wird
-eine Datei mit allen Seiten (bzw. Systemen) und Schriftarten erzeugt.
+@item -j, --jail=@var{Benutzer},@var{Gruppe},@var{Jail-Verzeichnis},@var{Arbeitsverzeichnis}
+Führt @command{lilypond} in einem chroot-Jail aus.
-Dies ist die Standardeinstellung von @command{lilypond-book}.
+Die @option{--jail} Option ist eine flexiblere Alternative zu @option{-dsafe}, wenn
+LilyPond über das Internet verfügbar gemacht wird oder LilyPond Befehle ausführt,
+die aus externe Quellen stammen (siehe @ref{Fortgeschrittene Optionen auf der Kommandozeile für LilyPond}).
-@cindex SVG (scalable vector graphics)
-@cindex Vektorgraphik (SVG)
+Sie funktioniert dergestalt, dass das Wurzelverzeichnis von
+@command{lilypond} auf @var{Jail-Verzeichnis} gesetzt wird, bevor die
+tatsächliche Kompilierung der @file{.ly}-Datei beginnt. Der Benutzer und die Gruppe
+werden auf die angegebenen Werte gesetzt und das aktuelle Arbeitsverzeichnis
+wird ebenfalls auf den angegebenen Wert @var{Arbeitsverzeichnis} gesetzt.
+Diese Einstellungen garantieren (zumindest in der Theorie), dass es nicht
+möglich ist, aus dem Jail auszubrechen. Damit @option{--jail} funktioniert, muss
+@command{lilypond} allerdings als root ausgeführt werden, was normalerweise
+auf sichere Art mit dem Kommando @command{sudo} erreicht werden kann.
-@item svg
+Das Jail-Verzeichnis zu erstellen ist etwas heikel, da LilyPond alle zur
+Ausführung nötigen Bibliotheken und Dateien @emph{innerhalb des
+Jail-Verzeichnisses} finden muss. Ein typisches Setup besteht aus folgenden
+Punkten:
-SVG-Ausgabe (Scalable Vector Graphics).
+@table @asis
-Hiermit wird eine einzelne SVG-Datei ohne eingebundene Schriften
-für jede Seite der Partitur erstellt. Es wird empfohlen, Century
-Schoolbook-Schriftarten zu installieren, die auch in der LilyPond-Installation
-enthalten sind, um optimales Rendern zu erhalten. Unter UNIX können
-diese Schriftarten einfach aus dem LilyPond-Verzeichnis (normalerweise
-@file{/usr/share/lilypond/VERSION/fonts/otf/}) nach @file{~/.fonts}
-kopiert werden. Die SVG-Ausgabe sollte mit allen SVG-Editoren oder
-Betrachtungsprogrammen kompatibel sein.
+@item Erstellung eines getrennten Dateisystems
+Ein eigenes Dateisystem muss für LilyPond erstellt werden, sodass es mit
+sicheren Einstellungen wie @code{noexec}, @code{nodev} und @code{nosuid}
+eingebunden werden kann. Damit ist es unmöglich, Programme von diesem
+Dateisystem auszuführen oder direkt auf eine Hardware-Schnittstelle
+zuzugreifen. Wenn Sie keine eigene Partition erstellen möchten, können Sie
+auch eine Datei der entsprechenden Größe erstellen und sie als @q{loop}-Gerät
+einbinden. Ein getrenntes Dateisystem garantiert auch, dass LilyPond nicht
+mehr Festplattenspeicher benutzt als erlaubt.
-@cindex Scheme-dump
+@item Erstellung eines eigenen Benutzerkontos
+Es sollte ein eigener Benutzer und eine eigene Gruppe (z. B.
+@code{lily}/@code{lily}) mit geringen Rechten für die Ausführung von LilyPond
+innerhalb des Jails benutzt werden. Nur ein einziges Verzeichnis des Jails sollte
+für den Benutzer schreibbar sein und als @var{Arbeitsverzeichnis} an
+@code{lilypond} übergeben werden.
-@item scm
-gibt die rohen Scheme-basierenden Zeichenbefehle aus, wie sie intern von
-LilyPond benutzt werden.
+@item Einrichtung des Jails
+LilyPond muss zahlreiche Dateien für die Ausführung einlesen. All diese
+Dateien müssen in das Jail-Verzeichnis kopiert werden (mit denselben Pfaden
+wie im tatsächlichen Wurzel-Dateisystem). Die gesamte LilyPond-Installation
+(typischerweise @file{/usr/share/lilypond}) sollte kopiert werden.
-@cindex Scheme dump
+Falls Probleme auftreten, ist es am einfachsten, Lilypond mittels
+@command{strace} zu starten, wodurch Sie relativ leicht feststellen können,
+welche Dateien im Jail noch fehlen.
-@item null
-Keine Partitur wird ausgegeben, hat gleichen Effekt wie @code{-dno-print-pages}.
+@item Ausführung von LilyPond
+In einem mit @code{noexec} eingebundenen Jail ist es nicht möglich, externe
+Programme auszuführen. Daher muss LilyPond auf eine Art gestartet werden,
+die keine weitere Ausführung von Programmen benötigt. Wie bereits erwähnt
+muss LilyPond mit Administrator-Rechten gestartet werden (die es allerdings
+sofort wieder abgibt), beispielsweise mittels @command{sudo}. Außerdem
+ist es eine gute Idee, die LilyPond zur Verfügung stehende CPU-Zeit zu
+limitieren (z. B. mit @command{ulimit -t}) und -- falls das Betriebssystem
+dies unterstützt -- auch den zur Verfügung stehenden Hauptspeicher. Siehe
+auch @ref{LilyPond in chroot-Kerker}
@end table
-Beispiel: @code{lilypond -dbackend=svg @var{Dateiname}.ly}
-
-@cindex Vorschau
+@cindex Logstufe
+@cindex Ausgabe, Ausführlichkeit
-@item preview
-Erzeugt eine Ausgabedatei, die nur die Titelzeilen und das erste System
-enthält. Wenn @code{\bookpart}-Umgebungen benutzt werden, erscheinen die
-Titel und ersten Systeme jedes @code{\bookpart}-Abschnitts in der Datei.
-Die Backends @code{ps}, @code{eps} und @code{svg} unterstützen diese Option.
+@item -l, --loglevel=@var{Logstufe}
+Passt die Ausführlichkeit der Ausgabe auf der Kommandozeile entsprechend
+@var{Logstufe} an. Mögliche Werte sind:
-@item print-pages
-Erzeugt vollständige Seiten (Standardeinstellung). @code{-dno-print-pages}
-ist in Verbindung mit @code{-dpreview} nützlich.
+@table @code
-@end table
+@item NONE
+Keine Ausgabe, nicht einmal Fehlermeldungen.
+@item ERROR
+Nur Fehlermeldungen, keine Warnungen oder Fortschrittsmeldungen.
+@item WARN
+Warnungen und Fehlermeldungen, keine Fortschrittsmeldungen.
-@item -h,--help
-Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
+@item BASIC_PROGRESS
+Grundlegende Fortschrittsmeldungen (Erfolg), Warnungen und Fehler.
-@item -H,--header=@var{FELD}
-Gibt den Inhalt eines Feldes aus dem @code{\header}-Block in die Datei
-@file{Dateiname.@var{FELD}} aus.
+@item PROGRESS
+Alle Fortschrittsmeldungen, Warnungen und Fehler.
-@item --include, -I=@var{Verzeichnis}
-Fügt @var{Verzeichnis} zur Liste der Suchpfade hinzu.
+@item INFO (Standard)
+Fortschrittmeldungen, Warnungen, Fehlermeldungen und weiter
+Information über die Ausführung.
-@cindex Dateisuche
-@cindex Suchpfad
+@item DEBUG
+Alle möglichen Meldungen, die auch mit der Fehlersuche (Debug) zu tun
+haben können.
-Mehrere -I-Optionen können angegeben werden. Die Suche beginnt mit dem
-ersten definierten Verzeichnis und setzt in den weiteren Verzeichnissen
-fort, wenn die gesuchte Datei nicht in dem Verzeichnis gefunden wird.
+@end table
-@item -i,--init=@var{Initialisierungsdatei}
-Benutzt @var{Initialisierungsdatei} zur gesamten Programminitialisierung. Der
-Standardwert ist @file{init.ly}.
@cindex Verzeichnis, Ausgabe speichern in
@cindex Ausgabedateiname
+@cindex Dateiname der Ausgabe bestimmen
-@item -o,--output=@var{DATEI}
+@item -o, --output=@var{DATEI} oder @var{ORDNER}
Schreibt das Ergebnis der Verarbeitung mit LilyPond in die Ausgabedatei
@var{DATEI}. Wenn ein Verzeichnis mit dem Namen existiert, werden die Ausgabedateien
in dieses Verzeichnis gespeichert, wobei der Dateiname der Eingabedatei
-benutzt wird. Die entsprechende Dateinamenserweiterung wird angehängt (z.B.
+benutzt wird. Die entsprechende Dateinamenserweiterung wird angehängt (z.B.
@code{.pdf} für pdf).
@cindex PostScript-Ausgabe
@item --pdf
Erzeugt PDF-Dateien. Dies impliziert @code{--ps}.
-@item -j,--jail=@var{Benutzer},@var{Gruppe},@var{Jail-Verzeichnis},@var{Arbeitsverzeichnis}
-Führt @command{lilypond} in einem chroot-Jail aus.
+@item -v, --version
+Gibt die Versionsnummer aus.
-Die @code{--jail} Option ist eine flexiblere Alternative zu @code{--safe}, wenn
-LilyPond über das Internet verfügbar gemacht wird oder LilyPond-Quelldateien
-von Dritten automatisch verarbeitet werden.
+@item -V, --verbose
+Gibt ausführliche informative Meldungen aus: Zeigt die vollen Dateipfade
+aller gelesenen Dateien sowie Informationen über die Laufzeit.
-Sie funktioniert dergestalt, dass das Wurzelverzeichnis von
-@command{lilypond} auf @var{Jail-Verzeichnis} gesetzt wird, bevor die
-tatsächliche Kompilierung der .ly-Datei beginnt. Der Benutzer und die Gruppe
-werden auf die angegebenen Werte gesetzt und das aktuelle Arbeitsverzeichnis
-wird ebenfalls auf den angegebenen Wert @var{Arbeitsverzeichnis} gesetzt.
-Diese Einstellungen garantieren (zumindest in der Theorie), dass es nicht
-möglich ist, aus dem Jail auszubrechen. Damit @code{--jail} funktioniert, muss
-@command{lilypond} allerdings als root ausgeführt werden, was normalerweise
-auf sichere Art mit dem Kommando @command{sudo} erreicht werden kann.
+@item -w, --warranty
+Zeigt die Garantiebedingungen an, unter denen GNU LilyPond steht. (Es besteht
+@strong{KEINERLEI GARANTIE}!)
-Das Jail-Verzeichnis zu erstellen ist etwas heikel, da LilyPond alle zur
-Ausführung nötigen Bibliotheken und Dateien @emph{innerhalb des
-Jail-Verzeichnisses} finden muss. Ein typisches Setup besteht aus folgenden
-Punkten:
+@end table
-@table @asis
-@item Erstellung eines getrennten Dateisystems
-Ein eigenes Dateisystem muss für LilyPond erstellt werden, sodass es mit
-sicheren Einstellungen wie @code{noexec}, @code{nodev} und @code{nosuid}
-eingebunden werden kann. Damit ist es unmöglich, Programme von diesem
-Dateisystem auszuführen oder direkt auf eine Hardware-Schnittstelle
-zuzugreifen. Wenn Sie keine eigene Partition erstellen möchten, können Sie
-auch eine Datei der entsprechenden Größe erstellen und sie als @q{loop}-Gerät
-einbinden. Ein getrenntes Dateisystem garantiert auch, dass LilyPond nicht
-mehr Festplattenspeicher benutzt als erlaubt.
-@item Erstellung eines eigenen Benutzerkontos
-Es sollte ein eigener Benutzer und eine eigene Gruppe (z. B.
-@code{lily}/@code{lily}) mit geringen Rechten für die Ausführung von LilyPond
-innerhalb des Jails benutzt werden. Nur ein einziges Verzeichnis des Jails sollte
-für den Benutzer schreibbar sein und als @var{Arbeitsverzeichnis} an
-@code{lilypond} übergeben werden.
-@item Einrichtung des Jails
-LilyPond muss zahlreiche Dateien für die Ausführung einlesen. All diese
-Dateien müssen in das Jail-Verzeichnis kopiert werden (mit denselben Pfaden
-wie im tatsächlichen Wurzel-Dateisystem). Die gesamte LilyPond-Installation
-(typischerweise @file{/usr/share/lilypond}) sollte kopiert werden.
+@node Fortgeschrittene Optionen auf der Kommandozeile für LilyPond
+@unnumberedsubsec Fortgeschrittene Optionen auf der Kommandozeile für LilyPond
+@translationof Advanced command line options for LilyPond
-Falls Probleme auftreten, ist es am einfachsten, Lilypond mittels
-@command{strace} zu starten, wodurch Sie relativ leicht feststellen können,
-welche Dateien im Jail noch fehlen.
+@table @code
-@item Ausführung von LilyPond
-In einem mit @code{noexec} eingebundenen Jail ist es nicht möglich, externe
-Programme auszuführen. Daher muss LilyPond auf eine Art gestartet werden,
-die keine weitere Ausführung von Programmen benötigt. Wie bereits erwähnt
-muss LilyPond mit Administrator-Rechten gestartet werden (die es allerdings
-sofort wieder abgibt), beispielsweise mittels @command{sudo}. Außerdem
-ist es eine gute Idee, die LilyPond zur Verfügung stehende CPU-Zeit zu
-limitieren (z. B. mit @command{ulimit -t}) und -- falls das Betriebssystem
-dies unterstützt -- auch den zur Verfügung stehenden Hauptspeicher.
+@item -d@var{[Optionsbezeichnung]}=@var{[Wert]},--define-default=@var{[Optionsbezeichnung]}=@var{[Wert]}
+Hiermit wird die entsprechende interne Scheme-Funktion auf den @var{Wert}
+gesetzt. Wenn kein @var{value} angegeben wird, wird der Standardwert
+eingesetzt. Die Vorsilbe @code{no-} kann zur @var{Optionsbezeichnung}
+hinzugefügt werden, um eine Funktion @qq{auszuschalten}. Beispielsweise
+
+@cindex Point and Click, Kommandozeile
+
+@example
+-dpoint-and-click=#f
+@end example
+
+@noindent
+ist das gleiche wie
+@example
+-dno-point-and-click
+@end example
@end table
+@noindent Folgende Optionen sind mit ihren entsprechenden Standardwerten
+unterstützt:
-@item -v,--version
-Gibt die Versionsnummer aus.
+@multitable @columnfractions .33 .16 .51
+@item @strong{Symbol}
+@tab @strong{Wert}
+@tab @strong{Erklärung/Optionen}
-@item -V,--verbose
-Gibt ausführliche informative Meldungen aus: Zeigt die vollen Dateipfade
-aller gelesenen Dateien sowie Informationen über die Laufzeit.
+@item @code{anti-alias-factor}
+@tab @code{1}
+@tab Die Bilder in einer höheren Auflösung rendern (Faktor angegeben) und
+das Resultat herunterrechnen, um @qq{Zacken} in @code{PNG}-Bildern zu
+vermeiden.
+
+@item @code{aux-files}
+@tab @code{#t}
+@tab Erstelle @code{.tex}, @code{.texi}, @code{.count}-Dateien im
+@code{EPS}-Backend.
+
+@item @code{backend}
+@tab @code{'ps}
+@tab Auswahl des Backend. Poststscript-Dateien (Standart) enthalten
+@code{TTF}, @code{Type1} und @code{OTF}-Schriftarten. Ihr Zeichenvorrat
+wird nicht reduziert (Subsetting). Die Benutzung von östlichen
+Schriftarten kann zu sehr großen Dateien führen.
+
+@item
+@tab @code{'eps}
+@tab Encapsulated PostScript. Hiermit wird jede Seite (System) als eine
+eigene @file{EPS}-Datei gespeichert, ohne Schriftarten, sowie als eine
+kombinierte @file{EPS}-Datei mit allen Seiten (Systemen) inclusive
+Schriftarten. Wird als Standard von @command{lilypond-book} benützt.
+
+@item
+@tab @code{'null}
+@tab Keine graphische Partitur ausgeben; hat den gleichen Effekt wie
+@code{-dno-print-pages}.
+
+@item
+@tab @code{'svg}
+@tab Scalable Vector Graphics. Hiermit wird eine einzelne @code{SVG}-Datei
+für jede Seite der Ausgabe erstellt, ohne Schriftarten. Es wird
+empfohlen, die Century Schoolbook-Schriftarten zu installieren, welche
+mit der LilyPond-Installation mitkommen, um optimales Rendern zu erreichen.
+Unter UNIX kann man einfach die Schriftartdateien aus dem LilyPond-Verzeichnis
+(üblicherweise @file{/usr/share/lilypond/VERSION/fonts/otf/}) nach
+@file{~/.fonts/}. Die @code{SVG}-Ausgabe sollte mit allen SVG-Programmen
+oder -Editoren kompatibel sein. Es gibt auch die Option @code{svg-woff}
+(siehe unten) um woff-Schriftarten im SVG-Backend zu benützen.
+
+@item
+@tab @code{'scm}
+@tab Ausgabe der rohen internen Scheme-basierten Zeichnungsbefehle.
+
+@item @code{check-internal-types}
+@tab @code{#f}
+@tab Überprüfe jede Eigenschaftszuweisung für Typen.
+
+@item @code{clip-systems}
+@tab @code{#f}
+@tab Erstelle ausgeschnittene Schnipsel einer Partitur.
+
+@item @code{datadir}
+@tab
+@tab Präfix für Datendateien (read-only).
+
+@item @code{debug-gc}
+@tab @code{#f}
+@tab Gebe Debugging-Statistik für Speicher aus.
+
+@item @code{debug-gc-assert-parsed-dead}
+@tab @code{#f}
+@tab Für Speicher-Debugging: Gehe sicher, dass alle Referenzen zu geparsten
+Objekten tot sind. Das ist eine interne Option und sie wird automatisch
+für @code{`-ddebug-gc'} angestellt.
+
+@item @code{debug-lexer}
+@tab @code{#f}
+@tab Debugging des Flex-lexer.
+
+@item @code{debug-page-breaking-scoring}
+@tab @code{#f}
+@tab Gebe viele unterschiedliche Seitenumbruchsituationen für Partituren
+aus.
+
+@item @code{debug-parser}
+@tab @code{#f}
+@tab Debugging des Bison-Parsers.
+
+@item @code{debug-property-callbacks}
+@tab @code{#f}
+@tab Debugging von zyklischen Callback-Ketten.
+
+@item @code{debug-skylines}
+@tab @code{#f}
+@tab Debugging von Skylines.
+
+@item @code{delete-intermediate-files}
+@tab @code{#t}
+@tab Entferne unbenutzbare, zwischenzeitliche @code{.ps}-Dateien, die während
+der Kompilations erstellt werden.
+
+@item @code{dump-cpu-profile}
+@tab @code{#f}
+@tab Gebe CPU-Zeitinformation aus (abhängig vom System).
+
+@item @code{dump-profile}
+@tab @code{#f}
+@tab Gebe Speicher- und CPU-Zeitbenutzung für jede Datei aus.
+
+@item @code{dump-signatures}
+@tab @code{#f}
+@tab Gebe Ausgabesignaturen für jedes System aus. Wird für das Prüfen
+der Regressionsteste eingesetzt.
+
+@item @code{eps-box-padding}
+@tab @code{#f}
+@tab Verschiebe die linke Ecke der ausgegebenen EPS-Boundingbox um die
+angegebene Entfernung (in mm).
+
+@item @code{gs-load-fonts}
+@tab @code{#f}
+@tab Lade die Schriftarten durch Ghostscript.
+
+@item @code{gs-load-lily-fonts}
+@tab @code{#f}
+@tab Lade nur die LilyPond-Schriftarten durch Ghostscript.
+
+@item @code{gui}
+@tab @code{#f}
+@tab Gibt keine Ausgabe auf der Kommandozeile aus, sondern schreibt alles in
+die Log-Datei.
+@end multitable
+
+@noindent
+@strong{Anmerkung für Windows-Benutzer:} Standardmäßig gibt @code{lilypond.exe} alle Fortschrittsinformation auf der Kommandozeile aus;
+@code{lilypond-windows.exe} gibt aber keine Fortschrittinformation aus und
+zeigt sofort den Prompt an. Die Option @option{-dgui} kann hier benutzt
+werden, um die Ausgabe in eine Log-Datei umzuleiten.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{help}
+@tab @code{#f}
+@tab Zeige die Hilfe.
+
+@item @code{include-book-title-preview}
+@tab @code{#t}
+@tab Füge Titel eines Buches (book) in die Vorschaubilder ein.
+
+@item @code{include-eps-fonts}
+@tab @code{#t}
+@tab Füge Schriftarten in EPS-Dateien von einzelnen Systemen ein.
+
+@item @code{include-settings}
+@tab @code{#f}
+@tab Füge eine Datei für globale Einstellungen ein, dieses wird gelesen, bevor die Partitur verarbeitet wird.
+
+@item @code{job-count}
+@tab @code{#f}
+@tab Bearbeite Dateien parallel, mit der angegebenen Anzahl von Prozessen.
+
+@item @code{log-file}
+@tab @code{#f [file]}
+@tab Wenn die Zeichenkette @code{FOO} als ein zweites Argument angegeben wird,
+wird die Ausgabe in die Log-Datei @code{FOO.log} umgeleitet.
+
+@item @code{max-markup-depth}
+@tab @code{1024}
+@tab Maximale Tiefe eines Beschriftungs-(markup)-Baumes. Wenn eine
+Beschriftung mehr Ebenen hat, wird angenommen, dass die Beschriftung
+nicht von sich aus schließt, eine Warnung ausgegeben und eine leere
+Beschriftung gesetzt.
+
+@item @code{midi-extension}
+@tab @code{"midi"}
+@tab Schreibe als Standarddateierweiterung für MIDI die angegebene Zeichenkette.
+
+@item @code{music-strings-to-paths}
+@tab @code{#f}
+@tab Konvertiere Textzeichenketten in Pfade, wenn die Glyphen einer
+Musik-Schriftart gehören.
+
+@item @code{old-relative}
+@tab @code{#f}
+@tab Lässt den @code{\relative}-Modus für simultane Musik ähnlich wie die
+Akkord-Syntax funktionieren.
+
+@item @code{paper-size}
+@tab @code{\"a4\"}
+@tab Stelle die Standardpapiergröße ein. Beachten Sie, dass die Zeichenkette
+von doppelten Anführungszeichen mit Backslash umgeben werden muss.
+
+@item @code{pixmap-format}
+@tab @code{png16m}
+@tab Stellt das Ausgabeformat von GhostScript für Pixel-Bilder ein.
+
+@item @code{point-and-click}
+@tab @code{#f}
+@tab Füge @q{point & click}-Links in die @code{PDF}-Ausgabedatei ein. Siehe auch
+@ref{Point and click}.
+
+@item @code{preview}
+@tab @code{#f}
+@tab Erstelle Vorschaubilder zusätzlich zur normalen Ausgabe.
+@end multitable
+
+@noindent
+Diese Option wird von allen Backends unterstützt: @code{pdf}, @code{png},
+@code{ps}, @code{eps} und @code{svg}, allerdings nicht @code{scm}. Hiermit
+wird eine Ausgabedatei in der Form @code{meineDatei.preview.Dateierweiterung}
+erstellt, die die Titel und das erste Notensystem enthält. Wenn @code{\book}-
+oder @code{\bookpart}-Umgebungen inegesetzt werden, werden die Titel von
+@code{\book}, @code{\bookpart} oder @code{\score} in die Ausgabe aufgenommen,
+sowie das erste System jeder @code{\score}-Umgebung, wenn die
+Variable @code{print-all-headers} in der @code{paper}-Umgebung auf @code{#t}
+eingesetllt ist.
+
+Um die normale Ausgabe zu unterdrücken, können die Optionen @option{-dprint-pages}
+oder @option{-dno-print-pages} eingesetzt werden.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{print-pages}
+@tab @code{#t}
+@tab Erstelle vollständige Seiten, der Standard. @option{-dno-print-pages} ist
+hilfreich im Zusammenhang mit @option{-dpreview}.
+
+@item @code{profile-property-accesses}
+@tab @code{#f}
+@tab Speichere Statistiken von @code{get_property()}-Funktionsaufrufen.
+
+@item @code{protected-scheme-parsing}
+@tab @code{#t}
+@tab Fahre fort, wenn Fehler in eingefügtem Scheme-Code im Parser bemerkt
+werden. Wenn auf @code{#f} gesetzt, halte an Fehlern an und gebe einen
+Stacktrace aus.
+
+@item @code{read-file-list}
+@tab @code{#f [file]}
+@tab Gibt den Dateinamen einer Datei an, die eine Liste mit Eingabedateien
+enthält, die kompiliert werden sollen.
+
+@item @code{relative-includes}
+@tab @code{#f}
+@tab Wenn ein @code{\include}-Befehl bearbeitet wird, suche nach der
+eingefügten Datei relativ zur aktuellen Datei (und nicht relativ zur untersten
+Ebene).
+
+@item @code{resolution}
+@tab @code{101}
+@tab Setzt die Auflösung, mit der @code{PNG}-Bilder erstellt werde, auf einen
+bestimmten Wert (in dpi).
+
+@item @code{safe}
+@tab @code{#f}
+@tab Der @code{.ly}-Eingabe nicht trauen.
+@end multitable
+
+@noindent
+Wenn LilyPond-Notensatz über einen Webserver zur Verfügung gestellt wird,
+@b{müssen} entweder die Option @option{--safe} oder die Option @option{--jail}
+mitgegeben werden. Die Option @option{--safe} verhindert eingefügten
+Scheme-Code daran, Schaden auszuüben, etwa
+
+@quotation
+@verbatim
+#(system "rm -rf /")
+{
+ c4^$(ly:gulp-file "/etc/passwd")
+}
+@end verbatim
+@end quotation
+
+Die Option @option{-dsafe} interpretiert eingefügte Scheme-Ausdrücke
+in einem besonderen sicheren Modul. Das ist aus dem GUILE
+@file{safe-r5rs}-Modul abgeleitet, fügt aber einige Funktionen der
+LilyPond API hinzu, welche sich in @file{scm/safe-lily.scm} aufgelistet finden.
+
+Zusätzliche verbietet der sichere Modus @code{\include}-Befehle und
+stellt die Benutzung von Backslash in @TeX{}-Zeichenketten aus. Im sicheren
+Modus ist es auch
+nicht möglich, LilyPond-Variablen in Scheme zu importieren.
+
+@option{-dsafe} kann jedoch @emph{nicht} Überbenutzung von Resourcen
+entdecken, sodass man trotzdem das Programm abschießen kann, etwa
+indem man eine sich wiederholende Datenstruktur in das Backend
+leitet. Darum sollte LilyPond sowohl in der CPU- als auch Speicherbenutzung
+eingeschränkt betrieben werden, wenn es über einen Webserver öffentlich zugänglich
+gemacht wird.
+
+Der sichere Modus verhindert die Kompilierung von vielen nützlichen
+LilyPond-Schnipseln.
+
+die Option @option{--jail} ist noch sicherer, erfordert aber mehr Arbeit
+beim Setup. Siehe auch @ref{Grundlegende Optionen auf der Kommandozeile für LilyPond}.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{separate-log-files}
+@tab @code{#f}
+@tab Für Eingabedateien @code{Datei1.ly}, @code{Datei2.ly} usw. die
+Log-Daten in die Dateien @code{Datei1.log}, @code{Datei2.log} ... schreiben.
+
+@item @code{show-available-fonts}
+@tab @code{#f}
+@tab Eine Liste der verfügbaren Schriftarten.
+
+@item @code{strict-infinity-checking}
+@tab @code{#f}
+@tab Erzwinge einen Programmabsturz wenn @code{Inf} und @code{NaN}
+Fließkommaausnahmen gefunden werden.
+
+@item @code{strip-output-dir}
+@tab @code{#t}
+@tab Verzeichnisse von Eingabedateien nicht in die Konstruktion der
+Ausgabedateinamen einbeziehen.
+
+@item @code{svg-woff}
+@tab @code{#f}
+@tab Woff-Schriftarten im SVG-Backend benuützen..
+
+@item @code{trace-memory-frequency}
+@tab @code{#f}
+@tab Zeichnet die Benutzung von Scheme so oft pro Sekunde auf. Das Resultat
+wird in die Dateien @code{FILE.stacks} und @code{FILE.graph} ausgegeben.
+
+@item @code{trace-scheme-coverage}
+@tab @code{#f}
+@tab Abdeckung der Scheme-Dateien in Datei @code{FILE.cov} schreiben.
+
+@item @code{verbose}
+@tab @code{#f}
+@tab Ausfühliche Ausgabe, also Logstufe DEBUG (read-only).
+
+@item @code{warning-as-error}
+@tab @code{#f}
+@tab Alle Warnungen und @q{Programmierfehler}-Nachrichten in Fehler ändern.
+@end multitable
-@item -w,--warranty
-Zeigt die Garantiebedingungen an, unter denen GNU LilyPond steht. (Es besteht
-@strong{KEINERLEI GARANTIE}!)
-@end table
@node Umgebungsvariablen
-@subsection Umgebungsvariablen
+@unnumberedsubsec Umgebungsvariablen
@translationof Environment variables
@cindex LANG
+@cindex LILYPOND_LOGLEVEL
@cindex LILYPOND_DATADIR
@cindex Variablen, Umgebungs-
@cindex Umgebungsvariablen
@item LANG
Gibt die Sprache an, in der Warnungen und Fehlermeldungen ausgegeben werden.
+@item LILYPOND_LOGLEVEL
+Die standardmäßige Logstufe. Wenn LilyPond ohne eine explizite
+Logstufe aufterufen wird (d. h. die Kommandozeilenoption @option{--loglevel}
+nicht eingesetzt wird), wird dieser Wert benutzt.
+
@item LILYPOND_GC_YIELD
-Mit dieser Variable (mit Werten zwischen 0 und 100) kann die Feinabstimmung
-zwischen dem Bedarf an Hauptspeicher und Rechenleistung bei der Ausführung
-von LilyPond durchgeführt werden. Bei höheren Werten benutzt LilyPond
-mehr Hauptspeicher, benötigt aber weniger Prozessor-Leistung. Bei
+Eine Variable (von 1 bis 100), die die Speicherverwaltung regelt. Bei
niedrigeren Werten wird mehr Prozessor-Zeit, dafür weniger Hauptspeicher
benötigt. Voreinstellung ist ein Wert von @code{70}.
Einen Server einzurichten, der LilyPond in einem chroot-Kerker bedient, ist
recht kompliziert. Die einzelnen Schritten finden sich unten aufgeliestet.
-Beispiele sind für Ubuntu Linux und erfordern evtl. die Benutzung von
+Beispiele sind für Ubuntu GNU/Linux und erfordern evtl. die Benutzung von
@code{sudo} an den entsprechenden Stellen.
@itemize
@cindex Scheme Fehler
Fehler, die während der Ausführung von Scheme-Code auftreten, werden
vom Scheme-Interpreter aufgefangen und an der Kommandozeile ausgegeben.
-Wenn Sie LilyPond mit der @code{--verbose} Option (auch @code{-V})
+Wenn Sie LilyPond mit der @option{--verbose} Option (auch @code{-V})
ausführen, wird der sogenannte @q{Call trace} ausgegeben, der die
aufgerufenen Funktionen zur Zeit des Fehlers angibt.
Dies bezeichnet einen ernsten Programmierfehler, der das Programm
zum Absturz gebracht hat. Solche Fehler werden als kritisch angesehen.
Falls daher einer auftritt, senden Sie bitte einen Bug-Report!
+
@end table
@cindex Fehlermeldung, Format
* Offensichtlicher Fehler in ../ly/init.ly::
* Fehlermeldung Ungebundene Variable %::
* Fehlermeldung FT_Get_Glyph_Name::
-* Warnung, dass staff affinities nur absteigen sollten::
+* Warnung über absteigende staff affinities::
@end menu
@node Noten laufen aus der Seite heraus
Notenköpfe immernoch schwarz im unteren System erscheinen.
@lilypond[quote,verbatim,relative=2]
-\override Staff.NoteHead #'color = #red
+\override Staff.NoteHead.color = #red
\new Staff { a }
@end lilypond
@lilypond[quote,verbatim,relative=2]
\new Staff {
- \override Staff.NoteHead #'color = #red
+ \override Staff.NoteHead.color = #red
a
}
@end lilypond
@lilypond[quote,verbatim]
\repeat unfold 2 {
- \relative c' { c4 d e f }
+ \relative { c'4 d e f }
}
@end lilypond
@lilypond[quote,verbatim]
\new Voice {
\repeat unfold 2 {
- \relative c' { c4 d e f }
+ \relative { c'4 d e f }
}
}
@end lilypond
@translationof Apparent error in @code{../ly/init.ly}
Verschiedene seltsame Fehlermeldungen können über Syntax-Fehler in
-@code{../ly/init.ly} auftauchen, wenn die Eingabedatei nicht richtig
+@file{../ly/init.ly} auftauchen, wenn die Eingabedatei nicht richtig
formuliert ist, wenn sie etwa nicht richtig passende Klammerpaare
oder Anführungszeichen enthält.
Klammer (@code{@}}). Ohne diese Trennung wird die Klammer als
Teil der Silbe gewertet. Es bietet sich immer an, Leerzeichen vor
und hinter @emph{jede} Klammer zu setzen. Wie wichtig das ist, wenn
-Gesangstext eingesetzt wird, siehe @ruser{Was ist Gesangtext}.
+Gesangstext eingesetzt wird, siehe @ruser{Eingabe von Text}.
Diese Fehlermeldung kann auch mit einem fehlenden schließenden Anführungszeichen
(@code{"}) auftreten. In diesem Fall sollte die begleitende Fehlermeldung
nicht in UTF-8-Kodierung gespeichert wurd. Sie auch @ruser{Zeichenkodierung}.
-@node Warnung, dass staff affinities nur absteigen sollten
-@unnumberedsubsec Warnung, dass staff affinities nur absteigen sollten
+@node Warnung über absteigende staff affinities
+@unnumberedsubsec Warnung über absteigende staff affinities
@translationof Warning staff affinities should only decrease
Diese Warnung erscheint, wenn keine Notensysteme in der Ausgabe vorhanden
in einem Liedblatt vorhanden sind. Die Warnungen können vermieden werden,
indem man einen der Kontexte als System erscheinen lässt, indem man ihm
zu Beginn hinzufügt:
-
+
@example
-\override VerticalAxisGroup #'staff-affinity = ##f
+\override VerticalAxisGroup.staff-affinity = ##f
@end example
-Zu Einzelheiten siehe @qq{Abstand von Nicht-Notensystem-Zeilen} in
-@ruser{Vertikale Abstände innerhalb eines Systems}.
+Zu Einzelheiten siehe @qq{Abstand von Nicht-Notensystemzeilen} in
+@ruser{Flexible vertikale Abstände in Systemgruppen}.
projects / lilypond.git / blobdiff