@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: 9634340429eb0518432b152fe4aaf7471b67b013
-
+ 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.
projects / lilypond.git / blobdiff