1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: cs -*-
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: Pavel Fric
15 @c Note: keep this node named so that `info lilypond-book' brings you here.
17 @chapter Vyvolání @command{lilypond-book}
18 @translationof lilypond-book
20 Wenn Sie in ein Dokument Grafiken Ihres Musiksatzes einfügen möchten, so
21 können Sie genauso vorgehen, wie Sie andere Grafiken einfügen würden: Die
22 Bilder werden getrennt vom Dokument im PostScript- oder PNG-Format erstellt
23 und können dann in @LaTeX{} oder HTML eingefügt werden.
25 @command{lilypond-book} automatisiert diesen Prozess: Dieses
26 Programm extrahiert Musik-Schnipsel aus Ihrem Dokument,
27 ruft @command{lilypond} auf und fügt die resultierenden Bilder
28 in Ihr Dokument ein. Die Länge der Zeilen und die Schriftgroße
29 werden dabei Ihrem Dokument angepasst.
31 @command{lilypond-book} ist ein eigenständiges Programm und wird
32 üblicherweise von der Kommandozeile aufgerufen. Nähere Informationen
33 hierzu finden sich in @ref{Benutzung auf der Kommandozeile}. Wenn Sie MacOS 10.3
34 oder 10.4 benutzen und Probleme mit @code{lilypond-book} haben, lesen
37 Dieses Vorgehen kann bei @LaTeX{}, HTML, Texinfo oder DocBook Dokumenten
46 @cindex Dokument, Noten einfügen in
47 @cindex HTML, Noten in
48 @cindex Texinfo, Noten in
49 @cindex DocBook, Noten in
50 @cindex @LaTeX{}, Noten in
54 * Hudebněvědný text jako příklad::
55 * Začlenění not do textu::
56 * Volby pro hudební kousky::
57 * Vyvolání lilypond-book::
59 * Předlohy pro lilypond-book::
61 * Náhradní způsoby míchání not a textu::
64 @node Hudebněvědný text jako příklad
65 @section Hudebněvědný text jako příklad
66 @translationof An example of a musicological document
69 @cindex Musikwissenschaft
71 Zahlreiche Texte enthalten Musikbeispiele: musikwissenschaftliche
72 Abhandlungen, Liederbücher oder Handbücher wie dieses. Solche
73 Texte können händisch erzeugt werden, indem einfach die Musikbeispiele
74 als Grafik (PostScript, PNG, GIF, etc.) im Textverarbeitungsprogramm
75 eingefügt werden. Für HTML, @LaTeX{}, Texinfo und DocBook Dokumente
76 existiert jedoch ein Weg, dies automatisiert durchzuführen.
78 Das Programm @code{lilypond-book} extrahiert die Musikfragmente aus
79 dem Dokument, formatiert sie automatisiert in eine Grafik und fügt die
80 resultierenden Notenbeispiele dann wieder in das Dokument ein. Dies soll
81 hier an einem einfachen @LaTeX{}-Beispiel verdeutlicht werden. Das Beispiel
82 selbst enthält schon Erklärungen, sodass wir es hier nicht weiter diskutieren
89 \documentclass[a4paper]{article}
93 Dokumente für \verb+lilypond-book+ können Musik und Text nach Belieben
94 kombinieren. Zum Beispiel:
98 c2 e2 \times 2/3 { f8 a b } a2 e4
102 Optionen für \verb+lilypond+ werden dabei in eckige Klammern gesetzt.
104 \begin{lilypond}[fragment,quote,staffsize=26,verbatim]
108 Größere Beispiele können auch in einer eigenständigen Datei gespeichert
109 und dann mit \verb+\lilypondfile+ eingebunden werden.
111 \lilypondfile[quote,noindent]{screech-and-boink.ly}
113 (Falls nötig kann @file{screech-and-boink.ly} durch eine beliebige andere
114 @file{.ly}-Datei im selben Verzeichnis wie diese Datei ersetzt werden.)
120 @subheading Verarbeitung
122 Speichern Sie den obigen @LaTeX{}-Quellcode in eine Datei @file{lilybook.lytex}
123 und führen Sie dann in der Kommandozeile folgende Befehle aus:
125 @c keep space after @version{} so TeX doesn't choke
127 lilypond-book --output=out --pdf lilybook.lytex
128 @emph{lilypond-book (GNU LilyPond) @version{} }
129 @emph{Reading lilybook.lytex...}
130 @emph{..(viele Ausgabezeilen entfernt)..}
131 @emph{Compiling lilybook.tex...}
134 @emph{..(viele Ausgabezeilen entfernt)..}
136 @emph{(Ersetzen Sie @command{xpdf} durch Ihren PDF-Betrachter)}
139 Die Ausführung von @command{lilypond-book} a @command{latex} erzeugt
140 zahlreiche temporäre Dateien, die das Arbeitsverzeichnis unnötig
141 vollstopfen würden. Daher empfiehlt sich die Benutzung der @code{--output=@var{dir}}
142 Option, wodurch die Dateien im Unterverzeichnis @file{dir} erzeugt werden.
144 Das Endresultat des obigen @LaTeX{}-Beispiels ist im nächsten Abschnitt
145 zu sehen.@footnote{Da dieses Handbuch mit Texinfo erzeugt wurde,
146 kann sich das Aussehen des Beispiels leicht von dem mit @LaTeX{}
147 erzeugten unterscheiden.}
153 Dokumente für @command{lilypond-book} können Musik und Text nach Belieben
154 kombinieren. Zum Beispiel:
158 c2 e2 \times 2/3 { f8 a b } a2 e4
162 Optionen für @command{lilypond} werden dabei in eckige Klammern gesetzt.
164 @lilypond[fragment,quote,staffsize=26,verbatim]
168 Größere Beispiele können auch in einer eigenständigen Datei gespeichert
169 und dann mit @code{\lilypondfile} eingebunden werden.
171 @lilypondfile[quote,noindent]{screech-and-boink.ly}
178 @node Začlenění not do textu
179 @section Začlenění not do textu
180 @translationof Integrating music and text
182 In diesem Abschnitt soll die Integration von LilyPond mit den
183 verschiedenen Dateiformaten detailliert erläutert werden.
197 @LaTeX{} ist der de-facto Standard zur Publikation von wissenschaftlichen Texten
198 in Naturwissenschaft und Technik. Es basiert auf dem Schriftsetzer @TeX{},
199 der die bestmögliche Typographie erzeugt.
201 Siehe die @uref{http://@/www@/.ctan@/.org/@/tex@/-archive/@/info/@/lshort/@/german/,
202 @emph{@LaTeX{}2e-Kurzbeschreibung}} für eine Einführung in die
203 Benutzung von @LaTeX{}.
205 Musikbeispiele können eingegeben werden als
208 \begin@{lilypond@}[Optionen,kommen,hierhin]
209 IHR LILYPOND-QUELLCODE
217 \lilypondfile[Optionen,kommen,hier]@{@var{Dateiname}@}
224 \lilypond@{ IHR LILYPOND-QUELLCODE @}
227 Zusätzlich kann mit @code{\lilypondversion} die benutzte Versionsnummer
228 von LilyPond angezeigt werden. Der Aufruf von @command{lilypond-book}
229 liefert eine Datei, die dann mit @LaTeX{} weiter verarbeitet werden kann.
231 Dies soll hier an einigen Beispielen gezeigt werden. Die @code{lilypond}-Umgebung
234 \begin@{lilypond@}[quote,fragment,staffsize=26]
242 @lilypond[quote,fragment,staffsize=26]
249 \lilypond[quote,fragment,staffsize=11]@{<c' e' g'>@}
255 @lilypond[quote,fragment,staffsize=11]{<c' e' g'>}
258 Innerhalb des @code{\lilypond@{@}} Befehls dürfen keine geschwungenen
259 Klammern @code{@{} oder @code{@}} vorkommen, weshalb dieser Befehl
260 nur mit der @code{fragment}-Option Sinn macht.
262 Die Standardzeilenlänge wird bestimmt, indem die Angaben in der Dokumentpräambel,
263 also dem Teil der @LaTeX{} Datei vor dem @code{\begin@{document@}},
264 analysiert werden. Der @command{lilypond-book}-Befehl sendet diese
265 Angaben an @LaTeX{}, um herauszufinden, wie breit der Text tatsächlich
266 ist. Die Breite der Notenzeilen wird dann an diese Textbreite angepasst.
267 Ein derartig heuristischer Algorithmus kann natürlich auch versagen,
268 wobei man in diesem Fall die Breite auch explizit durch die
269 @code{line-width} Option des @code{\lilypond@{@}} oder @code{\begin@{lilypond@}}
270 Befehls angeben kann.
272 @cindex Titel und lilypond-book
273 @cindex \header in @LaTeX{}-Dokumenten
275 Jedes Musikbeispiele ruft die folgenden Makros auf, wenn sie vom Benutzer
279 @item @code{\preLilyPondExample} -- wird vor der Musik aufgerufen,
281 @item @code{\postLilyPondExample} -- wird nach der Musik aufgerufen,
283 @item @code{\betweenLilyPondSystem[1]} -- wird zwischen den einzelnen
284 Systemen aufgerufen, wenn @code{lilypond-book} das Beispiel in verschiedene
285 PostScript Dateien getrennt hat. Dieser @LaTeX{}-Befehl muss so definiert
286 werden, dass er genau ein Argument erhält, nämlich die Zahl der bereits
287 in @LaTeX{} eingefügten Dateien dieses Beispiels. Als Standard wird einfach
288 ein @code{\linebreak} eingefügt.
294 @cindex Latex, Feta Schriftart
297 Um Zeichen wie Auflösungszeichen, Kreuze, Fermaten etc. aus der Feta-Schriftart
298 von LilyPond in @LaTeX{} einzufügen, muss @code{\input@{titledefs@}} benutzt werden,
299 wodurch dann der Befehl @code{\fetachar} zur Verfügung steht.
302 \documentclass[a4paper]@{article@}
313 Die Namen der Symbole sind in der Datei @file{feta20.tex} definiert. Sie finden
314 den Pfad zu dieser Datei mit dem Befehl
324 Manchmal ist es nötig, Musikelemente wie Halte- oder Bindebögen so darzustellen,
325 als ob sie am Ende des Musikausschnittes noch weitergehen würden. Eine solche
326 Ausgabe kann erreicht werden, indem ein Zeilenumbruch in die Notenzeile
327 eingefügt wird und die Ausgabe der folgenden Notenzeile unterdrückt wird.
329 In @LaTeX{} wird dazu der Befehl @code{\betweenLilyPondSystem} einfach derartig
330 programmiert, dass die Ausgabe der einzelnen Notensysteme abgebrochen wird,
331 sobald die gewünschte Anzahl an Systemen erreicht ist. Da
332 @code{\betweenLilyPondSystem} zum ersten Mal nach dem ersten System aufgerufen
333 wird, ist die Ausgabe nur eines Systems trivial.
336 \def\betweenLilyPondSystem#1@{\endinput@}
338 \begin@{lilypond@}[fragment]
339 c'1\( e'( c'~ \break c' d) e f\)
343 Um eine größere Zahl an System nötig, dann muss dementsprechend eine
344 @TeX{}-Bedingung vor dem @code{\endinput} benutzt werden:
347 \def\betweenLilyPondSystem#1@{
348 \ifnum##1<2\else\endinput\fi
352 Dieses Beispiel bricht nach genau zwei ausgegebenen Notenzeilen ab.
353 Für eine andere Anzahl braucht nur @q{2} durch die entsprechende
354 Anzahl ersetzt werden.
356 Die Definition von @code{\betweenLilyPondSystem} bleibt gültig,
357 bis @TeX{} die aktuelle Umgebung in @LaTeX{} verlässt oder der
358 Befehl durch eine neue Definition überschrieben wird.
359 Dies kann etwa folgendermaßen in der @LaTeX{}-Datei geschehen:
362 \let\betweenLilyPondSystem\undefined
365 Obige Definition von @code{\betweenLilyPondSystem} kann durch die
366 Definition eines @TeX{}-Makros auch verallgemeinert werden,
369 \def\onlyFirstNSystems#1@{
370 \def\betweenLilyPondSystem##1@{\ifnum##1<#1\else\endinput\fi@}
375 wobei diesem Makro @code{\onlyFirstNSystems} einfach die Anzahl der
376 gewünschten Systeme übergeben wird:
379 \onlyFirstNSystems@{3@}
380 \begin@{lilypond@}...\end@{lilypond@}
381 \onlyFirstNSystems@{1@}
382 \begin@{lilypond@}...\end@{lilypond@}
386 @command{lilypond-book} stellt auch zahlreiche Kommandozeilen-Optionen zur
387 Verfügung. Für eine Liste dieser Optionen und andere hilfreiche Details zur
388 Verarbeitung von @LaTeX{}-Dokumenten, siehe @ref{Vyvolání lilypond-book,,vyvolání lilypond-book}.
395 @translationof Texinfo
397 Texinfo ist das Standard-Dokumentationsformat des GNU Projekts. Ein Beispiel
398 für ein Dokument im Texinfo Format ist dieses Handbuch, wobei die HTML-, PDF- und
399 Info-Versionen alle aus demselben Texinfo Dokument erzeugt werden.
401 In der Eingabedatei wir Musik eingegeben als
404 @@lilypond[Optionen,kommen,hier]
405 IHR LILYPOND-QUELLCODE
413 @@lilypond[Optionen,kommen,hier]@{ IHR LILYPOND-QUELLCODE @}
420 @@lilypondfile[Optionen,kommen,hier]@{@var{Dateiname}@}
423 Zusätzlich kann mit @code{@@lilypondversion} die aktuelle Versionsnummer
424 von LilyPond angezeigt werden.
426 Wenn @command{lilypond-book} eine derartige Datei verarbeitet,
427 wird eine Texinfo-Datei mit der Erweiterung @file{.texi} erzeugt,
428 die @code{@@image} Befehle für die Ausgabe nach HTML, Info und PDF
429 enthält. @command{lilypond-book} erzeugt die entsprechenden Grafiken
430 der Musikbeispiele im EPS- und PDF-Format für die Ausgabe nach PDF
431 und im PNG-Format für die Ausgabe nach HTML und Info.
433 Hier sollen zwei einfache Beispiele gezeigt werden. Eine @code{lilypond} Umgebung
451 @@lilypond[fragment,staffsize=11]@{<c' e' g'>@}
457 @lilypond[fragment,staffsize=11]{<c' e' g'>}
459 Im Gegensatz zu @LaTeX{} erzeugt @code{@@lilypond@{...@}} allerdings keine Grafik
460 im Fließtext, sondern setzt sie immer in einen eigenen Absatz.
467 Noten werden eingegeben als
470 <lilypond fragment relative=2>
471 \key c \minor c4 es g2
476 @command{lilypond-book} erzeugt dann daraus eine HTML-Datei mit den entsprechenden
477 @code{<image>} Tags für die Musikbeispiele in jeweils einem eigenen Absatz.
479 @lilypond[fragment,relative=2]
480 \key c \minor c4 es g2
483 Für Grafiken im Fließtext kann @code{<lilypond ... />} benutzt werden, wobei
484 die Optionen durch einen Doppelpunkt von der Musik getrennt angegeben werden.
487 Musik <lilypond relative=2: a b c/> in derselben Zeile.
490 Um Dateien mit Musik einzubinden, kann folgendermaßen vorgegangen werden:
493 <lilypondfile @var{Option1} @var{Option2} ...>@var{Dateiname}</lilypondfile>
496 Eine Liste der Optionen, die man mit @code{lilypond} oder @code{lilypondfile}
497 benutzen kann, siehe @ref{Volby pro hudební kousky,,volby pro hudební kousky}
499 Zusätzlich gibt @code{<lilypondversion/>} die aktuelle Versionsnummer
505 @translationof DocBook
508 Bei der Einbindung von Musik im LilyPond-Format in DocBook soll die
509 Konformität unseres DocBook Dokuments erhalten bleiben und damit
510 die Bearbeiten mit DocBook-Editoren sowie die Validierung weiter
511 möglich bleiben. Aus diesem Grund werden in DocBook keine eigenen Tags
512 wie in HTML benutzt, sondern die von den vorhandenen DocBook-Elementen
513 vorgegebenen Konventionen entsprechend benützt.
515 @subheading Definitionen
517 Für die Einbindung von LilyPond Code werden in allen Fällen die
518 @code{mediaobject} und @code{inlinemediaobject} Elemente benutzt,
519 die unsere Beispiele in einem eigenen Absatz oder im Fließtext
520 einfügen. Die Optionen zur Formatierung mit LilyPond werden dabei
521 in der @code{role} Eigenschaft des innersten Elements angegeben,
522 wie im nächsten Abschnitt gezeigt wird. Die DocBook Datei, die
523 dann von @command{lilypond-book} verarbeitet wird, sollte der Klarheit
524 halber die Dateierweiterung @file{.lyxml} (jedenfalls nicht
525 @file{.xml}) besitzen.
527 @subheading Eine LilyPond-Datei einfügen
529 Dies ist der einfachste Fall: Die LilyPond-Datei besitzt die Erweiterung
530 @file{.ly} und wird einfach als @code{imageobject} eingebettet:
535 <imagedata fileref="music1.ly" role="printfilename" />
540 Für das äußerste Element kann je nach Bedarf @code{mediaobject} oder
541 @code{inlinemediaobject} benutzt werden.
543 @subheading LilyPond-Code einfügen
545 Die Einbindung von LilyPond-Code direkt in der DocBook-Datei ist
546 durch die Benutzung von @code{programlisting} möglich,
547 wobei die Sprache auf @code{lilypond} gesetzt wird:
552 <programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
553 \context Staff \with @{
554 \remove Time_signature_engraver
555 \remove Clef_engraver@}
562 Das äußerste Element ist also @code{mediaobject} oder
563 @code{inlinemediaobject}, welches ein @code{textobject} mit dem
564 @code{programlisting} enthält.
566 @subheading Ein DocBook-Dokument übersetzen
568 Der Aufruf von @command{lilypond-book} mit der @file{.lyxml}-Datei
569 erzeugt ein gültiges DocBook-Dokument mit der Erweiterung @file{.xml},
570 welches normal weiterverarbeitet werden kann. Bei Benutzung von
571 @uref{http://@/dblatex@/.sourceforge@/.net@/,dblatex} wird daraus
572 automatisch eine PDF-Datei erzeugt. Für die Erzeugung von HTML (HTML
573 Hilfe, JavaHelp, etc.) können die offiziellen DocBook XSL-Stylesheets
574 benutzt werden. Eventuell müssen dafür allerdings kleinere Anpassungen
578 @node Volby pro hudební kousky
579 @section Volby pro hudební kousky
580 @translationof Music fragment options
582 Im Folgenden meint @q{LilyPond-Befehl} einen beliebigen in den vorgehenden
583 Abschnitten beschriebenen Befehl, der ein LilyPond-Fragment in eine Datei
584 einfügt und von @command{lilypond-book} verarbeitet wird. Der Einfachheit
585 halber werden hier alle LilyPond-Befehle in der Syntax von @LaTeX{}
588 Zu beachten ist, dass die Optionen eines LilyPond-Befehls von links
589 nach rechts verarbeitet werden. Wenn eine Option also mehrfach angegeben
590 wird, wird nur die letzte benutzt.
592 Die folgenden Optionen können für LilyPond-Befehle benutzt werden:
595 @item staffsize=@var{ht}
596 Setzt die Höhe einer Notenzeile auf @var{ht}, angegeben in Punkten.
599 Erzeugt Notenzeilen im Flattersatz mit natürlichem Abstand der Noten. In
600 anderen Worten: @code{ragged-right = ##t} wird in das Musikfragment
601 eingefügt. Dies ist die Standardeinstellung für den
602 @code{\lilypond@{@}}-Befehl,
603 wenn die Option @code{line-width} nicht angegeben wird.
604 Ebenso ist dies die Standardeinstellung für die @code{lilypond}-Umgebung,
605 wenn die Option @code{fragment}, aber keine Zeilenlänge
606 explizit angegeben ist.
609 Streckt Musikfragmente mit nur einer Notenzeile auf die volle Breite,
610 es wird also @code{ragged-right = ##f} in das Musikfragment eingefügt.
613 @itemx line-width=@var{Breite}\@var{Einheit}
614 Setzt die Breite der Notenzeilen auf @var{Breite}, gemessen in Vielfachen
615 der @var{Einheit}. Als Einheit können die folgenden Zeichenfolgen angegeben
616 werden: @code{cm}, @code{mm}, @code{in} oder @code{pt}. Diese Option hat
617 nur Einfluss auf die Breite von Notenzeilen und Text im Musikfragment, nicht
618 jedoch auf den restlichen Text des Dokuments.
620 Wird diese Option ohne einen Wert angegeben, wird die Zeilenbreite auf
621 einen Standardwert gesetzt, der durch einen heuristischen Algorithmus
624 Wenn die @code{line-width}-Option nicht angegeben wird, versucht
625 @command{lilypond-book} einen geeigneten Standardwert für alle
626 @code{lilypond}-Umgebungen zu finden, die die @code{ragged-right}-Option
630 Verhindert die Ausgabe der Taktangabe am Anfang des Fragments und schaltet
631 Taktstriche und alle Taktangaben im Fragment ab.
634 Bewirkt, dass @command{lilypond-book} Standardcode um das Fragment herum einfügt, sodass z. B.
641 ohne @code{\layout}, @code{\score}, etc. eingegeben werden kann.
644 Verhindert das Einfügen von Standardcode um das Fragment herum. Dies ist
645 die Standardeinstellung, insofern ist diese Option im Normalfall unnötig.
647 @item indent=@var{Einzug}\@var{Einheit}
648 Setzt den Einzug des ersten Notensystems auf @var{Einzug}, gemessen in
649 Vielfachen der @var{Einheit}. Als Einheit können die folgenden Zeichenfolgen
650 angegeben werden: @code{cm}, @code{mm}, @code{in} oder @code{pt}. Diese
651 Option hat nur Einfluss auf den Einzug von Notenzeilen und Text im
652 Musikfragment, nicht jedoch auf den restlichen Text des Dokuments.
655 Setzt den Einzug des ersten Notensystems auf 0. Diese
656 Option hat nur Einfluss auf den Einzug von Notenzeilen und Text im
657 Musikfragment, nicht jedoch auf den restlichen Text des Dokuments. Dies
658 ist die Standardeinstellung, insofern ist diese Option im Normalfall
662 Verringert die Zeilenlänge des Musikfragments um @math{2*0.4}@dmn{in}
663 und setzt das Fragment in einen Zitat-Block. Der Wert von @q{0.4@dmn{in}}
664 kann durch die @code{exampleindent} Option angepasst werden.
667 Setzt den Betrag, um den das Fragment bei Benutzung der @code{quote}
668 Option eingerückt wird.
671 @itemx relative=@var{n}
672 Benutzt relative Oktavenbezeichnungen. Standardmäßig werden Noten relativ
673 zum mittleren C angegeben. Das optionale ganzzahlige Argument
674 gibt die Oktave der ersten Note an, wobei die Standardeinstellung von
675 @code{1} das mittlere C bedeutet. Die @code{relative} Option macht nur
676 Sinn in Verbindung mit der @code{fragment} Option, weshalb @code{fragment}
677 automatisch durch die Angabe der @code{relative} Option impliziert wird.
678 Eine explizite Angabe der @code{(no)fragment} Option hat keinen Effekt.
682 LilyPond benutzt zur Erzeugung seiner eigenen Dokumentation ebenfalls
683 @command{lilypond-book}. Zu diesem Zweck stehen noch zahlreiche
684 spezialisierte Optionen zur Verfügung:
688 Der LilyPond-Code im LilyPond-Kommando wird zum einen benutzt, um das
689 Musikfragment in eine Grafik mit schönem Notensatz zu konvertieren,
690 andererseits aber auch wörtlich in das Dokument eingefügt. Dies
691 geschieht in einem @q{verbatim}-Block, gefolgt vom Text einer
692 möglicherweise angegebenen @code{intertext} Option@footnote{Die
693 @code{intertext} Option ist noch nicht implementiert.} und der
694 Grafik des tatsächlichen Notensatzes. Diese Option funktioniert nur
695 fehlerhaft, wenn @code{\lilypond@{@}} im Fließtext benutzt wird.
697 Wird @code{verbatim} in Verbindung mit einem @code{lilypondfile}-Kommando
698 benutzt, so ist es auch möglich, nur ein Teil der Datei wörtlich einfügen
699 zu lassen: Wenn die eingebundene LilyPond-Datei ein Kommentar mit dem Inhalt
700 @samp{begin verbatim} (ohne Anführungszeichen) enthält, wird nur der
701 Dateiinhalt ab dieser Position eingefügt. Enthält die Datei mehrere
702 solche Kommentare, wirkt nur das letzte. Analog wird nur der Dateiinhalt
703 bis zu einem etwaigen Kommentar mit dem Inhalt @samp{end verbatim}
704 eingefügt. Im folgenden Beispiel wird das gesamte Musik für die
705 Erzeugung der Grafik im relativen Oktavenmodus interpretiert, der
706 wörtlich in das Dokument kopierte LilyPond-Code zeigt den @code{relative}-Befehl jedoch nicht.
709 \relative c' @{ % begin verbatim
716 erzeugt ein Zitat der Form
724 Wenn Kommentare und Variablen im Zitat, aber nicht im Quelltext
725 übersetzt werden sollen, kann die Umgebungsvariable @code{LYDOC_LOCALEDIR}
726 auf einen Verzeichnispfad gesetzt werden. Das Verzeichnis sollte
727 einen Baum an @file{.mo}-Nachrichtenkatalogen beinhalten mit
728 @code{lilypond-doc} als Domain.
731 (Nur innerhalb von Texinfo-Dateien.) Stellt @code{\version
732 @@w@{"@@version@{@}"@}} an den Beginn des Fragments der Ausgabe mit
736 (Nur innerhalb von Texinfo-Dateien.) Wird @command{lilypond} mit der
737 Kommandozeilenoption @option{--header=@/texidoc} für eine Datei
738 @file{foo.ly} und enthält die Datei ein @code{texidoc}-Feld im
739 @code{\header}-Block, so wird dessen Inhalt in die Datei
740 @file{foo.texidoc} ausgegeben. Die @code{texidoc} Option veranlasst
741 @code{lilypond-book}, den Inhalt dieser @file{.texidoc} Dateien innerhalb
742 eines Dokumentationsblocks direkt vor dem Musikfragment in das aktuelle
745 Enthält also die Datei @file{foo.ly} etwa den LilyPond-Code
749 texidoc = "Dieses Beispiel zeigt eine einzelne Note."
755 und das Texinfo-Dokument @file{text.texinfo}
758 @@lilypondfile[texidoc]@{foo.ly@}
762 so liefert der folgende Aufruf von @code{lilypond-book} das gewünschte
766 lilypond-book --pdf --process="lilypond \
767 -dbackend=eps --header=texidoc" test.texinfo
770 Die meisten Test-Dateien (im @file{input/} Verzeichnis von LilyPond)
771 sind kleine @file{.ly} Dateien von genau dieser Form.
773 Auch die Übersetzung dieser zusätzlichen Kommentare ist möglich:
774 Dazu muss das Texinfo-Dokument den Befehl @code{@@documentlanguage @var{LANG}}
775 und der @code{\header} Block in der Datei @file{foo.ly}
776 die Übersetzung im Feld @code{texidoc@var{LANG}} enthalten. Wird nun
777 @command{lilypond} mit der Option @option{--header=@/texidoc@var{LANG}}
778 aufgerufen, so wird der Inhalt der Datei @file{foo.texidoc@var{LANG}}
779 anstelle von @file{foo.texidoc} eingefügt.
782 (Nur innerhalb von Texinfo-Dateien.) Diese Option wirkt ähnlich wie die
783 @code{texidoc} Option: Wenn @command{lilypond} mit der Option
784 @option{--header=@/doctitle} aufgerufen wird und die Eingabedatei
785 @file{foo.ly} ein Feld @code{doctitle} im @code{\header}-Block enthält,
786 wird dessen Wert in die Datei @file{foo.doctitle} geschrieben. Wird die
787 @code{doctitle} Option für ein Musikfragment benutzt, so wird der Inhalt
788 dieser Datei, der eine einzelne Textzeile sein sollte, im Texinfo-Dokument
789 als @code{@@lydoctitle @var{Text}} eingefügt. @code{@@lydoctitle} muss
790 allerdings in Ihrem Texinfo-Dokument als Makro selbst definiert werden.
791 Die Übersetzung funktioniert völlig analog zu @code{texidoc}.
794 Nur für Texinfo-Ausgabe: Kommentare und Variablenbezeichnungen im
795 zitierten Quelltext des Schnipsel werden nicht übersetzt.
798 Wenn eine LilyPond-Datei mittels @code{\lilypondfile} und dieser Option
799 eingebunden wird, wird der Dateiname (ohne die Pfadangabe) unmittelbar vor
800 dem Musikfragment ausgegeben. In HTML-Dateien ist er außerdem ein Link
801 auf die LilyPond-Datei. Nur der eigentliche Name der Datei wird
802 ausgegeben, der Pfad wird also nicht mit angezeigt.
807 @node Vyvolání lilypond-book
808 @section Vyvolání @command{lilypond-book}
809 @translationof Invoking lilypond-book
811 @command{lilypond-book} erzeugt abhängig vom Ausgabeformat eine Datei mit
812 einer der folgenden Dateierweiterungen: @file{.tex}, @file{.texi},
813 @file{.html} oder @file{.xml}. Alle @file{.tex}, @file{.texi} und
814 @file{.xml} Dateien müssen noch mit den entsprechenden Programmen (@LaTeX{},
815 DocBook, etc.) weiter verarbeitet werden, um druckfähige Dateien zu erhalten.
818 @subheading Formatabhängige Anweisungen
820 @subsubheading @LaTeX{}
822 Es existieren zwei Methoden, Ihr @LaTeX{}-Dokument weiter zu verarbeiten,
823 um zu einer druck- oder publikationsfähigen Datei zu gelangen:
824 Zum einen die direkte Erzeugung einer PDF-Datei mit PDF@LaTeX{}, zum
825 anderen die Erzeugung einer DVI daraus einer PostScript-Datei mittels
826 @LaTeX{} und einem DVI-nach-PostScript Konverters wie @command{dvips}.
827 Die erste Methode ist einfacher und daher empfehlenswert.@footnote{Manchmal
828 kann eine Datei entweder von PDF@LaTeX{} oder von @LaTeX{} nicht korrekt
829 verarbeitet werden, weshalb hier beide Methoden beschrieben werden.} Welche
830 Methode auch immer benutzt wird, die Konvertierung zwischen PostScript und
831 PDF kann leicht mit Hilfsprogrammen wie @command{ps2pdf} und @command{pdf2ps}
832 (aus dem Ghostscript-Paket) erfolgen.
834 Um eine PDF-Datei mittels PDF@LaTeX{} zu erzeugen, kann folgendermaßen
838 lilypond-book --pdf Ihre_Datei.pdftex
839 pdflatex Ihre_Datei.tex
842 @cindex Konturschriften
843 @cindex Type1 Schriften
845 @cindex Aufruf von dvips
847 Um eine PDF-Datei mittels @LaTeX{}/@command{dvips}/@command{ps2pdf} zu
848 erhalten, sind folgende Befehle nötig:
851 lilypond-book Ihre_Datei.lytex
853 dvips -Ppdf Ihre_Datei.dvi
858 Die @file{.dvi}-Datei, die beim Aufruf von @command{latex} erzeugt wird,
859 scheint keine Notenköpfe zu enthalten, was in Ordnung ist. Wenn Sie die
860 Datei wie beschrieben weiter verarbeiten, erscheinen die Notenköpfe korrekt
861 in den @file{.ps} und @file{.pdf} Dateien.
863 Der Aufruf von @command{dvips} kann einige Warnungen über fehlende
864 Schriftarten ausgeben. Auch dies ist in Ordnung und kann ignoriert werden.
866 Wenn Sie in der @LaTeX{}-Datei das Papierformat auf Querformat eingestellt
867 haben, vergessen Sie nicht die @code{-t landscape}-Option beim
868 Aufruf von @command{dvips}.
871 @subsubheading Texinfo
873 Um ein von @command{lilypond-book} erzeugtes Texinfo-Dokument zu
874 verarbeiten, gehen Sie wie für alle anderen Texinfo-Dokumente vor:
875 Rufen Sie -- abhängig vom gewünschten Ausgabeformat -- eines der Programme
876 @command{texi2pdf}, @command{texi2dvi}, @command{makeinfo} oder
877 @command{texi2html} auf.
880 @xref{Format with texi2dvi, , , texinfo, GNU Texinfo}, und @ref{Creating an Info File, , , texinfo, GNU Texinfo}.
883 Die Dokumentation von Texinfo liefert dazu nähere Informationen.
887 @subheading Optionen auf der Kommandozeile
889 @command{lilypond-book} unterstützt die folgenden Kommandozeilenoptionen:
892 @item -f @var{Format}
893 @itemx --format=@var{Format}
894 Gibt das Format des Eingabedokuments an: @code{html}, @code{latex},
895 @code{texi} (Standardeinstellung), @code{texi-html} oder @code{docbook}.
896 Ist diese Option nicht angegeben, versucht @command{lilypond-book} das
897 Format anhand des Dateinamens zu bestimmen. Im Moment bedeutet @code{texi}
898 praktisch dasselbe wie @code{texi-html}.
900 @c This complicated detail is not implemented, comment it out -jm
902 The @code{texi} document type produces a Texinfo file with music
903 fragments in the printed output only. For getting images in the HTML
904 version, the format @code{texi-html} must be used instead.
907 @item -F @var{Filter}
908 @itemx --filter=@var{Filter}
909 Leitet die Musikfragmente durch das Programm @var{filter} anstatt sie
910 mit Lilypond zu einer Grafik zu verarbeiten. @option{--filter} und
911 @option{--process} kann nicht gleichzeitig benutzt werden. Beispielaufruf:
914 lilypond-book --filter='convert-ly --from=2.0.0 -' Mein-Buch.tely
919 Gibt eine kurze Hilfemeldung aus.
922 @itemx --include=@var{Pfad}
923 Fügt @var{Pfad} zu den Include-Pfaden hinzu. @command{lilypond-book} sucht
924 auch in allen Include-Pfaden nach bereits erstellten Grafiken für die
925 Musikfragmente. Wird das aktuelle Fragment gefunden und hat sich seit der
926 letzten Erstellung nicht geändert, wird es nicht erneut erzeugt. Bei manchen
927 der Programme zur Weiterverarbeitung wie etwa @command{makeinfo} oder
928 @command{latex} muss dieselbe @code{-I @var{Pfad}} Option angegeben werden,
929 damit das entsprechende Programm die Grafiken ebenso findet.
931 @item -o @var{Verzeichnis}
932 @itemx --output=@var{Verzeichnis}
933 Erzeugt die Ausgabedateien in @var{Verzeichnis}. Der Aufruf von
934 @command{lilypond-book} erzeugt zahlreiche kleine Dateien, die von
935 LilyPond, @command{latex}, @command{makeinfo} etc. dann weiter benützt
936 werden. Um zu vermeiden, dass das Quellenverzeichnis durch diese
937 Dateien unübersichtlich wird, kann die @option{--output} Option benutzt
938 werden. Vor dem Aufruf von @command{latex} oder @command{makeinfo}
939 sollten Sie in dieses Verzeichnis wechseln.
942 lilypond-book --output=out IhreDatei.lytex
947 @itemx --skip-lily-check
948 Nicht mit einer Fehlermeldung abbrechen, wenn keine Ausgabe von LilyPond
949 gefunden wird. Dies wird benutzt für Dokumentation ohne Grafiken.
951 @itemx --skip-png-check
952 Nicht mit einer Fehlermeldung abbrechen, wenn für die EPS-Dateien keine
953 PNG-Grafiken gefunden werden. Dies wird benutzt für Dokumentation ohne
956 @itemx --lily-output-dir=@var{Verzeichnis}
957 Schreibt @file{lily-XXX} Dateien nach @var{Verzeichnis} und erzeugt
958 im mit @code{--output} angegebenen Verzeichnis Verknüpfungen darauf.
959 Diese Option ist nützlich, um Zeit zu sparen, wenn Dokumente in
960 verschiedenen Verzeichnissen viele identische Musikfragmente
963 @itemx --info-images-dir=@var{Verzeichnis}
964 Formatiert die Texinfo-Ausgabe dergestalt, dass Info in @var{Verzeichnis}
965 nach den Grafiken zu den Musikfragmenten sucht.
967 @itemx --latex-program=@var{Programm}
968 Führt @command{Programm} anstelle von @command{latex} aus. Dies ist
969 nützlichen, wenn das Dokument mit einer anderen @LaTeX{}-Variante
970 wie etwa @command{xelatex} verarbeitet werden soll.
972 @itemx --left-padding=@var{Einrückung}
973 Fügt @var{Einrückung} als zusätzlichen Einzug in die EPS-Box ein.
974 @var{Einrückung} wird in Millimetern angegeben, die Standardeinstellung
975 ist 3.0 Millimeter. Diese Option kann benutzt werden, wenn die Notenzeilen
976 über den Rand des Dokuments hinausstehen.
978 Die Breite eines eng ausgeschnittenen Notensystems kann variieren
979 aufgrund von Notationselementen, die über den linken Rand hinausstehen,
980 wie etwa Taktzahlen und Bezeichnungen der Instrumente. Diese Option
981 verkürzt die Notenzeile und verschiebt sie um denselben Betrag nach
985 @item -P @var{Befehl}
986 @itemx --process=@var{Befehl}
987 Verarbeitet LilyPond-Fragmente mit @var{Befehl} anstelle des
988 Standardbefehls @code{lilypond}. @code{--filter} und @code{--process}
989 können nicht mit dieser Option benutzt werden.
992 Erzeugt PDF-Dateien mit PDF@LaTeX{}.
996 Gibt ausführliche informative Meldungen aus.
1000 Gibt die Versionsnummer aus.
1005 Der Texinfo-Befehl @code{@@pagesizes} wird ignoriert. Ebenso werden
1006 @LaTeX{}-Befehle ignoriert, die den Seitenrand oder die Zeilenlänge
1007 nach der Dokumentpräambel verändern.
1009 Nur der erste @code{\score}-Block eines LilyPond-Fragments wird verarbeitet.
1012 @node Souborové přípony
1013 @section Souborové přípony
1014 @translationof Filename extensions
1016 Für die Eingabedatei kann zwar jede beliebige Dateinamenserweiterung benutzt
1017 werden, allerdings muss bei Verwendung einer nicht bekannten Erweiterung
1018 das Ausgabeformat explizit an @command{lilypond-book} angegeben werden.
1019 Details dazu finden sich im Abschnitt @ref{Vyvolání lilypond-book}.
1020 Wird eine bekannte Erweiterung benutzt, wählt @command{lilypond-book}
1021 automatisch das richtige Ausgabeformat basierend auf der Erweiterung der
1025 @multitable @columnfractions .2 .5
1026 @item @strong{Erweiterung} @tab @strong{Ausgabeformat}
1028 @item @file{.html} @tab HTML
1029 @item @file{.itely} @tab Texinfo
1030 @item @file{.latex} @tab @LaTeX{}
1031 @item @file{.lytex} @tab @LaTeX{}
1032 @item @file{.lyxml} @tab DocBook
1033 @item @file{.tely} @tab Texinfo
1034 @item @file{.tex} @tab @LaTeX{}
1035 @item @file{.texi} @tab Texinfo
1036 @item @file{.texinfo} @tab Texinfo
1037 @item @file{.xml} @tab HTML
1041 Wird dieselbe Erweiterung für die Eingabedatei wie für die Ausgabedatei
1042 benutzt und befindet sich die Eingabedatei im aktuellen Arbeitsverzeichnis
1043 von @command{lilypond-book}, muss die @code{--output} Option für
1044 @command{lilypond-book} benutzt werden. Anderenfalls würde
1045 @command{lilypond-book} ja die Eingabedatei überschreiben, weshalb das
1046 Programm in diesem Fall mit einer Fehlermeldung wie @qq{Fehler: Ausgabe
1047 würde Eingabedatei überschreiben; verwenden Sie --output.} abbricht.
1050 @node Předlohy pro lilypond-book
1051 @section Předlohy pro @command{lilypond-book}
1052 @translationof lilypond-book templates
1054 Diese Vorlagen sollen mit @code{lilypond-book} benutzt werden. Wenn Sie sich
1055 mit dem Programm nicht auskennen, lesen Sie bitte
1056 @ref{lilypond-book}.
1060 Sie können LilyPond-Fragmente in ein LaTeX-Dokument einfügen:
1063 \documentclass[]@{article@}
1067 Normaler LaTeX-Text.
1075 Weiterer LaTeX-Text und Optionen in eckigen Klammern.
1077 \begin@{lilypond@}[fragment,relative=2,quote,staffsize=26,verbatim]
1085 LilyPond-Fragmente können in Texinfo-Dokumente eingefügt werden: dieses gesamte
1086 Handbuch wurde in Texinfo geschrieben.
1089 \input texinfo @c -*-texinfo-*-
1101 Weiterer Texinfo-Text und Optionen in Klammern.
1103 @@lilypond[verbatim,fragment,ragged-right]
1114 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1120 Dokumente für lilypond-book können Noten und Text frei kombinieren. Zum
1130 Noch etwas LilyPond, mit Optionen:
1132 <lilypond fragment quote staffsize=26 verbatim>
1146 \documentclass{article}
1147 \usepackage{ifxetex}
1149 %xetex specific stuff
1150 \usepackage{xunicode,fontspec,xltxtra}
1151 \setmainfont[Numbers=OldStyle]{Times New Roman}
1154 %This can be empty if you are not going to use pdftex
1155 \usepackage[T1]{fontenc}
1156 \usepackage[utf8]{inputenc}
1157 \usepackage{mathptmx}%Times
1158 \usepackage{helvet}%Helvetica
1160 %Here you can insert all packages that pdftex also understands
1161 \usepackage[ngerman,finnish,english]{babel}
1162 \usepackage{graphicx}
1165 \title{A short document with LilyPond and xelatex}
1168 Normal \textbf{font} commands inside the \emph{text} work,
1169 because they \textsf{are supported by \LaTeX{} and XeteX.}
1170 If you want to use specific commands like \verb+\XeTeX+, you
1171 should include them again in a \verb+\ifxetex+ environment.
1172 You can use this to print the \ifxetex \XeTeX{} command \else
1173 XeTeX command \fi which is not known to normal \LaTeX .
1175 In normal text you can easily use LilyPond commands, like this:
1184 The fonts of snippets set with LilyPond will have to be set from
1186 of the snippet. For this you should read the AU on how to use
1192 @node Sdílení obsahu
1193 @section Sdílení obsahu
1194 @translationof Sharing the table of contents
1196 Diese Funktionen existieren schon im OrchestraLily-Paket:
1199 @url{http://repo.or.cz/w/orchestrallily.git}
1202 Um den Text flexibler behandeln zu können, bevorzugen manche Benutzer es,
1203 das Inhaltsverzeichnis aus LilyPond zu exportieren und dann mit
1204 @LaTeX{} einzulesen.
1206 @subsubheading Das Ihaltsverzeichnis (ToC) aus LilyPond exportieren
1208 Hier wird angenommen, dass in Ihrer Partitur mehrere Sätze vorkommen, die
1209 sich alle in der selben LilyPond-Datei befinden.
1212 #(define (oly:create-toc-file layout pages)
1213 (let* ((label-table (ly:output-def-lookup layout 'label-page-table)))
1214 (if (not (null? label-table))
1215 (let* ((format-line (lambda (toc-item)
1216 (let* ((label (car toc-item))
1217 (text (caddr toc-item))
1218 (label-page (and (list? label-table)
1219 (assoc label label-table)))
1220 (page (and label-page (cdr label-page))))
1221 (format #f "~a, section, 1, @{~a@}, ~a" page text label))))
1222 (formatted-toc-items (map format-line (toc-items)))
1223 (whole-string (string-join formatted-toc-items ",\n"))
1224 (output-name (ly:parser-output-name parser))
1225 (outfilename (format "~a.toc" output-name))
1226 (outfile (open-output-file outfilename)))
1227 (if (output-port? outfile)
1228 (display whole-string outfile)
1229 (ly:warning (_ "Unable to open output file ~a for the TOC information") outfilename))
1230 (close-output-port outfile)))))
1233 #(define (page-post-process layout pages) (oly:create-toc-file layout pages))
1237 @subsubheading Das Inhaltsverzeichnis in LaTeX importieren
1239 In der LaTeX-Datei sollte folgendes enthalten:
1241 @c no, this doesn't require the smallexample, but since the other
1242 @c two blocks on this page use it, I figured I might as well
1243 @c user it here as well, for consistency. -gp
1245 \usepackage@{pdfpages@}
1246 \includescore@{nameofthescore@}
1250 wobei @code{\includescore} wiefolgt definiert ist:
1253 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1254 % \includescore@{PossibleExtension@}
1255 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1257 % Read in the TOC entries for a PDF file from the corresponding .toc file.
1258 % This requires some heave latex tweaking, since reading in things from a file
1259 % and inserting it into the arguments of a macro is not (easily) possible
1261 % Solution by Patrick Fimml on #latex on April 18, 2009:
1262 % \readfile@{filename@}@{\variable@}
1263 % reads in the contents of the file into \variable (undefined if file
1265 \newread\readfile@@f
1266 \def\readfile@@line#1@{%
1267 @{\catcode`\^^M=10\global\read\readfile@@f to \readfile@@tmp@}%
1268 \edef\do@{\noexpand\g@@addto@@macro@{\noexpand#1@}@{\readfile@@tmp@}@}\do%
1269 \ifeof\readfile@@f\else%
1270 \readfile@@line@{#1@}%
1273 \def\readfile#1#2@{%
1274 \openin\readfile@@f=#1 %
1276 \typeout@{No TOC file #1 available!@}%
1279 \readfile@@line@{#2@}%
1281 \closein\readfile@@f%
1285 \newcommand@{\includescore@}[1]@{
1286 \def\oly@@fname@{\oly@@basename\@@ifmtarg@{#1@}@{@}@{_#1@}@}
1287 \let\oly@@addtotoc\undefined
1288 \readfile@{\oly@@xxxxxxxxx@}@{\oly@@addtotoc@}
1289 \ifx\oly@@addtotoc\undefined
1290 \includepdf[pages=-]@{\oly@@fname@}
1292 \edef\includeit@{\noexpand\includepdf[pages=-,addtotoc=@{\oly@@addtotoc@}]
1293 @{\oly@@fname@}@}\includeit
1299 @node Náhradní způsoby míchání not a textu
1300 @section Náhradní způsoby míchání not a textu
1301 @translationof Alternate methods of mixing text and music
1303 Andere Methoden, Text und Noten miteinander zu kombinieren (ohne
1304 @command{lilypond-book} zu benutzen) werden beschrieben in
1305 @ref{LilyPond-Ausgabe in anderen Programmen}.