Documentation/de/usage/external.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2
   3 @ignore
   4     Translation of GIT committish: ebe492ca408fb0d9abf80b94c56197eef8dc2f09
   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.16.0"
  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 c' @{
 156   c2\f( f)
 157 @}
 158 @end example
 159
 160 oder
 161
 162 @example
 163 #(ly:set-option 'point-and-click 'note-event)
 164 \relative c' @{
 165   c2\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 c' @{
 187   c2\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 c' @{
 196   c2\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 --nd --no-articulation-directions
 465 Konvertiert keine Richtungsangaben (@code{^}, @code{_} oder @code{-})
 466 von Artikulations- und Lautstärkebezeichnungen.
 467
 468 @item --no-beaming
 469 Konvertiert keine Informationen über die Balkensetzung aus der
 470 MusicXML-Datei. Stattdessen wird dies LilyPond überlassen.
 471
 472 @item -o,--output=@var{Dateiname}
 473 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben. Wird
 474 als @var{Dateiname} nur @file{-} angegeben, wird das Ergebnis der Konvertierung
 475 an der Kommandozeile ausgegeben. Wird diese Option nicht angegeben, so
 476 erfolgt die Ausgabe in die Datei @var{XML-Datei}@file{.ly}.
 477
 478 @item -r,--relative
 479 Konvertiert in relative Tonhöhen. (Standardeinstellung)
 480
 481 @item -v, --verbose
 482 Gibt ausführliche informative Meldungen während der Konvertierung aus.
 483
 484 @item --version
 485 Gibt die Versionsnummer aus.
 486
 487 @item  -z,--compressed
 488 Die Eingabedatei wird als komprimierte MusicXML-Datei eingelesen.
 489 Dies ist die Standardeinstellung für Dateien mit der Erweiterung
 490 @file{.xml}.
 491 @end table
 492
 493
 494 @node abc2ly aufrufen
 495 @subsection @command{abc2ly} aufrufen
 496 @translationof Invoking abc2ly
 497
 498 @warning{Dieses Programm ist nicht unterstützt und kann aus kommenden
 499 LilyPond-Versionen entfernt werden.}
 500
 501 @cindex ABC
 502
 503 ABC ist ein relativ einfaches ASCII-basierendes Musikformat und ist
 504 dokumentiert auf der ABC-Homepage:
 505
 506 @quotation
 507 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
 508 @end quotation
 509
 510 @command{abc2ly} konvertiert ABC-Dateien nach LilyPond und wird
 511 von der Kommandozeile folgendermaßen aufgerufen:
 512
 513 @example
 514 abc2ly [@var{Optionen}]@dots{} @var{ABC-Datei}
 515 @end example
 516
 517 Die folgenden Kommandozeilenoptionen werden von @command{abc2ly}
 518 unterstützt:
 519
 520 @table @code
 521 @item -b,--beams=None
 522 Die Balkensetzung aus der ABC-Datei erhalten.
 523 @item -h,--help
 524 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 525 @item -o,--output=@var{Dateiname}
 526 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
 527 @item -s,--strict
 528 Strenge Auslegung einer erfolgreichen Konvertierung.
 529 @item -v,--version
 530 Gibt die Versionsnummer aus.
 531 @end table
 532
 533 Es existiert außerdem die Möglichkeit, LilyPond-Befehle für die
 534 Konvertierung mit @command{abc2ly} gleich in der ABC-Datei anzugeben.
 535 Wenn sich etwa in der ABC-Datei das Kommentar
 536
 537 @example
 538 %%LY voices \set autoBeaming = ##f
 539 @end example
 540
 541 @noindent
 542 befindet, so wird der Text nach dem Schlüsselwort @q{voices} direkt
 543 in die aktuelle Stimme in der LilyPond-Datei eingefügt.
 544
 545 Ebenso bewirkt
 546
 547 @example
 548 %%LY slyrics more words
 549 @end example
 550
 551 @noindent
 552 dass alles nach dem @q{slyrics} Schlüsselwort an der aktuellen Stelle
 553 im Liedtext eingefügt wird.  Gleichermaßen wird mit
 554
 555 @example
 556 %%LY slyrics more words
 557 @end example
 558
 559 @noindent
 560 der Text, der auf das @qq{slylrics}-Schlüsselwort folgt, in die aktuelle
 561 Gesangstextzeile eingefügt.
 562
 563
 564 @knownissues
 565
 566 Der ABC-Standard ist eigentlich kein wirklich vollständiger Standard.
 567 Für komplexere Notation wie etwa Polyphonie existieren verschiedene
 568 Konventionen.
 569
 570 Mehrere Lieder in einer Datei können nicht konvertiert werden.
 571
 572 ABC synchronisiert den Liedtext am Anfang jeder Zeile mit den Noten,
 573 @command{abc2ly} macht dies nicht.
 574
 575 @command{abc2ly} ignoriert die Balkensetzung in der ABC-Datei.
 576
 577
 578 @node etf2ly aufrufen
 579 @subsection @command{etf2ly} aufrufen
 580 @translationof Invoking etf2ly
 581
 582 @warning{Dieses Programm ist nicht unterstützt und kann in kommenden
 583 LilyPond-Versionen entfernt werden.}
 584
 585 @cindex ETF
 586 @cindex enigma
 587 @cindex Finale
 588 @cindex Coda Technology
 589
 590 ETF (Enigma Transport Format) ist ein Dateiformat, das Coda
 591 Music Technology in älteren Versionen des Programms Finale benutzt hat.
 592
 593 @command{etf2ly} konvertiert Teile einer ETF-Datei nach LilyPond
 594 und wird von der Kommandozeile folgendermaßen aufgerufen:
 595
 596 @example
 597 etf2ly [@var{Optionen}]@dots{} @var{ETF-Datei}
 598 @end example
 599
 600 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
 601 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
 602 @ref{Von anderen Formaten konvertieren}.
 603
 604 Die folgenden Kommandozeilenoptionen werden von @command{etf2ly}
 605 unterstützt:
 606
 607 @table @code
 608 @item -h,--help
 609 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 610 @item -o,--output=@var{Dateiname}
 611 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
 612 @item --version
 613 Gibt die Versionsnummer aus.
 614 @end table
 615
 616
 617 @knownissues
 618
 619 Die Liste der Artikulationszeichen is unvollständig. Leere Takte
 620 verwirren @command{etf2ly}. Mehrfache Vorschlagnoten werden falsch
 621 beendet.
 622
 623
 624 @node Andere Formate
 625 @subsection Andere Formate
 626 @translationof Other formats
 627
 628 @cindex Externe Programme, LilyPond-Dateien erstellen
 629
 630 LilyPond kommt nicht mit der Unterstützung für andere Formate, aber einige
 631 externe Programme können auch LilyPond-Dateien erstellen.  Diese finden
 632 sich unter @rweb{Leichteres Editieren}.
 633
 634
 635
 636 @node LilyPond-Ausgabe in anderen Programmen
 637 @section LilyPond-Ausgabe in anderen Programmen
 638 @translationof LilyPond output in other programs
 639
 640 Dieser Abschnitt stellt Methoden vor, wie Text und Musik auf andere
 641 Weise kombiniert werden können als dies durch @command{lilypond-book}
 642 automatisiert geschieht.
 643
 644
 645 @menu
 646 * Viele Zitate aus einer langen Partitur::
 647 * LilyPond-Noten in OpenOffice.org integrieren::
 648 * LilyPond-Noten in andere Programme integrieren::
 649 @end menu
 650
 651 @node Viele Zitate aus einer langen Partitur
 652 @unnumberedsubsec Viele Zitate aus einer langen Partitur
 653 @translationof Many quotes from a large score
 654
 655 Wenn aus einer großen Partitur viele kleine Fragmente eingefügt
 656 werden sollen, kann dazu das @q{clip systems} Feature benutzt werden.
 657 Siehe @ruser{Notationsfragmente extrahieren}.
 658
 659
 660 @node LilyPond-Noten in OpenOffice.org integrieren
 661 @unnumberedsubsec LilyPond-Noten in OpenOffice.org integrieren
 662 @translationof Inserting LilyPond output into OpenOffice.org
 663
 664 @cindex OpenOffice.org
 665
 666 Musik im LilyPond-Format kann in OpenOffice.org eingefügt werden mittels
 667 @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
 668
 669
 670 @node LilyPond-Noten in andere Programme integrieren
 671 @unnumberedsubsec LilyPond-Noten in andere Programme integrieren
 672 @translationof Inserting LilyPond output into other programs
 673
 674 Um die Ausgabe von LilyPond in anderen Programmen einzufügen,
 675 sollte @code{lilypond} anstelle von @code{lilypond-book}
 676 benutzt werden. Jedes Beispiel muss
 677 getrennt manuell erzeugt und ins Dokument eingefügt werden;
 678 für letzteres schlagen Sie bitte im Handbuch Ihrer
 679 Textverarbeitungs-Software nach. Die meisten Programme
 680 unterstützen das Einfügen von Grafiken im @file{PNG}-, @file{EPS}-
 681 oder @file{PDF}-Format.
 682
 683 Um den leeren Rand um die Notenzeilen zu verringern, können folgende
 684 Einstellungen benutzt werden:
 685
 686 @example
 687 \paper@{
 688   indent=0\mm
 689   line-width=120\mm
 690   oddFooterMarkup=##f
 691   oddHeaderMarkup=##f
 692   bookTitleMarkup = ##f
 693   scoreTitleMarkup = ##f
 694 @}
 695
 696 @{ c1 @}
 697 @end example
 698
 699 Benutzbare Bilddateien können mit folgendem Befehl erzeugt werden:
 700
 701 @example
 702 EPS
 703
 704 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts   Dateiname.ly
 705
 706 PNG
 707
 708 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png Dateiname.ly
 709
 710 Ein transparentes PNG
 711
 712 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts \
 713   -dpixmap-format=pngalpha --png myfile.ly
 714 @end example
 715
 716
 717 @node Unabhängige include-Abschnitte
 718 @section Unabhängige @code{include}-Abschnitte
 719 @translationof independent includes
 720
 721 Einige Leute haben große (und nützliche!) Code-Abschnitte geshrieben,
 722 die man in vielen Projekten verwenden kann.  Dieser Code wird möglicherweise
 723 auch eines Tages in LilyPond selbst integriert werden, aber bis dahin
 724 müssen Sie ihn selber herunterladen und mit @code{\include} selber
 725 einfügen.
 726
 727
 728 @menu
 729 * MIDI-Artikulation::
 730 @end menu
 731
 732
 733 @node MIDI-Artikulation
 734 @subsection MIDI-Artikulation
 735 @translationof MIDI articulation
 736
 737 LilyPond kann benutzt werden, um MIDI-Ausgabe zu erzeugen, etwa
 738 um hörend zu korrigieren, was man notiert hat.  Jedoch werden nur
 739 Dynamik, explizite Tempoänderungen und die Noten und Dauern selber
 740 in der MIDI-Datei aufgenommen.
 741
 742 Das @emph{articulate}-Projekt ist ein Versuch, mehr Information
 743 in eine MIDI-Datei zu kopieren.  Es funktioniert, indem man Noten,
 744 die sich nicht unter Bögen befinden, verkürzt, um die Noten
 745 zu @qq{artikulieren}.  Die Stärke der Kürzung hängt von den
 746 Aritkulationszeichen ab, die an die Noten gehängt werden:
 747 Staccato halbiert den Notwert, Tenuto gibt der Note ihre gesamte Dauer
 748 usw.  Das Skript kann auch Triller und Doppelschläge in MIDI umwandeln,
 749 und man könnte auch andere Ornamente implementieren.
 750
 751 @example
 752 @uref{http://@/www@/.nicta@/.com@/.au/@/people/@/chubbp/@/articulate}
 753 @end example
 754
 755 @knownissues
 756
 757 Die größte Einschränkung ist, dass man nur die Sachen beeinflussen kann,
 758 die man weiß: alles, was nur Textbeschriftung ist (anstelle einer Noteneigenschaft)
 759 wird immernoch ignoriert.