Documentation/de/application/converters.itely

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