1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond-program.tely
4 Translation of GIT committish: cdb8fdf689c58f742333f4bf4f92cbfae2e01a5b
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 @c Translators: Till Rettig, Reinhold Kainhofer
17 In diesem Kapitel werden verschiedene Konfigurationsoptionen für LilyPond und
18 andere Programme behandelt, die nach der Installation auszuführen sind. Dieses
19 Kapitel kann als Referenz betrachtet werden, lesen Sie einen Abschnitt nur,
20 wenn er auf Sie zutrifft.
23 * Setup for specific Operating Systems::
24 * Text editor support::
29 @node Setup for specific Operating Systems
30 @section Setup for specific Operating Systems
32 Dieser Abschnitt erklärt zusätzliche Einstellungen für bestimmte Betriebssysteme.
35 * MacOS X on the command-line::
39 @node MacOS X on the command-line
40 @subsection MacOS X on the command-line
42 Die Skripte (wie lilypond-book, convert-ly, abc2ly und sogar
43 lilypond selber) sind innerhalb der .app-Datei für MacOS@tie{}X enthalten. Sie können
44 auf der Kommandozeile direkt aufgerufen werden, etwa
47 @var{Pfad/zu}/LilyPond.app/Contents/Resources/bin/lilypond
51 Entsprechend funktionieren auch die anderen Skripte wie lilypond-book,
52 convert-ly, abc2ly usw.
54 Sie können sich auch selber Skripte anlegen, die diesen Pfad automatisch
55 hinzufügen. Erstellen Sie ein Verzeichnis, indem die Skripte gespeichert werden:
62 Erstellen Sie eine Datei mit dem Namen @code{lilypond} und dem Inhalt
65 exec @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
68 Erstellen Sie entsprechende Dateien mit den Namen @code{lilypond-book},
69 @code{convert-ly} und den Namen der anderen Hilfsprogramme, die Sie benutzen
70 (@code{abc2ly}, @code{midi2ly} usw.). Ersetzen Sie einfach den Teil
71 @code{bin/lilypond} mit @code{bin/convert-ly} (oder einem anderen
72 Programmnamen) in der entsprechenden Datei.
74 Machen Sie die Datei ausführbar:
80 Jetzt müssen Sie dieses Verzeichnis noch zu Ihrem Pfad (PATH) hinzufügen.
81 Verändern Sie die Datei @code{.profile} in Ihrem Benutzerverzeichnis
82 (oder erstellen Sie sie), dass sie die Zeile
85 export PATH=$PATH:~/bin
89 beinhaltet. Die Datei muss mit einer Leerzeile enden.
91 Beachten Sie, dass @var{Pfad/zu} üblicherweise @code{/Applications/} ist.
94 @node Text editor support
95 @section Text editor support
100 @cindex Modus, Editoren
101 @cindex Syntax-Hervorhebung
102 @cindex Hervorhebung der Syntax
104 Verschiedene Texteditoren haben Unterstützung für LilyPond.
116 @subsection Emacs mode
118 Emacs hat einen LilyPond-Modus (@file{lilypond-mode}), eine Datei, die
119 die Vervollständigung von Befehlen, Einrückungen, für LilyPond spezifische
120 Klammerschließungen und die Markierung der Syntax beherrscht.
121 Zusätzlich stehen noch praktische Tastaturkombinationen zum
122 Programmaufruf und zum Nachschlagen in den Handbüchern zur
123 Verfügung. Siehe unten, wenn die Datei @file{lilypond-mode}
124 sich nicht auf Ihrem Computer befindet.
126 Der Emacs-Modus zur Noteneingabe und zum Programmaufruf ist
127 in den Emacs-Quellen im @file{elisp}-Verzeichnis enthalten. Mit
128 dem Befehl @command{make install} können Sie es nach @var{elispdir}
129 installieren. Die Datei @file{lilypond-init.el} sollte in
130 @var{load-path}@file{/site-start.d/} liegen oder Ihrem
131 @file{~/.emacs} or @file{~/.emacs.el} hinzugefügt werden.
133 Als Benutzer können Sie Ihren Quellenpfad (etwa @file{~/site-lisp/})
134 ihrem @var{load-path} hinzufügen, indem Sie folgende Zeile zu Ihrer
135 @file{~/.emacs}-Datei hinzufügen:
137 @c any reason we do not advise: (push "~/site-lisp" load-path)
139 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
146 Für @uref{http://@/www@/.vim@/.org,VIM} wird ein @file{vimrc} bereitgestellt,
147 zusammen mit Werkzeugen zur Syntaxauszeichnung. Ein Vim-Modus zur
148 Noteneingabe und zum Programmaufruf befindet sich im Quellarchiv im
149 @code{$VIM}-Verzeichnis.
151 LilyPond-Dateien werden automatisch erkannt, wenn sich in der Datei
152 @file{~/.vim/filetype.vim} folgender Inhalt befindet:
155 if exists("did_load_filetypes")
158 augroup filetypedetect
159 au! BufNewFile,BufRead *.ly setf lilypond
163 Fügen Sie den LilyPond-Pfad in ihre
164 @file{~/.vimrc}-Datei ein, indem Sie ihre folgende Zeile hinzufügen:
167 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
171 Dabei wird $@{LILYPOND_VERSION@}durch Ihre LilyPond-Version ersetzt. Sollten
172 Sie LilyPond nicht nach @file{/usr/local/} installiert haben, müssen Sie den
173 Pfad entsprechend anpassen.
179 Das Plugin für den @uref{http://@/www@/.jedit@/.org@/,jEdit}-Texteditor,
180 LilyPondTool genannt, ist das vielfältigste textbasierte Werkzeug, um
181 LilyPond-Notationsdateien zu editieren. Zu den besonderen Eigenschaften
182 gehört ein Dokument-Ersteller mit Liedtextunterstützung, der die Neuerstellung
183 von Dateien erleichtert, und ein integriertes PDF-Anzeigeprogramm mit
184 @qq{point-and-click}-Unterstützung. Demos, Bildschirmphotos und
185 Installationsanweisungen finden sich unter
186 @uref{http://lilypondtool@/.organum@/.hu}
193 @uref{http://@/www@/.uoregon@/.edu/~koch/texshop/index@/.html,TexShop}-Editor
194 für MacOS@tie{}X kann erweitert werden, um LilyPond, lilypond-book und convert-ly aus dem
195 Editor heraus zu starten. Die Erweiterung findet sich unter
196 @uref{http://@/www@/.dimi@/.uniud@/.it/vitacolo/freesoftware@/.html}.
202 Es gibt ein LilyPond-Paket für TextMate. Es kann installiert werden, indem man
205 mkdir -p /Library/Application\ Support/TextMate/Bundles
206 cd /Library/Application\ Support/TextMate/Bundles
207 svn co http://macromates.com/svn/Bundles/trunk/Bundles/Lilypond.tmbundle/
217 @uref{http://lilykde.googlecode.com/,LilyKDE} ist eine Erweiterung für
218 den Texteditor @uref{http://kate-editor.org/,Kate} für KDE. LilyKDE
219 beinhaltet einen mächtigen Assistenten, mit dem sehr schnell neue
220 LilyPond-Dokumente erstellt werden könne, sowie einen eingebetteten
223 LilyKDE benutzt auch @uref{http://www.volny.cz/smilauer/rumor/,Rumor},
224 um Musik direkt von einem MIDI-Keyboard einzulesen.
226 Weitere Fähigkeiten von LilyKDE sind Silbentrennung für Liedtexte oder
227 die Möglichkeit, LilyPond gleichzeitig mit mehreren Eingabedateien vom
228 KDE Dateimanager aus aufzurufen.
231 @node Point and click
232 @section Point and click
233 @cindex Point and click
236 Point and click erlaubt es, die Noten in der Quelldatei zu finden, indem man sie
237 im PDF anklickt. Das erleichtert es, fehlerhafte Stellen zu finden.
239 Wenn diese Funktionalität aktiv ist, fügt LilyPond Hyperlinks zum PDF hinzu.
240 Diese werden dann bei einem Klick zum Browser geschickt, der wiederum
241 einen Texteditor mit dem Cursor an der richtigen Stelle öffnet.
243 Damit diese Kettenreaktion funktioniert, müssen Sie ihrem PDF-Programm
244 mit dem Skript @file{lilypond-invoke-editor} beibringen, Hyperlinks zu folgen.
246 Im Falle von Xpdf auf einer UNIX-Maschine sollte folgende Zeile in der Datei
247 @file{xpdfrc}@footnote{Unter UNIX befindet sich diese Datei entweder in
248 @file{/etc/xpdfrc} oder als @file{.xpdfrc} in Ihrem Heim-Verzeichnis.} stehen.
251 urlCommand "lilypond-invoke-editor %s"
254 Das Programm @file{lilypond-invoke-editor} ist ein kleines Hilfsprogramm.
255 Es ruft einen Editor auf für bestimmte @code{textedit}-URIs und startet
256 einen Browser für die anderen. Die Umgebungsvariable @code{EDITOR}
257 wird für folgende Zeichenketten:
263 emacsclient --no-wait +@var{line}:@var{column} @var{file}
268 gvim --remote +:@var{line}:norm@var{char} @var{file}
274 nc -noask +@var{line} @var{file}'
278 Die Umgebungsvariable @code{LYEDITOR} wird verwendet, um dieses zu
279 überschreiben. Sie enthält den Befehl, um den Editor aufzurufen, wobei
280 die Variablen @code{%(file)s},
281 @code{%(column)s}, @code{%(line)s} mit der Datei, Spalte und Zeile
282 ersetzt werden. Die Einstellung
285 emacsclient --no-wait +%(line)s:%(column)s %(file)s
289 für @code{LYEDITOR} etwa entspricht dem von vornherein eingestellten
293 @cindex Dateigröße, Ausgabedatei
295 Die point and click-Links vergrößern die Notationsdatei erheblich. Um die
296 Größe der PDF- und PS-Dateien zu verringern, kann point and click
297 ausgeschaltet werden, indem die Zeile
304 in der @file{.ly}-Datei gesetzt wird. Point and Click kann auch explizit
305 eingeschaltet werden durch die Zeile:
311 Alternativ können Sie Point and Click auch mit einer
312 Kommandozeilenoption ausschalten:
315 lilypond -dno-point-and-click file.ly
318 @warning{Sie sollten Point and Click immer für Dateien ausschalten, die
319 Sie an andere Personen weitergeben möchten. Anderenfalls werden
320 Pfadinformationen Ihres Computers in die PDF-Datei kopiert, was ein
321 potentielles Sicherheitsrisiko darstellt.}