1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond-program.tely
4 Translation of GIT committish: 76de7e168dbc9ffc7671d99663c5ce50dae42abb
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
15 In diesem Kapitel werden verschiedene Konfigurationsoptionen für LilyPond und
16 andere Programme behandelt, die nach der Installation auszuführen sind. Dieses
17 Kapitel kann als Referenz betrachtet werden, lesen Sie einen Abschnitt nur,
18 wenn er auf Sie zutrifft.
21 * Setup for specific Operating Systems::
22 * Text editor support::
27 @node Setup for specific Operating Systems
28 @section Setup for specific Operating Systems
30 Dieser Abschnitt erklärt zusätzliche Einstellungen für bestimmte Betriebssysteme.
33 * MacOS X on the command-line::
37 @node MacOS X on the command-line
38 @subsection MacOS X on the command-line
40 Die Skripte (wie lilypond-book, convert-ly, abc2ly und sogar
41 lilypond selber) sind innerhalb der MacOS X .app enthalten. Sie können
42 auf der Kommandozeile direkt aufgerufen werden, etwa
45 @var{Pfad/zu}/LilyPond.app/Contents/Resources/bin/lilypond
48 Entsprechend funktionieren auch die anderen Skripte wie lilypond-book,
49 convert-ly, abc2ly usw.
51 Sie können sich auch selber Skripte anlegen, die diesen Pfad automatisch
52 hinzufügen. Erstellen Sie ein Verzeichnis, indem die Skripte gespeichert werden:
59 Erstellen Sie eine Datei mit dem Namen @code{lilypond} und dem Inhalt
62 exec @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
65 Erstellen Sie entsprechende Dateien mit den Namen @code{lilypond-book},
66 @code{convert-ly} und den Namen der anderen Hilfsprogramme, die Sie benutzen
67 (@code{abc2ly}, @code{midi2ly} usw.). Ersetzen Sie einfach den Teil
68 @code{bin/lilypond} mit @code{bin/convert-ly} (oder einem anderen
69 Programmnamen) in der entsprechenden Datei.
71 Machen Sie die Datei ausführbar:
77 Jetzt müssen Sie dieses Verzeichnis noch zu Ihrem Pfad (PATH) hinzufügen.
78 Verändern Sie die Datei @code{.profile} in Ihrem Benutzerverzeichnis
79 (oder erstellen Sie sie), dass sie die Zeile
82 export PATH=$PATH:~/bin
86 beinhaltet. Die Datei muss mit einer Leerzeile enden.
88 Beachten Sie, dass @var{Pfad/zu} üblicherweise @code{/Applications/} ist.
91 @node Text editor support
92 @section Text editor support
97 @cindex Modus, Editoren
98 @cindex Syntax-Hervorhebung
99 @cindex Hervorhebung der Syntax
101 Verschiedene Texteditoren haben Unterstützung für LilyPond.
112 @subsection Emacs mode
114 Emacs hat einen LilyPond-Modus (@file{lilypond-mode}), eine Datei, die
115 die Vervollständigung von Befehlen, Einrückungen, für LilyPond spezifische
116 Klammerschließungen und die Markierung der Syntax beherrscht.
117 Zusätzlich stehen noch praktische Tastaturkombinationen zum
118 Programmaufruf und zum Nachschlagen in den Handbüchern zur
119 Verfügung. Siehe unten, wenn die Datei @file{lilypond-mode}
120 sich nicht auf Ihrem Computer befindet.
122 Der Emacs-Modus zur Noteneingabe und zum Programmaufruf ist
123 in den Emacs-Quellen im @file{elisp}-Verzeichnis enthalten. Mit
124 dem Befehl @command{make install} können Sie es nach @var{elispdir}
125 installieren. Die Datei @file{lilypond-init.el} sollte in
126 @var{load-path}@file{/site-start.d/} liegen oder Ihrem
127 @file{~/.emacs} or @file{~/.emacs.el} hinzugefügt werden.
129 Als Benutzer können Sie Ihren Quellenpfad (etwa @file{~/site-lisp/})
130 ihrem @var{load-path} hinzufügen, indem Sie folgende Zeile zu Ihrer
131 @file{~/.emacs}-Datei hinzufügen:
133 @c any reason we do not advise: (push "~/site-lisp" load-path)
135 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
142 Für @uref{http://@/www@/.vim@/.org,VIM} wird ein @file{vimrc} bereitgestellt,
143 zusammen mit Werkzeugen zur Syntaxauszeichnung. Ein Vim-Modus zur
144 Noteneingabe und zum Programmaufruf befindet sich im Quellarchiv im
145 @code{$VIM}-Verzeichnis.
147 LilyPond-Dateien werden automatisch erkannt, wenn sich in der Datei
148 @file{~/.vim/filetype.vim} folgender Inhalt befindet:
151 if exists("did_load_filetypes")
154 augroup filetypedetect
155 au! BufNewFile,BufRead *.ly setf lilypond
159 Fügen Sie den LilyPond-Pfad in ihre
160 @file{~/.vimrc}-Datei ein, indem Sie ihre folgende Zeile hinzufügen:
163 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
167 Dabei wird $@{LILYPOND_VERSION@}durch Ihre LilyPond-Version ersetzt. Sollten
168 Sie LilyPond nicht nach @file{/usr/local/} installiert haben, müssen Sie den
169 Pfad entsprechend anpassen.
175 Das Plugin für den @uref{http://@/www@/.jedit@/.org@/,jEdit}-Texteditor,
176 LilyPondTool genannt, ist das vielfältigste textbasierte Werkzeug, um
177 LilyPond-Notationsdateien zu editieren. Zu den besonderen Eigenschaften
178 gehört ein Dokument-Ersteller mit Liedtextunterstützung, der die Neuerstellung
179 von Dateien erleichtert, und ein integriertes PDF-Anzeigeprogramm mit
180 @qq{point-and-click}-Unterstützung. Demos, Bildschirmphotos und
181 Installationsanweisungen finden sich unter
182 @uref{http://lilypondtool@/.organum@/.hu}
189 @uref{http://@/www@/.uoregon@/.edu/~koch/texshop/index@/.html,TexShop}-Editor
190 für Mac OS X kann erweitert werden, um LilyPond, lilypond-book und convert-ly aus dem
191 Editor heraus zu starten. Die Erweiterung findet sich unter
192 @uref{http://@/www@/.dimi@/.uniud@/.it/vitacolo/freesoftware@/.html}.
198 Es gibt ein LilyPond-Paket für TextMate. Es kann installiert werden, indem man
201 mkdir -p /Library/Application\ Support/TextMate/Bundles
202 cd /Library/Application\ Support/TextMate/Bundles
203 svn co http://macromates.com/svn/Bundles/trunk/Bundles/Lilypond.tmbundle/
210 @node Point and click
211 @section Point and click
212 @cindex Point and click
215 Point and click erlaubt es, die Noten in der Quelldatei zu finden, indem man sie
216 im PDF anklickt. Das erleichtert es, fehlerhafte Stellen zu finden.
218 Wenn diese Funktionalität aktiv ist, fügt LilyPond Hyperlinks zum PDF hinzu.
219 Diese werden dann bei einem Klick zum Browser geschickt, der wiederum
220 einen Texteditor mit dem Cursor an der richtigen Stelle öffnet.
222 Damit diese Kettenreaktion funktioniert, müssen Sie ihrem PDF-Programm
223 mit dem Skript @file{lilypond-invoke-editor} beibringen, Hyperlinks zu folgen.
225 Im Falle von Xpdf auf einer Unix-Maschine sollte folgende Zeile in der Datei
226 @file{xpdfrc}@footnote{Unter Unix befindet sich diese Datei entweder in
227 @file{/etc/xpdfrc} oder als @file{.xpdfrc} in Ihrem Heim-Verzeichnis.} stehen.
230 urlCommand "lilypond-invoke-editor %s"
233 Das Programm @file{lilypond-invoke-editor} ist ein kleines Hilfsprogramm.
234 Es ruft einen Editor auf für bestimmte @code{textedit}-URIs und startet
235 einen Browser für die anderen. Die Umgebungsvariable @code{EDITOR}
236 wird für folgende Zeichenketten:
242 emacsclient --no-wait +@var{line}:@var{column} @var{file}
247 gvim --remote +:@var{line}:norm@var{char} @var{file}
253 nc -noask +@var{line} @var{file}'
257 Die Umgebungsvariable @code{LYEDITOR} wird verwendet, um dieses zu
258 überschreiben. Sie enthält den Befehl, um den Editor aufzurufen, wobei
259 die Variablen @code{%(file)s},
260 @code{%(column)s}, @code{%(line)s} mit der Datei, Spalte und Zeile
261 ersetzt werden. Die Einstellung
264 emacsclient --no-wait +%(line)s:%(column)s %(file)s
268 für @code{LYEDITOR} etwa entspricht dem von vornherein eingestellten
272 @cindex Dateigröße, Ausgabedatei
274 Die point and click-Links vergrößern die Notationsdatei erheblich. Um die
275 Größe der PDF- und PS-Dateien zu verringern, kann point and click
276 ausgeschaltet werden, indem die Zeile
279 #(ly:set-option 'point-and-click #f)
283 in der @file{.ly}-Datei gesetzt wird. Alternativ erreichen Sie das auch mit einer
284 Kommandozeilenoption:
287 lilypond -dno-point-and-click file.ly