Guide, node Updating translation committishes..
@end ignore
-@c \version "2.16.0"
+@c \version "2.19.21"
@c Translators: Reinhold Kainhofer, Till Paala
@c Translation checkers: Till Paala
@chapter @command{lilypond} starten
@translationof Running lilypond
-Dieses Kapitel behandelt die technischen Details, wie Lilypond ausgeführt werden kann.
+Dieses Kapitel behandelt die technischen Details, wie LilyPond ausgeführt werden kann.
@menu
@translationof Normal usage
Die meisten Benutzer führen LilyPond von einer graphischen Benutzeroberfläche
-aus. Siehe @rlearning{Übung}, falls Sie dies nicht bereits getan haben. Wenn
+aus. Siehe @rlearning{Tutorium}, falls Sie dies nicht bereits getan haben. Wenn
Sie einen alternativen Editor für Ihre LilyPond-Dateien verwenden, lesen Sie
bitte die Dokumentation dieses Editors.
@code{stdin} einzulesen, benutzen Sie einfach einen Bindestrich (@code{-})
als @var{Dateiname}.
-Wenn Lilypond die Datei @file{Dateiname.ly} verarbeitet, werden daraus
+Wenn LilyPond die Datei @file{Dateiname.ly} verarbeitet, werden daraus
die Dateien @file{Dateiname.ps} und @file{Dateiname.pdf} erzeugt.
Es können an @code{lilypond} auch mehrere @file{.ly} Dateien übergeben
werden, die dann einzeln und voneinander unabhängig abgearbeitet
werden die weiteren Stücke in durchnummerierte Dateien der Form
@file{Dateiname-1.pdf} ausgegeben. Zusätzlich wird der Wert der
Variable @code{output-suffix} zwischen den ursprünglichen Dateinamen
-und der Zahl eingefügt. Eine Lilypond-Datei @file{Dateiname.ly} mit dem Inhalt
+und der Zahl eingefügt. Eine LilyPond-Datei @file{Dateiname.ly} mit dem Inhalt
@example
#(define output-suffix "Geige")
@table @code
-@item -d,--define-default=@var{Variable}=@var{Wert}
+@item -b, --bigpdfs
+@cindex bigpdfs
+
+Mit dieser Option generierte PDF-Dateien sind deutlich größer als normal,
+weil keine oder nur minimale Zeichensatz-Optimierung erfolgt. Werden
+jedoch zwei oder mehr solcher PDF-Dateien in @w{@code{pdftex}-},
+@w{@code{xetex}-} oder @w{@code{luatex}}-Dokumente eingebunden und
+anschließend mit ghostscript nachbearbeitet, entstehen deutlich
+kleinere PDF-Dokumente, da ghostscript die Zeichensatzdaten auf
+diesem Weg viel besser komprimieren kann.
+
+Nach
+
+@example
+lilypond -b myfile
+@end example
+
+@noindent
+sollte @code{ghostscript} wie folgt ausgeführt werden.
+
+@example
+gs -q -sDEVICE=pdfwrite -o gsout.pdf myfile.pdf
+@end example
+
+Mit Hilfe von
+@uref{https://code.google.com/p/pdfsizeopt/,@code{pdfsizeopt.py}}
+kann die Ausgabedatei noch mehr verkleinert werden.
+
+@example
+pdfsizeopt.py --use-multivalent=no gsout.pdf final.pdf
+@end example
+
+@item -d, --define-default=@var{Variable}=@var{Wert}
Siehe @ref{Fortgeschrittene Optionen auf der Kommandozeile für LilyPond}.
@cindex Scheme, Auswertung von Ausdrücken
@cindex Auswertung von Ausdrücken, Scheme
-@item -e,--evaluate=@var{expr}
+@item -e, --evaluate=@var{expr}
Wertet den Scheme-Ausdruck @var{expr} aus, bevor die @file{.ly} Dateien
gelesen und interpretiert werden.
Die @code{-e} Option kann auch mehrfach angegeben werden, die Ausdrücke
@cindex Ausgabeformat
-@item -f,--format=@var{Format}
+@item -f, --format=@var{Format}
Bestimmt das Ausgabeformat. Mögliche Werte von @var{Format} sind
@code{svg}, @code{ps}, @code{pdf} und @code{png}.
Beispiel: @code{lilypond -fpng @var{Dateiname}.ly}
-@item -h,--help
+@item -h, --help
Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
-@item -H,--header=@var{FELD}
+@item -H, --header=@var{FELD}
Gibt den Inhalt eines Feldes aus dem @code{\header}-Block in die Datei
@file{Dateiname.@var{FELD}} aus.
-@item -i,--init=@var{Initialisierungsdatei}
+@item -i, --init=@var{Initialisierungsdatei}
Benutzt @var{Initialisierungsdatei} zur gesamten Programminitialisierung. Der
Standardwert ist @file{init.ly}.
@cindex Kerker, Programm ausführen
@cindex Jail, Programm ausführen
-@item -j,--jail=@var{Benutzer},@var{Gruppe},@var{Jail-Verzeichnis},@var{Arbeitsverzeichnis}
+@item -j, --jail=@var{Benutzer},@var{Gruppe},@var{Jail-Verzeichnis},@var{Arbeitsverzeichnis}
Führt @command{lilypond} in einem chroot-Jail aus.
Die @option{--jail} Option ist eine flexiblere Alternative zu @option{-dsafe}, wenn
wie im tatsächlichen Wurzel-Dateisystem). Die gesamte LilyPond-Installation
(typischerweise @file{/usr/share/lilypond}) sollte kopiert werden.
-Falls Probleme auftreten, ist es am einfachsten, Lilypond mittels
+Falls Probleme auftreten, ist es am einfachsten, LilyPond mittels
@command{strace} zu starten, wodurch Sie relativ leicht feststellen können,
welche Dateien im Jail noch fehlen.
@cindex Logstufe
@cindex Ausgabe, Ausführlichkeit
-@item -l,--loglevel=@var{Logstufe}
+@item -l, --loglevel=@var{Logstufe}
Passt die Ausführlichkeit der Ausgabe auf der Kommandozeile entsprechend
@var{Logstufe} an. Mögliche Werte sind:
@cindex Ausgabedateiname
@cindex Dateiname der Ausgabe bestimmen
-@item -o,--output=@var{DATEI} oder @var{ORDNER}
+@item -o, --output=@var{DATEI} oder @var{ORDNER}
Schreibt das Ergebnis der Verarbeitung mit LilyPond in die Ausgabedatei
@var{DATEI}. Wenn ein Verzeichnis mit dem Namen existiert, werden die Ausgabedateien
in dieses Verzeichnis gespeichert, wobei der Dateiname der Eingabedatei
@item --pdf
Erzeugt PDF-Dateien. Dies impliziert @code{--ps}.
-@item -v,--version
+@item -v, --version
Gibt die Versionsnummer aus.
-@item -V,--verbose
+@item -V, --verbose
Gibt ausführliche informative Meldungen aus: Zeigt die vollen Dateipfade
aller gelesenen Dateien sowie Informationen über die Laufzeit.
-@item -w,--warranty
+@item -w, --warranty
Zeigt die Garantiebedingungen an, unter denen GNU LilyPond steht. (Es besteht
@strong{KEINERLEI GARANTIE}!)
@code{EPS}-Backend.
@item @code{backend}
-@tab @code{'ps}
+@tab @code{ps}
@tab Auswahl des Backend. Poststscript-Dateien (Standart) enthalten
@code{TTF}, @code{Type1} und @code{OTF}-Schriftarten. Ihr Zeichenvorrat
wird nicht reduziert (Subsetting). Die Benutzung von östlichen
Schriftarten kann zu sehr großen Dateien führen.
@item
-@tab @code{'eps}
+@tab @code{eps}
@tab Encapsulated PostScript. Hiermit wird jede Seite (System) als eine
eigene @file{EPS}-Datei gespeichert, ohne Schriftarten, sowie als eine
kombinierte @file{EPS}-Datei mit allen Seiten (Systemen) inclusive
Schriftarten. Wird als Standard von @command{lilypond-book} benützt.
@item
-@tab @code{'null}
+@tab @code{null}
@tab Keine graphische Partitur ausgeben; hat den gleichen Effekt wie
@code{-dno-print-pages}.
@item
-@tab @code{'svg}
+@tab @code{svg}
@tab Scalable Vector Graphics. Hiermit wird eine einzelne @code{SVG}-Datei
für jede Seite der Ausgabe erstellt, ohne Schriftarten. Es wird
empfohlen, die Century Schoolbook-Schriftarten zu installieren, welche
(siehe unten) um woff-Schriftarten im SVG-Backend zu benützen.
@item
-@tab @code{'scm}
+@tab @code{scm}
@tab Ausgabe der rohen internen Scheme-basierten Zeichnungsbefehle.
@item @code{check-internal-types}
@item @code{strict-infinity-checking}
@tab @code{#f}
-@tab Erzwinge einen Programmabsturz wenn @code{Inf} und @code{NaN}
+@tab Erzwinge einen Programmabsturz wenn @code{Inf} und @code{NaN}
Fließkommaausnahmen gefunden werden.
@item @code{strip-output-dir}
@command{lilypond} erkennt und benützt die folgenden Umgebungsvariablen:
@table @code
@item LILYPOND_DATADIR
-Diese Variable gibt das Verzeichnis an, wo Lilypond seine eigenen Dateien,
+Diese Variable gibt das Verzeichnis an, wo LilyPond seine eigenen Dateien,
Meldungen und Übersetzungen finden kann. Dieses Verzeichnis sollte
Unterverzeichnisse @file{ly/}, @file{ps/}, @file{tex/}, etc. beinhalten.
Diese Stellen sind LilyPonds Vermutung, wo die Warnung oder der Fehler
aufgetreten ist, allerdings treten Warnungen und Fehler ja gerade in
-unerwarteten Fällen auf. Manchmal kann Lilypond auch eine fehlerhafte
+unerwarteten Fällen auf. Manchmal kann LilyPond auch eine fehlerhafte
Stelle zwar noch problemlos verarbeiten, ein paar Zeilen später wirkt
sich der Fehler aber dann doch noch aus. In solchen Fällen, wo Sie in
der angegebenen Zeile keinen Fehler erkennen, sollten Sie auch die Zeilen
rot macht, aber als Resultat hat man zwei Systeme, während die
Notenköpfe immernoch schwarz im unteren System erscheinen.
-@lilypond[quote,verbatim,relative=2]
-\override Staff.NoteHead #'color = #red
-\new Staff { a }
+@lilypond[quote,verbatim,fragment]
+\override Staff.NoteHead.color = #red
+\new Staff { a' }
@end lilypond
Das liegt daran, dass kein @code{Staff}-Kontext existiert, wenn
noch ein zusätzliches System, wo die Noten gesetzt werden. Die
richtige Schreibweise wäre:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim]
\new Staff {
- \override Staff.NoteHead #'color = #red
- a
+ \override Staff.NoteHead.color = #red
+ a'
}
@end lilypond
@lilypond[quote,verbatim]
\repeat unfold 2 {
- \relative c' { c4 d e f }
+ \relative { c'4 d e f }
}
@end lilypond
@lilypond[quote,verbatim]
\new Voice {
\repeat unfold 2 {
- \relative c' { c4 d e f }
+ \relative { c'4 d e f }
}
}
@end lilypond
Diese Fehlermeldung erscheint in der Kommandozeilenausgabe, wenn die
Datei ein Zeichen enthält, das nicht zu ASCII gehört und die Datei
-nicht in UTF-8-Kodierung gespeichert wurd. Sie auch @ruser{Zeichenkodierung}.
+nicht in UTF-8-Kodierung gespeichert wurd. Siehe auch @ruser{Zeichenkodierung}.
@node Warnung über absteigende staff affinities
zu Beginn hinzufügt:
@example
-\override VerticalAxisGroup #'staff-affinity = ##f
+\override VerticalAxisGroup.staff-affinity = ##f
@end example
Zu Einzelheiten siehe @qq{Abstand von Nicht-Notensystemzeilen} in
projects / lilypond.git / blobdiff