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 @c \version "2.11.51"
  11
  12 @node Setup
  13 @chapter Setup
  14
  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.
  19
  20 @menu
  21 * Setup for specific Operating Systems::
  22 * Text editor support::
  23 * Point and click::
  24 @end menu
  25
  26
  27 @node Setup for specific Operating Systems
  28 @section Setup for specific Operating Systems
  29
  30 Dieser Abschnitt erklärt zusätzliche Einstellungen für bestimmte Betriebssysteme.
  31
  32 @menu
  33 * MacOS X on the command-line::
  34 @end menu
  35
  36
  37 @node MacOS X on the command-line
  38 @subsection MacOS X on the command-line
  39
  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
  43
  44 @example
  45 @var{Pfad/zu}/LilyPond.app/Contents/Resources/bin/lilypond
  46 @end example
  47
  48 Entsprechend funktionieren auch die anderen Skripte wie lilypond-book,
  49 convert-ly, abc2ly usw.
  50
  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:
  53
  54 @example
  55 mkdir -p ~/bin
  56 cd ~/bin
  57 @end example
  58
  59 Erstellen Sie eine Datei mit dem Namen @code{lilypond} und dem Inhalt
  60
  61 @example
  62 exec @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
  63 @end example
  64
  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.
  70
  71 Machen Sie die Datei ausführbar:
  72
  73 @example
  74 chmod u+x lilypond
  75 @end example
  76
  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
  80
  81 @example
  82 export PATH=$PATH:~/bin
  83 @end example
  84
  85 @noindent
  86 beinhaltet. Die Datei muss mit einer Leerzeile enden.
  87
  88 Beachten Sie, dass @var{Pfad/zu} üblicherweise @code{/Applications/} ist.
  89
  90
  91 @node Text editor support
  92 @section Text editor support
  93
  94 @cindex Editoren
  95 @cindex vim
  96 @cindex emacs
  97 @cindex Modus, Editoren
  98 @cindex Syntax-Hervorhebung
  99 @cindex Hervorhebung der Syntax
 100
 101 Verschiedene Texteditoren haben Unterstützung für LilyPond.
 102
 103 @menu
 104 * Emacs mode::
 105 * Vim mode::
 106 * jEdit::
 107 * TexShop::
 108 * TextMate::
 109 @end menu
 110
 111 @node Emacs mode
 112 @subsection Emacs mode
 113
 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.
 121
 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.
 128
 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:
 132
 133 @c any reason we do not advise:  (push "~/site-lisp" load-path)
 134 @example
 135 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
 136 @end example
 137
 138
 139 @node Vim mode
 140 @subsection Vim mode
 141
 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.
 146
 147 LilyPond-Dateien werden automatisch erkannt, wenn sich in der Datei
 148 @file{~/.vim/filetype.vim} folgender Inhalt befindet:
 149
 150 @example
 151 if exists("did_load_filetypes")
 152   finish
 153 endif
 154 augroup filetypedetect
 155   au! BufNewFile,BufRead *.ly           setf lilypond
 156 augroup END
 157 @end example
 158
 159 Fügen Sie den LilyPond-Pfad in ihre
 160 @file{~/.vimrc}-Datei ein, indem Sie ihre folgende Zeile hinzufügen:
 161
 162 @example
 163 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
 164 @end example
 165
 166 @noindent
 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.
 170
 171
 172 @node jEdit
 173 @subsection jEdit
 174
 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}
 183
 184
 185 @node TexShop
 186 @subsection TexShop
 187
 188 Der
 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}.
 193
 194
 195 @node TextMate
 196 @subsection TextMate
 197
 198 Es gibt ein LilyPond-Paket für TextMate. Es kann installiert werden,  indem man
 199
 200 @example
 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/
 204 @end example
 205
 206 @noindent
 207 ausführt.
 208
 209
 210 @node Point and click
 211 @section Point and click
 212 @cindex Point and click
 213
 214
 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.
 217
 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.
 221
 222 Damit diese Kettenreaktion funktioniert, müssen Sie ihrem PDF-Programm
 223 mit dem Skript @file{lilypond-invoke-editor} beibringen, Hyperlinks zu folgen.
 224
 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.
 228
 229 @example
 230 urlCommand     "lilypond-invoke-editor %s"
 231 @end example
 232
 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:
 237
 238 @table @code
 239 @item emacs
 240   das startet
 241 @example
 242 emacsclient --no-wait +@var{line}:@var{column} @var{file}
 243 @end example
 244 @item vim
 245   das startet
 246 @example
 247 gvim --remote +:@var{line}:norm@var{char} @var{file}
 248 @end example
 249
 250 @item nedit
 251  das startet
 252 @example
 253   nc -noask +@var{line} @var{file}'
 254 @end example
 255 @end table
 256
 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
 262
 263 @example
 264 emacsclient --no-wait +%(line)s:%(column)s %(file)s
 265 @end example
 266
 267 @noindent
 268 für @code{LYEDITOR} etwa entspricht dem von vornherein eingestellten
 269 Emacs-Aufruf.
 270
 271
 272 @cindex Dateigröße, Ausgabedatei
 273
 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
 277
 278 @example
 279 #(ly:set-option 'point-and-click #f)
 280 @end example
 281
 282 @noindent
 283 in der @file{.ly}-Datei gesetzt wird. Alternativ erreichen Sie das auch mit einer
 284 Kommandozeilenoption:
 285
 286 @example
 287 lilypond -dno-point-and-click file.ly
 288 @end example
 289