Documentation/de/usage/converters.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
   2
   3 @ignore
   4     Translation of GIT committish: 3d7ffa1f82bb44673134b28becf7898482fe7316
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  For details, see the Contributors'
   8     Guide, node Updating translation committishes..
   9 @end ignore
  10
  11 @c \version "2.12.0"
  12
  13 @c Translators: Reinhold Kainhofer
  14 @c Translation checkers: Till Paala
  15
  16 @node Von anderen Formaten konvertieren
  17 @chapter Von anderen Formaten konvertieren
  18 @translationof Converting from other formats
  19
  20 LilyPond kann auch Musik aus diversen anderen Formaten importieren.
  21 Dieses Kapitel beschreibt die dazu mit LilyPond mitgelieferten
  22 Hilfsprogramme. Daneben existieren natürlich auch noch weitere
  23 Programme, die Dateien für LilyPond erstellen können, wie etwa
  24 graphische Sequenzierprogramme und XML-Konverter. Näheres dazu
  25 findet sich auf der @uref{http://@/lilypond@/.org,Homepage} von LilyPond.
  26
  27 Die im Folgenden beschriebenen Programme sind eigenständige Hilfsprogramme
  28 und werden üblicherweise von der Kommandozeile aufgerufen. Siehe
  29 @ref{Benutzung auf der Kommandozeile} für weitere Informationen.  Wenn Sie MacOS
  30 10.3 oder 10.4 benutzen und Probleme mit diesen Skripten (z. B.
  31 @code{convert-ly}) haben, lesen Sie
  32 Einrichtung für MacOS X.
  33 @c @ref{Einrichtung für MacOS X}.
  34
  35 @knownissues
  36 Leider haben wir nicht ausreichend viele Entwickler, um all die folgenden
  37 Hilfsprogramme ständig zu warten. Wir stellen den aktuellen Stand zur
  38 Verfügung, können aber leider Fehlerberichte nur selten bearbeiten.
  39 Selbstverständlich sind Patches von Ihnen sehr willkommen!
  40
  41
  42 @menu
  43 * midi2ly aufrufen::          Import von MIDI.
  44 * muscxml2ly aufrufen::      Import von MusicXML.
  45 * abc2ly aufrufen::           Import von ABC.
  46 * etf2ly aufrufen::           Import von (alten) Finale-Dateien.
  47 * LilyPond-Dateien erstellen:: Grafische Benutzeroberflächen,
  48 Musikübersetzer und Programme zur algorithmischen Komposition.
  49 @end menu
  50
  51 @node midi2ly aufrufen
  52 @section @command{midi2ly} aufrufen
  53 @translationof Invoking midi2ly
  54
  55 @cindex MIDI
  56
  57 @command{midi2ly} übersetzt eine Typ@tie{}1 MIDI-Datei in eine
  58 Eingabedatei für LilyPond.
  59
  60 MIDI (Music Instrument Digital Interface) ist ein internationaler
  61 Standard für digitale Instrumente: Es spezifiziert die Verkabelung,
  62 ein serielles Protokoll und ein Dateiformat. Das MIDI-Dateiformat
  63 ist der de-facto Standard um Musik von vielen Programmen zu exportieren.
  64 Allerdings fehlen in den MIDI-Dateien viele Ausdrucks- und
  65 Artikulationszeichen. Dennoch kann MIDI vielfach nützlich sein,
  66 um Musik von einem Programm zu importieren, für das kein spezielles
  67 Hilfsprogramm den direkten Import nach LilyPond unterstützt.
  68
  69 @command{midi2ly} konvertiert die MIDI-Spuren nach @rinternals{Staff} und
  70 MIDI-Kanäle in @rinternals{Voice} Kontexte. Tonhöhen werden relativ
  71 angegeben, Tondauern nur wenn nötig.
  72
  73 MIDI-Dateien können auch direkt von einem digitalen Keyboard
  74 aufgenommen und dann in eine @file{.ly}-Datei konvertiert werden.
  75 Allerdings sind Musikinterpretationen von Menschen (aus gutem Grund!)
  76 rhythmisch nicht exakt genug um die Konvertierung von MIDI nach LY
  77 trivial zu gestalten. Wenn @command{midi2ly} mit Quantisierung
  78 (@code{-s} und @code{-d} Kommandozeilenoptionen) aufgerufen wird,
  79 versucht es diese Unschärfen im Zeitablauf zu korrigieren, ist
  80 allerdings nicht sonderlich gut darin. Daher können wir diese Technik
  81 leider nicht für die Konvertierung von MIDI-Aufnahmen empfehlen.
  82
  83
  84 @command{midi2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
  85 @example
  86 midi2ly [@var{Optionen}]@dots{} @var{MIDI-Datei}
  87 @end example
  88
  89 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
  90 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
  91 @ref{Von anderen Formaten konvertieren}.
  92
  93 Die folgenden Kommandozeilenoptionen werden von @command{midi2ly}
  94 unterstützt:
  95
  96 @table @code
  97 @item -a, --absolute-pitches
  98 Gibt absolute Tonhöhen aus.
  99
 100 @item -d, --duration-quant=@var{LÄNGE}
 101 Quantisiert Tondauern zu Vielfachen von @var{LÄNGE}.
 102
 103 @item -e, --explicit-durations
 104 Gibt alle Tondauern explizit an.
 105
 106 @item -h,--help
 107 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 108
 109 @item -k, --key=@var{acc}[:@var{Moll}]
 110 Setzt die Standard-Tonart. @math{@var{acc} > 0} gibt die Anzahl der
 111 Kreuze an, @math{@var{acc} < 0} gibt die Anzahl der Bs der Tonart an.
 112 Eine Moll-Tonart wird durch @code{:1} angegeben.
 113
 114 @item -o, --output=@var{Datei}
 115 Die Ausgabe wird in die Datei @var{Datei}@file{.ly} geschrieben.
 116
 117 @item -s, --start-quant=@var{LÄNGE}
 118 Quantisiert den Beginn der Noten zu Vielfachen von @var{LÄNGE}.
 119
 120 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
 121 Erlaubt Tuplet-Dauern der Form @var{DUR}*@var{NUM}/@var{DEN}.
 122
 123 @item -V, --verbose
 124 Gibt ausführliche informative Meldungen während der Konvertierung aus.
 125
 126 @item -v, --version
 127 Gibt die Versionsnummer aus.
 128
 129 @item -w, --warranty
 130 Zeigt die Lizenzbedingungen und Urheberrechtshinweise.
 131
 132 @item -x, --text-lyrics
 133 Interpretiert alle Texte als Liedtexte.
 134 @end table
 135
 136
 137 @knownissues
 138
 139 Überlappende Noten in einem Arpeggio werden nicht korrekt dargestellt.
 140 Nur die erste Note wird eingelesen und konvertiert, die restlichen
 141 werden ignoriert. Als Abhilfe können Sie alle Noten auf dieselbe
 142 Tonlänge setzen und Phrasierungszeichen oder Pedalindikatoren
 143 hinzufügen.
 144
 145
 146 @node muscxml2ly aufrufen
 147 @section @command{muscxml2ly} aufrufen
 148 @translationof Invoking musicxml2ly
 149
 150 @cindex MusicXML
 151
 152 @uref{http://@/www.@/musicxml@/.org/,MusicXML} ist ein XML-Dialekt
 153 zur Darstellung von Musiknotation.
 154
 155 @command{musicxml2ly} wandelt eine MusicXML-Datei nach LilyPond um,
 156 wobei sowohl die Noten, Artikulationszeichen, Struktur der Partitur,
 157 Liedtexte etc. einer MusicXML-Datei (im @q{part-wise}-Format) in eine
 158 .ly-Datei um.
 159
 160 @command{musicxml2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
 161 @example
 162 musicxml2ly [@var{Optionen}]@dots{} @var{XML-Datei}
 163 @end example
 164
 165 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
 166 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
 167 @ref{Von anderen Formaten konvertieren}.
 168
 169 Wenn als Dateiname @file{-} angegeben wird, liest @command{musicxml2ly}
 170 Daten direkt von der Kommandozeile ein.
 171
 172 Die folgenden Kommandozeilenoptionen werden von @command{musicxml2ly}
 173 unterstützt:
 174
 175 @table @code
 176 @item -a, --absolute
 177 Konvertiert in absolute Tonhöhen.
 178
 179 @item -h,--help
 180 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 181
 182 @item -l, --language=LANG
 183 Inkludiert die Sprachdatei @var{LANG}@file{.ly} in der Ausgabe. Wird z.B.
 184 'deutsch' angegeben, wird @file{deutsch.ly} in die .ly-Datei eingebunden
 185 und deutsche Notenbezeichnungen benutzt.
 186
 187 @item --lxml
 188 Benutzt das lxml.etree Python-Paket für die Verarbeitung von XML (benötigt weniger Speicher und Rechenleistung)
 189
 190 @item --nd --no-articulation-directions
 191 Konvertiert keine Richtungsangaben (@code{^}, @code{_} oder @code{-})
 192 von Artikulations- und Lautstärkebezeichnungen.
 193
 194 @item --no-beaming
 195 Konvertiert keine Informationen über die Balkensetzung aus der
 196 MusicXML-Datei. Stattdessen wird dies LilyPond überlassen.
 197
 198 @item -o,--output=@var{Dateiname}
 199 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben. Wird
 200 als @var{Dateiname} nur @file{-} angegeben, wird das Ergebnis der Konvertierung
 201 an der Kommandozeile ausgegeben. Wird diese Option nicht angegeben, so
 202 erfolgt die Ausgabe in die Datei @var{XML-Datei}@file{.ly}.
 203
 204 @item -r,--relative
 205 Konvertiert in relative Tonhöhen. (Standardeinstellung)
 206
 207 @item -v, --verbose
 208 Gibt ausführliche informative Meldungen während der Konvertierung aus.
 209
 210 @item --version
 211 Gibt die Versionsnummer aus.
 212
 213 @item  -z,--compressed
 214 Die Eingabedatei wird als komprimierte MusicXML-Datei eingelesen.
 215 Dies ist die Standardeinstellung für Dateien mit der Erweiterung
 216 @file{.mxl}.
 217 @end table
 218
 219
 220 @node abc2ly aufrufen
 221 @section @command{abc2ly} aufrufen
 222 @translationof Invoking abc2ly
 223
 224 @cindex ABC
 225
 226 ABC ist ein relativ einfaches ASCII-basierendes Musikformat und ist
 227 dokumentiert auf der ABC-Homepage:
 228
 229 @quotation
 230 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
 231 @end quotation
 232
 233 @command{abc2ly} konvertiert ABC-Dateien nach LilyPond und wird
 234 von der Kommandozeile folgendermaßen aufgerufen:
 235
 236 @example
 237 abc2ly [@var{Optionen}]@dots{} @var{ABC-Datei}
 238 @end example
 239
 240 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
 241 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
 242 @ref{Von anderen Formaten konvertieren}.
 243
 244 Die folgenden Kommandozeilenoptionen werden von @command{abc2ly}
 245 unterstützt:
 246
 247 @table @code
 248 @item -b,--beams=None
 249 Die Balkensetzung aus der ABC-Datei erhalten.
 250 @item -h,--help
 251 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 252 @item -o,--output=@var{Dateiname}
 253 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
 254 @item -s,--strict
 255 Strenge Auslegung einer erfolgreichen Konvertierung.
 256 @item -v,--version
 257 Gibt die Versionsnummer aus.
 258 @end table
 259
 260 Es existiert außerdem die Möglichkeit, LilyPond-Befehle für die
 261 Konvertierung mit @command{abc2ly} gleich in der ABC-Datei anzugeben.
 262 Wenn sich etwa in der ABC-Datei das Kommentar
 263
 264 @example
 265 %%LY voices \set autoBeaming = ##f
 266 @end example
 267
 268 @noindent
 269 befindet, so wird der Text nach dem Schlüsselwort @q{voices} direkt
 270 in die aktuelle Stimme in der LilyPond-Datei eingefügt.
 271
 272 Ebenso bewirkt
 273
 274 @example
 275 %%LY slyrics more words
 276 @end example
 277
 278 @noindent
 279 dass alles nach dem @q{slyrics} Schlüsselwort an der aktuellen Stelle
 280 im Liedtext eingefügt wird.
 281
 282
 283 @knownissues
 284
 285 Der ABC-Standard ist eigentlich kein wirklich vollständiger Standard.
 286 Für komplexere Notation wie etwa Polyphonie existieren verschiedene
 287 Konventionen.
 288
 289 Mehrere Lieder in einer Datei können nicht konvertiert werden.
 290
 291 ABC synchronisiert den Liedtext am Anfang jeder Zeile mit den Noten,
 292 @command{abc2ly} macht dies nicht.
 293
 294 @command{abc2ly} ignoriert die Balkensetzung in der ABC-Datei.
 295
 296
 297 @node etf2ly aufrufen
 298 @section @command{etf2ly} aufrufen
 299 @translationof Invoking etf2ly
 300
 301 @cindex ETF
 302 @cindex enigma
 303 @cindex Finale
 304 @cindex Coda Technology
 305
 306 ETF (Enigma Transport Format) ist ein Dateiformat, das Coda
 307 Music Technology in älteren Versionen des Programms Finale benutzt hat.
 308
 309 @command{etf2ly} konvertiert Teile einer ETF-Datei nach LilyPond
 310 und wird von der Kommandozeile folgendermaßen aufgerufen:
 311
 312 @example
 313 etf2ly [@var{Optionen}]@dots{} @var{ETF-Datei}
 314 @end example
 315
 316 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
 317 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
 318 @ref{Von anderen Formaten konvertieren}.
 319
 320 Die folgenden Kommandozeilenoptionen werden von @command{etf2ly}
 321 unterstützt:
 322
 323 @table @code
 324 @item -h,--help
 325 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 326 @item -o,--output=@var{Dateiname}
 327 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
 328 @item --version
 329 Gibt die Versionsnummer aus.
 330 @end table
 331
 332
 333 @knownissues
 334
 335 Die Liste der Artikulationszeichen is unvollständig. Leere Takte
 336 verwirren @command{etf2ly}. Mehrfache Vorschlagnoten werden falsch
 337 beendet.
 338
 339
 340 @node LilyPond-Dateien erstellen
 341 @section LilyPond-Dateien erstellen
 342 @translationof Generating LilyPond files
 343
 344 @cindex Externe Programme, LilyPond-Dateien erzeugen
 345
 346 LilyPond selbst wird nur mit den oben genannten Konvertierprogrammen
 347 ausgeliefert und unterstützt keine weiteren Formate. Es existieren
 348 allerdings externe Hilfsprogramme, die auch LilyPond-Dateien erzeugen
 349 können.
 350 Diese umfassen unter anderem:
 351
 352 @itemize
 353 @item
 354 @uref{http://@/www@/.denemo@/.org/,Denemo}, ein grafisches
 355 Programm zum Musiksatz.
 356 @item
 357 @uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, ein
 358 MIDI-nach-LilyPond Konverter, der monophone MIDI-Eigaben in Echtzeit
 359 konvertiert.
 360 @item
 361 @uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, ein
 362 Emacs-Modus.
 363 @item
 364 @uref{http://@/www@/.nongnu@/.org/@/xml2ly/,xml2ly}, ein Konverter für
 365 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}, der auf
 366 XML-Transformationen mittels XSLT basiert.
 367 @item
 368 @uref{http://@/noteedit@/.berlios@/.de,NoteEdit}, ein grafisches
 369 Programm zum Notensatz, das auch
 370 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML} importieren kann.
 371 @item
 372 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
 373 das MIDI importieren kann.
 374 @item
 375 @uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
 376 eine LISP-Bibliothek, um Musiknotation zu erzeugen.
 377 @item
 378 @uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml},
 379 ein Notensatzprogramm mit experimentellem Export nach LilyPond.
 380 @item
 381 @uref{http://www.tuxguitar.com.ar/,TuxGuitar}, ein Programm zur Erzeugung von
 382 Gitarren-Tabulaturen, unterstützt den Export nach LilyPond.
 383 @item
 384 @uref{http://musescore.org/,MuseScore} unterstützt ebenfalls den
 385 Export nach LilyPond.
 386 @end itemize
 387