Documentation/de/usage/external.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
   2
   3 @ignore
   4     Translation of GIT committish: e5a609e373eae846857f9a6d70a402a3d42b7d94
   5
   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.
   9 @end ignore
  10
  11 @c \version "2.19.21"
  12
  13 @c Translators: Till Paala, Reinhold Kainhofer
  14
  15 @node Externe Programme
  16 @chapter Externe Programme
  17 @translationof External programs
  18
  19 LilyPond kann mit anderen Programmen auf verschiedene Weise interagieren.
  20
  21 @menu
  22 * Point and click::
  23 * Unterstützung von Texteditoren::
  24 * Von anderen Formaten konvertieren::
  25 * LilyPond-Ausgabe in anderen Programmen::
  26 * Unabhängige include-Abschnitte::
  27 @end menu
  28
  29
  30 @node Point and click
  31 @section Point and click
  32
  33 Poind and click fügt Verlinkung für bestimmte Notationselemente
  34 in die PDF-Dokumente ein.
  35
  36 @menu
  37 * Point and click aktivieren::
  38 * Selektives point-and-click::
  39 @end menu
  40
  41 @node Point and click aktivieren
  42 @unnumberedsubsec Point and click aktivieren
  43 @translationof Enabling point and click
  44
  45 @cindex point and click
  46
  47 Point and click erlaubt es, die Noten in der Eingabedatei schnell
  48 zu finden, indem man auf sie im PDF-Programm klickt.  Das erleichtert
  49 es, die Stellen zu finden, die Fehler in der Notation verursachen.
  50
  51 Wenn diese Funktionalität aktiv ist, fügt LilyPond Hyperlinks zur
  52 PDF-Datei hinzu.  Diese Hyperlinks werden an den Webbrowser gesendet,
  53 der einen Texteditor mit dem Cursor an der richtigen Stelle öffnet.
  54
  55 Damit diese Kettenreaktion funktionieren kann, müssen Sie das
  56 PDF-Programm dazu anweisen, Hyperlinks zu folgen, indem das Skript
  57 @file{lilypond-invoke-editor}, welches mit LilyPond kommt, verwendet
  58 wird.
  59
  60 Für Xpdf unter UNIX sollte folgende Zeile in der Datei
  61 @file{xpdfrc}. Unter UNIX findet man diese Datei
  62 entweder in @file{/etc/xpdfrc} oder als @file{$HOME/.xpdfrc}:
  63
  64 @example
  65 urlCommand     "lilypond-invoke-editor %s"
  66 @end example
  67
  68 Das Programm @file{lilypond-invoke-editor} ist ein kleines
  69 Hilfsprogramm.  Es ruft einen Editor für besondere @code{textedit}-URIs#
  70 auf und einen Webbrowser für andere.  Es testes die Umgebungsvariable
  71 @code{EDITOR} nach folgenden Mustern:
  72
  73 @table @code
  74 @item emacs
  75   das ruft auf
  76 @example
  77 emacsclient --no-wait +@var{line}:@var{column} @var{file}
  78 @end example
  79 @item gvim
  80   das ruft auf
  81 @example
  82 gvim --remote +:@var{line}:norm@var{column} @var{file}
  83 @end example
  84
  85 @item nedit
  86   das ruft auf
  87 @example
  88   nc -noask +@var{line} @var{file}'
  89 @end example
  90 @end table
  91
  92 Die Umgebungsvariable @code{LYEDITOR} wird benutzt, um dieses Verhalten
  93 zu umgehen.  Sie enthält die Kommandozeile, mit der der Editor aufgerufen
  94 wird, wobei @code{%(file)s}, @code{%(column)s} und @code{%(line)s} mit
  95 der Datei, Spalte und Zeile ersetzt wird.  Die Einstellung
  96
  97 @example
  98 emacsclient --no-wait +%(line)s:%(column)s %(file)s
  99 @end example
 100
 101 @noindent
 102 für @code{LYEDITOR} entspricht dem normalen Aufruf von emacsclient.
 103
 104
 105 @cindex Dateigröße, PDF
 106 @cindex Ausgabedatei, Dateigröße
 107
 108 Die point-and-click-Links vergrößern die Größe des PDFs sehr stark.
 109 Um die Größe von PDFs und auch PS-Dateien zu verkleinern, kann
 110 point and click ausgeschaltet werden, indem man in der Eingabedatei
 111
 112 @example
 113 \pointAndClickOff
 114 @end example
 115
 116 @noindent
 117 schreibt.  Point and click kann explizit aktiviert werden mit dem Befehl
 118
 119 @example
 120 \pointAndClickOn
 121 @end example
 122
 123 Alternativ können Sie point and click auch mit einer Kommandozeilenoption anschalten:
 124
 125 @example
 126 lilypond -dno-point-and-click file.ly
 127 @end example
 128
 129 @warning{Sie sollten immer point and click ausschalten, wenn Sie LilyPond-Dateien
 130 verteilen wollen, damit keine Informationen über Ihre Dateistrukturen in den
 131 Dateien gespeichert werden, was ein Sicherheitsrisiko darstellen könnte.}
 132
 133
 134 @node Selektives point-and-click
 135 @unnumberedsubsec Selektives point-and-click
 136 @translationof Selective point-and-click
 137
 138 Für einige interaktive Anwendungen kann es von Vorteil sein, nur
 139 einige Elemente mit Point and click zu aktivieren.  Wenn man
 140 beispielsweise eine Anwendung erstellen will, die Audio oder Video
 141 beginnend von einer angeklickten Note abspielt, würde es unpraktisch
 142 sein, wenn die Point-and-click-Zeiger Information eines Bogens oder
 143 Versetzungszeichen, die gleichzeitig mit der Note erscheinen,
 144 darstellen würden.
 145
 146 Man kann dieses Verhalten erreichen, indem man angibt, welche
 147 Ereignisse aufgenommen werden sollen:
 148
 149 @itemize
 150 @item
 151 Direkt in der @file{.ly}-Datei:
 152
 153 @example
 154 \pointAndClickTypes #'note-event
 155 \relative @{
 156   c'2\f( f)
 157 @}
 158 @end example
 159
 160 oder
 161
 162 @example
 163 #(ly:set-option 'point-and-click 'note-event)
 164 \relative @{
 165   c'2\f( f)
 166 @}
 167 @end example
 168
 169 @item
 170 Auf der Kommandozeile:
 171
 172 @example
 173 lilypond -dpoint-and-click=note-event   example.ly
 174 @end example
 175
 176 @end itemize
 177
 178 Auch mehrere Ereignisse können eingebunden werden:
 179
 180 @itemize
 181 @item
 182 Direkt in der @file{.ly}-Datei:
 183
 184 @example
 185 \pointAndClickTypes #'(note-event dynamic-event)
 186 \relative @{
 187   c'2\f( f)
 188 @}
 189 @end example
 190
 191 oder
 192
 193 @example
 194 #(ly:set-option 'point-and-click '(note-event dynamic-event))
 195 \relative @{
 196   c'2\f( f)
 197 @}
 198 @end example
 199
 200 @item
 201 Auf der Kommandozeile:
 202
 203 @smallexample
 204 lilypond \
 205   -e"(ly:set-option 'point-and-click '(note-event dynamic-event))" \
 206   example.ly
 207 @end smallexample
 208
 209 @end itemize
 210
 211
 212 @node Unterstützung von Texteditoren
 213 @section Unterstützung von Texteditoren
 214 @translationof Text editor support
 215
 216 @cindex Editoren
 217 @cindex vim
 218 @cindex emacs
 219 @cindex Modi, Editor
 220 @cindex Syntaxhervorhebung
 221 @cindex Hervorhebung, Syntax
 222 @cindex Syntax highlight
 223
 224 Verschiedene Editoren unterstützen LilyPond
 225
 226 @menu
 227 * Emacs-Modus::
 228 * Vim-Modus::
 229 * Andere Editoren::
 230 @end menu
 231
 232 @node Emacs-Modus
 233 @unnumberedsubsec Emacs-Modus
 234 @translationof Emacs mode
 235
 236 Emacs hat einen @file{lilypond-mode}-Modus, der Ergänzung von Befehlen,
 237 Einrückung, Syntaxhervorhebung, die Paarung von LilyPond-Klammern,
 238 einfache Tastaturkürzel zur Übersetzung und das Lesen von LilyPond-Dokumentation
 239 mit Info unterstützt.  Wenn @file{lilypond-mode} nicht auf Ihrem Computer
 240 installiert ist, siehe unten.
 241
 242 Ein Emacs-Modus zur Noteneingabe und zum Kompilieren mit LilyPond bfindet sich
 243 in dem Quellarchiv im @file{elisp}-Verzeichnis.  Führen Sie @command{make
 244 install} aus, damit es nach @var{elispdir} installiert wird.  Die Datei
 245 @file{lilypond-init.el} sollte in @var{Ladepfad}@file{/site-start.d/} gespeichert
 246 werden oder Ihrer @file{~/.emacs} bzw. @file{~/.emacs.el} hinzugefügt werden.
 247
 248 Als ein Benutzer können Sie Ihren Quellpfad (z. B. @file{~/site-lisp/})
 249 zum @var{Ladepfad} hinzufügen, indem Sie die (veränderte) folgende
 250 Zeile in Ihr @file{~/.emacs} kopieren:
 251
 252 @c any reason we do not advise:  (push "~/site-lisp" load-path)
 253 @example
 254 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
 255 @end example
 256
 257
 258 @node Vim-Modus
 259 @unnumberedsubsec Vim-Modus
 260 @translationof Vim mode
 261
 262 Für @uref{http://@/www@/.vim@/.org,Vim} gibt es ein Dateiartplugin, einen
 263 Einzugsmodus und einen Syntaxhervorhebungsmodus für LilyPond.  Um alle diese
 264 Eigenschaften zu aktivieren, erstellen (oder verändern) Sie die Datei
 265 @file{$HOME/.vimrc}, sodass sie folgende Zeilen enthält:
 266
 267 @example
 268 filetype off
 269 set runtimepath+=/usr/local/share/lilypond/current/vim/
 270 filetype on
 271 @end example
 272
 273 @noindent
 274 Wenn LilyPond nicht in @file{/usr/local/} installiert ist, müssen Sie
 275 den Pfad anpassen.  Das wird besprochen in
 276 @rlearning{Mehr Information}.
 277
 278
 279 @node Andere Editoren
 280 @unnumberedsubsec Andere Editoren
 281 @translationof Other editors
 282
 283 Andere Editoren (sowohl Texteditoren als auch graphische Editoren) haben
 284 Unterstützung für LilyPond, aber ihre besonderen Konfigurationsdateien werden
 285 nicht mit LilyPond zusammen verteilt.  Lesen Sie die entsprechende Dokumenation
 286 zu näheren Fragen.  Derartige Editoren finden sich unter @rweb{Leichteres Editieren}.
 287
 288
 289 @node Von anderen Formaten konvertieren
 290 @section Von anderen Formaten konvertieren
 291 @translationof Converting from other formats
 292
 293 LilyPond kann auch Musik aus diversen anderen Formaten importieren.
 294 Dieses Kapitel beschreibt die dazu mit LilyPond mitgelieferten
 295 Hilfsprogramme. Daneben existieren natürlich auch noch weitere
 296 Programme, die Dateien für LilyPond erstellen können, wie etwa
 297 graphische Sequenzierprogramme und XML-Konverter. Näheres dazu
 298 findet sich auf der @uref{http://@/lilypond@/.org,Homepage} von LilyPond.
 299
 300 Die im Folgenden beschriebenen Programme sind eigenständige Hilfsprogramme
 301 und werden üblicherweise von der Kommandozeile aufgerufen. Siehe
 302 @ref{Benutzung auf der Kommandozeile} für weitere Informationen.  Wenn Sie MacOS
 303 10.3 oder 10.4 benutzen und Probleme mit diesen Skripten (z. B.
 304 @code{convert-ly}) haben, lesen Sie @rweb{MacOS X}.
 305
 306 @knownissues
 307 Leider haben wir nicht ausreichend viele Entwickler, um all die folgenden
 308 Hilfsprogramme ständig zu warten. Wir stellen den aktuellen Stand zur
 309 Verfügung, können aber leider Fehlerberichte nur selten bearbeiten.
 310 Selbstverständlich sind Patches von Ihnen sehr willkommen!
 311
 312
 313 @menu
 314 * midi2ly aufrufen::          Import von MIDI.
 315 * musicxml2ly aufrufen::       Import von MusicXML.
 316 * abc2ly aufrufen::           Import von ABC.
 317 * etf2ly aufrufen::           Import von (alten) Finale-Dateien.
 318 * Andere Formate::
 319 @end menu
 320
 321 @node midi2ly aufrufen
 322 @subsection @command{midi2ly} aufrufen
 323 @translationof Invoking midi2ly
 324
 325 @cindex MIDI
 326
 327 @command{midi2ly} übersetzt eine Typ@tie{}1 MIDI-Datei in eine
 328 Eingabedatei für LilyPond.
 329
 330 MIDI (Music Instrument Digital Interface) ist ein internationaler
 331 Standard für digitale Instrumente: Es spezifiziert die Verkabelung,
 332 ein serielles Protokoll und ein Dateiformat. Das MIDI-Dateiformat
 333 ist der de-facto Standard um Musik von vielen Programmen zu exportieren.
 334 Allerdings fehlen in den MIDI-Dateien viele Ausdrucks- und
 335 Artikulationszeichen. Dennoch kann MIDI vielfach nützlich sein,
 336 um Musik von einem Programm zu importieren, für das kein spezielles
 337 Hilfsprogramm den direkten Import nach LilyPond unterstützt.
 338
 339 @command{midi2ly} konvertiert die MIDI-Spuren nach @rinternals{Staff} und
 340 MIDI-Kanäle in @rinternals{Voice} Kontexte. Tonhöhen werden relativ
 341 angegeben, Tondauern nur wenn nötig.
 342
 343 MIDI-Dateien können auch direkt von einem digitalen Keyboard
 344 aufgenommen und dann in eine @file{.ly}-Datei konvertiert werden.
 345 Allerdings sind Musikinterpretationen von Menschen (aus gutem Grund!)
 346 rhythmisch nicht exakt genug um die Konvertierung von MIDI nach LY
 347 trivial zu gestalten. Wenn @command{midi2ly} mit Quantisierung
 348 (@option{-s} und @option{-d} Kommandozeilenoptionen) aufgerufen wird,
 349 versucht es diese Unschärfen im Zeitablauf zu korrigieren, ist
 350 allerdings nicht sonderlich gut darin. Daher können wir diese Technik
 351 leider nicht für die Konvertierung von MIDI-Aufnahmen empfehlen.
 352
 353
 354 @command{midi2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
 355 @example
 356 midi2ly [@var{Optionen}]@dots{} @var{MIDI-Datei}
 357 @end example
 358
 359 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
 360 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
 361 @ref{Von anderen Formaten konvertieren}.
 362
 363 Die folgenden Kommandozeilenoptionen werden von @command{midi2ly}
 364 unterstützt:
 365
 366 @table @code
 367 @item -a, --absolute-pitches
 368 Gibt absolute Tonhöhen aus.
 369
 370 @item -d, --duration-quant=@var{LÄNGE}
 371 Quantisiert Tondauern zu Vielfachen von @var{LÄNGE}.
 372
 373 @item -e, --explicit-durations
 374 Gibt alle Tondauern explizit an.
 375
 376 @item -h, --help
 377 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 378
 379 @item -k, --key=@var{acc}[:@var{Moll}]
 380 Setzt die Standard-Tonart. @math{@var{acc} > 0} gibt die Anzahl der
 381 Kreuze an, @math{@var{acc} < 0} gibt die Anzahl der Bs der Tonart an.
 382 Eine Moll-Tonart wird durch @code{:1} angegeben.
 383
 384 @item -o, --output=@var{Datei}
 385 Die Ausgabe wird in die Datei @var{Datei}@file{.ly} geschrieben.
 386
 387 @item -s, --start-quant=@var{LÄNGE}
 388 Quantisiert den Beginn der Noten zu Vielfachen von @var{LÄNGE}.
 389
 390 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
 391 Erlaubt Tuplet-Dauern der Form @var{DUR}*@var{NUM}/@var{DEN}.
 392
 393 @item -V, --verbose
 394 Gibt ausführliche informative Meldungen während der Konvertierung aus.
 395
 396 @item -v, --version
 397 Gibt die Versionsnummer aus.
 398
 399 @item -w, --warranty
 400 Zeigt die Lizenzbedingungen und Urheberrechtshinweise.
 401
 402 @item -x, --text-lyrics
 403 Interpretiert alle Texte als Liedtexte.
 404 @end table
 405
 406
 407 @knownissues
 408
 409 Überlappende Noten in einem Arpeggio werden nicht korrekt dargestellt.
 410 Nur die erste Note wird eingelesen und konvertiert, die restlichen
 411 werden ignoriert. Als Abhilfe können Sie alle Noten auf dieselbe
 412 Tonlänge setzen und Phrasierungszeichen oder Pedalindikatoren
 413 hinzufügen.
 414
 415
 416 @node musicxml2ly aufrufen
 417 @subsection @command{musicxml2ly} aufrufen
 418 @translationof Invoking musicxml2ly
 419
 420 @cindex MusicXML
 421
 422 @uref{http://@/www.@/musicxml@/.org/,MusicXML} ist ein XML-Dialekt
 423 zur Darstellung von Musiknotation.
 424
 425 @command{musicxml2ly} wandelt eine MusicXML-Datei nach LilyPond um,
 426 wobei sowohl die Noten, Artikulationszeichen, Struktur der Partitur,
 427 Liedtexte etc. einer MusicXML-Datei (im @q{part-wise}-Format) in eine
 428 @file{.ly}-Datei um.
 429
 430 @command{musicxml2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
 431 @example
 432 musicxml2ly [@var{Optionen}]@dots{} @var{XML-Datei}
 433 @end example
 434
 435 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
 436 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
 437 @ref{Von anderen Formaten konvertieren}.
 438
 439 Wenn als Dateiname @file{-} angegeben wird, liest @command{musicxml2ly}
 440 Daten direkt von der Kommandozeile ein.
 441
 442 Die folgenden Kommandozeilenoptionen werden von @command{musicxml2ly}
 443 unterstützt:
 444
 445 @table @code
 446 @item -a, --absolute
 447 Konvertiert in absolute Tonhöhen.
 448
 449 @item -h, --help
 450 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 451
 452 @item -l, --language=SPRACHE
 453 Benutzt SPRACHE für die Notenbezeichnungen, etwa "deutsch" für deutsche
 454 Notenbezeichnungen.
 455
 456 @item --loglevel=@var{Logstufe}
 457 Passt die Ausführlichkeit der Ausgabe entsprechend @var{Logstufe} an.
 458 Mögliche Werte sind @code{NONE},
 459 @code{ERROR}, @code{WARNING}, @code{PROGRESS} (Standard) und @code{DEBUG}.
 460
 461 @item --lxml
 462 Benutzt das lxml.etree Python-Paket für die Verarbeitung von XML (benötigt weniger Speicher und Rechenleistung)
 463
 464 @item -m --midi
 465 Aktiviert die MIDI-Umgebung
 466
 467 @item -nd --no-articulation-directions
 468 Konvertiert keine Richtungsangaben (@code{^}, @code{_} oder @code{-})
 469 von Artikulations- und Lautstärkebezeichnungen.
 470
 471 @item --no-beaming
 472 Konvertiert keine Informationen über die Balkensetzung aus der
 473 MusicXML-Datei. Stattdessen wird dies LilyPond überlassen.
 474
 475 @item -o, --output=@var{Dateiname}
 476 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben. Wird
 477 als @var{Dateiname} nur @file{-} angegeben, wird das Ergebnis der Konvertierung
 478 an der Kommandozeile ausgegeben. Wird diese Option nicht angegeben, so
 479 erfolgt die Ausgabe in die Datei @var{XML-Datei}@file{.ly}.
 480
 481 @item -r, --relative
 482 Konvertiert in relative Tonhöhen. (Standardeinstellung)
 483
 484 @item -v, --verbose
 485 Gibt ausführliche informative Meldungen während der Konvertierung aus.
 486
 487 @item --version
 488 Gibt die Versionsnummer aus.
 489
 490 @item -z, --compressed
 491 Die Eingabedatei wird als komprimierte MusicXML-Datei eingelesen.
 492 Dies ist die Standardeinstellung für Dateien mit der Erweiterung
 493 @file{.xml}.
 494 @end table
 495
 496
 497 @node abc2ly aufrufen
 498 @subsection @command{abc2ly} aufrufen
 499 @translationof Invoking abc2ly
 500
 501 @warning{Dieses Programm ist nicht unterstützt und kann aus kommenden
 502 LilyPond-Versionen entfernt werden.}
 503
 504 @cindex ABC
 505
 506 ABC ist ein relativ einfaches ASCII-basierendes Musikformat und ist
 507 dokumentiert auf der ABC-Homepage:
 508
 509 @quotation
 510 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
 511 @end quotation
 512
 513 @command{abc2ly} konvertiert ABC-Dateien nach LilyPond und wird
 514 von der Kommandozeile folgendermaßen aufgerufen:
 515
 516 @example
 517 abc2ly [@var{Optionen}]@dots{} @var{ABC-Datei}
 518 @end example
 519
 520 Die folgenden Kommandozeilenoptionen werden von @command{abc2ly}
 521 unterstützt:
 522
 523 @table @code
 524 @item -b, --beams=None
 525 Die Balkensetzung aus der ABC-Datei erhalten.
 526 @item -h, --help
 527 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 528 @item -o, --output=@var{Dateiname}
 529 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
 530 @item -s, --strict
 531 Strenge Auslegung einer erfolgreichen Konvertierung.
 532 @item -v, --version
 533 Gibt die Versionsnummer aus.
 534 @end table
 535
 536 Es existiert außerdem die Möglichkeit, LilyPond-Befehle für die
 537 Konvertierung mit @command{abc2ly} gleich in der ABC-Datei anzugeben.
 538 Wenn sich etwa in der ABC-Datei das Kommentar
 539
 540 @example
 541 %%LY voices \set autoBeaming = ##f
 542 @end example
 543
 544 @noindent
 545 befindet, so wird der Text nach dem Schlüsselwort @q{voices} direkt
 546 in die aktuelle Stimme in der LilyPond-Datei eingefügt.
 547
 548 Ebenso bewirkt
 549
 550 @example
 551 %%LY slyrics more words
 552 @end example
 553
 554 @noindent
 555 dass alles nach dem @q{slyrics} Schlüsselwort an der aktuellen Stelle
 556 im Liedtext eingefügt wird.  Gleichermaßen wird mit
 557
 558 @example
 559 %%LY slyrics more words
 560 @end example
 561
 562 @noindent
 563 der Text, der auf das @qq{slylrics}-Schlüsselwort folgt, in die aktuelle
 564 Gesangstextzeile eingefügt.
 565
 566
 567 @knownissues
 568
 569 Der ABC-Standard ist eigentlich kein wirklich vollständiger Standard.
 570 Für komplexere Notation wie etwa Polyphonie existieren verschiedene
 571 Konventionen.
 572
 573 Mehrere Lieder in einer Datei können nicht konvertiert werden.
 574
 575 ABC synchronisiert den Liedtext am Anfang jeder Zeile mit den Noten,
 576 @command{abc2ly} macht dies nicht.
 577
 578 @command{abc2ly} ignoriert die Balkensetzung in der ABC-Datei.
 579
 580
 581 @node etf2ly aufrufen
 582 @subsection @command{etf2ly} aufrufen
 583 @translationof Invoking etf2ly
 584
 585 @warning{Dieses Programm ist nicht unterstützt und kann in kommenden
 586 LilyPond-Versionen entfernt werden.}
 587
 588 @cindex ETF
 589 @cindex enigma
 590 @cindex Finale
 591 @cindex Coda Technology
 592
 593 ETF (Enigma Transport Format) ist ein Dateiformat, das Coda
 594 Music Technology in älteren Versionen des Programms Finale benutzt hat.
 595
 596 @command{etf2ly} konvertiert Teile einer ETF-Datei nach LilyPond
 597 und wird von der Kommandozeile folgendermaßen aufgerufen:
 598
 599 @example
 600 etf2ly [@var{Optionen}]@dots{} @var{ETF-Datei}
 601 @end example
 602
 603 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
 604 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
 605 @ref{Von anderen Formaten konvertieren}.
 606
 607 Die folgenden Kommandozeilenoptionen werden von @command{etf2ly}
 608 unterstützt:
 609
 610 @table @code
 611 @item -h, --help
 612 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 613 @item -o, --output=@var{Dateiname}
 614 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
 615 @item --version
 616 Gibt die Versionsnummer aus.
 617 @end table
 618
 619
 620 @knownissues
 621
 622 Die Liste der Artikulationszeichen is unvollständig. Leere Takte
 623 verwirren @command{etf2ly}. Mehrfache Vorschlagnoten werden falsch
 624 beendet.
 625
 626
 627 @node Andere Formate
 628 @subsection Andere Formate
 629 @translationof Other formats
 630
 631 @cindex Externe Programme, LilyPond-Dateien erstellen
 632
 633 LilyPond kommt nicht mit der Unterstützung für andere Formate, aber einige
 634 externe Programme können auch LilyPond-Dateien erstellen.  Diese finden
 635 sich unter @rweb{Leichteres Editieren}.
 636
 637
 638
 639 @node LilyPond-Ausgabe in anderen Programmen
 640 @section LilyPond-Ausgabe in anderen Programmen
 641 @translationof LilyPond output in other programs
 642
 643 Dieser Abschnitt stellt Methoden vor, wie Text und Musik auf andere
 644 Weise kombiniert werden können als dies durch @command{lilypond-book}
 645 automatisiert geschieht.
 646
 647
 648 @menu
 649 * Viele Zitate aus einer langen Partitur::
 650 * LilyPond-Noten in OpenOffice.org integrieren::
 651 * LilyPond-Noten in andere Programme integrieren::
 652 @end menu
 653
 654 @node Viele Zitate aus einer langen Partitur
 655 @unnumberedsubsec Viele Zitate aus einer langen Partitur
 656 @translationof Many quotes from a large score
 657
 658 Wenn aus einer großen Partitur viele kleine Fragmente eingefügt
 659 werden sollen, kann dazu das @q{clip systems} Feature benutzt werden.
 660 Siehe @ruser{Notationsfragmente extrahieren}.
 661
 662
 663 @node LilyPond-Noten in OpenOffice.org integrieren
 664 @unnumberedsubsec LilyPond-Noten in OpenOffice.org integrieren
 665 @translationof Inserting LilyPond output into OpenOffice.org
 666
 667 @cindex OpenOffice.org
 668
 669 Musik im LilyPond-Format kann in OpenOffice.org eingefügt werden mittels
 670 @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
 671
 672
 673 @node LilyPond-Noten in andere Programme integrieren
 674 @unnumberedsubsec LilyPond-Noten in andere Programme integrieren
 675 @translationof Inserting LilyPond output into other programs
 676
 677 Um die Ausgabe von LilyPond in anderen Programmen einzufügen,
 678 sollte @code{lilypond} anstelle von @code{lilypond-book}
 679 benutzt werden. Jedes Beispiel muss
 680 getrennt manuell erzeugt und ins Dokument eingefügt werden;
 681 für letzteres schlagen Sie bitte im Handbuch Ihrer
 682 Textverarbeitungs-Software nach. Die meisten Programme
 683 unterstützen das Einfügen von Grafiken im @file{PNG}-, @file{EPS}-
 684 oder @file{PDF}-Format.
 685
 686 Um den leeren Rand um die Notenzeilen zu verringern, können folgende
 687 Einstellungen benutzt werden:
 688
 689 @example
 690 \paper@{
 691   indent=0\mm
 692   line-width=120\mm
 693   oddFooterMarkup=##f
 694   oddHeaderMarkup=##f
 695   bookTitleMarkup = ##f
 696   scoreTitleMarkup = ##f
 697 @}
 698
 699 @{ c1 @}
 700 @end example
 701
 702 Benutzbare Bilddateien können mit folgendem Befehl erzeugt werden:
 703
 704 @example
 705 EPS
 706
 707 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts   Dateiname.ly
 708
 709 PNG
 710
 711 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png Dateiname.ly
 712
 713 Ein transparentes PNG
 714
 715 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts \
 716   -dpixmap-format=pngalpha --png myfile.ly
 717 @end example
 718
 719
 720 @node Unabhängige include-Abschnitte
 721 @section Unabhängige @code{include}-Abschnitte
 722 @translationof independent includes
 723
 724 Einige Leute haben große (und nützliche!) Code-Abschnitte geshrieben,
 725 die man in vielen Projekten verwenden kann.  Dieser Code wird möglicherweise
 726 auch eines Tages in LilyPond selbst integriert werden, aber bis dahin
 727 müssen Sie ihn selber herunterladen und mit @code{\include} selber
 728 einfügen.
 729
 730
 731 @menu
 732 * MIDI-Artikulation::
 733 @end menu
 734
 735
 736 @node MIDI-Artikulation
 737 @subsection MIDI-Artikulation
 738 @translationof MIDI articulation
 739
 740 LilyPond kann benutzt werden, um MIDI-Ausgabe zu erzeugen, etwa
 741 um hörend zu korrigieren, was man notiert hat.  Jedoch werden nur
 742 Dynamik, explizite Tempoänderungen und die Noten und Dauern selber
 743 in der MIDI-Datei aufgenommen.
 744
 745 Das @emph{articulate}-Projekt ist ein Versuch, mehr Information
 746 in eine MIDI-Datei zu kopieren.  Es funktioniert, indem man Noten,
 747 die sich nicht unter Bögen befinden, verkürzt, um die Noten
 748 zu @qq{artikulieren}.  Die Stärke der Kürzung hängt von den
 749 Aritkulationszeichen ab, die an die Noten gehängt werden:
 750 Staccato halbiert den Notwert, Tenuto gibt der Note ihre gesamte Dauer
 751 usw.  Das Skript kann auch Triller und Doppelschläge in MIDI umwandeln,
 752 und man könnte auch andere Ornamente implementieren.
 753
 754 @example
 755 @uref{http://@/www@/.nicta@/.com@/.au/@/people/@/chubbp/@/articulate}
 756 @end example
 757
 758 @knownissues
 759
 760 Die größte Einschränkung ist, dass man nur die Sachen beeinflussen kann,
 761 die man weiß: alles, was nur Textbeschriftung ist (anstelle einer Noteneigenschaft)
 762 wird immernoch ignoriert.