1 @c -*- coding: utf-8; mode: texinfo; -*-
4 Translation of GIT committish: 0764a50d470cab82ca29da30298dacd333d3da12
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.
13 @c Translators: Till Paala, Reinhold Kainhofer
15 @node Externe Programme
16 @chapter Externe Programme
17 @translationof External programs
19 LilyPond kann mit anderen Programmen auf verschiedene Weise interagieren.
23 * Unterstützung von Texteditoren::
24 * Von anderen Formaten konvertieren::
25 * LilyPond-Ausgabe in anderen Programmen::
26 * Unabhängige include-Abschnitte::
31 @section Point and click
33 @cindex point and click
35 Point and click erlaubt es, die Noten in der Eingabedatei schnell
36 zu finden, indem man auf sie im PDF-Programm klickt. Das erleichtert
37 es, die Stellen zu finden, die Fehler in der Notation verursachen.
39 Wenn diese Funktionalität aktiv ist, fügt LilyPond Hyperlinks zur
40 PDF-Datei hinzu. Diese Hyperlinks werden an den Webbrowser gesendet,
41 der einen Texteditor mit dem Cursor an der richtigen Stelle öffnet.
43 Damit diese Kettenreaktion funktionieren kann, müssen Sie das
44 PDF-Programm dazu anweisen, Hyperlinks zu folgen, indem das Skript
45 @file{lilypond-invoke-editor}, welches mit LilyPond kommt, verwendet
48 Für Xpdf unter UNIX sollte folgende Zeile in der Datei
49 @file{xpdfrc}@footnote{Unter UNIX findet man diese Datei
50 entweder in @file{/etc/xpdfrc} oder als @file{.xpdfrc} im
51 home-Verzeichnis.} stehen:
54 urlCommand "lilypond-invoke-editor %s"
57 Das Programm @file{lilypond-invoke-editor} ist ein kleines
58 Hilfsprogramm. Es ruft einen Editor für besondere @code{textedit}-URIs#
59 auf und einen Webbrowser für andere. Es testes die Umgebungsvariable
60 @code{EDITOR} nach folgenden Mustern:
66 emacsclient --no-wait +@var{line}:@var{column} @var{file}
71 gvim --remote +:@var{line}:norm@var{column} @var{file}
77 nc -noask +@var{line} @var{file}'
81 Die Umgebungsvariable @code{LYEDITOR} wird benutzt, um dieses Verhalten
82 zu umgehen. Sie enthält die Kommandozeile, mit der der Editor aufgerufen
83 wird, wobei @code{%(file)s}, @code{%(column)s} und @code{%(line)s} mit
84 der Datei, Spalte und Zeile ersetzt wird. Die Einstellung
87 emacsclient --no-wait +%(line)s:%(column)s %(file)s
91 für @code{LYEDITOR} entspricht dem normalen Aufruf von emacsclient.
94 @cindex Dateigröße, PDF
95 @cindex Ausgabedatei, Dateigröße
97 Die point-and-click-Links vergrößern die Größe des PDFs sehr stark.
98 Um die Größe von PDFs und auch PS-Dateien zu verkleinern, kann
99 point and click ausgeschaltet werden, indem man in der Eingabedatei
106 schreibt. Point and click kann explizit aktiviert werden mit dem Befehl
112 Alternativ können Sie point and click auch mit einer Kommandozeilenoption anschalten:
115 lilypond -dno-point-and-click file.ly
118 @warning{Sie sollten immer point and click ausschalten, wenn Sie LilyPond-Dateien
119 verteilen wollen, damit keine Informationen über Ihre Dateistrukturen in den
120 Dateien gespeichert werden, was ein Sicherheitsrisiko darstellen könnte.}
123 @node Unterstützung von Texteditoren
124 @section Unterstützung von Texteditoren
125 @translationof Text editor support
131 @cindex Syntaxhervorhebung
132 @cindex Hervorhebung, Syntax
133 @cindex Syntax highlight
135 Verschiedene Editoren unterstützen LilyPond
144 @unnumberedsubsec Emacs-Modus
145 @translationof Emacs mode
147 Emacs hat einen @file{lilypond-mode}-Modus, der Ergänzung von Befehlen,
148 Einrückung, Syntaxhervorhebung, die Paarung von LilyPond-Klammern,
149 einfache Tastaturkürzel zur Übersetzung und das Lesen von LilyPond-Dokumentation
150 mit Info unterstützt. Wenn @file{lilypond-mode} nicht auf Ihrem Computer
151 installiert ist, siehe unten.
153 Ein Emacs-Modus zur Noteneingabe und zum Kompilieren mit LilyPond bfindet sich
154 in dem Quellarchiv im @file{elisp}-Verzeichnis. Führen Sie @command{make
155 install} aus, damit es nach @var{elispdir} installiert wird. Die Datei
156 @file{lilypond-init.el} sollte in @var{Ladepfad}@file{/site-start.d/} gespeichert
157 werden oder Ihrer @file{~/.emacs} bzw. @file{~/.emacs.el} hinzugefügt werden.
159 Als ein Benutzer können Sie Ihren Quellpfad (z. B. @file{~/site-lisp/})
160 zum @var{Ladepfad} hinzufügen, indem Sie die (veränderte) folgende
161 Zeile in Ihr @file{~/.emacs} kopieren:
163 @c any reason we do not advise: (push "~/site-lisp" load-path)
165 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
170 @unnumberedsubsec Vim-Modus
171 @translationof Vim mode
173 Für @uref{http://@/www@/.vim@/.org,Vim} gibt es ein Dateiartplugin, einen
174 Einzugsmodus und einen Syntaxhervorhebungsmodus für LilyPond. Um alle diese
175 Eigenschaften zu aktivieren, erstellen (oder verändern) Sie die Datei
176 @file{$HOME/.vimrc}, sodass sie folgende Zeilen enthält:
180 set runtimepath+=/usr/local/share/lilypond/current/vim/
185 Wenn LilyPond nicht in @file{/usr/local/} installiert ist, müssen Sie
186 den Pfad anpassen. Das wird besprochen in
187 @rlearning{Mehr Information}.
190 @node Andere Editoren
191 @unnumberedsubsec Andere Editoren
192 @translationof Other editors
194 Andere Editoren (sowohl Texteditoren als auch graphische Editoren) haben
195 Unterstützung für LilyPond, aber ihre besonderen Konfigurationsdateien werden
196 nicht mit LilyPond zusammen verteilt. Lesen Sie die entsprechende Dokumenation
197 zu näheren Fragen. Derartige Editoren finden sich unter @rweb{Leichteres Editieren}.
200 @node Von anderen Formaten konvertieren
201 @section Von anderen Formaten konvertieren
202 @translationof Converting from other formats
204 LilyPond kann auch Musik aus diversen anderen Formaten importieren.
205 Dieses Kapitel beschreibt die dazu mit LilyPond mitgelieferten
206 Hilfsprogramme. Daneben existieren natürlich auch noch weitere
207 Programme, die Dateien für LilyPond erstellen können, wie etwa
208 graphische Sequenzierprogramme und XML-Konverter. Näheres dazu
209 findet sich auf der @uref{http://@/lilypond@/.org,Homepage} von LilyPond.
211 Die im Folgenden beschriebenen Programme sind eigenständige Hilfsprogramme
212 und werden üblicherweise von der Kommandozeile aufgerufen. Siehe
213 @ref{Benutzung auf der Kommandozeile} für weitere Informationen. Wenn Sie MacOS
214 10.3 oder 10.4 benutzen und Probleme mit diesen Skripten (z. B.
215 @code{convert-ly}) haben, lesen Sie @rweb{MacOS X}.
218 Leider haben wir nicht ausreichend viele Entwickler, um all die folgenden
219 Hilfsprogramme ständig zu warten. Wir stellen den aktuellen Stand zur
220 Verfügung, können aber leider Fehlerberichte nur selten bearbeiten.
221 Selbstverständlich sind Patches von Ihnen sehr willkommen!
225 * midi2ly aufrufen:: Import von MIDI.
226 * muscxml2ly aufrufen:: Import von MusicXML.
227 * abc2ly aufrufen:: Import von ABC.
228 * etf2ly aufrufen:: Import von (alten) Finale-Dateien.
232 @node midi2ly aufrufen
233 @subsection @command{midi2ly} aufrufen
234 @translationof Invoking midi2ly
238 @command{midi2ly} übersetzt eine Typ@tie{}1 MIDI-Datei in eine
239 Eingabedatei für LilyPond.
241 MIDI (Music Instrument Digital Interface) ist ein internationaler
242 Standard für digitale Instrumente: Es spezifiziert die Verkabelung,
243 ein serielles Protokoll und ein Dateiformat. Das MIDI-Dateiformat
244 ist der de-facto Standard um Musik von vielen Programmen zu exportieren.
245 Allerdings fehlen in den MIDI-Dateien viele Ausdrucks- und
246 Artikulationszeichen. Dennoch kann MIDI vielfach nützlich sein,
247 um Musik von einem Programm zu importieren, für das kein spezielles
248 Hilfsprogramm den direkten Import nach LilyPond unterstützt.
250 @command{midi2ly} konvertiert die MIDI-Spuren nach @rinternals{Staff} und
251 MIDI-Kanäle in @rinternals{Voice} Kontexte. Tonhöhen werden relativ
252 angegeben, Tondauern nur wenn nötig.
254 MIDI-Dateien können auch direkt von einem digitalen Keyboard
255 aufgenommen und dann in eine @file{.ly}-Datei konvertiert werden.
256 Allerdings sind Musikinterpretationen von Menschen (aus gutem Grund!)
257 rhythmisch nicht exakt genug um die Konvertierung von MIDI nach LY
258 trivial zu gestalten. Wenn @command{midi2ly} mit Quantisierung
259 (@code{-s} und @code{-d} Kommandozeilenoptionen) aufgerufen wird,
260 versucht es diese Unschärfen im Zeitablauf zu korrigieren, ist
261 allerdings nicht sonderlich gut darin. Daher können wir diese Technik
262 leider nicht für die Konvertierung von MIDI-Aufnahmen empfehlen.
265 @command{midi2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
267 midi2ly [@var{Optionen}]@dots{} @var{MIDI-Datei}
270 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
271 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
272 @ref{Von anderen Formaten konvertieren}.
274 Die folgenden Kommandozeilenoptionen werden von @command{midi2ly}
278 @item -a, --absolute-pitches
279 Gibt absolute Tonhöhen aus.
281 @item -d, --duration-quant=@var{LÄNGE}
282 Quantisiert Tondauern zu Vielfachen von @var{LÄNGE}.
284 @item -e, --explicit-durations
285 Gibt alle Tondauern explizit an.
288 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
290 @item -k, --key=@var{acc}[:@var{Moll}]
291 Setzt die Standard-Tonart. @math{@var{acc} > 0} gibt die Anzahl der
292 Kreuze an, @math{@var{acc} < 0} gibt die Anzahl der Bs der Tonart an.
293 Eine Moll-Tonart wird durch @code{:1} angegeben.
295 @item -o, --output=@var{Datei}
296 Die Ausgabe wird in die Datei @var{Datei}@file{.ly} geschrieben.
298 @item -s, --start-quant=@var{LÄNGE}
299 Quantisiert den Beginn der Noten zu Vielfachen von @var{LÄNGE}.
301 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
302 Erlaubt Tuplet-Dauern der Form @var{DUR}*@var{NUM}/@var{DEN}.
305 Gibt ausführliche informative Meldungen während der Konvertierung aus.
308 Gibt die Versionsnummer aus.
311 Zeigt die Lizenzbedingungen und Urheberrechtshinweise.
313 @item -x, --text-lyrics
314 Interpretiert alle Texte als Liedtexte.
320 Überlappende Noten in einem Arpeggio werden nicht korrekt dargestellt.
321 Nur die erste Note wird eingelesen und konvertiert, die restlichen
322 werden ignoriert. Als Abhilfe können Sie alle Noten auf dieselbe
323 Tonlänge setzen und Phrasierungszeichen oder Pedalindikatoren
327 @node muscxml2ly aufrufen
328 @subsection @command{muscxml2ly} aufrufen
329 @translationof Invoking musicxml2ly
333 @uref{http://@/www.@/musicxml@/.org/,MusicXML} ist ein XML-Dialekt
334 zur Darstellung von Musiknotation.
336 @command{musicxml2ly} wandelt eine MusicXML-Datei nach LilyPond um,
337 wobei sowohl die Noten, Artikulationszeichen, Struktur der Partitur,
338 Liedtexte etc. einer MusicXML-Datei (im @q{part-wise}-Format) in eine
341 @command{musicxml2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
343 musicxml2ly [@var{Optionen}]@dots{} @var{XML-Datei}
346 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
347 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
348 @ref{Von anderen Formaten konvertieren}.
350 Wenn als Dateiname @file{-} angegeben wird, liest @command{musicxml2ly}
351 Daten direkt von der Kommandozeile ein.
353 Die folgenden Kommandozeilenoptionen werden von @command{musicxml2ly}
358 Konvertiert in absolute Tonhöhen.
361 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
363 @item -l, --language=SPRACHE
364 Benutzt SPRACHE für die Notenbezeichnungen, etwa "deutsch" für deutsche
368 Benutzt das lxml.etree Python-Paket für die Verarbeitung von XML (benötigt weniger Speicher und Rechenleistung)
370 @item --nd --no-articulation-directions
371 Konvertiert keine Richtungsangaben (@code{^}, @code{_} oder @code{-})
372 von Artikulations- und Lautstärkebezeichnungen.
375 Konvertiert keine Informationen über die Balkensetzung aus der
376 MusicXML-Datei. Stattdessen wird dies LilyPond überlassen.
378 @item -o,--output=@var{Dateiname}
379 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben. Wird
380 als @var{Dateiname} nur @file{-} angegeben, wird das Ergebnis der Konvertierung
381 an der Kommandozeile ausgegeben. Wird diese Option nicht angegeben, so
382 erfolgt die Ausgabe in die Datei @var{XML-Datei}@file{.ly}.
385 Konvertiert in relative Tonhöhen. (Standardeinstellung)
388 Gibt ausführliche informative Meldungen während der Konvertierung aus.
391 Gibt die Versionsnummer aus.
393 @item -z,--compressed
394 Die Eingabedatei wird als komprimierte MusicXML-Datei eingelesen.
395 Dies ist die Standardeinstellung für Dateien mit der Erweiterung
400 @node abc2ly aufrufen
401 @subsection @command{abc2ly} aufrufen
402 @translationof Invoking abc2ly
404 @warning{Dieses Programm ist nicht unterstützt und kann aus kommenden
405 LilyPond-Versionen entfernt werden.}
409 ABC ist ein relativ einfaches ASCII-basierendes Musikformat und ist
410 dokumentiert auf der ABC-Homepage:
413 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
416 @command{abc2ly} konvertiert ABC-Dateien nach LilyPond und wird
417 von der Kommandozeile folgendermaßen aufgerufen:
420 abc2ly [@var{Optionen}]@dots{} @var{ABC-Datei}
423 Die folgenden Kommandozeilenoptionen werden von @command{abc2ly}
427 @item -b,--beams=None
428 Die Balkensetzung aus der ABC-Datei erhalten.
430 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
431 @item -o,--output=@var{Dateiname}
432 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
434 Strenge Auslegung einer erfolgreichen Konvertierung.
436 Gibt die Versionsnummer aus.
439 Es existiert außerdem die Möglichkeit, LilyPond-Befehle für die
440 Konvertierung mit @command{abc2ly} gleich in der ABC-Datei anzugeben.
441 Wenn sich etwa in der ABC-Datei das Kommentar
444 %%LY voices \set autoBeaming = ##f
448 befindet, so wird der Text nach dem Schlüsselwort @q{voices} direkt
449 in die aktuelle Stimme in der LilyPond-Datei eingefügt.
454 %%LY slyrics more words
458 dass alles nach dem @q{slyrics} Schlüsselwort an der aktuellen Stelle
459 im Liedtext eingefügt wird. Gleichermaßen wird mit
462 %%LY slyrics more words
466 der Text, der auf das @qq{slylrics}-Schlüsselwort folgt, in die aktuelle
467 Gesangstextzeile eingefügt.
472 Der ABC-Standard ist eigentlich kein wirklich vollständiger Standard.
473 Für komplexere Notation wie etwa Polyphonie existieren verschiedene
476 Mehrere Lieder in einer Datei können nicht konvertiert werden.
478 ABC synchronisiert den Liedtext am Anfang jeder Zeile mit den Noten,
479 @command{abc2ly} macht dies nicht.
481 @command{abc2ly} ignoriert die Balkensetzung in der ABC-Datei.
484 @node etf2ly aufrufen
485 @subsection @command{etf2ly} aufrufen
486 @translationof Invoking etf2ly
488 @warning{Dieses Programm ist nicht unterstützt und kann in kommenden
489 LilyPond-Versionen entfernt werden.}
494 @cindex Coda Technology
496 ETF (Enigma Transport Format) ist ein Dateiformat, das Coda
497 Music Technology in älteren Versionen des Programms Finale benutzt hat.
499 @command{etf2ly} konvertiert Teile einer ETF-Datei nach LilyPond
500 und wird von der Kommandozeile folgendermaßen aufgerufen:
503 etf2ly [@var{Optionen}]@dots{} @var{ETF-Datei}
506 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
507 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
508 @ref{Von anderen Formaten konvertieren}.
510 Die folgenden Kommandozeilenoptionen werden von @command{etf2ly}
515 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
516 @item -o,--output=@var{Dateiname}
517 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
519 Gibt die Versionsnummer aus.
525 Die Liste der Artikulationszeichen is unvollständig. Leere Takte
526 verwirren @command{etf2ly}. Mehrfache Vorschlagnoten werden falsch
531 @subsection Andere Formate
532 @translationof Other formats
534 @cindex Externe Programme, LilyPond-Dateien erstellen
536 LilyPond kommt nicht mit der Unterstützung für andere Formate, aber einige
537 externe Programme können auch LilyPond-Dateien erstellen. Diese finden
538 sich unter @rweb{Leichteres Editieren}.
542 @node LilyPond-Ausgabe in anderen Programmen
543 @section LilyPond-Ausgabe in anderen Programmen
544 @translationof LilyPond output in other programs
546 Dieser Abschnitt stellt Methoden vor, wie Text und Musik auf andere
547 Weise kombiniert werden können als dies durch @command{lilypond-book}
548 automatisiert geschieht.
552 * Viele Zitate aus einer langen Partitur::
553 * LilyPond-Noten in OpenOffice.org integrieren::
554 * LilyPond-Noten in andere Programme integrieren::
557 @node Viele Zitate aus einer langen Partitur
558 @subsection Viele Zitate aus einer langen Partitur
559 @translationof Many quotes from a large score
561 Wenn aus einer großen Partitur viele kleine Fragmente eingefügt
562 werden sollen, kann dazu das @q{clip systems} Feature benutzt werden.
563 Siehe @ruser{Notationsfragmente extrahieren}.
566 @node LilyPond-Noten in OpenOffice.org integrieren
567 @subsection LilyPond-Noten in OpenOffice.org integrieren
568 @translationof Inserting LilyPond output into OpenOffice.org
570 @cindex OpenOffice.org
572 Musik im LilyPond-Format kann in OpenOffice.org eingefügt werden mittels
573 @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
576 @node LilyPond-Noten in andere Programme integrieren
577 @subsection LilyPond-Noten in andere Programme integrieren
578 @translationof Inserting LilyPond output into other programs
580 Um die Ausgabe von LilyPond in anderen Programmen einzufügen,
581 sollte @code{lilypond} anstelle von @code{lilypond-book}
582 benutzt werden. Jedes Beispiel muss
583 getrennt manuell erzeugt und ins Dokument eingefügt werden;
584 für letzteres schlagen Sie bitte im Handbuch Ihrer
585 Textverarbeitungs-Software nach. Die meisten Programme
586 unterstützen das Einfügen von Grafiken im @file{PNG}-, @file{EPS}-
587 oder @file{PDF}-Format.
589 Um den leeren Rand um die Notenzeilen zu verringern, können folgende
590 Einstellungen benutzt werden:
598 bookTitleMarkup = ##f
599 scoreTitleMarkup = ##f
605 Eine @file{EPS}-Datei kann mit folgendem Befehl erzeugt werden:
608 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts Dateiname.ly
612 eine @file{PNG}-Datei mittels:
615 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png Dateiname.ly
619 @node Unabhängige include-Abschnitte
620 @section Unabhängige @code{include}-Abschnitte
621 @translationof independent includes
623 Einige Leute haben große (und nützliche!) Code-Abschnitte geshrieben,
624 die man in vielen Projekten verwenden kann. Dieser Code wird möglicherweise
625 auch eines Tages in LilyPond selbst integriert werden, aber bis dahin
626 müssen Sie ihn selber herunterladen und mit @code{\include} selber
631 * MIDI-Artikulation::
635 @node MIDI-Artikulation
636 @subsection MIDI-Artikulation
637 @translationof MIDI articulation
639 LilyPond kann benutzt werden, um MIDI-Ausgabe zu erzeugen, etwa
640 um hörend zu korrigieren, was man notiert hat. Jedoch werden nur
641 Dynamik, explizite Tempoänderungen und die Noten und Dauern selber
642 in der MIDI-Datei aufgenommen.
644 Das @emph{articulate}-Projekt ist ein Versuch, mehr Information
645 in eine MIDI-Datei zu kopieren. Es funktioniert, indem man Noten,
646 die sich nicht unter Bögen befinden, verkürzt, um die Noten
647 zu @qq{artikulieren}. Die Stärke der Kürzung hängt von den
648 Aritkulationszeichen ab, die an die Noten gehängt werden:
649 Staccato halbiert den Notwert, Tenuto gibt der Note ihre gesamte Dauer
650 usw. Das Skript kann auch Triller und Doppelschläge in MIDI umwandeln,
651 und man könnte auch andere Ornamente implementieren.
654 @uref{http://@/www@/.nicta@/.com@/.au/@/people/@/chubbp/@/articulate}
659 Die größte Einschränkung ist, dass man nur die Sachen beeinflussen kann,
660 die man weiß: alles, was nur Textbeschriftung ist (anstelle einer Noteneigenschaft)
661 wird immernoch ignoriert.