1 @c -*- coding: utf-8; mode: texinfo; -*-
4 Translation of GIT committish: 4f7427e7a314a71bde16559247885544256b8213
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 @chapter 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 @section @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 @section @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=LANG
364 Inkludiert die Sprachdatei @var{LANG}@file{.ly} in der Ausgabe. Wird z.B.
365 'deutsch' angegeben, wird @file{deutsch.ly} in die .ly-Datei eingebunden
366 und deutsche Notenbezeichnungen benutzt.
369 Benutzt das lxml.etree Python-Paket für die Verarbeitung von XML (benötigt weniger Speicher und Rechenleistung)
371 @item --nd --no-articulation-directions
372 Konvertiert keine Richtungsangaben (@code{^}, @code{_} oder @code{-})
373 von Artikulations- und Lautstärkebezeichnungen.
376 Konvertiert keine Informationen über die Balkensetzung aus der
377 MusicXML-Datei. Stattdessen wird dies LilyPond überlassen.
379 @item -o,--output=@var{Dateiname}
380 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben. Wird
381 als @var{Dateiname} nur @file{-} angegeben, wird das Ergebnis der Konvertierung
382 an der Kommandozeile ausgegeben. Wird diese Option nicht angegeben, so
383 erfolgt die Ausgabe in die Datei @var{XML-Datei}@file{.ly}.
386 Konvertiert in relative Tonhöhen. (Standardeinstellung)
389 Gibt ausführliche informative Meldungen während der Konvertierung aus.
392 Gibt die Versionsnummer aus.
394 @item -z,--compressed
395 Die Eingabedatei wird als komprimierte MusicXML-Datei eingelesen.
396 Dies ist die Standardeinstellung für Dateien mit der Erweiterung
401 @node abc2ly aufrufen
402 @section @command{abc2ly} aufrufen
403 @translationof Invoking abc2ly
405 @warning{Dieses Programm ist nicht unterstützt und kann aus kommenden
406 LilyPond-Versionen entfernt werden.}
410 ABC ist ein relativ einfaches ASCII-basierendes Musikformat und ist
411 dokumentiert auf der ABC-Homepage:
414 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
417 @command{abc2ly} konvertiert ABC-Dateien nach LilyPond und wird
418 von der Kommandozeile folgendermaßen aufgerufen:
421 abc2ly [@var{Optionen}]@dots{} @var{ABC-Datei}
424 Die folgenden Kommandozeilenoptionen werden von @command{abc2ly}
428 @item -b,--beams=None
429 Die Balkensetzung aus der ABC-Datei erhalten.
431 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
432 @item -o,--output=@var{Dateiname}
433 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
435 Strenge Auslegung einer erfolgreichen Konvertierung.
437 Gibt die Versionsnummer aus.
440 Es existiert außerdem die Möglichkeit, LilyPond-Befehle für die
441 Konvertierung mit @command{abc2ly} gleich in der ABC-Datei anzugeben.
442 Wenn sich etwa in der ABC-Datei das Kommentar
445 %%LY voices \set autoBeaming = ##f
449 befindet, so wird der Text nach dem Schlüsselwort @q{voices} direkt
450 in die aktuelle Stimme in der LilyPond-Datei eingefügt.
455 %%LY slyrics more words
459 dass alles nach dem @q{slyrics} Schlüsselwort an der aktuellen Stelle
460 im Liedtext eingefügt wird. Gleichermaßen wird mit
463 %%LY slyrics more words
467 der Text, der auf das @qq{slylrics}-Schlüsselwort folgt, in die aktuelle
468 Gesangstextzeile eingefügt.
473 Der ABC-Standard ist eigentlich kein wirklich vollständiger Standard.
474 Für komplexere Notation wie etwa Polyphonie existieren verschiedene
477 Mehrere Lieder in einer Datei können nicht konvertiert werden.
479 ABC synchronisiert den Liedtext am Anfang jeder Zeile mit den Noten,
480 @command{abc2ly} macht dies nicht.
482 @command{abc2ly} ignoriert die Balkensetzung in der ABC-Datei.
485 @node etf2ly aufrufen
486 @section @command{etf2ly} aufrufen
487 @translationof Invoking etf2ly
489 @warning{Dieses Programm ist nicht unterstützt und kann in kommenden
490 LilyPond-Versionen entfernt werden.}
495 @cindex Coda Technology
497 ETF (Enigma Transport Format) ist ein Dateiformat, das Coda
498 Music Technology in älteren Versionen des Programms Finale benutzt hat.
500 @command{etf2ly} konvertiert Teile einer ETF-Datei nach LilyPond
501 und wird von der Kommandozeile folgendermaßen aufgerufen:
504 etf2ly [@var{Optionen}]@dots{} @var{ETF-Datei}
507 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
508 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
509 @ref{Von anderen Formaten konvertieren}.
511 Die folgenden Kommandozeilenoptionen werden von @command{etf2ly}
516 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
517 @item -o,--output=@var{Dateiname}
518 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
520 Gibt die Versionsnummer aus.
526 Die Liste der Artikulationszeichen is unvollständig. Leere Takte
527 verwirren @command{etf2ly}. Mehrfache Vorschlagnoten werden falsch
532 @subsection Andere Formate
533 @translationof Other formats
535 @cindex Externe Programme, LilyPond-Dateien erstellen
537 LilyPond kommt nicht mit der Unterstützung für andere Formate, aber einige
538 externe Programme können auch LilyPond-Dateien erstellen. Diese finden
539 sich unter @rweb{Leichteres Editieren}.
543 @node LilyPond-Ausgabe in anderen Programmen
544 @section LilyPond-Ausgabe in anderen Programmen
545 @translationof LilyPond output in other programs
547 Dieser Abschnitt stellt Methoden vor, wie Text und Musik auf andere
548 Weise kombiniert werden können als dies durch @command{lilypond-book}
549 automatisiert geschieht.
553 * Viele Zitate aus einer langen Partitur::
554 * LilyPond-Noten in OpenOffice.org integrieren::
555 * LilyPond-Noten in andere Programme integrieren::
558 @node Viele Zitate aus einer langen Partitur
559 @subsection Viele Zitate aus einer langen Partitur
560 @translationof Many quotes from a large score
562 Wenn aus einer großen Partitur viele kleine Fragmente eingefügt
563 werden sollen, kann dazu das @q{clip systems} Feature benutzt werden.
564 Siehe @ruser{Notationsfragmente extrahieren}.
567 @node LilyPond-Noten in OpenOffice.org integrieren
568 @subsection LilyPond-Noten in OpenOffice.org integrieren
569 @translationof Inserting LilyPond output into OpenOffice.org
571 @cindex OpenOffice.org
573 Musik im LilyPond-Format kann in OpenOffice.org eingefügt werden mittels
574 @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
577 @node LilyPond-Noten in andere Programme integrieren
578 @subsection LilyPond-Noten in andere Programme integrieren
579 @translationof Inserting LilyPond output into other programs
581 Um die Ausgabe von LilyPond in anderen Programmen einzufügen,
582 sollte @code{lilypond} anstelle von @code{lilypond-book}
583 benutzt werden. Jedes Beispiel muss
584 getrennt manuell erzeugt und ins Dokument eingefügt werden;
585 für letzteres schlagen Sie bitte im Handbuch Ihrer
586 Textverarbeitungs-Software nach. Die meisten Programme
587 unterstützen das Einfügen von Grafiken im @file{PNG}-, @file{EPS}-
588 oder @file{PDF}-Format.
590 Um den leeren Rand um die Notenzeilen zu verringern, können folgende
591 Einstellungen benutzt werden:
599 bookTitleMarkup = ##f
600 scoreTitleMarkup = ##f
606 Eine @file{EPS}-Datei kann mit folgendem Befehl erzeugt werden:
609 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts Dateiname.ly
613 eine @file{PNG}-Datei mittels:
616 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png Dateiname.ly
620 @node Unabhängige include-Abschnitte
621 @section Unabhängige @code{include}-Abschnitte
622 @translationof independent includes
624 Einige Leute haben große (und nützliche!) Code-Abschnitte geshrieben,
625 die man in vielen Projekten verwenden kann. Dieser Code wird möglicherweise
626 auch eines Tages in LilyPond selbst integriert werden, aber bis dahin
627 müssen Sie ihn selber herunterladen und mit @code{\include} selber
632 * MIDI-Artikulation::
636 @node MIDI-Artikulation
637 @subsection MIDI-Artikulation
638 @translationof MIDI articulation
640 LilyPond kann benutzt werden, um MIDI-Ausgabe zu erzeugen, etwa
641 um hörend zu korrigieren, was man notiert hat. Jedoch werden nur
642 Dynamik, explizite Tempoänderungen und die Noten und Dauern selber
643 in der MIDI-Datei aufgenommen.
645 Das @emph{articulate}-Projekt ist ein Versuch, mehr Information
646 in eine MIDI-Datei zu kopieren. Es funktioniert, indem man Noten,
647 die sich nicht unter Bögen befinden, verkürzt, um die Noten
648 zu @qq{artikulieren}. Die Stärke der Kürzung hängt von den
649 Aritkulationszeichen ab, die an die Noten gehängt werden:
650 Staccato halbiert den Notwert, Tenuto gibt der Note ihre gesamte Dauer
651 usw. Das Skript kann auch Triller und Doppelschläge in MIDI umwandeln,
652 und man könnte auch andere Ornamente implementieren.
655 @uref{http://@/www@/.nicta@/.com@/.au/@/people/@/chubbp/@/articulate}
660 Die größte Einschränkung ist, dass man nur die Sachen beeinflussen kann,
661 die man weiß: alles, was nur Textbeschriftung ist (anstelle einer Noteneigenschaft)
662 wird immernoch ignoriert.