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: cdb8fdf689c58f742333f4bf4f92cbfae2e01a5b
   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.61"
  11
  12 @c Translators: Till Rettig, Reinhold Kainhofer
  13
  14 @node Setup
  15 @chapter Setup
  16
  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.
  21
  22 @menu
  23 * Setup for specific Operating Systems::
  24 * Text editor support::
  25 * Point and click::
  26 @end menu
  27
  28
  29 @node Setup for specific Operating Systems
  30 @section Setup for specific Operating Systems
  31
  32 Dieser Abschnitt erklärt zusätzliche Einstellungen für bestimmte Betriebssysteme.
  33
  34 @menu
  35 * MacOS X on the command-line::
  36 @end menu
  37
  38
  39 @node MacOS X on the command-line
  40 @subsection MacOS X on the command-line
  41
  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
  45
  46 @example
  47 @var{Pfad/zu}/LilyPond.app/Contents/Resources/bin/lilypond
  48 @end example
  49
  50 @noindent
  51 Entsprechend funktionieren auch die anderen Skripte wie lilypond-book,
  52 convert-ly, abc2ly usw.
  53
  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:
  56
  57 @example
  58 mkdir -p ~/bin
  59 cd ~/bin
  60 @end example
  61
  62 Erstellen Sie eine Datei mit dem Namen @code{lilypond} und dem Inhalt
  63
  64 @example
  65 exec @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
  66 @end example
  67
  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.
  73
  74 Machen Sie die Datei ausführbar:
  75
  76 @example
  77 chmod u+x lilypond
  78 @end example
  79
  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
  83
  84 @example
  85 export PATH=$PATH:~/bin
  86 @end example
  87
  88 @noindent
  89 beinhaltet. Die Datei muss mit einer Leerzeile enden.
  90
  91 Beachten Sie, dass @var{Pfad/zu} üblicherweise @code{/Applications/} ist.
  92
  93
  94 @node Text editor support
  95 @section Text editor support
  96
  97 @cindex Editoren
  98 @cindex vim
  99 @cindex emacs
 100 @cindex Modus, Editoren
 101 @cindex Syntax-Hervorhebung
 102 @cindex Hervorhebung der Syntax
 103
 104 Verschiedene Texteditoren haben Unterstützung für LilyPond.
 105
 106 @menu
 107 * Emacs mode::
 108 * Vim mode::
 109 * jEdit::
 110 * TexShop::
 111 * TextMate::
 112 * LilyKDE::
 113 @end menu
 114
 115 @node Emacs mode
 116 @subsection Emacs mode
 117
 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.
 125
 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.
 132
 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:
 136
 137 @c any reason we do not advise:  (push "~/site-lisp" load-path)
 138 @example
 139 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
 140 @end example
 141
 142
 143 @node Vim mode
 144 @subsection Vim mode
 145
 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.
 150
 151 LilyPond-Dateien werden automatisch erkannt, wenn sich in der Datei
 152 @file{~/.vim/filetype.vim} folgender Inhalt befindet:
 153
 154 @example
 155 if exists("did_load_filetypes")
 156   finish
 157 endif
 158 augroup filetypedetect
 159   au! BufNewFile,BufRead *.ly           setf lilypond
 160 augroup END
 161 @end example
 162
 163 Fügen Sie den LilyPond-Pfad in ihre
 164 @file{~/.vimrc}-Datei ein, indem Sie ihre folgende Zeile hinzufügen:
 165
 166 @example
 167 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
 168 @end example
 169
 170 @noindent
 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.
 174
 175
 176 @node jEdit
 177 @subsection jEdit
 178
 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}
 187
 188
 189 @node TexShop
 190 @subsection TexShop
 191
 192 Der
 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}.
 197
 198
 199 @node TextMate
 200 @subsection TextMate
 201
 202 Es gibt ein LilyPond-Paket für TextMate. Es kann installiert werden,  indem man
 203
 204 @example
 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/
 208 @end example
 209
 210 @noindent
 211 ausführt.
 212
 213
 214 @node LilyKDE
 215 @subsection LilyKDE
 216
 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
 221 PDF-Betrachter.
 222
 223 LilyKDE benutzt auch @uref{http://www.volny.cz/smilauer/rumor/,Rumor},
 224 um Musik direkt von einem MIDI-Keyboard einzulesen.
 225
 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.
 229
 230
 231 @node Point and click
 232 @section Point and click
 233 @cindex Point and click
 234
 235
 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.
 238
 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.
 242
 243 Damit diese Kettenreaktion funktioniert, müssen Sie ihrem PDF-Programm
 244 mit dem Skript @file{lilypond-invoke-editor} beibringen, Hyperlinks zu folgen.
 245
 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.
 249
 250 @example
 251 urlCommand     "lilypond-invoke-editor %s"
 252 @end example
 253
 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:
 258
 259 @table @code
 260 @item emacs
 261   das startet
 262 @example
 263 emacsclient --no-wait +@var{line}:@var{column} @var{file}
 264 @end example
 265 @item vim
 266   das startet
 267 @example
 268 gvim --remote +:@var{line}:norm@var{char} @var{file}
 269 @end example
 270
 271 @item nedit
 272  das startet
 273 @example
 274   nc -noask +@var{line} @var{file}'
 275 @end example
 276 @end table
 277
 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
 283
 284 @example
 285 emacsclient --no-wait +%(line)s:%(column)s %(file)s
 286 @end example
 287
 288 @noindent
 289 für @code{LYEDITOR} etwa entspricht dem von vornherein eingestellten
 290 Emacs-Aufruf.
 291
 292
 293 @cindex Dateigröße, Ausgabedatei
 294
 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
 298
 299 @example
 300 \pointAndClickOff
 301 @end example
 302
 303 @noindent
 304 in der @file{.ly}-Datei gesetzt wird. Point and Click kann auch explizit
 305 eingeschaltet werden durch die Zeile:
 306
 307 @example
 308 \pointAndClickOn
 309 @end example
 310
 311 Alternativ können Sie Point and Click auch mit einer
 312 Kommandozeilenoption ausschalten:
 313
 314 @example
 315 lilypond -dno-point-and-click file.ly
 316 @end example
 317
 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.}