Documentation/de/user/running.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
   2 @c This file is part of lilypond-program.tely
   3 @ignore
   4     Translation of GIT committish: 4ac76531a06d6b6836b67d3650b57a2f58d1108f
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  See TRANSLATION for details.
   8 @end ignore
   9
  10
  11 @node Running LilyPond
  12 @chapter Running LilyPond
  13
  14 Dieses Kapitel behandelt die technischen Details, wie Lilypond ausgeführt werden kann.
  15
  16
  17 @menu
  18 * Normal usage::
  19 * Command-line usage::
  20 * Error messages::
  21 * Updating files with convert-ly::
  22 * Reporting bugs::
  23 @end menu
  24
  25 @node Normal usage
  26 @section Normal usage
  27
  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.
  30
  31
  32 @node Command-line usage
  33 @section Command-line usage
  34
  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.
  40
  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.
  46
  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.
  51
  52
  53 @menu
  54 * Invoking lilypond::
  55 * Command line options::
  56 * Environment variables::
  57 @end menu
  58
  59 @node Invoking lilypond
  60 @subsection Invoking lilypond
  61
  62 @cindex LilyPond aufrufen
  63 @cindex Kommandozeilen-Optionen
  64 @cindex Optionen an der Kommandozeile
  65
  66 Das @command{lilypond} Programm kann folgendermaßen von der Kommandozeile
  67 aufgerufen werden.
  68
  69 @example
  70 lilypond [@var{Option}]@dots{} @var{Dateiname}@dots{}
  71 @end example
  72
  73
  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{-})
  77 als @var{Dateiname}.
  78
  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.}
  86
  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
  92
  93 @example
  94 #(define output-suffix "Geige")
  95 \book @{ @dots{} @}
  96 #(define output-suffix "Cello")
  97 \book @{ @dots{} @}
  98 @end example
  99
 100 @noindent
 101 erzeigt daher die Dateien @var{Dateiname}@file{-Geige.pdf} und
 102 @var{Dateiname}@file{-Cello-1.pdf}.
 103
 104
 105
 106 @node Command line options
 107 @subsection Command line options
 108
 109 @untranslated
 110
 111
 112 @node Environment variables
 113 @subsection Environment variables
 114
 115 @cindex LANG
 116 @cindex LILYPOND_DATADIR
 117
 118 @command{lilypond} erkennt und benützt die folgenden Umgebungsvariablen:
 119 @table @code
 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.
 124
 125 @item LANG
 126 Gibt die Sprache an, in der Warnungen und Fehlermeldungen ausgegeben werden.
 127
 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}.
 135
 136 @end table
 137
 138
 139 @node Error messages
 140 @section Error messages
 141
 142 @cindex error messages
 143 Während der Verarbeitung einer Dateien können diverse Meldungen an der
 144 Kommandozeile auftreten:
 145
 146 @table @emph
 147
 148 @item Warnung
 149 @cindex Warnung
 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.
 155
 156 @item Fehler
 157 @cindex Fehler
 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.
 161
 162 @item Fataler Fehler
 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.
 167
 168 @item Scheme Fehler
 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.
 176
 177 @item Programmierfehler
 178 @cindex Programmierfehler
 179 Eine interne Inkonsistenz ist aufgetreten.  Diese Fehlermeldungen
 180 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.
 184
 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!
 189 @end table
 190
 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
 195 Form:
 196
 197 @example
 198 @var{Dateiname}:@var{Zeile}:@var{Spalte}: @var{Meldung}
 199 @var{Fehlerhafte Eingabezeile}
 200 @end example
 201
 202 Ein Zeilenumbruch wird in der fehlerhaften Zeile an jener Stelle eingefügt,
 203 wo der Fehler aufgetreten ist.  Zum Beispiel
 204
 205 @example
 206 test.ly:2:19: Fehler: keine gültige Dauer: 5
 207   @{ c'4 e'
 208              5 g' @}
 209 @end example
 210
 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.
 218
 219
 220 @node Updating files with convert-ly
 221 @section Updating with @command{convert-ly}
 222
 223 @untranslated
 224
 225
 226 @subsection Command line options
 227 @menu
 228 * Problems with convert-ly::
 229 @end menu
 230
 231 @node Problems with convert-ly
 232 @subsection Problems with @code{convert-ly}
 233
 234 @untranslated
 235
 236
 237 @node Reporting bugs
 238 @section Reporting bugs
 239
 240
 241 @cindex Fehler
 242 @cindex Fehler melden
 243
 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}:
 247
 248 @uref{http://code.google.com/p/lilypond/issues/list}
 249
 250 Wenn Sie einen Fehler gefunden haben, der noch nicht aufgelistet ist, melden
 251 Sie dies bitte anhand der Anweisungen auf der Seite
 252
 253 @uref{http://lilypond.org/web/devel/participating/bugs}
 254
 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.
 260
 261
 262
 263 @c -- SKELETON FILE --