Documentation/de/user/setup.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @c This file is part of lilypond-program.tely
   3 @ignore
   4     Translation of GIT committish: 76de7e168dbc9ffc7671d99663c5ce50dae42abb
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  See TRANSLATION for details.
   8 @end ignore
   9
  10 @node Setup
  11 @chapter Setup
  12
  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.
  17
  18 @menu
  19 * Setup for specific Operating Systems::
  20 * Text editor support::
  21 * Point and click::
  22 @end menu
  23
  24
  25 @node Setup for specific Operating Systems
  26 @section Setup for specific Operating Systems
  27
  28 Dieser Abschnitt erklärt zusätzliche Einstellungen für bestimmte Betriebsysteme.
  29
  30 @menu
  31 * MacOS X on the command-line::
  32 @end menu
  33
  34
  35 @node MacOS X on the command-line
  36 @subsection MacOS X on the command-line
  37
  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
  41
  42 @example
  43 @var{Pfad/zu}/LilyPond.app/Contents/Resources/bin/lilypond
  44 @end example
  45
  46 Entsprechend funktionieren auch die anderen Skripte wie lilypond-book,
  47 convert-ly, abc2ly usw.
  48
  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:
  51
  52 @example
  53 mkdir -p ~/bin
  54 cd ~/bin
  55 @end example
  56
  57 Erstellen Sie eine Datei mit dem Namen @code{lilypond} und dem Inhalt
  58
  59 @example
  60 exec @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
  61 @end example
  62
  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.
  68
  69 Machen Sie die Datei ausführbar:
  70
  71 @example
  72 chmod u+x lilypond
  73 @end example
  74
  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
  78
  79 @example
  80 export PATH=$PATH:~/bin
  81 @end example
  82
  83 @noindent
  84 beinhaltet. Die Datei muss mit einer Leerzeile enden.
  85
  86 Beachten Sie, dass @var{Pfad/zu} überlicherweise @code{/Applications/} ist.
  87
  88
  89 @node Text editor support
  90 @section Text editor support
  91
  92 @cindex Editoren
  93 @cindex vim
  94 @cindex emacs
  95 @cindex Modus, Editoren
  96 @cindex Syntax-Hervorhebung
  97 @cindex Hervorhebung der Syntax
  98
  99 Verschiedene Texteditoren haben Unterstützung für LilyPond.
 100
 101 @menu
 102 * Emacs mode::
 103 * Vim mode::
 104 * jEdit::
 105 * TexShop::
 106 * TextMate::
 107 @end menu
 108
 109 @node Emacs mode
 110 @subsection Emacs mode
 111
 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.
 119
 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.
 126
 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:
 130
 131 @c any reason we do not advise:  (push "~/site-lisp" load-path)
 132 @example
 133 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
 134 @end example
 135
 136
 137 @node Vim mode
 138 @subsection Vim mode
 139
 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.
 144
 145 LilyPond-Dateien werden automatisch erkannt, wenn sich in der Datei
 146 @file{~/.vim/filetype.vim} folgender Inhalt befindet:
 147
 148 @example
 149 if exists("did_load_filetypes")
 150   finish
 151 endif
 152 augroup filetypedetect
 153   au! BufNewFile,BufRead *.ly           setf lilypond
 154 augroup END
 155 @end example
 156
 157 Fügen Sie den LilyPond-Pfad in ihre
 158 @file{~/.vimrc}-Datei ein, indem Sie ihre folgende Zeile hinzufügen:
 159
 160 @example
 161 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
 162 @end example
 163
 164 @noindent
 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.
 168
 169
 170 @node jEdit
 171 @subsection jEdit
 172
 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}
 181
 182
 183 @node TexShop
 184 @subsection TexShop
 185
 186 Der
 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}.
 191
 192
 193 @node TextMate
 194 @subsection TextMate
 195
 196 Es gibt ein LilyPond-Paket für TextMate. Es kann installiert werden,  indem man
 197
 198 @example
 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/
 202 @end example
 203
 204 @noindent
 205 ausführt.
 206
 207
 208 @node Point and click
 209 @section Point and click
 210 @cindex Point and click
 211
 212
 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.
 215
 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.
 219
 220 Damit diese Kettenreaktion funktioniert, müssen Sie ihrem PDF-Programm
 221 mit dem Skript @file{lilypond-invoke-editor} beibringen, Hyperlinks zu folgen.
 222
 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.
 226
 227 @example
 228 urlCommand     "lilypond-invoke-editor %s"
 229 @end example
 230
 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:
 235
 236 @table @code
 237 @item emacs
 238   das startet
 239 @example
 240 emacsclient --no-wait +@var{line}:@var{column} @var{file}
 241 @end example
 242 @item vim
 243   das startet
 244 @example
 245 gvim --remote +:@var{line}:norm@var{char} @var{file}
 246 @end example
 247
 248 @item nedit
 249  das startet
 250 @example
 251   nc -noask +@var{line} @var{file}'
 252 @end example
 253 @end table
 254
 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
 260
 261 @example
 262 emacsclient --no-wait +%(line)s:%(column)s %(file)s
 263 @end example
 264
 265 @noindent
 266 für @code{LYEDITOR} etwa entspricht dem von vornherein eingestellten
 267 Emacs-Aufruf.
 268
 269
 270 @cindex Dateigröße, Ausgabedatei
 271
 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
 275
 276 @example
 277 #(ly:set-option 'point-and-click #f)
 278 @end example
 279
 280 @noindent
 281 in der @file{.ly}-Datei gesetzt wird. Alternativ erreichen Sie das auch mit einer
 282 Kommandozeilenoption:
 283
 284 @example
 285 lilypond -dno-point-and-click file.ly
 286 @end example
 287