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.
13 In diesem Kapitel werden verschiedene Konfigurationsoptionen für LilyPond und
14 andere Programme behandelt, die nach der Installation auszuführen sind. Dieses
15 Kapitel kann als Referenz betrachtet werden, lesen Sie einen Abschnitt nur,
16 wenn er auf Sie zutrifft.
19 * Setup for specific Operating Systems::
20 * Text editor support::
25 @node Setup for specific Operating Systems
26 @section Setup for specific Operating Systems
28 Dieser Abschnitt erklärt zusätzliche Einstellungen für bestimmte Betriebsysteme.
31 * MacOS X on the command-line::
35 @node MacOS X on the command-line
36 @subsection MacOS X on the command-line
38 Die Skripte (wie lilypond-book, convert-ly, abc2ly und sogar
39 lilypond selber) sind innerhalb der MacOS X .app enthalten. Sie können
40 auf der Kommandozeile direkt aufgerufen werden, etwa
43 @var{Pfad/zu}/LilyPond.app/Contents/Resources/bin/lilypond
46 Entsprechend funktionieren auch die anderen Skripte wie lilypond-book,
47 convert-ly, abc2ly usw.
49 Sie können sich auch selber Skripte anlegen, die diesen Pfad automatisch
50 hinzufügen. Erstellen Sie ein Verzeichnis, indem die Skripte gespeichert werden:
57 Erstellen Sie eine Datei mit dem Namen @code{lilypond} und dem Inhalt
60 exec @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
63 Erstellen Sie entsprechende Dateien mit den Namen @code{lilypond-book},
64 @code{convert-ly} und den Namen der anderen Hilfsprogramme, die Sie benutzen
65 (@code{abc2ly}, @code{midi2ly} usw.). Ersetzen Sie einfach den Teil
66 @code{bin/lilypond} mit @code{bin/convert-ly} (oder einem anderen
67 Programmnamen) in der entsprechenden Datei.
69 Machen Sie die Datei ausführbar:
75 Jetzt müssen Sie dieses Verzeichnis noch zu Ihrem Pfad (PATH) hinzufügen.
76 Verändern Sie die Datei @code{.profile} in Ihrem Benutzerverzeichnis
77 (oder erstellen Sie sie), dass sie die Zeile
80 export PATH=$PATH:~/bin
84 beinhaltet. Die Datei muss mit einer Leerzeile enden.
86 Beachten Sie, dass @var{Pfad/zu} überlicherweise @code{/Applications/} ist.
89 @node Text editor support
90 @section Text editor support
95 @cindex Modus, Editoren
96 @cindex Syntax-Hervorhebung
97 @cindex Hervorhebung der Syntax
99 Verschiedene Texteditoren haben Unterstützung für LilyPond.
110 @subsection Emacs mode
112 Emacs hat einen LilyPond-Modus (@file{lilypond-mode}), eine Datei, die
113 die Verfollständigung von Befehlen, Einrückungen, für LilyPond spezifische
114 Klammerschließungen und die Markierung der Syntax beherrscht.
115 Zusätzlich stehen noch praktische Tastaturkombinationen zum
116 Programmaufruf und zum Nachschlagen in den Handbüchern zur
117 Verfügung. Siehe unten, wenn die Datei @file{lilypond-mode}
118 sich nicht auf Ihrem Computer befindet.
120 Der Emacs-Modus zur Noteneingabe und zum Programmaufruf ist
121 in den Emacs-Quellen im @file{elisp}-Verzeichnis enthalten. Mit
122 dem Befehl @command{make install} können Sie es nach @var{elispdir}
123 installieren. Die Datei @file{lilypond-init.el} sollte in
124 @var{load-path}@file{/site-start.d/} liegen oder Ihrem
125 @file{~/.emacs} or @file{~/.emacs.el} hinzugefügt werden.
127 Als Benutzer können Sie Ihren Quellenpfad (etwa @file{~/site-lisp/})
128 ihrem @var{load-path} hinzufügen, indem Sie folgende Zeile zu Ihrer
129 @file{~/.emacs}-Datei hinzufügen:
131 @c any reason we do not advise: (push "~/site-lisp" load-path)
133 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
140 Für @uref{http://@/www@/.vim@/.org,VIM} wird ein @file{vimrc} bereitgestellt,
141 zusammen mit Werkzeugen zur Syntaxauszeichnung. Ein Vim-Modus zur
142 Noteneingabe und zum Programmaufruf befindet sich im Quellarchiv im
143 @code{$VIM}-Verzeichnis.
145 LilyPond-Dateien werden automatisch erkannt, wenn sich in der Datei
146 @file{~/.vim/filetype.vim} folgender Inhalt befindet:
149 if exists("did_load_filetypes")
152 augroup filetypedetect
153 au! BufNewFile,BufRead *.ly setf lilypond
157 Fügen Sie den LilyPond-Pfad in ihre
158 @file{~/.vimrc}-Datei ein, indem Sie ihre folgende Zeile hinzufügen:
161 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
165 Dabei wird $@{LILYPOND_VERSION@}durch Ihre LilyPond-Version ersetzt. Sollten
166 Sie LilyPond nicht nach @file{/usr/local/} installiert haben, müssen Sie den
167 Pfad entsprechend anpassen.
173 Das Plugin für den @uref{http://@/www@/.jedit@/.org@/,jEdit}-Texteditor,
174 LilyPondTool genannt, ist das vielfältigste textbasierte Werkzeug, um
175 LilyPond-Notationsdateien zu editieren. Zu den besonderen Eigenschaften
176 gehört ein Dokument-Ersteller mit Liedtextunterstützung, der die Neuerstellung
177 von Dateien erleichtert, und ein integriertes PDF-Anzeigeprogramm mit
178 @qq{point-and-click}-Unterstützung. Demos, Bildschirmphotos und
179 Installationsanweisungen finden sich unter
180 @uref{http://lilypondtool@/.organum@/.hu}
187 @uref{http://@/www@/.uoregon@/.edu/~koch/texshop/index@/.html,TexShop}-Editor
188 für Mac OS X kann erweitert werden, um LilyPond, lilypond-book und convert-ly aus dem
189 Editor heraus zu starten. Die Erweiterung findet sich unter
190 @uref{http://@/www@/.dimi@/.uniud@/.it/vitacolo/freesoftware@/.html}.
196 Es gibt ein LilyPond-Paket für TextMate. Es kann installiert werden, indem man
199 mkdir -p /Library/Application\ Support/TextMate/Bundles
200 cd /Library/Application\ Support/TextMate/Bundles
201 svn co http://macromates.com/svn/Bundles/trunk/Bundles/Lilypond.tmbundle/
208 @node Point and click
209 @section Point and click
210 @cindex Point and click
213 Point and click erlaubt es, die Noten in der Quelldatei zu finden, indem man sie
214 im PDF anklickt. Das erleichtert es, fehlerhafte Stellen zu finden.
216 Wenn diese Funktionalität aktiv ist, fügt LilyPond hyperlinks zum PDF hinzu.
217 Diese werden dann bei einem Klick zum Browser geschickt, der wiederum
218 einen Texteditor mit dem Cursor an der richtigen Stelle öffnet.
220 Damit diese Kettenreaktion funktioniert, müssen Sie ihrem PDF-Programm
221 mit dem Skript @file{lilypond-invoke-editor} beibringen, Hyperlinks zu folgen.
223 Im Falle von Xpdf auf einer Unix-Maschine sollte folgende Zeile in der Datei
224 @file{xpdfrc}@footnote{Unter Unix befindet sich diese Datei entweder in
225 @file{/etc/xpdfrc} oder als @file{.xpdfrc} in Ihrem Heim-Verzeichnis.} stehen.
228 urlCommand "lilypond-invoke-editor %s"
231 Das Programm @file{lilypond-invoke-editor} ist ein kleines Hilfsprogramm.
232 Es ruft einen Editor auf für bestimmte @code{textedit}-URIs und startet
233 einen Browser für die anderen. Die Umgebungsvariable @code{EDITOR}
234 wird für folgende Zeichenketten:
240 emacsclient --no-wait +@var{line}:@var{column} @var{file}
245 gvim --remote +:@var{line}:norm@var{char} @var{file}
251 nc -noask +@var{line} @var{file}'
255 Die Umgebunsvariable @code{LYEDITOR} wird verwendet, um dieses zu
256 überschreiben. Sie enthält den Befehl, um den Editor aufzurufen, wobei
257 die Variablen @code{%(file)s},
258 @code{%(column)s}, @code{%(line)s} mit der Datei, Spalte und Zeile
259 ersetzt werden. Die Einstellung
262 emacsclient --no-wait +%(line)s:%(column)s %(file)s
266 für @code{LYEDITOR} etwa entspricht dem von vornherein eingestellten
270 @cindex Dateigröße, Ausgabedatei
272 Die point and click-Links vergrößern die Notationsdatei erheblich. Um die
273 Größe der PDF- und PS-Dateien zu verringern, kann point and click
274 ausgeschaltet werden, indem die Zeile
277 #(ly:set-option 'point-and-click #f)
281 in der @file{.ly}-Datei gesetzt wird. Alternativ erreichen Sie das auch mit einer
282 Kommandozeilenoption:
285 lilypond -dno-point-and-click file.ly