X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fde%2Fuser%2Fconverters.itely;h=6dc9f62837220a4b084a74e784add81061d1553d;hb=6140c6eb657080939fa4aef3d00d717bd85b5028;hp=f99a58b57ceaca70047f68226c018e0e5c0e8378;hpb=e4b3aa8d0afa689a3a95e1c730cb3d2213418270;p=lilypond.git diff --git a/Documentation/de/user/converters.itely b/Documentation/de/user/converters.itely index f99a58b57c..6dc9f62837 100644 --- a/Documentation/de/user/converters.itely +++ b/Documentation/de/user/converters.itely @@ -1,52 +1,378 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*- -@c This file is part of lilypond.tely +@c This file is part of lilypond-program.tely @ignore - Translation of GIT committish: 3237f4afc77b528ca92ca6d68664bd80e39d9e76 - + Translation of GIT committish: 499a511d4166feaada31114e097f86b5e0c56421 When revising a translation, copy the HEAD committish of the version that you are working on. See TRANSLATION for details. @end ignore +@c \version "2.12.0" + +@c Translators: Reinhold Kainhofer +@c Translation checkers: Till Rettig @node Converting from other formats @chapter Converting from other formats -UNTRANSLATED NODE: IGNORE ME +LilyPond kann auch Musik aus diversen anderen Formaten importieren. +Dieses Kapitel beschreibt die dazu mit LilyPond mitgelieferten +Hilfsprogramme. Daneben existieren natürlich auch noch weitere +Programme, die Dateien für LilyPond erstellen können, wie etwa +graphische Sequenzierprogramme und XML-Konverter. Näheres dazu +findet sich auf der @uref{http://@/lilypond@/.org,Homepage} von LilyPond. + +Die im Folgenden beschriebenen Programme sind eigenständige Hilfsprogramme +und werden üblicherweise von der Kommandozeile aufgerufen. Siehe +@ref{Command-line usage} für weitere Informationen. Wenn Sie MacOS +10.3 oder 10.4 benutzen und Probleme mit diesen Skripten (z. B. +@code{convert-ly}) haben, lesen Sie @ref{Setup for MacOS X}. + +@knownissues +Leider haben wir nicht ausreichend viele Entwickler, um all die folgenden +Hilfsprogramme ständig zu warten. Wir stellen den aktuellen Stand zur +Verfügung, können aber leider Fehlerberichte nur selten bearbeiten. +Selbstverständlich sind Patches von Ihnen sehr willkommen! + + +@menu +* Invoking midi2ly:: Import von MIDI. +* Invoking musicxml2ly:: Import von MusicXML. +* Invoking abc2ly:: Import von ABC. +* Invoking etf2ly:: Import von (alten) Finale-Dateien. +* Generating LilyPond files:: Grafische Benutzeroberflächen, +Musikübersetzer und Programme zur algorithmischen Komposition. +@end menu -@menu -* Invoking midi2ly:: -* Invoking etf2ly:: -* Invoking musicxml2ly:: -* Invoking abc2ly:: -* Generating LilyPond files:: -@end menu @node Invoking midi2ly @section Invoking @command{midi2ly} -UNTRANSLATED NODE: IGNORE ME +@cindex MIDI -@node Invoking etf2ly -@section Invoking @command{etf2ly} +@command{midi2ly} übersetzt eine Typ@tie{}1 MIDI-Datei in eine +Eingabedatei für LilyPond. + +MIDI (Music Instrument Digital Interface) ist ein internationaler +Standard für digitale Instrumente: Es spezifiziert die Verkabelung, +ein serielles Protokoll und ein Dateiformat. Das MIDI-Dateiformat +ist der de-facto Standard um Musik von vielen Programmen zu exportieren. +Allerdings fehlen in den MIDI-Dateien viele Ausdrucks- und +Artikulationszeichen. Dennoch kann MIDI vielfach nützlich sein, +um Musik von einem Programm zu importieren, für das kein spezielles +Hilfsprogramm den direkten Import nach LilyPond unterstützt. + +@command{midi2ly} konvertiert die MIDI-Spuren nach @rinternals{Staff} und +MIDI-Kanäle in @rinternals{Voice} Kontexte. Tonhöhen werden relativ +angegeben, Tondauern nur wenn nötig. + +MIDI-Dateien können auch direkt von einem digitalen Keyboard +aufgenommen und dann in eine @file{.ly}-Datei konvertiert werden. +Allerdings sind Musikinterpretationen von Menschen (aus gutem Grund!) +rhythmisch nicht exakt genug um die Konvertierung von MIDI nach LY +trivial zu gestalten. Wenn @command{midi2ly} mit Quantisierung +(@code{-s} und @code{-d} Kommandozeilenoptionen) aufgerufen wird, +versucht es diese Unschärfen im Zeitablauf zu korrigieren, ist +allerdings nicht sonderlich gut darin. Daher können wir diese Technik +leider nicht für die Konvertierung von MIDI-Aufnahmen empfehlen. + + +@command{midi2ly} wird von der Kommandozeile folgendermaßen aufgerufen: +@example +midi2ly [@var{Optionen}]@dots{} @var{MIDI-Datei} +@end example + +Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des +jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe +@ref{Converting from other formats}. + +Die folgenden Kommandozeilenoptionen werden von @command{midi2ly} +unterstützt: + +@table @code +@item -a, --absolute-pitches +Gibt absolute Tonhöhen aus. + +@item -d, --duration-quant=@var{LÄNGE} +Quantisiert Tondauern zu Vielfachen von @var{LÄNGE}. + +@item -e, --explicit-durations +Gibt alle Tondauern explizit an. + +@item -h,--help +Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen. + +@item -k, --key=@var{acc}[:@var{Moll}] +Setzt die Standard-Tonart. @math{@var{acc} > 0} gibt die Anzahl der +Kreuze an, @math{@var{acc} < 0} gibt die Anzahl der Bs der Tonart an. +Eine Moll-Tonart wird durch @code{:1} angegeben. + +@item -o, --output=@var{Datei} +Die Ausgabe wird in die Datei @var{Datei}@file{.ly} geschrieben. + +@item -s, --start-quant=@var{LÄNGE} +Quantisiert den Beginn der Noten zu Vielfachen von @var{LÄNGE}. + +@item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN} +Erlaubt Tuplet-Dauern der Form @var{DUR}*@var{NUM}/@var{DEN}. + +@item -V, --verbose +Gibt ausführliche informative Meldungen während der Konvertierung aus. + +@item -v, --version +Gibt die Versionsnummer aus. + +@item -w, --warranty +Zeigt die Lizenzbedingungen und Urheberrechtshinweise. + +@item -x, --text-lyrics +Interpretiert alle Texte als Liedtexte. +@end table + + +@knownissues + +Überlappende Noten in einem Arpeggio werden nicht korrekt dargestellt. +Nur die erste Note wird eingelesen und konvertiert, die restlichen +werden ignoriert. Als Abhilfe können Sie alle Noten auf dieselbe +Tonlänge setzen und Phrasierungszeichen oder Pedalindikatoren +hinzufügen. -UNTRANSLATED NODE: IGNORE ME @node Invoking musicxml2ly @section Invoking @code{musicxml2ly} -UNTRANSLATED NODE: IGNORE ME +@cindex MusicXML + +@uref{http://@/www.@/musicxml@/.org/,MusicXML} ist ein XML-Dialekt +zur Darstellung von Musiknotation. + +@command{musicxml2ly} wandelt eine MusicXML-Datei nach LilyPond um, +wobei sowohl die Noten, Artikulationszeichen, Struktur der Partitur, +Liedtexte etc. einer MusicXML-Datei (im @q{part-wise}-Format) in eine +.ly-Datei um. + +@command{musicxml2ly} wird von der Kommandozeile folgendermaßen aufgerufen: +@example +musicxml2ly [@var{Optionen}]@dots{} @var{XML-Datei} +@end example + +Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des +jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe +@ref{Converting from other formats}. + +Wenn als Dateiname @file{-} angegeben wird, liest @command{musicxml2ly} +Daten direkt von der Kommandozeile ein. + +Die folgenden Kommandozeilenoptionen werden von @command{musicxml2ly} +unterstützt: + +@table @code +@item -a, --absolute +Konvertiert in absolute Tonhöhen. + +@item -h,--help +Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen. + +@item -l, --language=LANG +Inkludiert die Sprachdatei @var{LANG}@file{.ly} in der Ausgabe. Wird z.B. +'deutsch' angegeben, wird @file{deutsch.ly} in die .ly-Datei eingebunden +und deutsche Notenbezeichnungen benutzt. + +@item --lxml +Benutzt das lxml.etree Python-Paket für die Verarbeitung von XML (benötigt weniger Speicher und Rechenleistung) + +@item --nd --no-articulation-directions +Konvertiert keine Richtungsangaben (@code{^}, @code{_} oder @code{-}) +von Artikulations- und Lautstärkebezeichnungen. + +@item --no-beaming +Konvertiert keine Informationen über die Balkensetzung aus der +MusicXML-Datei. Stattdessen wird dies LilyPond überlassen. + +@item -o,--output=@var{Dateiname} +Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben. Wird +als @var{Dateiname} nur @file{-} angegeben, wird das Ergebnis der Konvertierung +an der Kommandozeile ausgegeben. Wird diese Option nicht angegeben, so +erfolgt die Ausgabe in die Datei @var{XML-Datei}@file{.ly}. + +@item -r,--relative +Konvertiert in relative Tonhöhen. (Standardeinstellung) + +@item -v, --verbose +Gibt ausführliche informative Meldungen während der Konvertierung aus. + +@item --version +Gibt die Versionsnummer aus. + +@item -z,--compressed +Die Eingabedatei wird als komprimierte MusicXML-Datei eingelesen. +Dies ist die Standardeinstellung für Dateien mit der Erweiterung +@file{.mxl}. +@end table + @node Invoking abc2ly @section Invoking @code{abc2ly} -UNTRANSLATED NODE: IGNORE ME +@cindex ABC + +ABC ist ein relativ einfaches ASCII-basierendes Musikformat und ist +dokumentiert auf der ABC-Homepage: + +@quotation +@uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}. +@end quotation + +@command{abc2ly} konvertiert ABC-Dateien nach LilyPond und wird +von der Kommandozeile folgendermaßen aufgerufen: + +@example +abc2ly [@var{Optionen}]@dots{} @var{ABC-Datei} +@end example + +Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des +jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe +@ref{Converting from other formats}. + +Die folgenden Kommandozeilenoptionen werden von @command{abc2ly} +unterstützt: + +@table @code +@item -b,--beams=None +Die Balkensetzung aus der ABC-Datei erhalten. +@item -h,--help +Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen. +@item -o,--output=@var{Dateiname} +Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben. +@item -s,--strict +Strenge Auslegung einer erfolgreichen Konvertierung. +@item -v,--version +Gibt die Versionsnummer aus. +@end table + +Es existiert außerdem die Möglichkeit, LilyPond-Befehle für die +Konvertierung mit @command{abc2ly} gleich in der ABC-Datei anzugeben. +Wenn sich etwa in der ABC-Datei das Kommentar + +@example +%%LY voices \set autoBeaming = ##f +@end example + +@noindent +befindet, so wird der Text nach dem Schlüsselwort @q{voices} direkt +in die aktuelle Stimme in der LilyPond-Datei eingefügt. + +Ebenso bewirkt + +@example +%%LY slyrics more words +@end example + +@noindent +dass alles nach dem @q{slyrics} Schlüsselwort an der aktuellen Stelle +im Liedtext eingefügt wird. + + +@knownissues + +Der ABC-Standard ist eigentlich kein wirklich vollständiger Standard. +Für komplexere Notation wie etwa Polyphonie existieren verschiedene +Konventionen. + +Mehrere Lieder in einer Datei können nicht konvertiert werden. + +ABC synchronisiert den Liedtext am Anfang jeder Zeile mit den Noten, +@command{abc2ly} macht dies nicht. + +@command{abc2ly} ignoriert die Balkensetzung in der ABC-Datei. + + +@node Invoking etf2ly +@section Invoking @command{etf2ly} + +@cindex ETF +@cindex enigma +@cindex Finale +@cindex Coda Technology + +ETF (Enigma Transport Format) ist ein Dateiformat, das Coda +Music Technology in älteren Versionen des Programms Finale benutzt hat. + +@command{etf2ly} konvertiert Teile einer ETF-Datei nach LilyPond +und wird von der Kommandozeile folgendermaßen aufgerufen: + +@example +etf2ly [@var{Optionen}]@dots{} @var{ETF-Datei} +@end example + +Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des +jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe +@ref{Converting from other formats}. + +Die folgenden Kommandozeilenoptionen werden von @command{etf2ly} +unterstützt: + +@table @code +@item -h,--help +Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen. +@item -o,--output=@var{Dateiname} +Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben. +@item --version +Gibt die Versionsnummer aus. +@end table + + +@knownissues + +Die Liste der Artikulationszeichen is unvollständig. Leere Takte +verwirren @command{etf2ly}. Mehrfache Vorschlagnoten werden falsch +beendet. + @node Generating LilyPond files @section Generating LilyPond files -UNTRANSLATED NODE: IGNORE ME +@cindex Externe Programme, LilyPond-Dateien erzeugen + +LilyPond selbst wird nur mit den oben genannten Konvertierprogrammen +ausgeliefert und unterstützt keine weiteren Formate. Es existieren +allerdings externe Hilfsprogramme, die auch LilyPond-Dateien erzeugen +können. +Diese umfassen unter anderem: +@itemize +@item +@uref{http://@/www@/.denemo@/.org/,Denemo}, ein grafisches +Programm zum Musiksatz. +@item +@uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, ein +MIDI-nach-LilyPond Konverter, der monophone MIDI-Eigaben in Echtzeit +konvertiert. +@item +@uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, ein +Emacs-Modus. +@item +@uref{http://@/www@/.nongnu@/.org/@/xml2ly/,xml2ly}, ein Konverter für +@uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}, der auf +XML-Transformationen mittels XSLT basiert. +@item +@uref{http://@/noteedit@/.berlios@/.de,NoteEdit}, ein grafisches +Programm zum Notensatz, das auch +@uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML} importieren kann. +@item +@uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden}, +das MIDI importieren kann. +@item +@uref{http://@/common-lisp@/.net/project/fomus/,FOMUS}, +eine LISP-Bibliothek, um Musiknotation zu erzeugen. +@item +@uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml}, +ein Notensatzprogramm mit experimentellem Export nach LilyPond. +@item +@uref{http://www.tuxguitar.com.ar/,TuxGuitar}, ein Programm zur Erzeugung von +Gitarren-Tabulaturen, unterstützt den Export nach LilyPond. +@item +@uref{http://musescore.org/,MuseScore} unterstützt ebenfalls den +Export nach LilyPond. +@end itemize --- SKELETON FILE -- -When you actually translate this file, please remove these lines as -well as all `UNTRANSLATED NODE: IGNORE ME' lines.