1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
2 @c This file is part of lilypond-program.tely
4 Translation of GIT committish: 4ac76531a06d6b6836b67d3650b57a2f58d1108f
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
11 @node Running LilyPond
12 @chapter Running LilyPond
14 Dieses Kapitel behandelt die technischen Details, wie Lilypond ausgeführt werden kann.
19 * Command-line usage::
21 * Updating files with convert-ly::
28 Die meisten Benutzer führen LilyPond von einer graphischen Benutzeroberfläche
29 aus. Siehe @rlearning{First steps}, falls Sie dies nicht bereits getan haben.
32 @node Command-line usage
33 @section Command-line usage
35 Dieser Abschnitt enthält zusätzliche Informationen, wie Sie LilyPond
36 von der Kommandozeile ausführen können. Dies kann erforderlich sein,
37 um etwa zusätzliche Optionen an das Programm zu übergeben. Außerdem
38 sind einige Zusatzprogramme (wie etwa @code{midi2ly}) nur von der
39 Kommandozeile verfügbar.
41 Unter @q{Kommandozeile} verstehen wir die Kommandozeile des jeweiligen
42 Betriebssystems. Windows Benutzern ist sie vielleicht eher unter den
43 englischen Begriffen @q{DOS shell} oder @q{command shell} bekannt.
44 MacOS@tie{}X Benutzer kennen sie eher unter @q{Terminal} oder @q{Konsole}.
45 Sie sollten auch den Abschnitt @ref{MacOS X on the command-line} konsultieren.
47 Wie die Kommandozeile im jeweiligen Betriebssystem benutzt werden kann,
48 soll in diesem Handbuch nicht näher beschrieben werden. Sehen Sie bitte
49 im Handbuch Ihres Betriebssystems nach oder informieren Sie sich im
50 Internet, wenn Sie mit der Kommandozeile nicht vertraut sind.
55 * Command line options::
56 * Environment variables::
59 @node Invoking lilypond
60 @subsection Invoking lilypond
62 @cindex LilyPond aufrufen
63 @cindex Kommandozeilen-Optionen
64 @cindex Optionen an der Kommandozeile
66 Das @command{lilypond} Programm kann folgendermaßen von der Kommandozeile
70 lilypond [@var{Option}]@dots{} @var{Dateiname}@dots{}
74 Wird ein @file{Dateiname} ohne Erweiterung angegeben, so wird @file{.ly} als
75 Standarderweiterung für LilyPond-Dateien benutzt. Um Daten von
76 @code{stdin} einzulesen, benutzen Sie einfach einen Bindestrich (@code{-})
79 Wenn Lilypond die Datei @file{Dateiname.ly} verarbeitet, werden daraus
80 die Dateien @file{Dateiname.ps} und @file{Dateiname.pdf} erzeugt.
81 Es können an @code{lilypond} auch mehrere @file{.ly} Dateien übergeben
82 werden, die dann einzeln und voneinander unabhängig abgearbeitet
83 werden.@footnote{Der Zustand von GUILE wird allerdings nicht nach
84 jeder Datei zurückgesetzt, sodass Achtung geboten ist, wenn in einer
85 Datei globale Änderungen von Scheme aus durchgeführt werden.}
87 Falls @file{Dateiname.ly} mehr als einen @code{\score}-Block enthält,
88 werden die weiteren Stücke in durchnummerierte Dateien der Form
89 @file{Dateiname-1.pdf} ausgegeben. Zusätzlich wird der Wert der
90 Variable @code{output-suffix} zwischen den ursprünglichen Dateienamen
91 und der Zahl eingefügt. Eine Lilypond-Datei @var{Dateiname.ly} mit dem Inhalt
94 #(define output-suffix "Geige")
96 #(define output-suffix "Cello")
101 erzeigt daher die Dateien @var{Dateiname}@file{-Geige.pdf} und
102 @var{Dateiname}@file{-Cello-1.pdf}.
106 @node Command line options
107 @subsection Command line options
112 @node Environment variables
113 @subsection Environment variables
116 @cindex LILYPOND_DATADIR
118 @command{lilypond} erkennt und benützt die folgenden Umgebungsvariablen:
120 @item LILYPOND_DATADIR
121 Diese Variable gibt das Verzeichnis an, wo Lilypond seine eigenen Dateien,
122 Meldungen und Übersetzungen finden kann. Dieses Verzeichnis sollte
123 Unterverzeichnisse @file{ly/}, @file{ps/}, @file{tex/}, etc. beinhalten.
126 Gibt die Sprache an, in der Warnungen und Fehlermeldungen ausgegeben werden.
128 @item LILYPOND_GC_YIELD
129 Mit dieser Variable (mit Werten zwischen 0 und 100) kann die Feinabstimmung
130 zwischen dem Bedarf an Hauptspeicher und Rechenleistung bei der Ausführung
131 von LilyPond durchgeführt werden. Bei höheren Werten benutzt LilyPond
132 mehr Hauptspeicher, benötigt aber weniger Prozessor-Leistung. Bei
133 niedrigeren Werten wird mehr Prozessor-Zeit, dafür weniger Hauptspeicher
134 benötigt. Voreinstellung ist ein Wert von @code{70}.
140 @section Error messages
142 @cindex error messages
143 Während der Verarbeitung einer Dateien können diverse Meldungen an der
144 Kommandozeile auftreten:
150 Irgendetwas ist verdächtig. Wenn Sie etwas Ungewöhnliches in Ihrer
151 Datei durchführen, dann werden Sie die Meldung verstehen und können
152 sie gegebenenfalls ignorieren. Im Normalfall jedoch bedeutet eine
153 Warnung, dass mit Ihrer Datei etwas nicht stimmt, LilyPond jedoch
154 trotzdem versucht, die Datei soweit wie möglich korrekt zu übersetzen.
158 Irgendetwas stimmt definitiv nicht. Der aktuelle Bearbeitungsschritt
159 (Einlesen, Interpretieren oder Formatieren der Datei) wird noch fertig
160 ausgeführt, danach bricht die Bearbeitung aber ab.
163 @cindex Fataler Fehler
164 Irgendetwas stimmt definitiv nicht und LilyPond kann nicht weiter
165 ausgeführt werden. Dies ist nur sehr selten der Fall, meist sind
166 die Schriftarten nicht korrekt installiert.
169 @cindex Fehlerprotokoll, Scheme
170 @cindex Scheme Fehler
171 Fehler, die während der Ausführung von Scheme-Code auftreten, werden
172 vom Scheme-Interpreter aufgefangen und an der Kommandozeile ausgegeben.
173 Wenn Sie LilyPond mit der @code{--verbose} Option (auch @code{-V})
174 ausführen, wird der sogennante @q{Call trace} ausgegeben, der die
175 aufgerufenen Funktionen zur Zeit des Fehlers angibt.
177 @item Programmierfehler
178 @cindex Programmierfehler
179 Eine interne Inkonsistenz ist aufgetreten. Diese Fehlermeldungen
180 sind sollen den Programmierern die Fehlersuche erleichtern und
181 können meistens einfach ignoriert werden. In manchen Fällen werden
182 so viele Meldungen ausgegeben, dass die Lesbarkeit der restliche
183 Ausgabe davon beeinträchtigt wird.
185 @item Abgebrochen (core dumped)
186 Dies bezeichnet einen ernsten Programmierfehler, der das Programm
187 zum Absturz gebracht hat. Solche Fehler werden als kritisch angesehen.
188 Falls daher einer auftritt, senden Sie bitte einen Bug-Report!
191 @cindex Fehlermeldung, Format
192 @cindex Form der Fehlermeldungen
193 Wenn Warnungen oder Fehlermeldungen mit einer konkreten Stelle in der
194 Eingabedatei verknüpft werden können, dann hat die Meldung die folgende
198 @var{Dateiname}:@var{Zeile}:@var{Spalte}: @var{Meldung}
199 @var{Fehlerhafte Eingabezeile}
202 Ein Zeilenumbruch wird in der fehlerhaften Zeile an jener Stelle eingefügt,
203 wo der Fehler aufgetreten ist. Zum Beispiel
206 test.ly:2:19: Fehler: keine gültige Dauer: 5
211 Diese Stellen sind LilyPonds Vermutung, wo die Warnung oder der Fehler
212 aufgetreten ist, allerdings treten Warnungen und Fehler ja gerade in
213 unerwarteten Fällen auf. Manchmal kann Lilypond auch eine fehlerhafte
214 Stelle zwar noch problemlos verarbeiten, ein paar Zeilen später wirkt
215 sich der Fehler aber dann doch noch aus. In solchen Fällen, wo Sie in
216 der angegebenen Zeile keinen Fehler erkenn, sollten Sie auch die Zeilen
217 oberhalb der angegebenen Stelle genauer unter die Lupe nehmen.
220 @node Updating files with convert-ly
221 @section Updating with @command{convert-ly}
226 @subsection Command line options
228 * Problems with convert-ly::
231 @node Problems with convert-ly
232 @subsection Problems with @code{convert-ly}
238 @section Reporting bugs
242 @cindex Fehler melden
244 Wenn Sie eine Datei haben, die zu einem Absturz von LilyPond oder zu einer
245 fehlerhaften Ausgabe führt, so ist dies ein @q{Bug}. Die List der aktuell
246 bekannten derartigen Fehler findet sich in unserem @q{Google Bug Tracker}:
248 @uref{http://code.google.com/p/lilypond/issues/list}
250 Wenn Sie einen Fehler gefunden haben, der noch nicht aufgelistet ist, melden
251 Sie dies bitte anhand der Anweisungen auf der Seite
253 @uref{http://lilypond.org/web/devel/participating/bugs}
255 Wenn Sie Beispieldateien für den Fehler erstellen, versuchen Sie bitte, die
256 Datei möglichst minimal zu halten und nur jenen LilyPond Code aufzunehmen,
257 der auch wirklich für den Fehler verantwortlich ist. Meldungen mit
258 Beispieldateien, die nicht minimal sind, können wir meist aus Zeitgründen
259 nicht effektiv bearbeiten.
263 @c -- SKELETON FILE --