@c -*- coding: utf-8; mode: texinfo; -*- @ignore Translation of GIT committish: 0764a50d470cab82ca29da30298dacd333d3da12 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' Guide, node Updating translation committishes. @end ignore @c \version "2.16.0" @c Translators: Pavel Fric @node Vnější programy @chapter Vnější programy @translationof External programs LilyPond kann mit anderen Programmen auf verschiedene Weise interagieren. @menu * Ukázat a klepnout:: * Podpora textových editorů:: * Převod z jiných formátů:: * Výstup LilyPondu do jiných programů:: * Nezávislé include úryvky:: @end menu @node Ukázat a klepnout @section Ukázat a klepnout @translationof Point and click @cindex Ukázat a klepnout Ukázat a klepnout erlaubt es, die Noten in der Eingabedatei schnell zu finden, indem man auf sie im PDF-Programm klickt. Das erleichtert es, die Stellen zu finden, die Fehler in der Notation verursachen. Wenn diese Funktionalität aktiv ist, fügt LilyPond Hyperlinks zur PDF-Datei hinzu. Diese Hyperlinks werden an den Webbrowser gesendet, der einen Texteditor mit dem Cursor an der richtigen Stelle öffnet. Damit diese Kettenreaktion funktionieren kann, müssen Sie das PDF-Programm dazu anweisen, Hyperlinks zu folgen, indem das Skript @file{lilypond-invoke-editor}, welches mit LilyPond kommt, verwendet wird. Für Xpdf unter UNIX sollte folgende Zeile in der Datei @file{xpdfrc}@footnote{Unter UNIX findet man diese Datei entweder in @file{/etc/xpdfrc} oder als @file{.xpdfrc} im home-Verzeichnis.} stehen: @example urlCommand "lilypond-invoke-editor %s" @end example Das Programm @file{lilypond-invoke-editor} ist ein kleines Hilfsprogramm. Es ruft einen Editor für besondere @code{textedit}-URIs# auf und einen Webbrowser für andere. Es testes die Umgebungsvariable @code{EDITOR} nach folgenden Mustern: @table @code @item emacs das ruft auf @example emacsclient --no-wait +@var{line}:@var{column} @var{file} @end example @item gvim das ruft auf @example gvim --remote +:@var{line}:norm@var{column} @var{file} @end example @item nedit das ruft auf @example nc -noask +@var{line} @var{file}' @end example @end table Die Umgebungsvariable @code{LYEDITOR} wird benutzt, um dieses Verhalten zu umgehen. Sie enthält die Kommandozeile, mit der der Editor aufgerufen wird, wobei @code{%(file)s}, @code{%(column)s} und @code{%(line)s} mit der Datei, Spalte und Zeile ersetzt wird. Die Einstellung @example emacsclient --no-wait +%(line)s:%(column)s %(file)s @end example @noindent für @code{LYEDITOR} entspricht dem normalen Aufruf von emacsclient. @cindex Dateigröße, PDF @cindex Ausgabedatei, Dateigröße Die point-and-click-Links vergrößern die Größe des PDFs sehr stark. Um die Größe von PDFs und auch PS-Dateien zu verkleinern, kann ukázat a klepnout ausgeschaltet werden, indem man in der Eingabedatei @example \pointAndClickOff @end example @noindent schreibt. Ukázat a klepnout kann explizit aktiviert werden mit dem Befehl @example \pointAndClickOn @end example Alternativ können Sie ukázat a klepnout auch mit einer Kommandozeilenoption anschalten: @example lilypond -dno-point-and-click file.ly @end example @warning{Sie sollten immer ukázat a klepnout ausschalten, wenn Sie LilyPond-Dateien verteilen wollen, damit keine Informationen über Ihre Dateistrukturen in den Dateien gespeichert werden, was ein Sicherheitsrisiko darstellen könnte.} @node Podpora textových editorů @section Podpora textových editorů @translationof Text editor support @cindex Editoren @cindex vim @cindex emacs @cindex Modi, Editor @cindex Syntaxhervorhebung @cindex Hervorhebung, Syntax @cindex Syntax highlight Verschiedene Editoren unterstützen LilyPond @menu * Režim Emacs:: * Režim Vim:: * Jiné editoryn:: @end menu @node Režim Emacs @unnumberedsubsec Režim Emacs @translationof Emacs mode Emacs hat einen @file{lilypond-mode}-Modus, der Ergänzung von Befehlen, Einrückung, Syntaxhervorhebung, die Paarung von LilyPond-Klammern, einfache Tastaturkürzel zur Übersetzung und das Lesen von LilyPond-Dokumentation mit Info unterstützt. Wenn @file{lilypond-mode} nicht auf Ihrem Computer installiert ist, siehe unten. Režim Emacs zur Noteneingabe und zum Kompilieren mit LilyPond bfindet sich in dem Quellarchiv im @file{elisp}-Verzeichnis. Führen Sie @command{make install} aus, damit es nach @var{elispdir} installiert wird. Die Datei @file{lilypond-init.el} sollte in @var{Ladepfad}@file{/site-start.d/} gespeichert werden oder Ihrer @file{~/.emacs} bzw. @file{~/.emacs.el} hinzugefügt werden. Als ein Benutzer können Sie Ihren Quellpfad (z. B. @file{~/site-lisp/}) zum @var{Ladepfad} hinzufügen, indem Sie die (veränderte) folgende Zeile in Ihr @file{~/.emacs} kopieren: @c any reason we do not advise: (push "~/site-lisp" load-path) @example (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path)) @end example @node Režim Vim @unnumberedsubsec Režim Vim @translationof Vim mode Für @uref{http://@/www@/.vim@/.org,Vim} gibt es ein Dateiartplugin, einen Einzugsmodus und einen Syntaxhervorhebungsmodus für LilyPond. Um alle diese Eigenschaften zu aktivieren, erstellen (oder verändern) Sie die Datei @file{$HOME/.vimrc}, sodass sie folgende Zeilen enthält: @example filetype off set runtimepath+=/usr/local/share/lilypond/current/vim/ filetype on @end example @noindent Wenn LilyPond nicht in @file{/usr/local/} installiert ist, müssen Sie den Pfad anpassen. Das wird besprochen in @rlearning{Mehr Information}. @node Jiné editory @unnumberedsubsec Jiné editory @translationof Other editors Jiné editory (sowohl Texteditoren als auch graphische Editoren) haben Unterstützung für LilyPond, aber ihre besonderen Konfigurationsdateien werden nicht mit LilyPond zusammen verteilt. Lesen Sie die entsprechende Dokumenation zu näheren Fragen. Derartige Editoren finden sich unter @rweb{Leichteres Editieren}. @node Převod z jiných formátů @section Převod z jiných formátů @translationof Converting from other formats 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{Benutzung auf der Kommandozeile} 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 @rweb{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 * Vyvolání midi2ly:: Import von MIDI. * Vyvolání musicxml2ly:: Import von MusicXML. * Vyvolání abc2ly:: Import von ABC. * Vyvolání etf2ly:: Import von (alten) Finale-Dateien. * Jiné formáty:: @end menu @node Vyvolání midi2ly @subsection Vyvolání @command{midi2ly} @translationof Invoking midi2ly @cindex MIDI @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{Převod z jiných formátů,,převod z jiných formátů}. 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. @node Vyvolání musicxml2ly @subsection Vyvolání @command{muscxml2ly} @translationof Invoking musicxml2ly @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 @file{.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{Převod z jiných formátů,,převod z jiných formátů}. 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=SPRACHE Benutzt SPRACHE für die Notenbezeichnungen, etwa "deutsch" für deutsche Notenbezeichnungen. @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{.xml}. @end table @node Vyvolání abc2ly @subsection Vyvolání @command{abc2ly} @translationof Invoking abc2ly @warning{Dieses Programm ist nicht unterstützt und kann aus kommenden LilyPond-Versionen entfernt werden.} @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 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. Gleichermaßen wird mit @example %%LY slyrics more words @end example @noindent der Text, der auf das @qq{slylrics}-Schlüsselwort folgt, in die aktuelle Gesangstextzeile eingefügt. @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 Vyvolání etf2ly @subsection Vyvolání @command{etf2ly} @translationof Invoking etf2ly @warning{Dieses Programm ist nicht unterstützt und kann in kommenden LilyPond-Versionen entfernt werden.} @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{Převod z jiných formátů,,převod z jiných formátů}. 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 Jiné formáty @subsection Jiné formáty @translationof Other formats @cindex Vnější programy, LilyPond-Dateien erstellen LilyPond kommt nicht mit der Unterstützung für jiné formáty, aber einige vnější programy können auch LilyPond-Dateien erstellen. Diese finden sich unter @rweb{Leichteres Editieren}. @node Výstup LilyPondu do jiných programů @section Výstup LilyPondu do jiných programů @translationof LilyPond output in other programs Dieser Abschnitt stellt Methoden vor, wie Text und Musik auf andere Weise kombiniert werden können als dies durch @command{lilypond-book} automatisiert geschieht. @menu * Hodně uvozovek v dlouhém notovém zápisu:: * Vložení not LilyPondu do OpenOffice.org:: * Vložení not LilyPondu do jiných programů:: @end menu @node Hodně uvozovek v dlouhém notovém zápisu @unnumberedsubsec Hodně uvozovek v dlouhém notovém zápisu @translationof Many quotes from a large score Wenn aus einer großen Partitur viele kleine Fragmente eingefügt werden sollen, kann dazu das @q{clip systems} Feature benutzt werden. Siehe @ruser{Notationsfragmente extrahieren}. @node Vložení not LilyPondu do OpenOffice.org @unnumberedsubsec Vložení not LilyPondu do OpenOffice.org @translationof Inserting LilyPond output into OpenOffice.org @cindex OpenOffice.org Musik im LilyPond-Format kann in OpenOffice.org eingefügt werden mittels @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}. @node Vložení not LilyPondu do jiných programů @unnumberedsubsec Vložení not LilyPondu do jiných programů @translationof Inserting LilyPond output into other programs Um die Ausgabe von LilyPond in anderen Programmen einzufügen, sollte @code{lilypond} anstelle von @code{lilypond-book} benutzt werden. Jedes Beispiel muss getrennt manuell erzeugt und ins Dokument eingefügt werden; für letzteres schlagen Sie bitte im Handbuch Ihrer Textverarbeitungs-Software nach. Die meisten Programme unterstützen das Einfügen von Grafiken im @file{PNG}-, @file{EPS}- oder @file{PDF}-Format. Um den leeren Rand um die Notenzeilen zu verringern, können folgende Einstellungen benutzt werden: @example \paper@{ indent=0\mm line-width=120\mm oddFooterMarkup=##f oddHeaderMarkup=##f bookTitleMarkup = ##f scoreTitleMarkup = ##f @} @{ c1 @} @end example Eine @file{EPS}-Datei kann mit folgendem Befehl erzeugt werden: @example lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts Dateiname.ly @end example @noindent eine @file{PNG}-Datei mittels: @example lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png Dateiname.ly @end example @node Nezávislé include úryvky @section Nezávislé @code{include} úryvky @translationof independent includes Einige Leute haben große (und nützliche!) Code-Abschnitte geshrieben, die man in vielen Projekten verwenden kann. Dieser Code wird möglicherweise auch eines Tages in LilyPond selbst integriert werden, aber bis dahin müssen Sie ihn selber herunterladen und mit @code{\include} selber einfügen. @menu * Artikulace MIDI:: @end menu @node Artikulace MIDI @subsection Artikulace MIDI @translationof MIDI articulation LilyPond kann benutzt werden, um MIDI-Ausgabe zu erzeugen, etwa um hörend zu korrigieren, was man notiert hat. Jedoch werden nur Dynamik, explizite Tempoänderungen und die Noten und Dauern selber in der MIDI-Datei aufgenommen. Das @emph{articulate}-Projekt ist ein Versuch, mehr Information in eine MIDI-Datei zu kopieren. Es funktioniert, indem man Noten, die sich nicht unter Bögen befinden, verkürzt, um die Noten zu @qq{artikulieren}. Die Stärke der Kürzung hängt von den Aritkulationszeichen ab, die an die Noten gehängt werden: Staccato halbiert den Notwert, Tenuto gibt der Note ihre gesamte Dauer usw. Das Skript kann auch Triller und Doppelschläge in MIDI umwandeln, und man könnte auch andere Ornamente implementieren. @example @uref{http://@/www@/.nicta@/.com@/.au/@/people/@/chubbp/@/articulate} @end example @knownissues Die größte Einschränkung ist, dass man nur die Sachen beeinflussen kann, die man weiß: alles, was nur Textbeschriftung ist (anstelle einer Noteneigenschaft) wird immernoch ignoriert.